> ## Documentation Index
> Fetch the complete documentation index at: https://comfytv.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Getting started

ComfyTV turns ComfyUI into a **canvas app for making media** — generate, pick, edit, composite, and export across image, video, audio, music, panorama, 2D layers, and 3D, with \~190 stages. Every operation is its own node; results flow downstream automatically.

<img src="https://mintcdn.com/comfytv/dMkMxJDZdIo4YzAU/images/overview.png?fit=max&auto=format&n=dMkMxJDZdIo4YzAU&q=85&s=56e82e706ba5bdc9356b26bb46dc0d2c" alt="The ComfyTV canvas" width="2409" height="1695" data-path="images/overview.png" />

***

## Install

```bash theme={null}
cd ComfyUI/custom_nodes
git clone https://github.com/jtydhr88/ComfyTV
```

Restart ComfyUI. Open the **Add Node** menu (double-click the canvas or right-click) and look for the **`ComfyTV`** category. It's split into sub-menus: Project, Input, Generate, Image, Panorama, Video, VideoFX, Keying, Compose, Timeline, Audio, AudioFX, Music, 3D, Material, Storyboard, Bridge.

<img src="https://mintcdn.com/comfytv/dMkMxJDZdIo4YzAU/images/node-groups.png?fit=max&auto=format&n=dMkMxJDZdIo4YzAU&q=85&s=ffe9be7cf67021750dc23264d65eec9e" alt="Add-node menu" width="1615" height="1341" data-path="images/node-groups.png" />

***

## The basics

### Each node has its own Run button

Most stages have a **▶ Run** button inside their panel. Clicking it runs *just that stage* — it does **not** re-run the whole graph. The result appears in the node's output preview.

> Many stages **have no Run button at all** — crop, rotate, mirror, grid split, panorama viewports, the layer editor, piano rolls, and most FX previews work entirely in your browser and update instantly as you adjust them. A Run (or a final render like FX Chain) is only needed when a file has to be produced.

### Results flow downstream as snapshots

Once an upstream stage runs, its result is saved as a snapshot; downstream stages use that snapshot directly when they run, without re-running the upstream.

### Project selector

Drop a **Project** node to name/switch the current project. Everything you generate is filed under it — with full output history — and restored when you reload the workflow.

### The sidebar

The **ComfyTV** sidebar on the left has seven tabs: **Workflow** (config editor for the selected stage), **Assets** (media library), **Entries** (reusable prompt fragments, referenced with `@label`), **Stages** (workflows + custom parameters per stage kind, ★ default), **Presets**, **Resources** (LUTs / fonts / SoundFonts), and **Servers** (run stages on other machines). Full tour: [sidebar.md](/guides/sidebar).

***

## Quick run

1. Add **Generate → Image Stage**.
2. Type a prompt in the node's text box (e.g. `a red apple on a wooden table`).
3. Pick a model in the **workflow** dropdown — start with **`Local SD1.5`**.
4. Click **▶ Run**.

<img src="https://mintcdn.com/comfytv/dMkMxJDZdIo4YzAU/images/image-run.png?fit=max&auto=format&n=dMkMxJDZdIo4YzAU&q=85&s=c440e53c5f433b5792b4aa26b1ba0caa" alt="Image stage running" width="1654" height="1159" data-path="images/image-run.png" />

The Image Stage produces a **set of images** (a workflow can output more than one). The first time you Run it, ComfyTV **auto-adds an Image Picker** wired to its output.

### Pick a result

Click a thumbnail on the Image Stage itself, or on the auto-spawned Image Picker. Either way an **action toolbar** (`✏️ Edit`, `🌐 Panorama`, `📐 Multiangle`, …) appears next to the picked frame.

<img src="https://mintcdn.com/comfytv/dMkMxJDZdIo4YzAU/images/picker-toolbar.png?fit=max&auto=format&n=dMkMxJDZdIo4YzAU&q=85&s=10483c1b2f24b26e3e6896e43d47fcbc" alt="Image picker with toolbar" width="2277" height="1287" data-path="images/picker-toolbar.png" />

***

## Zoom into a preview

Hover any output image and use the **mouse wheel** to zoom (1×–6×), **drag** to pan, and **double-click** to reset. Works on every image output preview.

***

## Where to next

* [sidebar.md](/guides/sidebar) — the 7-tab sidebar and `@` prompt references
* [generate.md](/guides/generate) — generators (text / image / video / music / speech / 3D model)
* [image-tools.md](/guides/image-tools) — crop, rotate, mirror, inpaint, erase, cutout, upscale, outpaint, grid split, variations, multi-angle, relight
* [video-and-audio.md](/guides/video-and-audio) — the video & audio suites (\~100 video nodes, 30+ audio nodes)
* [making-music.md](/guides/making-music) — scores, piano rolls, SoundFont synthesis
* [compose.md](/guides/compose) — pickers, A/B compare, storyboard, timeline
* [custom-workflows.md](/guides/custom-workflows) — **🔗 Link workflow** (recommended), upload, and the library folder

The full documentation — including a reference page for every node — lives at **[comfytv.org](https://comfytv.org)**.
