Command Palette

The command palette is the fastest way to control a live session. Press the : key (when you're not typing in a text field) to activate it, type a command, and press Enter to execute.

How It Works

1. Press : — the command palette appears
2. Type a command (e.g., pma to mute all)
3. Press Enter or Tab to execute
4. Press Escape or Backspace (on empty input) to cancel

When a command shows a list (like scenes or variables), you can navigate with:

• Arrow keys or j/k — move up and down
• Enter — select the highlighted item
• gg — jump to the top of the list

Command Reference

Scenes (:s)

Command	Description
:s <name or #num>	Switch to a scene by name or number
:sn	Next scene (editor order)
:sp	Previous scene
:sl	List all scenes (navigate and select)

Snapshots (:ss)

Command	Description
:ss <name or #num>	Apply a snapshot by name or number
:ssl	List all snapshots (navigate and select)
:ssn	Next snapshot (wraps around)
:ssp	Previous snapshot (wraps around)

People (:p)

Command	Description
:pm <name>	Mute a specific participant (fuzzy name match)
:pma	Mute all participants
:pk <name>	Kick (remove) a participant
:pa <name>	Admit a waiting visitor (fuzzy name match)
:paa	Admit all waiting visitors
:pd <name>	Deny a waiting visitor
:pda	Deny all waiting visitors
:pso	Toggle speakers-only mode (restrict mic and camera)

Note: You cannot unmute another participant — this is a privacy protection. Participants must unmute themselves.

Ripple Control (:r)

Command	Description
:rl	Lock the Ripple (prevent new joins)
:ru	Unlock the Ripple (allow joins)
:rlt	Toggle lock state
:rba	Activate breakout zones
:rbd	Deactivate breakouts (return to main)
:rbt	Toggle breakout zones
:rr	Reset Ripple to its start state

Drops (:d)

Command	Description
:dn	Toggle drop number labels (visible over seats)
:dm <name> <drop#>	Move a participant to a drop by number

Tip: Use :dn to see which seat is which, then :dm jessica 5 to move Jessica to drop 5. The name is fuzzy-matched — typing the first few characters is enough.

Variables (:v)

Command	Description
:vs <name> <value>	Set a variable to a value
:vi <name> [amount]	Increment a numeric variable (default: +1)
:vd <name> [amount]	Decrement a numeric variable (default: -1)
:vt <name>	Toggle a boolean variable
:vr <name>	Reset a variable to its initial value
:vra	Reset all variables to initial values
:vl	List all variables with current values
:vR <name> <min> <max> [mode]	Set a variable to a random value in range

Random modes: cycle (no immediate repeats), no-repeat (exhaustive), pure (truly random).

Timers (:t)

Command	Description
:tc <duration>	Start a countdown timer (e.g., 5m, 90s, 1h)
:tp [focus/break]	Start a pomodoro timer (default: 25/5)
:tq	Start a sequence timer (uses saved config)
:t.	Toggle pause/resume
:tx	Stop/cancel the timer
:ta <duration>	Add time to a running timer (e.g., 2m)
:tn	Advance to next round (sequence timer only)
:tr	Reset timer to original duration

Duration formats: 5m (minutes), 90s (seconds), 1h (hours), or a plain number (treated as minutes).

UI Panels (:g)

Command	Description
:gc	Open the chat panel
:gp	Open the People list
:go	Open the polls panel
:gt	Open the timer controls (coming soon)
:ge	Open the Ripple editor (same tab)
:gE	Open the Ripple editor (new tab)
:gT	Toggle the creator toolbar
:gx	Close all panels and hide bars
:gxt	Toggle title and control bars

Tips

• Fuzzy matching: Commands like :pm and :pa use fuzzy name matching — you don't need to type the full name. Typing the first few characters is usually enough.
• Quick sequences: Commands execute immediately, so you can chain actions quickly — press :, type pma, press Enter, and everyone is muted in under a second.
• Always available: The command palette works whenever you're not typing in a text input (chat, forms, etc.). If it doesn't activate, click somewhere neutral first.
• Hints appear as you type: After pressing :, available commands appear as hints. As you type more characters, the list narrows to matching commands.