prism docs · Music, control and shows · The timeline

The timeline

A timeline animates a scene or a cue: its settings change over time, from key to key, in seconds or in beats. Fire the scene and its timeline plays from the start, on every projector at once. Music reactions and automation keep working on top.

WhereLive control ▸ Timeline
StartA tile's menu ▸ Animate, or a setting's right-click ▸ Add to timeline
PlayShift + Space, or fire the scene
ModeAdvanced (timelines play in Simple too)
The song lane 1 · Animate a scene or cue 2 · The Timeline tab 3 · Put settings on the timeline 4 · Keys 5 · Rec 6 · Playing, and firing scenes 7 · Take-over 8 · Beats, snapping and loops 9 · Key diamonds and tile badges 10 · Hints and tips 11 · When something looks wrong 12 · Mouse and keyboard

1Animate a scene or cue

  1. Save the look as a scene (+ Scene), then click its tile so it is selected.
  2. Open Live control ▸ Timeline. It shows the selected tile's timeline, or says it isn't animated.
  3. Click Animate (or right-click the tile ▸ Animate). The scene gets an 8-second timeline. A scene starts empty; a cue's settings become its first tracks, each with a key at 0.
  4. Add settings and keys (next sections), then press Shift + Space to play it.
The Timeline tab: “Scene 1” isn't animated, with Animate
A scene without a timeline: Animate gives it one.

An animated tile shows a lavender timeline badge. Its menu then has Open timeline and Stop animating (which takes the timeline away; Ctrl + Z brings it back).

2The Timeline tab

A timeline with the Wall's colour and brightness, the Door's opacity and the Pillar's scale, the playhead at 2.5 s and a key selected
Scene 1's timeline: the Wall's Colour (a strip through red, blue and yellow), its Brightness (a curve), the Door's Opacity and the Pillar's Scale. The playhead is at 2.5 s; a key is selected and the key editor shows it at the bottom.

The transport, left to right

ControlWhat it does
▶ / ❚❚Play and pause (Shift + Space). Paused, the values hold at the playhead.
■Stop: back to the start, and the scene's saved values show again.
LoopPlay the loop again and again. Off: it plays once and holds its last values.
PositionWhere the playhead is, for example 0:02.50. Click it to switch between seconds and bars:beats.
Speed0.25× to 4×.
FollowThe view scrolls to keep the playhead in sight while it plays.
Length, s | beatsThe timeline's length, in seconds or in beats of the tempo.
“Cue 2” playsShown when another scene's timeline is playing.
N taken over ↺Settings a control has taken over; ↺ gives them all back (Take-over).
SnappingKeys snap to beats, other keys and the playhead.
Zoom to fitShows the whole timeline.
RecEvery change writes a key at the playhead (Rec).

Tracks and lanes

3Put settings on the timeline

A setting's menu with Timeline of “Scene 1” and Add to timeline, a key at 3 s
Right-click a setting: Timeline of “Scene 1” ▸ Add to timeline, a key at 3 s. Once on the timeline, the same place offers Add a key at… / Remove the key at…, Show in the timeline and Remove from timeline.

What can be animated: a look's settings (numbers, colours, switches and choices, positions), the layer's opacity and playback speed, and the master brightness. Colours fade through a perceptual colour space, so fades look even; switches and choices change at the key. Not yet: a layer's visibility and blend, a surface's or group's opacity and visibility, and shapes.

4Keys

To…Do this
Add a keyDouble-click a lane · ◆ on the track (at the playhead) · a diamond in the look panel (section 9). A new key holds what the track plays there, so the animation doesn't change until you change the key.
Select keysClick · Shift or Ctrl-click to add · drag a box on an empty lane · Ctrl + A · double-click a track's name for all its keys
Move keysDrag them (they snap); Alt-drag copies; Shift-drag moves freely; ← → nudge by the grid
Change a keyThe key editor under the lanes: Time (seconds, m:ss or bars:beats), Value (the setting's own control) and how it moves to the next key
How it moves onHold H (stays, then jumps) · Linear L · Bézier B (eases in and out) · Auto A (a smooth curve through the keys that never overshoots)
Copy and pasteCtrl + C, then Ctrl + V pastes at the playhead, into the tracks you picked (a colour only into a colour)
DeleteDelete or Backspace (never the canvas's surface)
A key's menu: Hold, Linear, Bézier, Auto, Go to key, Copy key, Paste at the playhead, Delete
Right-click a key: how it moves on, Go to key, copy, paste, delete.
A timeline in beats, 16 beats long, with a loop over the whole length
The same timeline in beats with Loop on: the ruler counts bars:beats and the lavender band on top is the loop.

Key shapes tell you how they move on: a diamond is linear, a square holds, a round key eases (Bézier or Auto). Every edit is one undo step (“Move 3 keys”, “Set 2 keys to Hold”).

5Rec

  1. Move the playhead to where the change should be.
  2. Click Rec. It turns red, the view gets a red outline, and the playhead and the scene's name turn red.
  3. Change settings in the look panel or inspector. Each change writes a key at the playhead (“Key Wall · Colour at 2.5 s”), making a track if needed.
  4. Move the playhead and change again. Click Rec to stop.
The Timeline tab with Rec on: red button, red outline, red playhead and scene name
Rec on: every change writes a key at the red playhead.

6Playing, and firing scenes

7Take-over

While a timeline drives a setting, you can still grab it. A change by hand (without Rec), a MIDI or OSC control, a trigger, or a cue fired on top takes the setting over: it follows the new value, not the timeline. The track shows Taken over by hand (or by MIDI, OSC, a key, “Cue 2”…) and its lane is hatched.

The Wall's Brightness track taken over by hand, hatched, with 1 taken over in the transport
The Wall's brightness, changed by hand while the timeline played: Taken over by hand ↺, the hatched lane, and 1 taken over ↺ in the transport.

↺ on the track (or right-click ▸ Back to the timeline) gives it back; ↺ in the transport gives all of them back. Stop, firing another timeline, and a Rec key on that setting also give it back. Undo doesn't.

8Beats, snapping and loops

9Key diamonds and tile badges

For each setting on the selected scene's timeline, the look panel and inspector show a small lime diamond on the left of the setting: filled when a key sits at the playhead, hollow otherwise. Click it to add a key there (holding what plays at that moment) or to remove the one there.

Colour with a filled diamond, Brightness with a hollow one, Playback speed without
The playhead is on a Colour key (filled diamond), between Brightness keys (hollow); Playback speed isn't on the timeline, so it has none.
Tile 1 with the lavender timeline badge and a progress bar along its bottom
An animated tile in the strip: the lavender badge, and the progress bar along its bottom.

The song lane Advanced editing

A scene's timeline can play one imported song. Choose Add a song, select a library song or A song file from this computer…, or drop a file onto the lane beneath the ruler. MP3, WAV, OGG and M4A are common choices; the browser must decode the codec and the file must be at most 300 MB. Simple mode can play a scene that already has a song.

ControlUse it for
WaveformSee the song's shape; drag it to change its offset relative to the timeline. Song options can start it at the playhead or put it back at the timeline start.
Detect beatsFind tempo, bars and sections. The ruler and snapping follow the detected grid; detection is a starting point to check by ear.
Song optionsReplace or remove the song, halve/double tempo, move Beat 1 a beat earlier/later, or remove the grid.
Song volumeAdjust -30 to +12 dB; double-click for the recorded level (0 dB). Check the computer's sound-output level too.
Play, GO, scene tile or Shift+SpaceStart timeline and song together. The song is the timeline clock. Pause, seek and loop follow the same transport.

A song timeline uses seconds, even when the ruler counts musical bars. It cannot switch to beat units with a song attached. The audio plays in the editor window on this computer; projector windows follow its timing, rather than playing duplicate sound. The song also feeds the sound analyser while playing.

Missing song: restore the archive containing the file or choose a replacement in the lane. Browser blocks playback: click Play in the editor to grant the required user gesture. No steady beat: some music will not yield a reliable grid; listen, correct half/double tempo and beat placement, or remove the grid. Changing or removing the song does not delete the source file from the library.

Follow A show to one song, then export a complete project including its audio.

10Hints and tips

11When something looks wrong

You seeWhyFix
“Select a scene or cue”No tile is selected.Click a tile (Ctrl-click selects it without firing).
“This setting can't be keyed on a timeline yet”Visibility, blends, group and surface opacity and shapes aren't animated yet.Use a layer's opacity, or scenes and cues for those.
A setting ignores its keysIt is taken over (hatched) or its track is muted.↺ Back to the timeline; unmute the track.
Keys went into the wrong sceneRec keys the scene the transport is on, which moves when you fire another tile.Undo, select the right tile, Rec again.
The timeline plays once and stopsLoop is off.Turn on Loop.
Play pauses another scene's timelineAnother timeline was playing (“Cue 2” plays): the transport acts on it.Fire this scene (click its tile): its timeline plays from the start.
The ruler switches between seconds and barsIt follows the tempo while the tracker is sure of it.Click the position to fix the display you want.
A beats timeline speeds up and slows downIt follows the live tempo.Lock the tempo (Audio ▸ Lock), or use seconds.

12Mouse and keyboard

These keys work while the timeline has the focus (click a key, a lane or a track name first).

ActionHow
Play / pauseShift + Space (anywhere in Design)
Next / previous keyTab / Shift + Tab (at the last key the focus moves on)
Start / endHome / End
Nudge keys, or move the playhead← → (Shift: a bigger step)
InterpolationH Hold · L Linear · B Bézier · A Auto
Copy, paste, select allCtrl + C · Ctrl + V (at the playhead) · Ctrl + A
Delete keysDelete or Backspace
DeselectEsc
Copy while dragging · drag freelyAlt + drag · Shift + drag
Zoom time · track height · scroll timeAlt + wheel · Ctrl + wheel · Shift + wheel
MenusRight-click a key, a lane, a track name or the ruler · Shift + F10
prism documentation · Music, control and shows · screenshots taken in prism's simulator · 28 Sept 2026