Parameter Reference

Complete reference for every custom parameter on the Embody COMP, grouped by parameter page. For a guided tour of the settings that matter most, see Configuration.

Auto-generated from Embody.tdn

This page is generated from the externalized Embody COMP (dev/embody/Embody.tdn), the source of truth for its parameters, so it stays in sync with the actual component. 137 parameters across 9 pages.

Embody

Parameter	Type	Default	Description
Setup Wizard (Setupwizard)	Pulse	-	Open the Embody setup wizard to review or change your mode, AI assistant, and where config files are written.
Mode (Embodymode)	Menu	auto	How Embody handles invasive, project-level changes (git config, .venv, MCP/AI config files, network ops). 'Auto' manages everything silently -- recommended for most users. 'Advanced' asks before each such change and keeps the footprint minimal -- for users who want full control. Options: Auto - manage everything, Advanced - ask first.
Ext. Folder (Rel. to Project) (Folder)	Folder	-	Root folder where externalized files are saved. All .tox, .py, .json, and other externalized files are written relative to this folder.
Externalize Full Project (Externalizeproject)	Pulse	-	Tags all eligible operators in the entire project for externalization. COMPs get .tox tags, DATs get file-type tags based on their content.
Disable	Pulse	-	Disables Embody: removes all externalization tags from operators and stops tracking. Use Update to re-enable.
Enable / Update (Update)	Pulse	-	Initializes Embody if not yet running, or triggers a full update cycle: scans all tagged operators, checks continuity, and syncs the externalizations table.
Release All (Releaseall)	Pulse	-	Export every releasable component as its own portable .tox into the release folder, in one pass. A component is releasable when it is BOTH externalized by Embody (tracked -- it is yours) AND carries a release hook (a pre_release or post_release Text DAT as a direct child). Third-party components that ship with their authors' hook DATs are never batch-released -- export those explicitly if needed. Failures are logged and skipped without halting the batch.
Refresh	Pulse	-	Refreshes the externalizations table by re-scanning tagged operators without triggering saves or continuity checks.
Perform Mode (Performmode)	Toggle	-	-
Embody Status (Status)	Str (read-only)	Disabled	Current Embody status (read-only). Shows whether Embody is initialized and running.

Tags

Parameter	Type	Default	Description
tox Tags (Toxtags)	Header	-	Tag strings and operator colors for TOX externalization. COMPs tagged with the Tox tag are externalized as .tox files.
tox Tag Color (Toxtagcolor)	RGBA	-	Color applied to tox-tagged COMP operators in the network editor. Makes externalized COMPs visually identifiable.
.tox Tag (Toxtag)	Str	tox	Tag string applied to COMP operators for .tox externalization. Operators with this tag are externalized as .tox files.
DAT Tags (Dattags)	Header	-	Tag strings and operator colors for DAT externalization. DATs are tagged with format-specific tags (py, json, xml, etc.) and externalized to matching file types.
DAT Tag Color (Dattagcolor)	RGBA	-	Color applied to DAT-tagged operators in the network editor. Makes externalized DATs visually identifiable.
Clone Tag Color (Clonetagcolor)	RGBA	-	Color applied to clone-tagged operators in the network editor. Distinguishes cloned externalized operators from originals.
.py Tag (Pytag)	Str	py	Tag string for .py (Python) externalization. Applied to text DATs containing Python code.
.json Tag (Jsontag)	Str	json	Tag string for .json externalization. Applied to text DATs containing JSON data.
.xml Tag (Xmltag)	Str	xml	Tag string for .xml externalization. Applied to text DATs containing XML data.
.html Tag (Htmltag)	Str	html	Tag string for .html externalization. Applied to text DATs containing HTML content.
.glsl Tag (Glsltag)	Str	glsl	Tag string for .glsl externalization. Applied to text DATs containing GLSL shader code.
.frag Tag (Fragtag)	Str	frag	Tag string for .frag externalization. Applied to text DATs containing fragment shader code.
.vert Tag (Verttag)	Str	vert	Tag string for .vert externalization. Applied to text DATs containing vertex shader code.
.txt Tag (Txttag)	Str	txt	Tag string for .txt externalization. Applied to text DATs containing plain text.
.md Tag (Mdtag)	Str	md	Tag string for .md externalization. Applied to text DATs containing Markdown content.
.rtf Tag (Rtftag)	Str	rtf	Tag string for .rtf externalization. Applied to text DATs containing rich text format content.
.csv Tag (Csvtag)	Str	csv	Tag string for .csv externalization. Applied to table DATs with comma-separated values.
.tsv Tag (Tsvtag)	Str	tsv	Tag string for .tsv externalization. Applied to table DATs with tab-separated values.
.dat Tag (Dattag)	Str	dat	Tag string for .dat externalization. Generic DAT externalization format.
TDN Tags (Tdntags)	Header	-	Tag strings and operator colors for TDN externalization. COMPs tagged with the TDN tag have their children exported as human-readable .tdn JSON network files.
TDN Tag Color (Tdntagcolor)	RGBA	0.3	Color applied to TDN-tagged COMP operators in the network editor. Makes TDN-strategy COMPs visually identifiable.
.tdn Tag (Tdntag)	Str	tdn	Tag string for .tdn externalization. Applied to COMPs whose children are exported as human-readable JSON network files.
.tdn Exclude Tag (Tdnexcludetag)	Str	tdn_exclude	Tag name (default 'tdn_exclude') that opts a COMP out of the entire TDN system. Primary use: opt a single child out of cascade autotag (when Tdncascade is on, the tdn tag normally propagates from a tdn-tagged parent to all its children -- apply this tag to a child to keep it excluded). Also useful for app-managed COMPs (e.g. spawned via .copy() at runtime) that the application is responsible for. Excluded COMPs are invisible to TDN: never exported, never inlined in parent .tdn files, never stripped on save, never destroyed by reconstruction.

TDN

Parameter	Type	Default	Description
TDN Mode (Tdnmode)	Menu	export	Three-mode master for the TDN subsystem. Off = no TDN runtime (.tdn files on disk are preserved, Embody simply stops touching them). Export-on-Save (recommended) = write .tdn on save, .toe stays the source of truth, MCP reads live state via read_tdn. Roundtrip (Experimental) = bidirectional strip/restore of COMPs at save and open; may hit edge cases with extension reload timing on deeply-nested TDN COMPs. Options: Off, Export-on-Save, Roundtrip (Experimental).
Clipboard Auto-Paste (Clipboardautopaste)	Toggle	On	When on, Embody watches the OS clipboard and prompts to paste an Embody network the moment one is copied (e.g. the web "embody it" button) -- no keyboard shortcut needed. Turn off to disable the automatic prompt.
Cascade to Children (Tdncascade)	Toggle	-	When tagging a COMP for TDN, automatically tag all child COMPs so each gets its own .tdn file.
Large TDN Warning (Tdncascadewarn)	Menu	ask	Controls whether a warning dialog is shown when a TDN file exceeds 5 MB. Set automatically when dismissed. Options: Ask, Quiet.
Locked Content Warning (Tdnlockedwarn)	Menu	ask	Controls whether a dialog is shown when a TDN export contains locked TOPs, CHOPs, or SOPs whose frozen data will not survive the round-trip. Batch sweeps show one combined dialog. Set automatically when dismissed with Don't show again. Options: Ask, Quiet.
Embed DATs (default) (Embeddatsintdns)	Toggle	-	When enabled, DAT content (text and table data) is included in TDN exports by default. Can be overridden per-export. Disabling reduces file size but loses DAT content.
Embed Storage (default) (Embedstorageintdns)	Toggle	On	Include Python storage entries in TDN exports. Disable for COMPs with large storage to reduce file size. Can be overridden per-COMP from the tagging menu.
Auto-Save Checkpoints (Autosave)	Toggle	On	When on, after the agent (or you) goes idle Embody writes changed TDN COMPs to disk as a cheap ~6ms .tdn checkpoint -- NO full project save, no strip/restore, no freeze -- so a crash loses little unsaved work. Checkpointed COMPs are rebuilt on next open. Skips during Perform Mode and project saves.
TDN Create on Start (Tdncreateonstart)	Toggle	On	When enabled, reconstructs TDN-strategy COMP children from .tdn files on disk when the project opens. Required for TDN round-trip workflow where children are stripped on save.
Auto-Save Status (Autosavestatus)	Str (read-only)	Idle	Read-only auto-save state: Idle / Saving / Bypassed (Perform Mode) / Disabled.
Strip on Save (Tdnstriponsave)	Toggle	On	When enabled, strips children from TDN-strategy COMPs during project save. Children are recreated on next open via TDN Create on Start. Keeps .toe files minimal.
Palette Handling (Tdnpalettehandling)	Menu	ask	How to handle TD palette COMPs (e.g. abletonLink, Widget components) during TDN export. Ask: prompt on first encounter per COMP. Black Box: reference the palette and skip internal children -- the correct choice for stock palette components. Full Export: export all internals -- use when the palette COMP has been heavily customized internally. Options: Ask, Black Box, Full Export.
TDN File (Tdnfile)	File	-	Path to a .tdn file to import. Select a file, set the Network Path target, then pulse Import TDN.
Network Path (Networkpath)	COMP	-	Target COMP where the TDN file will be imported. Operators from the .tdn are created as children of this COMP.
Import TDN (Importtdn)	Pulse	-	Imports the specified TDN File into the Network Path target. Creates all operators, sets parameters, connections, and positions.

Envoy

Parameter	Type	Default	Description
AI Client (Aiclient)	Menu	0	Selects the AI client used with Envoy. Determines which MCP configuration file format is generated (e.g. .mcp.json for Claude Code, opencode.json for OpenCode). Options: Claude Code, OpenCode, Codex, Gemini, VS Code, Cursor, Windsurf, GitHub Copilot, None.
Launch AI Client (Launchaiclient)	Pulse	-	Open the AI client selected above at the project root: editors (VS Code, Cursor, Windsurf, Copilot) open the folder as a workspace; CLI tools (Claude Code, Codex, Gemini) open in a new terminal at the root.
AI Project Root (Aiprojectroot)	Menu	gitroot	Where Embody writes AI config (AGENTS.md, CLAUDE.md, .claude/, .cursor/, .mcp.json, .embody/). "Git root" (default) writes at the top of the git repo. "Project folder" writes alongside the .toe -- use this when your TD project lives in a subdirectory of a larger repo and you open that subdirectory as your AI tool workspace. Options: Git repository root, Project folder (.toe directory), Custom.
AI Project Root (Custom) (Aiprojectrootcustom)	Folder	-	Custom directory for AI/MCP config when "AI Project Root" is set to "Custom". Relative paths are resolved against the .toe directory (e.g. "../" places config one level above the .toe -- useful when multiple TouchDesigner projects share a parent folder in a monorepo). Absolute paths are used as-is. Changing this path migrates Embody state and AI config to the new location.
Envoy Enable (Envoyenable)	Toggle	On	Enables/disables the Envoy MCP server. When enabled, starts an HTTP server that exposes TouchDesigner operations to Claude Code and other MCP clients.
Envoy Port (Envoyport)	Int	9870	Port number for the Envoy MCP server (default: 9870). Changing while running automatically restarts the server on the new port.
Embot (Embotenable)	Toggle	On	Show the Embot builder mascot. He appears on each operator Envoy creates or edits and narrates what it does. He settles where the work is rather than chasing it -- when the agent is hopping between networks he stays put and keeps narrating from where he stands, and he moves once the work has actually settled somewhere new. With Envoy Follow off he only ever appears in the network you are already viewing (building him into one you cannot see costs real time for nothing). Off hides him entirely (no character, no camera movement).
Envoy Follow (Envoyfollow)	Toggle	On	Camera follows the operator Envoy is working on, panning the network editor to it. Works with or without the Embot character shown. With Embot on, the camera settles with him rather than cutting to every network the work merely passes through; with Embot off it follows every hop as before.
Auto-Externalize New Ops (Autoexternalize)	Menu	neither	Auto-tag operators that Envoy creates via create_op for externalization to version-control-friendly files. Neither = off. DATs = externalize created DATs (source files). COMPs = externalize created COMPs (TDN). DATs and COMPs = both. Only ops at an externalization boundary are tagged -- never ops already inside an externalized COMP, palette clones, or Embody itself. Additive only: it never deletes files or removes tags. Options: Neither, DATs, COMPs, DATs and COMPs.
Tool Permissions (Toolpermissions)	Menu	all	Whether Embody pre-approves Envoy MCP tool calls in .claude/settings.local.json so Claude Code isn't prompted on every tool use. all = pre-approve all Envoy tools (no prompts). some = pre-approve read-only/query tools only; tools that create/edit/delete/execute still prompt. prompt = pre-approve nothing; every tool prompts. leave = never create or modify settings.local.json. Except for 'leave', Embody also whitelists the OS temp directory so captured TOP images can be read without a prompt. The setup wizard sets this; you can change it here anytime. When AI Client is OpenCode, the same posture seeds the 'permission' block of a freshly created opencode.json (existing files are merged, never overwritten). Options: Don't prompt for any tool, Prompt for some tools (read-only auto-approved), Prompt for all tools, Leave settings file alone.
Envoy Status (Envoystatus)	Str (read-only)	Disabled	Current status of the Envoy MCP server (read-only). Shows Running, Stopped, or error information.

Convoy

Parameter	Type	Default	Description
Enable Convoy (Convoyenable)	Toggle	-	Joins this Embody node to other Convoy-enabled nodes on the same trusted LAN and lets those nodes discover, inspect, and control it -- queries, test runs, project saves, and more -- through Envoy. Enabling this installs and starts Convoy's small background app, opens an authenticated LAN listener, and begins automatic discovery and reconnect. Disable this on guest, public, or otherwise untrusted networks. Arbitrary TD Python and full shell stay OFF until you enable them locally on this machine. Convoy does not configure or launch an AI client. The first enable creates this project's convoy identity and asks for confirmation.
Node Name (Convoynodename)	Str	-	Display name for this node in Convoy. Defaults to ' / '. Editing it sets a persistent override; routing always uses the stable node identity, never this name.
Status (Convoystatus)	Str (read-only)	Disabled	Convoy's current state -- whether this node is connected, and anything blocking it (no host app, install failed, consent required).
Remote Wake (Convoyremotewake)	Toggle	On	Allows a real remote TouchDesigner operation to temporarily wake Convoy's command service while this node is in Perform Mode. Discovery, status, ping, and controller queries never wake it. After remote work finishes, the node returns to its previous Perform state following the idle grace period.
Remote Wake Idle Grace (Convoywakegrace)	Float	60	Seconds after the final remote wake finishes before Convoy restores this node's previous Perform Mode state.
Allow Execute TD Python (Convoyallowtdpython)	Toggle	-	Allows Convoy controllers to execute arbitrary Python inside this TouchDesigner process. Python can access the filesystem, network, credentials available to TouchDesigner, and operating-system process APIs, so enabling this is effectively host-user code execution even when Allow Full Shell is off. Keep it off unless explicitly needed. This setting can only be enabled locally.
Allow Full Shell (Convoyallowfullshell)	Toggle	-	Allows Convoy controllers to use Convoy's purpose-built interface for arbitrary operating-system commands as the current user. This can change or delete files, install software, or expose secrets. Structured Git and GitHub CLI tools do not require this option. Turning it off does not sandbox arbitrary TouchDesigner Python if Allow Execute TD Python is on. This setting applies to every Convoy node on this computer and can only be enabled locally.
Artifact Quota (MB) (Convoyartifactquota)	Int	1024	Maximum disk space (MB) this computer may use for temporary Convoy artifacts: screenshots, transferred files, large tool results, command output, and local client-readable copies. When the limit is reached, Convoy removes the least-recently-used unpinned artifacts first. Active transfers, artifacts required by running or unacknowledged jobs, and files you explicitly saved are not removed. This setting applies to all Convoy-enabled Embody nodes on this computer.
Convoy Nodes (Convoynodes)	Sequence (read-only)	-	-
Node Name (Nodename)	Str (read-only)	-	Display name of the node.
IP Address (Ipaddress)	Str (read-only)	-	Current LAN endpoint.
Status (Nodestatus)	Str (read-only)	-	Node and connection status; notes an Embody version mismatch only when relevant.
Last Seen (Lastseen)	Str (read-only)	-	How recently the node was seen.
Forget Offline Nodes... (Convoyforgetoffline)	Pulse	-	Remove this machine's offline Convoy node rows. Names the rows it would forget (the first eight, then a count) in a confirmation before anything is removed. A forgotten node rejoins as a NEW identity the next time its project opens, and its TD Python approval resets. A node with a delivery that has not finished is kept and named afterwards -- a finished result never holds a row, because results are fetched by delivery id and outlive it. A node that comes back online before you confirm is skipped. Each computer can only forget its own rows.
Resolve Realm Conflict... (Convoyresolverealm)	Pulse	-	Recover from a split-realm conflict (status "Refused: local_realm_conflict"). Lists the conflicting Convoy realms and their live senders (hostname where reverse DNS answers), then offers both directions: Keep This Realm denylists those senders, resets this machine's realm to the preserved one, and re-registers this node -- Join Other Realm abandons this machine's realm, adopts the other one, and rebinds this project to it (other projects on this machine offer their rejoin on their next Convoy enable). Also usable without a conflict, to denylist -- or join -- foreign realms being advertised on the LAN.
Repair Convoy App (Convoyinstallhost)	Pulse	-	Reinstall or upgrade the background app for YOUR user account. Enabling Convoy installs it automatically; use this to repair a broken install or apply an update.
Start Convoy App (Convoystarthost)	Pulse	-	Start the installed host app now, without waiting for the next login.
Stop Convoy App (Convoystophost)	Pulse	-	Stop the host app and keep it stopped. This disables the supervisor first -- otherwise it would restart within a minute and the button would look broken. Jobs already queued stay queued. Use Start Convoy App to resume.
Uninstall Convoy App (Convoyuninstallhost)	Pulse	-	Remove the host app and its login registration. Shows you exactly what will be removed and what will be KEPT before doing anything -- this machine's host identity and its job history are kept, so re-installing later rejoins the same convoy rather than becoming a new host.

UI

Parameter	Type	Default	Description
Open Manager (Openmanager)	Pulse	-	Opens the Embody Manager window, which provides a list view of all externalized operators with status, actions, and strategy management.
Close Manager (Closemanager)	Pulse	-	Closes the Embody Manager window.
Text Color (Textcolor)	RGBA	-	Text color used throughout the Embody UI (toolbar, manager, dialogs).
Background Color (Backgroundcolor)	RGBA	-	Background color for the Embody UI panels and windows.
Button Background Color (Buttonbackgroundcolor)	RGBA	-	Background color for buttons in the Embody UI.
List Header Color (Listheadercolor)	RGBA	-	Header row color in the Manager list view.
List Row Color (Listrowcolor)	RGBA	-	Default row color in the Manager list view.
List Row Select Color (Listrowselectcolor)	RGBA	-	Selected row highlight color in the Manager list view.
Saved Color (Savedcolor)	RGBA	-	Color indicator for operators that are saved and up-to-date (not dirty).
Dirty Color (Dirtycolor)	RGBA	-	Color indicator for operators that have unsaved changes (dirty state).
Dirty Par Color (Dirtyparcolor)	RGBA	-	Color indicator for parameters that have been modified since last save.
Uncommitted Color (Uncommittedcolor)	RGBA	0.6	Color indicator for externalized files that are saved to disk but not yet committed to git (uncommitted). Distinct from the red unsaved color and the amber par-change color.
Tagging Menu Color (Taggingmenucolor)	RGBA	-	Background color for the tagging menu popup.
Highlight Color (Highlightcolor)	RGBA	-	Accent/highlight color used for interactive elements in the Embody UI.
TDN Saved Color (Tdnsavedcolor)	RGBA	-	Color indicator for TDN-strategy operators that are saved and up-to-date.

Shortcuts

Parameter	Type	Default	Description
Enable Keyboard Shortcuts (Enablekeyboardshortcuts)	Toggle	On	Master switch for Embody's keyboard shortcuts. When off, the Keyboard In DAT is disabled and no Embody shortcut (including the tagger double-tap) fires.
Open Manager (Shortcutmanager)	Str	ctrl+shift+o	Keyboard shortcut for Open Manager. Lowercase combo like 'cmd+shift+o' or 'ctrl+shift+o': modifiers joined with '+' plus one trigger key. ctrl and cmd are distinct keys on macOS (matched exactly); on Windows/Linux, which has no Cmd key, a cmd binding fires via Ctrl. Each combo may be assigned to only one action. Leave empty to disable. Edit by hand or pulse Record below.
Record (Recordmanager)	Pulse	-	Arm the shortcut recorder for Open Manager: press the desired key combo -- the first non-modifier key commits it with whatever modifiers are held. If the combo already drives another action, a dialog explains and recording continues. Esc cancels; times out after 10 seconds.
Update All Externalizations (Shortcutupdateall)	Str	ctrl+shift+u	Keyboard shortcut for Update All Externalizations. Lowercase combo like 'cmd+shift+o' or 'ctrl+shift+o': modifiers joined with '+' plus one trigger key. ctrl and cmd are distinct keys on macOS (matched exactly); on Windows/Linux, which has no Cmd key, a cmd binding fires via Ctrl. Each combo may be assigned to only one action. Leave empty to disable. Edit by hand or pulse Record below.
Record (Recordupdateall)	Pulse	-	Arm the shortcut recorder for Update All Externalizations: press the desired key combo -- the first non-modifier key commits it with whatever modifiers are held. If the combo already drives another action, a dialog explains and recording continues. Esc cancels; times out after 10 seconds.
Update Current COMP (Shortcutupdatecomp)	Str	ctrl+alt+u	Keyboard shortcut for Update Current COMP. Lowercase combo like 'cmd+shift+o' or 'ctrl+shift+o': modifiers joined with '+' plus one trigger key. ctrl and cmd are distinct keys on macOS (matched exactly); on Windows/Linux, which has no Cmd key, a cmd binding fires via Ctrl. Each combo may be assigned to only one action. Leave empty to disable. Edit by hand or pulse Record below.
Record (Recordupdatecomp)	Pulse	-	Arm the shortcut recorder for Update Current COMP: press the desired key combo -- the first non-modifier key commits it with whatever modifiers are held. If the combo already drives another action, a dialog explains and recording continues. Esc cancels; times out after 10 seconds.
Refresh Tracking (Shortcutrefresh)	Str	ctrl+shift+r	Keyboard shortcut for Refresh Tracking. Lowercase combo like 'cmd+shift+o' or 'ctrl+shift+o': modifiers joined with '+' plus one trigger key. ctrl and cmd are distinct keys on macOS (matched exactly); on Windows/Linux, which has no Cmd key, a cmd binding fires via Ctrl. Each combo may be assigned to only one action. Leave empty to disable. Edit by hand or pulse Record below.
Record (Recordrefresh)	Pulse	-	Arm the shortcut recorder for Refresh Tracking: press the desired key combo -- the first non-modifier key commits it with whatever modifiers are held. If the combo already drives another action, a dialog explains and recording continues. Esc cancels; times out after 10 seconds.
Export Project to TDN (Shortcutexportproject)	Str	ctrl+shift+e	Keyboard shortcut for Export Project to TDN. Lowercase combo like 'cmd+shift+o' or 'ctrl+shift+o': modifiers joined with '+' plus one trigger key. ctrl and cmd are distinct keys on macOS (matched exactly); on Windows/Linux, which has no Cmd key, a cmd binding fires via Ctrl. Each combo may be assigned to only one action. Leave empty to disable. Edit by hand or pulse Record below.
Record (Recordexportproject)	Pulse	-	Arm the shortcut recorder for Export Project to TDN: press the desired key combo -- the first non-modifier key commits it with whatever modifiers are held. If the combo already drives another action, a dialog explains and recording continues. Esc cancels; times out after 10 seconds.
Export Current COMP to TDN (Shortcutexportcomp)	Str	ctrl+alt+e	Keyboard shortcut for Export Current COMP to TDN. Lowercase combo like 'cmd+shift+o' or 'ctrl+shift+o': modifiers joined with '+' plus one trigger key. ctrl and cmd are distinct keys on macOS (matched exactly); on Windows/Linux, which has no Cmd key, a cmd binding fires via Ctrl. Each combo may be assigned to only one action. Leave empty to disable. Edit by hand or pulse Record below.
Record (Recordexportcomp)	Pulse	-	Arm the shortcut recorder for Export Current COMP to TDN: press the desired key combo -- the first non-modifier key commits it with whatever modifiers are held. If the combo already drives another action, a dialog explains and recording continues. Esc cancels; times out after 10 seconds.
Copy Selected COMP as TDN (Shortcutcopytdn)	Str	ctrl+shift+c	Keyboard shortcut for Copy Selected COMP as TDN. Lowercase combo like 'cmd+shift+o' or 'ctrl+shift+o': modifiers joined with '+' plus one trigger key. ctrl and cmd are distinct keys on macOS (matched exactly); on Windows/Linux, which has no Cmd key, a cmd binding fires via Ctrl. Each combo may be assigned to only one action. Leave empty to disable. Edit by hand or pulse Record below.
Record (Recordcopytdn)	Pulse	-	Arm the shortcut recorder for Copy Selected COMP as TDN: press the desired key combo -- the first non-modifier key commits it with whatever modifiers are held. If the combo already drives another action, a dialog explains and recording continues. Esc cancels; times out after 10 seconds.
Tagger Double-Tap Key (Shortcuttagger)	Menu	lctrl	Modifier key that opens the tagger for the operator under the cursor when double-tapped (two presses within half a second). Entries are physical keys and adapt per platform: macOS offers Left Ctrl plus left/right Cmd (Apple keyboards have no right Ctrl); Windows/Linux offers left/right Ctrl (no Cmd key). A choice a platform's keyboard lacks falls back to its closest key -- the saved value is never rewritten, so it round-trips between platforms intact. Off disables the tagger shortcut.
Reset Shortcuts to Defaults (Resetshortcuts)	Pulse	-	Restore all keyboard shortcuts (and the tagger double-tap key) to factory defaults.

Adv

Parameter	Type	Default	Description
Create Externalizations Table (Createexternalizationstable)	Pulse	-	Creates the externalizations tracking table as a sibling operator if it does not already exist. Safe to pulse at any time - no-op if the table is already connected. Use this to recover if the table was lost after an Embody upgrade.
Externalizations Table (Externalizations)	DAT	/embody/externalizations	Reference to the externalizations tracking table DAT (stored in TSV format). Lists all externalized operators with their paths, types, timestamps, and dirty state.
Open Externalizations Table (Openexternalizationstable)	Pulse	-	Opens the externalizations tracking table in a floating viewer window.
Detect Duplicate Paths (Detectduplicatepaths)	Toggle	On	When enabled, warns if multiple operators resolve to the same externalized file path. Helps catch naming conflicts.
Template Master Name (Templatemaster)	Str	__template__	When duplicate external paths are detected, an operator whose path contains a folder/COMP with this exact name is auto-selected as the master (the rest are tagged as clones), with no prompt. Matches only when exactly one operator in the group contains this name. Clear this field to always choose the master manually, or set it to your own naming convention (e.g. '_master').
Local Timestamps (Localtimestamps)	Toggle	On	When enabled, timestamps in the externalizations table are displayed in your local timezone instead of UTC.
Restore toxes on Start (Toxrestoreonstart)	Toggle	On	When enabled, automatically restores TOX-strategy COMPs from .tox files on disk when the project opens. Useful when COMPs were externalized but the .toe was not saved.
Restore DATs on Start (Datrestoreonstart)	Toggle	On	When enabled, automatically restores DAT-strategy operators from externalized files on disk when the project opens. Recreates missing DATs (py, json, xml, etc.) and configures file sync. Safely excludes Embody descendants and DATs inside TOX/TDN COMPs.
File Cleanup (Filecleanup)	Menu	ask	When a deleted operator's external file still exists on disk: Ask prompts each time, Always Keep removes the tracking entry but leaves files on disk, Always Delete removes both the entry and the file. Options: Ask, Always Keep Files, Always Delete Files.
Dropped .tox Expression (Toxdropexpr)	Menu	ask	How to handle the default expression TouchDesigner writes into a COMP's External .tox when a .tox is dragged in (me.parent().fileFolder + '/' + ...). Ask: prompt when detected (the dialog's Always buttons set this parameter). Always Clean: silently clear the expression. Always Ignore: silently leave it. Embody's own descendants are always cleaned regardless. Options: Ask, Always Clean, Always Ignore.
Content Safety (Tdndatsafety)	Menu	ask	What to do when TDN COMPs contain DATs or storage that will be lost on save. 'Ask Each Save' prompts on each save (recommended), 'Always Externalize' auto-externalizes at-risk DATs without asking, 'Never Ask' suppresses the check entirely. Prefer 'Ask' or 'Always Externalize' -- 'Never Ask' is an opt-in escape hatch for power users who accept the risk. Options: Ask Each Save, Always Externalize, Never Ask.
Show Built-in Pars (Showbuiltinpars)	Toggle	-	Show TouchDesigner's built-in parameter pages (Layout, Panel, Look, Children, Drag/Drop, Extensions, Common) alongside Embody's pages in this dialog. Off (default) filters the dialog to Embody's pages only. The built-in pages remain fully functional either way -- this only controls dialog visibility, e.g. turn it on to reach the Common page's Global OP Shortcut.
Verbose (Debug) (Verbose)	Toggle	-	Enables debug-level logging. When off, only INFO and above are logged. Enable for detailed diagnostics when troubleshooting issues.
Print to Textport (Print)	Toggle	On	Echoes all log messages to the TouchDesigner textport. Useful for monitoring Embody activity in real-time.
Log to File (Logtofile)	Toggle	On	Writes log messages to a file on disk. Files are saved to the Log Folder with automatic rotation at 10 MB.
Log Folder (Logfolder)	Folder	logs	Folder where log files are saved. Defaults to dev/logs/ in the project directory. Files are named _YYMMDD.log.
Uninstall	Pulse	-	Removes Embody from this project: deletes Embody-generated config (CLAUDE.md / AGENTS.md / .claude / .cursor / ...), Embody's .venv, and .embody/ state; strips only Embody's block from shared files (.gitignore, .gitattributes, .mcp.json); un-sets the .tdn git diff driver. Your own files, externalized .tox / .tdn / .py, and the Embody COMP are NOT removed. Asks for confirmation first.

About

Parameter	Type	Default	Description
Version	Str (read-only)	6.0.241	Embody version string (read-only).
Touch Build (Touchbuild)	Str (read-only)	2025.33070	TouchDesigner build number this version was developed on (read-only).
Author	Str (read-only)	Dylan Roscover	Embody author (read-only).
Build Number (Build)	Int (read-only)	-	Embody build number (read-only). Incremented with each release.
GitHub (Github)	Pulse	-	Opens the Embody GitHub repository in your web browser.
Build Date (Date)	Str (read-only)	-	Date of this Embody build (read-only).
Help	Pulse	-	Opens the Embody help documentation.
Auto-Update (Autoupdate)	Menu	off	Startup self-update behavior. Off: never checks (nothing leaves your machine). Check and Notify: checks GitHub once at startup and shows availability in Update Status without installing. Check and Install: installs a verified newer release automatically at startup -- a check that can't complete is logged quietly, but any failure during the install itself always raises a dialog. Persisted setting -- survives the update it triggers. See the Auto-Update docs page. Options: Off, Check and Notify, Check and Install.
Check for Update (Checkforupdate)	Pulse	-	Checks GitHub for a newer Embody release now. Prompts with the version pair and a release-notes link if one is available (install / not now); reports up-to-date and network errors in a dialog. Refused in the dev checkout (update via git instead).
Update Status (Updatestatus)	Str (read-only)	Disabled	Result of the last update check or install: Disabled while Auto-Update is Off (the fresh-install resting state), up to date, a newer version available, download/install progress, or an error summary (read-only).