Persona

The Control Panel and the stage run as separate windows. The stage window is transparent and frameless, designed specifically for clean capture in broadcast software like OBS. The Control Panel includes standard window chrome with a translucent surface and is completely excluded from stage capture.

The Control Panel has two columns and no tabs. The left column holds the scene selector and the Layers list, which always ends with a Stage row; Tracking, Automations, and Settings are pinned to the bottom of the column. The right column shows the details of the selected item.

You select these rows the same way you select a layer.

WindowCopy Anchor Link

The first section under Stage manages the dimensions, operating mode, and overlay chrome of the stage window itself. These controls are global application settings rather than scene properties; they remain unchanged when switching scenes.

ModeCopy Anchor Link

The Mode segmented control under Stage → Window switches between Edit, Stream, and Studio. The Stage row's ellipsis menu offers the same choices as radio options, and the row icon shows the active mode:

• Edit: Default mode. The stage renders transformation gizmos, handles, and the top hover bar, suited for layout and calibration.
• Stream: Stream Mode. Hides all on-stage editing handles and wireframes so OBS window capture records only clean character and scene visuals.
• Studio: Studio Mode. Opens camera and recording controls in the Control Panel below Mode for high-resolution photo and video capture; clicking the Stage row's camera icon selects Stage and scrolls Studio's controls into view (turning red while recording). Stream Mode and Studio Mode are mutually exclusive; entering Studio exits Stream Mode.

Window SizeCopy Anchor Link

Directly sets the dimensions of the stage window. The dropdown menu provides common broadcast presets, including two vertical formats optimized for TikTok and YouTube Shorts:

Under Custom Size, you can enter any width and height between 100 and 8192 pixels. Changes apply as soon as focus leaves the field. When the current window dimensions do not match any preset, the dropdown displays Custom. Manually resizing the stage window also switches the dropdown to Custom and updates both dimensions in real time.

Click Save Size beside the fields to keep the current custom size; it then appears in the dropdown's Saved Sizes group below the presets, ready to pick again at any time. Built-in presets need no saving, so the button is unavailable for them. When a saved size is selected, the button becomes Remove Size.

All values are specified in logical device-independent pixels. On Retina displays or monitors with display scaling enabled, OBS captures the physical pixel count multiplied by the active scaling factor.

On first launch, the stage window opens at 1920 × 1080, scaled down evenly to fit within 90% of a smaller screen's work area so it stays 16:9. The stage window can exceed physical screen boundaries, allowing full vertical presets to maintain their target dimensions on laptop displays. While a Studio Mode photo or video capture is running, window sizing controls are temporarily disabled so the frame size stays fixed until the export completes. Content layout and avatar scaling use calibrated reference sizing (stageReferenceSize), maintaining consistent composition and alignment across arbitrary window resizes.

Hide Stage WindowCopy Anchor Link

Windows only. Located under Stage → Window.

Hides the stage from the desktop while OBS Window Capture keeps receiving its frames. Minimizing can't do this: the operating system stops compositing a minimized window, so OBS Window Capture freezes on the last frame it received. Persona therefore disables normal minimizing on macOS and Linux, and on Windows turns every minimize gesture into Hide Stage Window:

• Win + D (Show Desktop), Win + M, and Win + ↓
• The taskbar button
• The hover bar's minimize button
• The switch in the Control Panel

While the stage is hidden, its opacity is 0 and mouse clicks pass through it (WS_EX_TRANSPARENT | WS_EX_LAYERED). The window is also disabled (WS_DISABLED), so Windows doesn't give it focus when another window closes or after Show Desktop. It disappears from the desktop but keeps its taskbar button, its taskbar thumbnail when grouped with the Control Panel, and its Alt + Tab entry, and it keeps presenting frames for OBS Window Capture and Studio captures.

To show the stage again, do any of the following:

• Click its taskbar button or thumbnail
• Pick it in Alt + Tab
• Toggle the switch in the Control Panel
• Choose Stage Window from the tray menu

Closing the stage from any of these entries works as usual. The setting lasts only for the current session and resets on relaunch, so the stage is never hidden unexpectedly at startup.

Stream ModeCopy Anchor Link

Disabled by default. When enabled, the stage window stops rendering selection bounding boxes and the FPS counter, ensuring OBS captures only clean scene content (along with the Inspector, if enabled). The top drag handle continues to appear on hover so streamers can still reposition the stage.

Stream Mode only hides editing chrome rendered onto the stage. Layer selection and interaction remain fully functional: selected layers remain selected and can still be moved, but their visual outlines are hidden. Because the Control Panel is an independent window that is never captured, it does not need to be hidden.

Controls that Stream Mode disables appear dimmed in the Control Panel. They include:

• Handle Mode
• The environment Handles toggle
• The position pointer button on light rows
• Show FPS Counter, which keeps its value

Except for the light pointer button, each of these shows a note asking you to turn off Stream Mode first. Light rows show no note, because their lighting parameters stay editable.

To keep local disk paths and private web addresses out of a broadcast, Stream Mode also masks them:

• Plugin folder paths in Settings are blurred until you hover over them.
• Webpage layer URLs show only the origin plus /***. The copy button in the layer's details still copies the full URL.

InspectorCopy Anchor Link

Disabled by default. When enabled, a read-only floating card with a blurred backdrop appears in the top-left corner of the stage, displaying the LAPLACE Persona name and version number. Because this overlay is drawn directly on the stage canvas, it is included in OBS window captures. Stream Mode does not hide the Inspector, and its toggle remains functional while Stream Mode is active.

The Inspector always tracks the active scene's Primary Model, regardless of the current selection in the Control Panel. The Info section displays the same technical details as the model's own property section (Live2D Model Info and VRM Model Info) in a permanently expanded state. The Inspector is purely for monitoring; it includes no model selector or tracking controls.

Show FPS CounterCopy Anchor Link

Overlays a performance statistics widget in the bottom-left corner of the stage window (avoiding overlap with the top drag bar), displaying rates for two independent runtime loops: UI measures the main thread and interaction loop (gesture processing, tracking inputs, and layer transformations); GPU measures the stage canvas render rate (including avatars, 3D props, and the post-processing effects chain). When a loop is idle and has no work to render, its row displays –.

Both values are measured in real time rather than reflecting fixed caps, making the widget useful for verifying frame limiting and diagnosing performance bottlenecks. Each row shows a 24-second rolling history graph. Click the widget to cycle through metrics:

In Stream Mode, Show FPS Counter is disabled in the Control Panel with a note to turn off Stream Mode first, since Stream Mode hides the overlay on the stage. In Studio Mode, the counter stays visible on the stage and is automatically excluded from exported photos and videos.

BackgroundCopy Anchor Link

The stage background controls what appears behind your avatars and objects, supporting full transparency for OBS alpha overlays, solid colors, custom images and videos, as well as 3D panoramic skyboxes (HDRI); see Stage Background.

Window BehaviorCopy Anchor Link

Persona maintains two distinct windows, each saving its own dimensions and screen position. If the stage was saved on a display that has since been disconnected, it opens at its saved size centered on the primary display instead of off-screen; the saved position is kept, so once that display returns the stage goes back there, unless you've moved it in the meantime.

The stage window is transparent, frameless, and resizable. It has no title bar; instead, hovering over the 28 px strip along its top edge reveals a hover bar:

• Left: the LAPLACE Persona wordmark
• Center: a drag grip (drag it to move the window)
• Right: Maximize/Restore, plus a Minimize button on Windows that triggers Hide Stage Window

As with a system title bar, double-clicking the bar maximizes or restores the stage window. On Windows, a maximized stage can't be resized from its edges or dragged, and the grip icon dims to show it.

The bar is window chrome, not an editing gizmo, so Stream Mode still shows it on hover and streamers can move or maximize the window. Dragging across the top edge with a mouse button held during canvas interaction counts as a scene gesture and doesn't reveal the bar. For exact broadcast framing, use the Window Size presets or enter the dimensions directly.

The Control Panel features standard window chrome and a translucent backdrop that becomes opaque when resized below a two-column width. It opens at 760 × 720 (wide enough for two columns side by side) and supports a minimum size of 360 × 640. Closing the panel hides the window; the application and background rendering continue running normally.

• The vertical divider between columns can be dragged to resize panes: the left column has a minimum width of 260 px, and the right column 360 px. Column widths are preserved across restarts; double-click the divider to reset to the default 288 px width.
• A section bar stays pinned atop each detail page, listing its collapsible sections in order. Click a chip to open that section and scroll to it; the chip for the section you're reading stays highlighted. Pages with fewer than two sections hide the bar.
• In two columns, each layer and page keeps its own scroll position: switching back returns to where you left off, and a page you haven't opened yet starts at the top.
• In a wide window, the right column's settings center at a maximum width of 730 px, so a switch never sits far from its label.
• Keep Panel on Top: Keeps the Control Panel floating above the stage and other application windows, allowing seamless scene staging. This option is disabled by default and can be toggled in Settings (affects the Control Panel, not the stage).
• The system tray or menu bar icon can be hidden in Settings. See Settings and Updates.

The two windows carry different titles: the stage is always "LAPLACE Persona", and the Control Panel is "Control Panel — LAPLACE Persona" (localized with the interface language). Pick "LAPLACE Persona" for an OBS Window Capture source; it never latches onto the Control Panel, and existing sources keep matching the stage.

Positioning Scene ItemsCopy Anchor Link

Each layer's position and scale are independent of the window and other layers. Select a layer in Layers to use these controls:

Items in 3D scenes also support on-stage transform handles for translation, rotation, and scaling. For exact numeric fields and parameter ranges, see Placement.

Click Reset Position in a layer's action menu to restore default framing. In the Camera section, Reset Camera performs the same reset for the 3D orbit camera.

All layout and positioning adjustments save automatically and restore upon next launch as part of the scene state.

Control SurfacesCopy Anchor Link

LAPLACE Persona provides multiple pathways to access core controls:

The Control Panel header includes version information, update controls, and the application menu. The panel menu houses application-level actions: Onboarding… reopens the First Run guide; external links open online documentation and the Web Console in your default browser, or connect to the official Discord community.

Closing the Control Panel hides the window without quitting the application; the stage window keeps rendering. To bring the Control Panel back:

• Choose the first item in the system tray menu (on Windows, you can also left-click the tray icon)
• On macOS, use the application menu or press ⌘,
• On Windows and Linux, click the stage window and press Ctrl+,

The second tray item, Stage Window, restores the stage window: it re-creates a closed stage, un-hides a hidden stage, and brings it to the foreground. So hiding the tray icon never locks you out. Launching the application again while it is already running also brings the open stage and Control Panel forward instead of creating a second instance.

To hide editing controls in OBS captures, turn on Stream Mode: selection handles and the FPS counter stop drawing on the stage. The Control Panel does not need to be hidden, as it is never captured.

When face or body Tracking is actively running, quitting the application displays a confirmation prompt specifying the active sources that will stop. This safeguard protects every exit route (panel menu, tray menu, ⌘Q, close button, and Alt+F4), preventing accidental session termination during live broadcasts. When tracking is inactive, quitting is immediate.

The stage window never displays banner toasts. Key system events (such as Plugin API client connections and file drop results) arrive as silent system notifications, falling back to Control Panel toasts only if the operating system denies notification permissions. This prevents sensitive information, such as local network plugin addresses, from appearing in live broadcast captures.