Get started

Keyboard shortcuts

Every key the studio answers to.

The studio answers to single keys for the things you do most: playing, versions, drawers and panels. Press ? in the studio, or click Keyboard shortcuts at the bottom of the rail, to see the main ones on screen.

The single-key shortcuts don't fire while you're typing in a field (the prompt box, the code editor, a name), or while you hold ⌘, Ctrl or Alt, so the browser's own shortcuts keep working. Where this page shows ⌘, use Ctrl on Windows.

Studio

Key	What it does
`/`	Puts the cursor in Perlin's prompt box, opening the panel first if it's folded.
`Space`	Pauses or plays the piece.
`R`	Restarts the piece.
`F`	Presents the piece full screen, or leaves present mode.
`[`	Steps back to the previous version.
`]`	Steps forward to the next version.
`\`	Shows or hides Perlin's panel (on a computer).
`W`	Opens Wallpaper & avatar.
`?`	Shows or hides the list of shortcuts.
`Esc`	Closes or lets go of whatever is on top. See below.

Space, R and F need a piece on stage. W needs a piece that is running without an error. The version keys don't work while Perlin is building.

Esc closes one thing at a time, in this order: an image you're previewing, the asset viewer, the asset picker, the Generate assets panel, present mode, whatever is selected in the Motion panel, then an open drawer. It also closes the shortcuts list.

Panels and drawers

Press a drawer's key again to close it. Opening another drawer replaces the one that's open.

Key	What it does
`H`	Opens or closes Versions.
`L`	Opens or closes My pieces.
`A`	Opens or closes Assets.
`C`	Opens or closes Code.
`G`	Opens or closes the Gallery.
`P`	Shows or hides the Parameters panel.
`M`	Opens or closes the Motion panel.

M needs a piece on stage and a screen at least 1024 pixels wide. When the stage is narrow, with the code drawer open for instance, the Parameters panel starts folded and P leaves it as it is: click the panel's title to open it.

Prompt box and fields

Key	Where	What it does
`↵`	Prompt box	Sends the prompt.
`Shift` `↵`	Prompt box	Starts a new line.
`⌘` `V`	Anywhere but another text field	Pastes a copied image as a reference image, or a copied PDF or text file for Perlin to read. Works in the prompt box too.
`↵` or `Esc`	Piece title	Saves or cancels the new name.
`↵` or `Esc`	A parameter's value, after you click it	Sets the number you typed, or cancels.
`Shift` while dragging	A parameter's name	Nudges the value in finer steps.
`↵`	Generate assets	Sends the request; `Shift` `↵` starts a new line.

Code editor

Key	What it does
`⌘` `↵`	Runs the code in the editor. Changed code becomes a new version.
`⌘` `S`	Does the same.

Motion panel

These work while the Motion panel is open.

Key	What it does
`Space`	Plays or pauses the timeline.
`M`	Closes the panel.
`Delete` or `Backspace`	Removes the selected keyframe or sound clip.
`Esc`	Lets go of the selected keyframe, sound clip or layer.
`Shift` while dragging a sound clip or a layer's bar	Places it freely, without snapping to the playhead, keyframes or other edges.
`Shift` while scrubbing the ruler	Moves the playhead smoothly instead of a frame at a time.
`↑` or `↓` in a number field	Steps the value up or down; add `Shift` for ten steps.
`↵` in a field	Sets what you typed. In a text field `Esc` puts back what was there.
`⌘` `↵` in a text box of several lines	Sets what you typed.

Stage layers

With the Motion panel open, click a layer on the stage to select it.

Key	What it does
`←` `→` `↑` `↓`	Nudges the selected layer a pixel.
`Shift` and an arrow	Nudges it ten pixels.
`Delete` or `Backspace`	Removes the selected layer.
`Esc`	Lets go of the layer.
`Shift` while moving a layer	Keeps it to one direction, across or up and down.
`⌘` while moving a layer	Moves it freely, without snapping to the middle of the frame.
`Shift` while sizing a layer	Sizes it in steps of 10%.
`Shift` while turning a layer	Turns it in steps of 15°.

Assets and the asset viewer

Key	Where	What it does
`Shift` and click	Assets drawer	Selects every asset from the last one you picked to this one.
Double click	Assets drawer	Opens the asset in the viewer.
`Esc`	A name you're typing	Cancels the new name or folder without closing the drawer.
`←` `→`	Asset viewer	Shows the previous or next asset on show.
`←` `→`	A sound's position slider, once you've tabbed to it	Moves through the sound a tenth of its length at a time.
`Esc`	Asset viewer	Closes it.

Dialogs

Key	Where	What it does
`Space`	Wallpaper & avatar	Pauses or plays the preview.
`Esc`	Wallpaper & avatar, Embed code, Post a clip, the token shop	Closes the dialog.
`Esc`	Render video	Closes the dialog, unless a render is under way.

Still stuck, or something here out of date? Tell us