Persona

Use the Web Console to control the running desktop app from a browser. Its appearance and connection preferences belong to that browser.

ConnectCopy Anchor Link

1. In the desktop app, open Settings → Plugin API, enable the API, and create a key.
2. Open persona-console.laplace.live.
3. Enter the desktop host, API port, and key, then connect. On the same computer, use 127.0.0.1; the default port is 25034.

For another computer on the network, enable Allow Access on Local Network in the desktop app. An HTTPS console cannot connect to a remote unencrypted ws:// endpoint: serve the console over HTTP, or use a TLS proxy and enable Use TLS (wss://). The built-in Persona API does not terminate TLS. See Plugin API for server settings and key management.

Browser PreferencesCopy Anchor Link

Under Settings → Web Console, Language and Theme affect this browser only. They do not change the desktop app’s appearance. Connect Automatically reuses a complete saved connection when the console opens.

On the connection screen, Save API Key controls whether the key is stored in browser local storage. With it off, the current connection keeps the key in memory; enter it again after reloading. An explicit disconnect does not immediately reconnect, and a revoked key must be replaced.

The General and Performance sections change settings in the connected desktop app. The console’s section expansion states and panel width remain browser-local.

What You Can ControlCopy Anchor Link

The console mirrors scenes, layers, model controls, tracking, effects, and saved automations. Select a layer to edit its supported properties. Avatar shortcuts are grouped by model, with each group independently collapsible. A section bar atop each detail page jumps to any section on the page.

• Outliner: Matching the desktop app, Stage is a fixed row at the bottom of Layers; click it to open scene properties and clear the layer selection. Under object-pin-depth, a pinned 2D image, video, or webpage supports Depth adjustments in the host model's stack (older hosts omit the depth slider and row pin marker; Webpage sections no longer include a front/behind layer control).
• Scene Presets: On hosts with the scene-presets capability, the top of the Outliner lists the active scene's scene presets, supporting apply, create, update to current layout, transition, rename, and delete, matching the desktop app.
• Text Layers: Require the host to report the object-text capability (or the legacy text-objects).
  • The Inventory's Text tab and the system font picker appear only on hosts that support text layers. The picker calls fonts.list to list fonts on the desktop host, never browser fonts.
  • Keystrokes and slider changes in the Text section commit through object.setContent. The desktop treats them as in-place edits, with one undo step per typing pause.
• Video Layers: Require the host to report the object-video-sound capability (or the legacy video-sound).
  • Selecting a video layer shows Loop, Mute, and Volume controls, which write in place through object.setContent. Older hosts would swap the scene on every edit and flush the undo history, so the console hides this section for them.
  • There are no play, pause, or scrubbing controls, because the console has no direct link to the live media element on the desktop stage. The saved paused state is left untouched.
• Chroma Key: Requires the host to advertise the object-chroma-key capability. Selecting an image, video, or webpage layer displays the Chroma Key section (toggle, key color, similarity, smoothness, and spill reduction). Older hosts omit this section to prevent edits from being discarded.
• Whole-Model Movement: On hosts reporting model-movement, selecting a Live2D model reveals horizontal, vertical, and depth movement sliders (range −50 to 50). Hosts with model-movement-pivot additionally expose Depth Pivot settings with "Pick on Stage" support, scaling the model around a selected anchor as you lean in or out.
• Privacy: When Stream Mode is active on the desktop app, webpage URLs are automatically masked to origin plus /*** (the full URL can still be copied via the copy button, and the input field allows direct paste replacement).
• Local Assets: Model and asset files belong to the desktop computer. The Inventory lists registered assets; registering a path requires an allowed plugin folder. It is not a browser file-upload workflow.

Automation authoring, shortcut recording, API key management, native file dialogs, stage gizmos, and application updates stay in the desktop app.