00:00 / 00:00

Persona

Shortcuts

Shortcuts is the row below Tracking in the Control Panel's left column, and one list holds all three kinds: app shortcuts come first, then the avatar shortcuts the current primary model carries, with the scene row at the bottom

App Shortcuts

One combination fires an ordered list of actions against the current scene. A single key can turn on an effect, pull the camera back to a saved position, and hide a layer, all at once

ActionEffect
Toggle EffectTurn an effect on or off
Apply Effect SettingsWrite back all of an effect's values, enabled state included
Camera PositionEase the 3D camera back to a saved pose
Reset CameraEase the 3D camera back to its default framing
Layer VisibilityShow, hide, or toggle a layer
Stream ModeTurn Stream Mode on, off, or toggle it

Pick an action kind in the dropdown at the bottom of the list, then choose what it acts on in the picker beside it, and a new shortcut appears. Camera Position, Reset Camera and Stream Mode offer only an Add button, because they need no target selection. The same dropdown carries the avatar shortcut actions below a separator, in a group named for the current avatar

Apply Effect Settings and Camera Position snapshot at the moment you add them. Tuning that effect or moving the camera afterwards does not change the stored copy — to update it, remove the action and add it again. Reset Camera does not store a snapshot: it eases to the framing the scene starts from, wherever the camera has since been left

Stream Mode is the one action that writes an application setting rather than scene state, so it survives a scene switch the way the switch under Stage does

Clicking a row expands it: rename it under Name, remove actions one at a time, or add more. A Layer Visibility row also carries a Toggle / Show / Hide picker, and a Stream Mode row a Toggle / On / Off one. With the name left blank, the title is derived by joining the action names with +. Removing the last action deletes the shortcut with it — an empty one can do nothing

Binding and Triggering

Set Shortcut… opens the recorder, and the rules match avatar shortcuts: a combination holding Ctrl, Alt or Cmd keeps working while another application is in front, anything else only fires while Persona is focused

A combination is not required. A shortcut with nothing bound can still be fired from outside — the web console's Shortcuts page, the Stream Deck Run Shortcut key, or a plugin calling shortcut.trigger. That is how you get a whole row of buttons without spending a whole row of key combinations

Every row's options menu also carries Trigger, to test the shortcut immediately. On an avatar shortcut row it is unavailable for anything Persona would refuse to run anyway: an unsupported VTube Studio action, one the model has switched off, or any row at all while Enable Avatar Shortcuts is off

MarkerMeaning
Red triangleAnother shortcut in the list uses the same combination
Amber triangleAnother application already holds it

When it fires, targets the current scene no longer holds are skipped silently — deleting a layer does not break a shortcut that referenced it, that one action simply does nothing

Scene Shortcuts

The Scenes row at the bottom of the list handles the combination that switches to a scene: pick a scene, then set its combination. Each scene in the dropdown shows the key it is currently bound to

Avatar Shortcuts

The shortcuts the current primary model carries follow the app shortcuts in the same list. They are marked with the model format's glyph, whose tooltip reads Saved with «model», and an Enable Avatar Shortcuts switch at the bottom of the list turns the whole set on and off — it appears only when that avatar actually carries shortcuts

Shortcuts belong to the model rather than to the application. Each model carries its own set, and swapping the primary model swaps which set is live — so a rig's bindings travel with it between machines, and between Persona and VTube Studio

Only the primary model's set is listed. A model that is not primary contributes no rows, and its bindings do not fire

Adding a Shortcut

These share the dropdown at the bottom of the list: the group named for the current avatar, below the separator, holds their actions — each carries an icon that also marks its rows in the list — and the picker beside it chooses what the action acts on:

ActionWhat it does
Toggle ExpressionApplies the chosen expression, or removes it if it is already applied — the same toggle as its button
Play MotionPlays one specific motion, taking over from whatever is playing
Clear All ExpressionsRemoves everything applied at once, including expressions a running motion is suppressing
Swap ModelSwaps this layer to another model — any format, so a binding can jump from a Live2D rig to a VRM. The picker omits the model already loaded

These act on the current primary model whatever its format — a VRM's expressions and animations bind just as well. A picker is unavailable when the model has no motions or expressions to bind; Swap Model lists every registered model but the one already loaded, and is unavailable when there is none

The new row starts unbound. Click Set Shortcut… to open the recorder, press the combination you want, and confirm with Save or Enter. Clear unbinds it again

Every registered shortcut is released while the recorder is open, so a combination that is already bound reaches the dialog instead of firing its own shortcut

The recorder also accepts a controller — up to three controls from one device, stick and D-pad directions and triggers included. See Controller Shortcuts

A combination is at most two modifiers plus one key. That is not an interface limit but a storage one — VTube Studio's format keeps exactly three trigger slots per hotkey, and Persona refuses anything it could not write back. Modifier keys are named per platform, so a macOS binding reads and rather than Alt and Win

Background and Focused Shortcuts

Each row's options menu holds Run in Background, which decides whether the shortcut works while another application is in front. A globe icon marks rows that run in the background

It requires Ctrl, Alt or Cmd. A bare key, or Shift with a key, is how text is typed — claiming it system-wide could prevent other applications from receiving it — so those bindings stay focused-only and the option is disabled. Controller combinations are the exception: they never register with the operating system's global shortcuts, so Run in Background is always available for them and needs no modifier

A combination another application already owns cannot be claimed either. The shortcut is not lost: it falls back to working while Persona is focused, and the globe turns red to explain why

When Two Shortcuts Share a Combination

Both fire, and a warning triangle marks the rows. This matches VTube Studio, where one combination can drive several hotkeys at once — useful for applying two expressions together, and worth noticing when it was not what you meant

Each shortcut has its own short re-fire guard, so holding a key down triggers it once rather than repeating for as long as it is held

Where They Are Stored

ModelWritten to
Has a .vtube.jsonThat file's own hotkey list, in VTube Studio's format
Has no .vtube.jsonA <model>.persona.json sidecar beside the model's entry file

Persona edits these files in place and preserves unrecognized fields. A hotkey using a VTube Studio action Persona has no equivalent for is listed greyed out and marked unsupported, never runs, and survives untouched when the file is written back — so editing shortcuts in Persona preserves the rest of your VTube Studio configuration

A read-only configuration file is never written to, and changes are simply not saved

Last updated on September 9, 2026

Tech otakus destroy the world