# 🎬 DP Thumbnail Server

**Preview thumbnails for ALL vMix inputs — zero configuration.**

Companion tool for [Directors Plan](https://adelvo.io/directors-plan). Works with every input type: Video, NDI, Camera, PowerPoint, Overlay, Xaml, and more.

## Quick Start

1. **Download** from [adelvo.io/directors-plan](https://adelvo.io/directors-plan/#thumbnail-server)
2. **Install ffmpeg**: `winget install ffmpeg` (recommended — resizes to 320×180 for fast loading)
3. **Double-click** `start.bat` — browser opens automatically
4. **Click** "Generate All" — done!

## How It Works

Uses the vMix `SnapshotInput` API to capture preview images of every input. If ffmpeg is installed, thumbnails are resized to 320×180 (~5–15 KB each). Without ffmpeg the server still works, but serves full-resolution snapshots (~200–500 KB each) which is noticeably slower with many inputs.

**ffmpeg is strongly recommended** — install with `winget install ffmpeg` or download from [ffmpeg.org](https://ffmpeg.org/download.html).

## API Endpoints

| Endpoint | Description |
|---|---|
| `GET /{number}.jpg` | Thumbnail by input number |
| `GET /key/{uuid}.jpg` | Thumbnail by input key (stable, recommended) |
| `GET /regen` | Regenerate all thumbnails |
| `GET /regen/{number}` | Regenerate single thumbnail |
| `GET /thumbnails` | JSON with base64 data |
| `GET /settings` | GET/POST server configuration |
| `GET /autorefresh` | POST to toggle auto-refresh |

## For Directors Plan

In DP Settings → Thumbnail Server: `http://vmix-machine-ip:8098`

Use `/key/{uuid}.jpg` for stable thumbnails that survive input reordering.

## CLI Options

```
dp-thumbnail-server.exe [port] [vmix-host] [vmix-port]
```

Defaults: port 8098, vMix localhost:8088. Host/port also configurable in web UI.


## License

MIT — Copyright (c) 2026 [Adelvo Inc.](https://adelvo.io)

---

**[Directors Plan](https://adelvo.io/directors-plan)** — Professional vMix Control & Automation
