> ## 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 **TapNow / LibTV-style canvas app**. Every operation is its own node; results flow downstream automatically. Chain stages into a complete flow: generate → pick → edit → compose.

<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, Audio, Compose.

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

> Some stages (Crop, Rotate, Mirror, Grid Split, Panorama viewports) **have no Run button** — they work entirely in your browser and update instantly as you adjust them.

### 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 and restored when you reload the workflow.

***

## 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

* [generate.md](/guides/generate) — generators (text / image / video / audio)
* [image-tools.md](/guides/image-tools) — crop, rotate, mirror, inpaint, erase, cutout, upscale, outpaint, grid split, variations, multi-angle
* [compose.md](/guides/compose) — Image Picker, A/B compare
