So you have a large TouchDesigner project, where do you start?
How do you set up your network? What if you’re working with multiple developers?
This blog will serve as a starter guide with tips to help you plan, organize, and maintain efficiency when undertaking a larger-scale TouchDesigner project.
File Structure
When working on a large-scale project, things can get messy quickly. If a file contains multiple visual assets, post-processing chains, logic sections, multiple outputs, and a UI, navigation becomes difficult without clear structure and consistency.
Here are some organization tips that can make a big difference in keeping your network manageable:
Using COMPs to House Sections
Placing sections of your network inside COMPs is a great way to stay organized. A Base COMP can collapse a section of your network, keeping it compact and readable.
Take advantage of what COMPs have to offer.
Custom Parameters
Custom parameters let you create a custom parameter page on a COMP. This is useful for housing parameters you frequently adjust, instead of tracking them across multiple nodes.
Pro tip: Always use Bind References for custom parameters. Then the value change will affect both the upper and lower level.
Parent Shortcuts
A Parent Shortcut allows any component to reference its parent using the parent.Name notation, no matter how deep it is nested.
Global OP Shortcuts
Global Operator Shortcuts help you access any component from anywhere in the project. In large systems, this can be essential when you need to reference components that aren’t parents or direct neighbors.
Using Annotations to Organize Sections
You can organize your network visually by using annotations and assigning them specific colors. To add an annotation box, use the shortcut Shift + A. This makes large networks easier to read and navigate.
Keep an Asset Folder
Large project or not, always keep an Asset folder at the same level as your .toe project file. This ensures your file paths remain consistent when sharing or transferring projects.
Without a consistent folder structure, paths will break — and relinking assets in a large project can be time-consuming, especially when collaborating with others.
Have a Project State Machine
State machines manage the flow and behavior of an application by defining distinct states and the transitions between them.
Different developers use different approaches, but a simple way to start is by using a UI Lister to control your project’s states.
Check out Mary Frank’s video on State Machines for Interactive Projects for a helpful overview.
Get Our 7 Core TouchDesigner Templates, FREE
We’re making our 7 core project file templates available – for free.
These templates shed light into the most useful and sometimes obtuse features of TouchDesigner.
They’re designed to be immediately applicable for the complete TouchDesigner beginner, while also providing inspiration for the advanced user.
Optimization
As your project grows, maintaining performance becomes critical. Here are some ways to keep things optimized:
Probe Tool
Found in the Palette, the Probe tool visually monitors performance, showing CPU times (circles), GPU times (diamonds), and more — including CPU/GPU memory and component count.
Optimization Tips:
- Don’t lock nodes unnecessarily — it increases file size.
- Delete unused nodes.
- Turn off unnecessary display flags — every active display cooks.
Group Workflows
When multiple developers are collaborating on a single project, workflow and version control become important.
Git
Git is a free and open-source version control system. It can be used to manage updates and share project versions among team members. However, it comes with limitations in TouchDesigner.
Check out Matthew Ragan’s blog on TouchDesigner and Git for a detailed overview.
External TOXes
TOX files are modular components that can be saved and re-imported into any network. Using external TOX files helps teams work in parallel and update individual sections without breaking the main project.
Learn more in Matthew Ragan’s blog on External TOXes.
Strong Machine
Make sure your workstation or server can handle the project’s performance demands. Read TouchDesigner Server 101 to learn more about hardware considerations.
Save Often
As projects grow, so does the risk of crashes or corruption. Save your work often and keep backup copies on an external drive or cloud service. You never know when something unexpected will happen.
Wrap Up
Larger TouchDesigner projects require more than creative ideas and they demand structure, clarity, and maintenance. By using COMPs effectively, keeping a clean file hierarchy, optimizing performance, and setting up systems for collaboration, you’ll save hours of troubleshooting and make your project more scalable.
Good structure isn’t just organization, it’s what keeps your creative process efficient, adaptable, and ready to grow.
