Projects
Make a project in Tato Studio, start one from a sample, open or import one, duplicate it, and share it with someone else as a folder or a .zip.
A project is one folder: its streams, its nodes’ code, its assets and the modules it uses. Studio opens one project per window, and plays it as a whole.
Make one
Section titled “Make one”Choose New project (⌘N) in the Projects window, or File › New project…. Give it a name and Studio makes its folder in Documents/Tato Studio/, or in another location you pick, and opens it. It starts with one stream, which shows a test pattern: colour bars with a potato bouncing around them. There’s no camera, Python or anything else to set up first; the runtime brings its own Python and makes the project’s environment the first time it opens.
Start from a sample
Section titled “Start from a sample”Every example is also a sample project. Open File › Marketplace…, find the sample, and press Clone sample: Studio downloads it, checks it against its SHA-256, and makes it a new project of your own. The project you had open isn’t changed.
Open and import
Section titled “Open and import”- File › Open project… (⌘O), or Import project folder… in the Projects window, opens a project folder that’s already on disk: one you made from the command line, cloned from git, or copied from another machine.
- Import project .zip… makes a new project from a project’s
.zip, in a new folder, under the name it was saved with. It gets a project identity of its own, so the same.zipimported twice makes two separate projects.
Duplicate, rename, describe
Section titled “Duplicate, rename, describe”Each card in the Projects window has a ⋯ menu:
- Details opens the project’s name, its description and its cover image. With no cover, the card shows a plain one in a colour picked from the name.
- Rename… renames the project; its folder stays where it is.
- Duplicate copies the project, with its whole history, into a new folder beside it, as a separate project.
- Delete… stops its streams and moves its folder to the Trash, where you can put it back.
A rename, a new description or a new cover is an edit like any other: Edit › Undo takes it back.
Share a project
Section titled “Share a project”A project is its folder, so sharing one is sharing that folder:
- As a
.zip. Compress the project folder and send it. The other person chooses Import project .zip… and gets a project of their own. The import leaves out the project’s.tatolab/folder, which holds this machine’s log and history, and its Python environment, which the runtime makes again for their machine. - With git. A project is plain files: the graph documents in
streams/, your nodes’ Python,pyproject.toml, the assets and their sidecar files. Commit it, and anyone who clones it opens it with File › Open project…. - As a module. A project can be imported into another one, its nodes and streams with it. See Marketplace and modules.
The other person needs Tato and the hardware the project uses: a camera, a GPU with what its nodes need, and so on. Modules from the Marketplace say which machines they run on.
What’s in the folder
Section titled “What’s in the folder”my-stream/├── tatolab-project.json the project: its name, its identity and its modules├── streams/│ └── main.graph.json each stream: its nodes and the wires between them├── nodes/ the nodes you write├── imports/ the modules you added, copied in├── pyproject.toml the Python packages your nodes use└── .tatolab/ this machine's log and the project's historyStudio writes all of it for you. If you’d rather work with the files directly, Streams and graphs describes the graph document, and the CLI works on the same folder.
One project, many places
Section titled “One project, many places”A project open in Studio is open in the runtime, so the tatolab command and an agent see and change the same project while you work. When you quit Studio, the runtime it started stops with it, and the project opens again, playing or stopped as you left it, the next time a runtime starts. On a machine where the runtime runs as a service, it keeps playing without Studio. See Keep it running.