Skip to content

DarienBrito/TDMorph

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

What is TDMorph?

TDMorph is a toolbox designed to enhance parametric exploration, preset storage, composition, and cueing within the TouchDesigner platform.

It facilitates the creation and performance of generative content through various methods, while allowing you to archive and recall parameter configurations using a flexible JSON-based format.

In addition, TDMorph includes a set of developer tools for building custom systems, making it a versatile resource for artists and technical creators alike.

What can I do with it?

With TDMorph, you can perform a wide range of operations for creative exploration, performance, and system design in TouchDesigner, including:

  1. Random search for parameter states across one or multiple nodes.
  2. Morphing between states using various interpolation curves.
  3. Store and retrieve an unlimited number of presets.
  4. Control parameters and transitions through automatically generated UIs.
  5. Automatically store, randomize, and transform parameters of any node.
  6. Auto-learn MIDI and OSC mappings for every UI control.
  7. Script full UI behavior via high-level Python commands.
  8. Set global and local timing for each parameter independently.
  9. Automatically generate animations from stored presets.
  10. Build flexible cueing systems with follow actions and quantization.
  11. Generate parameter patterns programmatically using the Patterns library.
  12. Create algorithmic cueing systems through scripting.

And much more!

How does it work?

The architecture of TDMorph is fully modular, allowing you to use its core functionality either as a unified system or as individual components. This flexibility lets you combine different approaches depending on your needs.
The three main modes of operation are:

  • PresetManager
    A UI-less core component that manages any number of nodes simultaneously. It serves as the backbone of the engine—ideal for advanced developers who want to build their own systems from scratch.

  • ParameterMorpher
    A node with an interactive interface that includes widgets and control buttons, allowing you to easily perform morphing, randomization, and parameter operations across multiple nodes.

  • SceneLauncher
    A high-level UI designed for show control. It enables you to organize and trigger scenes and presets, supports follow actions, and integrates seamlessly with cue-based workflows.

Download

Starting with version 3.2, TDMorph has been divided into free and paid components. This change allows me to continue maintaining and improving the tool, as well as creating learning resources for the community — work that requires significant time and effort, which I can sustain only with proper support.

The PresetManager remains completely free. You can download it by grabbing the PresetManager folder from this repository or the corresponding build from the Releases section.

The following modules are paid:

  • ParameterMorpher
  • SceneLauncher

You can get them through my Patreon 👇:

https://www.patreon.com/c/darienbrito

Tutorials

TDMorph is a powerful and versatile tool — while it may take some time to explore its depth, the basic functionality is intuitive and easy to grasp.

To get started and learn everything TDMorph has to offer, check out the tutorial series on Vimeo or YouTube

Overview

Here a quick overview of the main tools to give you a quick idea.

Preset Manager

UI-less node to store, recall, and morph parameter states across multiple TouchDesigner nodes. The core of the TDMorph architecture.

Parameter Morpher

A powerful drag-and-drop front end for generating automatic UIs, enabling morphing, preset management, and aleatoric parameter exploration — fully

Scene Launcher

A minimalistic controller for cueing and managing scenes from arbitrary presets, featuring follow actions, randomization, and versatile tools for intuitive scene sequencing.

Shortcuts

The TDMorph ecosystem includes a set of simple, intuitive shortcuts designed to streamline your workflow. You only need to remember a few combinations — all built around the keys:

Shift or Ctrl + Mouse Button

That’s it! Every shortcut in TDMorph is derived from these two simple modifiers. Click here to see all functions

Code documentation

You can find documentation for relevant TDMorph modules here.

Bug Reports and contributions

Feedback and contributions are always welcome! If you notice anything that could be improved — whether in the networks, the UI, or the underlying code — please don’t hesitate to let me know. And if you spot something that looks off (which is bound to happen here and there), I’d really appreciate your input.

To report bugs or suggest improvements, please use the official issue tracker:

🔗 TDMorph GitHub Issues

About the License

Since version 3.2, TDMorph has moved to an MIT license, which means that you can

  • Use it for personal or commercial projects
  • Modify the code freely
  • Redistribute or sell derived works
  • Combine it with closed-source software

But you must:

  • Include the copyright notice
  • Include the license text
  • Accept that there is no warranty or liability

If you’re unsure what this implies, you can read what is the MIT License.

Final Thoughts

The motivation to share this tool comes from the wonderful sense of camaraderie within the TouchDesigner community, and from the inspiring philosophy of its creators at Derivative.

I hope the ethos that defines the TouchDesigner world continues to thrive, and that TDMorph helps you expand your creative possibilities as an artist, technologist, and maker.

Support

Thank you for your interest in my work! 🙏 You can visit my website and follow me on Instagram.

If you’d like to go one step further in supporting what I do, consider subscribing to my Patreon. Your support helps me keep creating, maintaining tools, and sharing knowledge with the community. 💛

Enjoy!

Darien Brito

About

TDMorph, a toolbox for enhanced parametric exploration in TouchDesigner

Resources

License

Stars

Watchers

Forks

Packages

No packages published