Skip to content

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.

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 .zip someone 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.

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.

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.

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 tatolab command into ~/.local/bin, and shows the MCP command and the .mcp.json a coding agent needs. See Build with an agent.
  • General has opening Studio in the tray at login, with the runtime ready for the tatolab command, and notifications when a stream fails to start.