DOCUMENTATION
0. OVERVIEW
2. INSTALLATION
4. CREATE OP
5. SEARCH OP
6. SEARCH CODE
7. LIBRARY
8. PALETTE
9. VST
10. AI
11. HUB
12. LOCATIONS
13. RECENT PROJECTS
14. SETTINGS
15. MCP
16. UPDATE
17. WHY
18. CHANGELOG
0. OVERVIEW
twozero is designed to significantly simplify and speed up boring actions and reduce amount of mouse clicks during daily life in TouchDesigner, like creating OPs and changing it's defualt settings, searching for OPs/old components or projects/palette comps/python code..
twozero is injected directly into TouchDesigner user interface, thus it leaves no traces in your projects.
twozero consists of several utilities centered around a "search bar" with customizable hotkeys and other settings.
ABBREVIATIONS:
TD - TouchDesigner
OP - TD's operator
UI - user interface
LMB - left mouse button
RMB - right mouse button
MMB - middle mouse button
[key] - keyboard button
1. SYSTEM REQUIREMENTS
Windows: Win 10+ modern gaming class machine.
Mac: M1 or higer, macOS 10.14+
TouchDesigner Free/Commercial/Pro, minimum build: 2025.32280
2. INSTALLATION
WINDOWS:
1. Drop twozero.tox to TD network editor -> Install
2. Confirm admin access (WHY?)
MACOS:
1. Allow TouchDesigner full disc access (WHY?):
OPTION+F2 -> Privacy & Security -> Full Disc Access -> TouchDesigner -> turn on (use + at bottom if there is no TouchDesigner in a list)
2. Drop twozero.tox to TD network editor -> Install
In case of success you will see twozero launcher icon next to 'Open palette' button.
NOTES:
All twozero settings and data are stored on a disk, so it is possible to install and uninstall twozero at any time without loosing any data.
twozero data location could be changed via twozero settings.
twozero requires installation each time TD is updated, however all the settings will be loaded automatically.
UNINSTALL:
Go to twozero setting -> uninstall.
3. TOOLSET AND USAGE
twozero consists of several utilities centered around a "search bar".
twozero tools are designed to enhance actual work by simplifying past works reusage and minimizing needs of file management.
Each tool could be assigned to keyboard shortcut via Settings.
GENERAL USAGE:
1. Click twozero launcher icon - you are at the root level.
2. Select a tool
3. Use a tool.
Most of operations could be performed with keyboard only, by typing in Search Bar and up/down/enter keys.
LMB also works fine.
All tools could be assigned to keyboard hotkeys via Settings
Press ESC or click red dot to exit twozero
Click ... at navigation bar to go back to root level or press [CMD/CTRL]+[UP]
Hold mouse pointer at navigation bar over current tool name to see quick help.
LIST OF TOOLS:
Create OP - Create new OPs and redefine defaults for new OPs
Search OP - Enhanced operator search
Search Code - Search python code through all DATs
Library - Save/Load components and templates
Palette - Search in TD palette
VST - VST plug-ins search and create vstCHOPs
AI - Browse and create AI model adapters (twozero.ai)
Hub - Cloud component sharing via twozero.ai
Recent Projects - search through all recent projects
Locations - project locations bookmarks
Settings - twozero settings
4. CREATE OP
CREATE NEW OPs:
Create new OPs is similar to origianl TD 'create OP' dialog. [UP]/[DOWN]/[ENTER] keys also works.
USAGE:
1. Open the Create OP diaolg in a regular way.
2. Start typing the OP type. It is possible to search by word parts, for example:
'a de ou' -> audiodeviceoutCHOP
'a osc' -> audiooscillatorCHOP
3. Use [UP/DOWN] keys to select, [ENTER].
or
3. LMB on item.
REDEFINE DEFAULT SETTING FOR NEW OPs:
1. Select OP(s) in NetworkEditor with desired settings
2. Open Create OP tool
3. Type '='
4. Press [ENTER] -> Confirm
NOTES:
Will be saved/loaded as defaults: parameters and their modes and expressions, docked OPs and their parameters, DAT's content
5. SEARCH OP
Search OP by name or/and type.
The search performs within a current location and it's childs.
SEARCH SYNTAX:
'name type'
Both name and type are optional.
name and type are separated with space.
To search by OP type only - start with space, e.g. ' noisechop',' textdat',' sop'
Search results are sorted in following order:
1. Depth from current location
2. name search position in OP name
3. OP type
Pressing [UP]/[DOWN] keys or selecting with LMB - automatically navigates to selected OP
SEARCH EXAMPLES:
'no' - will find all types OPs with names like: noise1, mono1, nvdenoise1
'co cho' - will find CHOPs with names like 'constant', 'record'
' spee' - will find all speedCHOPs
6. SEARCH CODE
Search python code through all DATs
7. LIBRARY
Library Tool handles save/search/load OPs across different project.
It is possible to save/load both components and set of OPs, it's connections and parameter expressions (aka templates).
It also optionally collects and store to library external assets (for example moiviefileinTOP's movie file) then copy and relinks them while loading from library.
To search by multiple parts of the name - separete parts by spaces. For example searching for 'noiseWithSpeedOne' could be done by typing: 'no sp' or 'noise sp' or 'n sp on' e.t.c as well as with 'noisewiths'.
SAVE TO LIBRAY:
1. Select OP(s) in NetworkEditor
2. Open Library Tool
3. Type '+nameOfItem'
4. [ENTER]
LOAD FROM LIBRAY:
1. Start typing item name
2. Select item from the list with keyboard or mouse
3. [ENTER] or LMB
4. Place OP(s) in NetworkEditor
REMOVE FROM LIBRARY
CMD/CTRL + Delete/Backspace -> confirm
or
1. Start typing '-nameOfItem'
2. LMB on item -> confirm
NOTES:
By default Library is located in TD preferences folder.
To change library location use Settings:
1. Settings -> library -> select new location
2. Check copy library to copy existed items to new location or uncheck to initialize empty library
MULTIPLE MACHINES:
In case using multiple machines - it is good idea to relocate the library to shared or cloud folder.
In our experience Dropbox works good for that, simply set 'Available Offline' for the folder via Dropbox settings.
In that case, the library will be accessible and synchronized across all computers, significantly simplifying components and templates reusage across all machines.
8. PALETTE
Search in TD palete
9. VST
VST plug-ins search and create vstCHOPs
10. AI
Login required - invites only
AI MODEL BROWSER:
Browse generative AI models and create AI adapter COMPs linked to twozero.ai.
Requires a twozero.ai account.
USAGE:
1. Open the AI tool.
2. Search or browse available model families and individual models.
3. [ENTER] or LMB on a model family → creates adapter with best model auto-selected.
[ENTER] or LMB on a specific model (listed indented under its family) → creates adapter with that exact model pinned.
ADAPTER TYPES:
The tool creates one of three adapter COMPs depending on model's generation type:
chat — text-to-text and image-to-text (multimodal LLM). Output: DAT.
image — text-to-image, image-to-image. Output: TOP.
video — image-to-video, text-to-video. Output: TOP.
NOTES:
Models are sorted by recency of use.
Adapters auto-update to the latest template version on next AI tool open.
Models and pricing are fetched live from twozero.ai on tool open.
11. HUB
Login required - invites only
CLOUD COMPONENT SHARING:
Hub is a GitHub-like cloud storage for TD components and networks.
Upload your OPs, patches and templates once — access them from any machine at any time.
Supports file versioning and optional automatic collection of external assets (movies, images, etc.).
Requires a twozero.ai account.
NAVIGATION:
Hub has three levels — navigate with [ENTER]/[→]/[←]:
repos — list of your repos (folders). Entry point.
files — components inside a repo. [ENTER] or [→] on a repo to open.
versions — version history of a file. [→] on a file to open. [←] goes back one level.
FIRST TIME SETUP:
Open Hub — a login dialog will appear automatically.
Enter your twozero.ai email → receive a 6-digit code → enter it → done.
CREATE A REPO (FOLDER):
Files can only be uploaded inside a repo — create one first.
Type '/new_repo $reponame' → [ENTER].
UPLOAD:
1. Open a repo ([ENTER] on it).
2. Select OP(s) in Network Editor.
3. Type '+name' (optionally '+name?description').
4. [ENTER] → packages and uploads. Confirm whether to collect external assets.
DOWNLOAD:
1. Open a repo, select a file.
2. [ENTER] or LMB → downloads and places the latest version into the current network.
To download a specific version: open versions ([→] on file) → [ENTER] on the version.
VERSION HISTORY:
Every upload creates a new version of the file. All versions are kept.
[→] on a file → opens the versions list (date, size, uploader, description).
[ENTER] on a version → downloads that specific version.
[CMD/CTRL]+[Delete/Backspace] → delete selected version only.
In files scope → [CMD/CTRL]+[Delete/Backspace] → delete file and all its versions.
SHARING:
Type '/share $reponame @username &permission' → [ENTER].
Tab-complete each part with [ENTER] as you go.
Permissions: read, write, root.
Shared repos appear in the other user's repos list.
OTHER COMMANDS (type / to see all):
/logout — sign out.
NOTES:
External assets (movie files, images, etc.) are optionally collected and bundled with the component.
VST plugins are handled separately and relinked on load.
OP names are automatically renamed to avoid conflicts in the target network.
12. LOCATIONS
PROJECT LOCATIONS BOOKMARKS:
Save and restore viewport positions: network path, scroll position and zoom level.
Locations are stored per-project in /local/pisang_locations.
Navigating through the list live-previews each location in the Network Editor.
SAVE LOCATION:
Type '+name' → [ENTER] saves the current viewport (network + position + zoom).
NAVIGATE TO LOCATION:
Search or scroll through the list — viewport updates in real time as you move.
[ENTER] or LMB → confirms and closes twozero.
REMOVE LOCATION:
[CMD/CTRL]+[Delete/Backspace] → remove selected location.
NOTES:
Locations marked as lost indicate the saved network path no longer exists in the project.
13. RECENT PROJECTS
Search through all recent projects.
LMB or [ENTER] - load project
RMB - show project in folder
14. SETTINGS
general:
library - location for the most of data managed by twozero. Also used by Library and Recent Projects logs.
dialog size - the size of twozero window (XS / S / M / L / XL).
num lines - number of visible lines with search results for all twozero tools.
Pisang creates OPs - if Yes, twozero intercepts the standard TD Create OP dialog.
auto update - twozero will check and install updates each time TD starts.
scroll OP's parameters - twozero will alter OP's parameter value under the mouse cursor on mouse scroll. Handy while using touchpads. Use with CTRL/SHIFT to in-de/crease step, use ALT to scroll entire parameter group.
autosave - automaticaly save project every [autosave interval] minutes.
autosave interval - if autosave is on, defines the interval in minutes.
store OP defaults to library - if Yes, Create OP tool will store user defaults for new OPs in library folder, otherwise in local preferences folder.
manage VST - enable VST management features.
uninstall - uninstall twozero from TD. This will not affect Library data.
check updates - manually check for twozero updates.
mcp:
auto start MCP - automatically start the MCP server when twozero initializes. Allows AI agents (e.g. Claude Code) to control TD via Pisang.
local only MCP - if Yes, reject connections from non-localhost addresses (recommended for security).
MCP default port - set one base port once (for example 40404). twozero uses it for the primary instance and auto-assigns next ports for additional opened TD projects. You do not configure separate ports manually for each instance; connect your client to the base port.
hotkeys:
Assign hotkey for each tool:
1. Select a tool
2. [ENTER] or LMB
3. Press hotkey, or cancel/clear.
15. MCP
MCP SERVER:
twozero includes a built-in MCP (Model Context Protocol) server that lets AI agents such as Claude Code control TouchDesigner directly — create operators, read networks, run scripts and more.
ENABLE MCP:
START AUTOMATICALLY ON LAUNCH TD:
Settings -> mcp -> auto start MCP -> Yes
MCP server starts automatically on next TD launch (base port from Settings: mcp -> MCP default port).
ONE-TIME SETUP:
Ask your agent (Cursor/Codex/Claude):
`Add twozero TD MCP for me with server key "twozero_td" and URL "http://localhost:40404/mcp". Configure it globally (user scope) so it is available from any project/workspace.`
NOTES:
twozero must be running in TouchDesigner for the MCP server to be available.
Use Settings -> mcp -> local only MCP to restrict connections to localhost only (recommended).
16. UPDATE
Go to Settings -> Check Updates, confirm if any.
Or
Perform Installation
CHECK UPDATES AUTOMATICALLY ON START TD:
Go to Settings -> Auto Update -> Yes
17. WHY
WHY GRANT ADMIN ACCESS DURING INSTALLATION AND UPDATE?
twozero is designed to be a part of TD ui, not a part of particular .toe file.
It is loaded dynamically in a same way most of TD ui elements are loaded.
After launching TD instance twozero is located here: /ui/dialogs/bookmark_bar which is part of /ui COMP.
/ui COMP is loaded from ui.tox on TD startup. Ui.tox is located in TD installation folder.
During installtion - twozero copies itself to /ui/dialogs/bookmark_bar, adjust some parameters and saves /ui COMP back to TD installation folder.
Saving anything to TD installation folder requires admin access.
18. CHANGELOG
TD build: 2025.32280
March 06, 2026
TD build: 2025.32280
March 06, 2026
TD build: 2025.32280
March 05, 2026
TD build: 2025.32280
March 05, 2026
TD build: 2025.32280
March 05, 2026
TD build: 2025.32280
March 05, 2026
TD build: 2025.32280
March 05, 2026
TD build: 2025.32280
March 05, 2026
TD build: 2025.32280
March 05, 2026
TD build: 2025.32280
March 05, 2026
pisang -> twozero
TD build: 2025.32280
March 05, 2026
TD build: 2025.32280
March 02, 2026
TD build: 2025.32280
March 02, 2026
TD build: 2025.32280
March 02, 2026
TD build: 2025.32280
March 01, 2026
screenshots: JPEG auto for viewer, smart size detection via OnViewerSizeDetected, quality=0.85, batch default 256px, format param
td_get_focus(screenshots=true): auto-batch screenshots of selected ops
screenshots hints key with resolution rules
TD build: 2025.32280
March 01, 2026
td_get_screenshots batch tool: multi-operator screenshots in one call, batchId polling, output_dir option
TD build: 2025.32280
March 01, 2026
td_get_screenshot: as_top mode (selectTOP+switchTOP, preserves alpha), output_path param, max_size param, async queue with fallback warning
TD build: 2025.32280
March 01, 2026
td_get_screenshot tool: async PNG capture via opviewerTOP+moviefileoutTOP, max_size param, multi-word search in searchRecentFile/VST/palette/searchCode, MCP hints updated with ui_analysis key
TD build: 2025.32280
March 01, 2026
multi-word search in Recent Projects, VST, Palette, Search Code
TD build: 2025.32280
March 01, 2026
TD build: 2025.32280
February 28, 2026
TD build: 2025.32280
February 28, 2026
TD build: 2025.32280
February 27, 2026
Hub: repos-level file search, direct download and versions navigation, back navigation restores search and cursor
TD build: 2025.32280
February 27, 2026
added MCP section to documentation
TD build: 2025.32280
February 27, 2026
Locations: fixed LMB click not navigating to location
TD build: 2025.32280
February 27, 2026
Hub: login now uses email + code flow (same as AI tool), no more slash commands needed
TD build: 2025.32280
February 27, 2026
TD build: 2025.32280
February 27, 2026
TD build: 2025.32280
February 27, 2026
TD build: 2025.32280
February 27, 2026
TD bug custom parameters + placeOPs avoience
TD build: 2025.32280
February 27, 2026
MCP + twozero.ai
ai models selection auto/specific
Massive refactor with agent help
agent_md
TD build: 2025.32280
February 22, 2026
TD build: 2025.32280
February 22, 2026
TD build: 2025.32280
February 21, 2026
TD build: 2025.32280
February 21, 2026
bugfix: createOp from hotkey
TD build: 2025.32280
February 21, 2026
ai fetch history fix
TD build: 2025.32280
February 21, 2026
ai updates - ensure Genmusicpar
TD build: 2025.32280
February 13, 2026
ai history
auto apdate ai-adapter COMPs
TD build: 2025.32280
February 10, 2026
TD build: 2025.32280
February 10, 2026
hub refactor and python threadings
TD build: 2025.32280
February 09, 2026
TD build: 2025.32280
February 04, 2026
TD build: 2025.32280
February 04, 2026
ai login with email
TD build: 2025.32280
February 04, 2026
TD build: 2025.32280
January 24, 2026
ai adapters - display filename
TD build: 2025.32280
January 23, 2026
TD build: 2025.32280
January 23, 2026
TD build: 2025.32280
January 23, 2026
TD build: 2025.32280
January 23, 2026
TD build: 2025.32280
January 23, 2026
TD build: 2025.32280
January 23, 2026
TD build: 2025.32280
January 23, 2026
TD build: 2025.32280
January 23, 2026
TD build: 2025.32280
January 22, 2026
ai-image v2.01
TD build: 2025.32280
January 22, 2026
TD build: 2025.32280
January 22, 2026
ai save inputs improvemnts
TD build: 2025.32280
January 22, 2026
TD build: 2025.32280
January 22, 2026
TD build: 2025.32280
January 22, 2026
ai logged out handle
TD build: 2025.32280
January 22, 2026
TD build: 2025.32280
January 21, 2026
TD build: 2025.32280
January 21, 2026
TD build: 2025.32280
January 21, 2026
TD build: 2025.32280
January 21, 2026
ai: history
TD build: 2025.32260
January 20, 2026
TD build: 2025.32260
January 20, 2026
global shortcut
TD build: 2025.32260
January 20, 2026
model selection improvements
TD build: 2025.32260
January 20, 2026
ai stuff in progress
TD build: 2025.32260
January 20, 2026
fixed broken panels while creating COMPs
global shortcut
TD build: 2023.12480
January 15, 2026
hub load toxes as lib to avoid 2025 panel bug, temporary. Waiting for Derivative fix
TD build: 2023.12480
December 28, 2025
still fighting with 2025 panels bugs...
TD build: 2023.12480
November 20, 2025
cleanup
TD build: 2023.12480
November 15, 2025
bugfix: palette
prod brunch
Hub: direct download/upload
library temp solution for experimental TD
ignore locked OPs while collecting asstes
perform mode - do not autosave, do not scroll change parameters
hub search improvements
recent projects - improvements
Experimental log project encoding fix
TD 2025.30960 avoid bug when creating panelCOMPs
createOP sorting improvements
createOP family labels
selectMAT selectCOMP handle
pop families on left/right keys
remove debug()
library, hub - clear externaltox par when save to
manage vst save project
recent projects - search from othere machines improvements
date format
uppercase handle for hub and locations
repo owner to title
manage vst behavour to follow recent TD bugfixes:
Hub: cache repo index
selectTool search improvemnts
lib fix
library uuid fix
Library, hub - better VST handling
VST checker
VST improvemnts
do not auto save if project not modified
VST improvemnts
Compatible ops fix
hub - files fix
createOP bifixes (when creating compatible ops)
hub: ower/repo for shared repos
createOP: creating selectOP improovements
POPs
autosave blank project fix
dev brunch
hubb
hub
hub test
Teams Alpha
TD build: 2023.12230
May 31, 2025
Library tool - collects and relinks external assets
Location tool: save and nbavigate to specific project locations.
Library and Location tools: delete items with Ctrl(Cmd) + Del(Backspace)
TD build: 2023.12230
April 21, 2025
library ignore ._files
TD build: 2023.12230
April 21, 2025
Search OP improvements
searchOP - instantly navigate to the first found OP
TD build: 2023.12230
March 05, 2025
Keyboard modKeys read from native ctypes to avoid TD bug
TD build: 2023.12120
March 01, 2025
library: automatic renaming ops improvements
TD build: 2023.12120
January 29, 2025
bugfix
TD build: 2023.12120
January 29, 2025
bugfix
TD build: 2023.12120
January 29, 2025
createOp dialog - family filter by pressing TAB or LEFT/RIGHT
TD build: 2023.12120
January 25, 2025
fixed default settings: tab hotkey
TD build: 2023.12000
December 13, 2024
Library Tool: no name auto completions while adding template
TD build: 2023.12000
December 10, 2024
Recent Projects: automatically finds projects located in shared folders saved from other machines.
TD build: 2023.12000
December 07, 2024
library save bugfix
TD build: 2023.12000
December 07, 2024
createOP sorting improvements
bugfixes
TD build: 2023.12000
November 25, 2024
improvements: do not autoSave blank project
TD build: 2023.12000
November 15, 2024
fixed: library does not working on first install
TD build: 2023.12000
November 13, 2024
recent files on RMB fix
TD build: 2023.12000
November 12, 2024
alt+scroll par -> affect parGroup
TD build: 2023.12000
November 09, 2024
no privacy
TD build: 2023.11760
June 23, 2024
UTF-8 with BOM
TD build: 2023.11760
June 23, 2024
log files force encoding
TD build: 2023.11760
June 19, 2024
quick switch to TD create OP
TD build: 2023.11760
June 18, 2024
scroll parameters for multiple ops
TD build: 2023.11760
June 18, 2024
handle binded parameters on scroll mouse
TD build: 2023.11760
May 30, 2024
shift + click -> opens library instead of createOP
TD build: 2023.11760
May 29, 2024
createOp search and sort improovments
TD build: 2023.11760
May 28, 2024
scroll binded parameters
TD build: 2023.11760
May 28, 2024
FIRST PUBLIC RELEASE