Skip to content
Back to search

claude-touchdesigner

MarketplaceWorks with Claude CodeGitHub

Claude Code plugins for TouchDesigner

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/satoruhiga--claude-touchdesigner/badge.svg)](/listings/satoruhiga--claude-touchdesigner)

HTML

<a href="/listings/satoruhiga--claude-touchdesigner"><img src="/api/listings/satoruhiga--claude-touchdesigner/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. Install the Claude Code Plugin

# Add marketplace
/plugin marketplace add satoruhiga/claude-touchdesigner

# Install plugin
/plugin install touchdesigner@satoruhiga-claude-touchdesigner

2. Load the TOX in TouchDesigner

1. Open your TouchDesigner project 2. Drag and drop `toe/TouchDesignerAPI.tox` anywhere in your project 3. The MCP server will start automatically

3. Verify Connection

In Claude Code, run `/touchdesigner` to load the skill, then try:

Create a Grid SOP with noise

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 16 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "claude-touchdesigner",
  3. "description": "Claude Code plugins for TouchDesigner",
  4. "owner": {
  5. "name": "Satoru Higa",
  6. "email": "satoruhiga@gmail.com"
  7. },
  8. "plugins": [
  9. {
  10. "name": "touchdesigner",
  11. "source": "./touchdesigner",
  12. "description": "TouchDesigner integration for Claude Code - Execute Python, query editor state, and manage operators",
  13. "version": "0.1.6"
  14. }
  15. ]
  16. }
README.md · README · 97 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # TouchDesigner Plugin for Claude Code
  2. A Claude Code plugin that enables AI-assisted TouchDesigner network creation and manipulation via MCP (Model Context Protocol).
  3. ## Features
  4. - **Execute Python in TouchDesigner** - Run Python code directly in your TD project
  5. - **Query Editor State** - Get current network path, selection, and operator info
  6. - **Operator Management** - Create, connect, and layout operators with best practices
  7. - **Skill-based Guidance** - Built-in patterns for rendering, GLSL, instancing, and more
  8. ## Installation
  9. ### 1. Install the Claude Code Plugin
  10. ```bash
  11. # Add marketplace
  12. /plugin marketplace add satoruhiga/claude-touchdesigner
  13. # Install plugin
  14. /plugin install touchdesigner@satoruhiga-claude-touchdesigner
  15. ```
  16. ### 2. Load the TOX in TouchDesigner
  17. 1. Open your TouchDesigner project
  18. 2. Drag and drop `toe/TouchDesignerAPI.tox` anywhere in your project
  19. 3. The MCP server will start automatically
  20. ### 3. Verify Connection
  21. In Claude Code, run `/touchdesigner` to load the skill, then try:
  22. ```
  23. Create a Grid SOP with noise
  24. ```
  25. ## MCP Tools
  26. | Tool | Description |
  27. |------|-------------|
  28. | `td_execute` | Run Python code in TouchDesigner |
  29. | `td_pane` | Get current network editor state |
  30. | `td_selection` | Get selected operators |
  31. | `td_operators` | List operators at a path |
  32. ## Skills
  33. The plugin includes a `td-guide` skill with reference documentation for:
  34. - Operator families (SOP, POP, TOP, CHOP, DAT, COMP)
  35. - Network layout patterns
  36. - Geometry COMP and instancing
  37. - Rendering setup (Camera, Light, Render TOP)
  38. - GLSL shaders (TOP, MAT, POP)
  39. - Feedback loops and simulations
  40. ## Configuration
  41. ### Port Settings
  42. By default, the MCP server connects to TouchDesigner on port `44444`. You can change this using the `TDAPI_PORT` environment variable.
  43. **macOS / Linux:**
  44. ```bash
  45. TDAPI_PORT=12345 claude
  46. ```
  47. **Windows (Command Prompt):**
  48. ```cmd
  49. set TDAPI_PORT=12345
  50. claude
  51. ```
  52. **Windows (PowerShell):**
  53. ```powershell
  54. $env:TDAPI_PORT="12345"
  55. claude
  56. ```
  57. To set the port permanently on Windows, add `TDAPI_PORT` to System Environment Variables:
  58. 1. Open **Settings** > **System** > **About** > **Advanced system settings**
  59. 2. Click **Environment Variables**
  60. 3. Under User or System variables, click **New**
  61. 4. Set Variable name: `TDAPI_PORT`, Variable value: your port number
  62. The port must match the `Port` parameter in the `TouchDesignerAPI.tox` component inside TouchDesigner.
  63. ## Requirements
  64. - TouchDesigner 2025 or later
  65. - Claude Code CLI
  66. - Node.js (for MCP server)
  67. ## License
  68. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.