A tour of Tato Studio
The Projects window, the project window and its areas, the menus, and where each part of a project shows in Tato Studio.
Tato Studio is where you build with Tato. You make a project, drop nodes into its streams, connect their pins, and play it, with every node’s output there to watch. Studio carries the runtime and runs it while it’s open, so there’s nothing else to start. Install Tato covers getting it.
Everything you do in Studio is an edit the runtime applies to the running project and saves in the project’s folder. Close Studio and the folder holds the whole project; open it again, from Studio, the command line or an agent, and it’s all there.
The Projects window
Section titled “The Projects window”Studio opens on All projects: a card for each project you’ve made or opened, with its cover, its name and when you last edited it. Search them, or start one:
- New project (⌘N) makes a project in
Documents/Tato Studio/, with a stream to start from. - Import project folder… opens a project that’s already on disk.
- Import project .zip… makes a project of your own from a
.zipsomeone sent you.
Each card’s ⋯ menu has Details (its name, description and cover), Rename…, Duplicate and Delete…, which moves the folder to the Trash. Projects has more.
The project window
Section titled “The project window”Opening a project opens its window, and closing the window stops and closes the project, after Studio asks. Along the top are the project’s name, a tab for each stream you’ve opened, the layout buttons and the Play button. Below is the layout: areas side by side, each showing one view, and each with a menu in its title that switches which view it shows.
| View | Shows |
|---|---|
| Stream graph | The open stream’s nodes and the wires between their pins. Where you build. See Build a graph. |
| Node visualizer | What the selected node outputs, live: pictures, audio, encoded media or records. |
| Outliner | The project as a tree: its streams and their nodes. Double-click a stream to open its tab. |
| Properties | The selected node: its name, its inputs and their values, its settings, and what it’s connected to. |
| Controls | The open stream’s Graph Inputs, as controls you play it with. See Streams as compositions. |
| Library | What the project can use: node types, generators, views and assets. See Library and assets. |
| Files | The project folder on disk, and New node file. See Make nodes. |
| Code | An editor for the project’s files, with Python completions, and the project’s log beneath it. |
| History | Every edit to the project, by you, an agent or the runtime, newest first. |
Window › Layout arranges the areas: Two columns, Three columns, Main + right, Main + bottom, or Left + main + right. Drag the edges between areas to resize them, and expand any area to fill the window, then press Esc to put the layout back. Save layout as preset… keeps an arrangement, and ⌘1, ⌘2 and on bring each preset back. Studio remembers each project’s layout.
The menus
Section titled “The menus”| Menu | Holds |
|---|---|
| File | Projects, Open project… (⌘O), New project… (⌘N), Import project .zip…, Marketplace… and Modules… |
| Edit | Undo (⌘Z), Redo (⇧⌘Z) and Settings… (⌘,) |
| Stream | New stream…, Rename stream…, Delete stream…, and the tabs: Close tab (⌘W), Reopen closed tab (⇧⌘T), next and previous (Ctrl-Tab) |
| Run | Play (F5), Pause and Stop (Shift-F5) |
| Window | Layout |
| Help | About Tato Studio and Check for Updates… |
On Linux the same menus sit in the window’s own menu bar.
Settings
Section titled “Settings”Edit › Settings… has the project’s settings, and this machine’s:
- Developer adds the Transactions view, which lists every change the runtime recorded in the open project, exactly as it was sent.
- Runtime shows the runtime’s state, version and uptime, and where it writes its log.
- Command line links the
tatolabcommand into~/.local/bin, and shows the MCP command and the.mcp.jsona coding agent needs. See Build with an agent. - General has opening Studio in the tray at login, with the runtime ready for the
tatolabcommand, and notifications when a stream fails to start.
Where to next
Section titled “Where to next”- Projects: make, import, duplicate and share them.
- Build a graph: add nodes, connect pins and set values.
- The quickstart: all of it, start to finish, in five minutes.