Skip to content

Preferences

Open with the button in the top bar. Two tabs — General and Keyboard Shortcuts — and three buttons at the bottom.

General preferences

Button Effect
Restore Defaults Resets every preference and every keyboard binding. Takes effect in the dialog immediately, but still needs OK to be written.
Cancel Nothing is saved.
OK Saves and applies.

Each section header is collapsible — click the / .

Session Defaults

Setting Values Default What it does
Auto-capture Off, On Off The state the auto-capture dot starts in each session. See Keying & Auto-Capture.

General

Setting Default What it does
Auto-scan targets on load On Scans the rig's targets when a rig loads.
Auto-restore session on startup Off When on, a found autosave is restored silently instead of offering the blue Restore / Dismiss bar.
Auto-prune empty layers on compose On Layers with no content of their own — no drivers, constraints, hide-nodes or widget references, and not the ancestor of a surviving layer — are dropped from the composed MC, so they do not show up as dead checkboxes in the Camera View. The layer configs stay in your rig data; only the compose output is affected. Turn it off to keep placeholder layers visible.
History depth 50 (10–250) How many actions the History panel keeps for undo, redo and jump-to-entry. Each entry is a full rig snapshot, so a deeper history costs memory — and a hard RAM ceiling drops the oldest entries regardless of this number. Applied live.
Enable Octo Skip Nodes integration On With Octo Skip Nodes installed, target lists gain a Skip column and flagged nodes are tagged with OSN's skip symbol at Compose, so B-navigation skips them. Off means ORC ignores OSN entirely, even if it is installed. It also decides which Harmony binding B / Shift+B follow.
Empty drawing names ZZ, 00 Comma-separated drawing names that count as "hidden". When the MC head writes one of these to a column, pose layers will not override it. Empty exposures are always treated as hidden regardless. Re-compose after changing this.

Side Naming

Setting Values Default
Side 1 label -L, -R, -1, -2, -Left, -Right -L
Side 2 label the same six -R
Separator -, _, . -
Numbering order L first (1→L, 2→R, 3→L …), R first (1→R, 2→L, 3→R …) L first

Setting Side 1 automatically sets Side 2 to its reciprocal, and vice versa (-L-R, -1-2, -Left-Right).

Not yet wired up in v1.0.0

These four settings are saved, but nothing in the rest of ORC reads them yet — side labels are currently fixed at L / R, separator -, L first. Changing them here has no effect on your rig. They are listed for completeness; treat the panel as inert until a release note says otherwise.

Widget Editor

These are the boot defaults for the Widget Editor. Its own toolbar still overrides them for the session, and changes here are pushed live to an editor that is already open.

Setting Default What it does
Default background grey The canvas background the editor opens with — dark, grey, white, checker, or a custom colour.
Show grid Off Draw the field chart that "Snap to grid" aligns to.
Snap to widgets On Photoshop-style alignment snapping between widgets.
Snap to grid Off
Snap to guides On
Backdrop opacity % 55 (0–100) Opacity of the character snapshot drawn behind the widgets.
Undo steps 60 (10–250) How many steps the standalone Widget Editor keeps. The editor embedded in ORC uses ORC's own History depth instead.
Load selected MC on open On Standalone only: load the MC selected in the Node View on open. Off opens empty and waits for Set.
Reopen at last window size On Standalone only: restore the last session's size and position.

License

Read-only status plus two buttons.

Row Shows
Status ✅ Activated (key: XXXX-…), ⏳ Trial: N day(s) remaining, or ❌ Expired
Machine ID Your 16-character machine fingerprint. Selectable — copy it when contacting support.

Change Key / Add Key opens the activation dialog. Deactivate frees the activation slot on this machine, after a confirmation. See Licensing & Activation.

Keyboard Shortcuts

See Keyboard Shortcuts for the full keymap and the rebinding procedure.

Where preferences are stored

%APPDATA%\Toon Boom Animation\Toon Boom Harmony Premium\octo_rig_composer\preferences.json

Plain UTF-8 JSON. A corrupt or unreadable file is ignored and defaults are used, so deleting this file is a safe way to reset everything.

Only keyboard bindings you actually changed are written; if you never change one, the key is absent entirely.

Two settings exist in that file but have no checkbox:

Key Default Notes
onboarding_dismissed false Flipped to true the first time you set either MC slot; suppresses the welcome hint permanently.
trace_heap false Traces Python memory for one compose. Deliberately has no UI — set the environment variable ORC_TRACE_HEAP=1 or edit the JSON if support asks you to.

Three different folders

Preferences, presets/logs and the license each live in their own root:

What Where
Preferences %APPDATA%\Toon Boom Animation\Toon Boom Harmony Premium\octo_rig_composer\
Presets and orc.log %APPDATA%\OctoRigComposer\
License %APPDATA%\Octo\OctoRigComposer\

The license sits outside the Harmony tree on purpose — one activation covers every host the product ships in.