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
| Action | Effect |
|---|---|
| Toggle Effect | Turn an effect on or off |
| Apply Effect Settings | Write back all of an effect's values, enabled state included |
| Camera Position | Ease the 3D camera back to a saved pose |
| Reset Camera | Ease the 3D camera back to its default framing |
| Layer Visibility | Show, hide, or toggle a layer |
| Stream Mode | Turn 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
| Marker | Meaning |
|---|---|
| Red triangle | Another shortcut in the list uses the same combination |
| Amber triangle | Another 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
Bind a scene shortcut to each layout to switch during a stream without opening the panel
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:
| Action | What it does |
|---|---|
| Toggle Expression | Applies the chosen expression, or removes it if it is already applied — the same toggle as its button |
| Play Motion | Plays one specific motion, taking over from whatever is playing |
| Clear All Expressions | Removes everything applied at once, including expressions a running motion is suppressing |
| Swap Model | Swaps 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
| Model | Written to |
|---|---|
Has a .vtube.json | That file's own hotkey list, in VTube Studio's format |
Has no .vtube.json | A <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
Bound keys appear as badges on the model's motion and expression buttons, so those sections double as the reference for what is bound to what
Last updated on September 9, 2026