TvT Documentation

A tour of TvT: profiles and kid mode, the library and search, the player and everything around it, and every admin page from Video Locations to Advanced.

Installing TvT on Windows: the installer and its two options, the first start and the firewall question, starting and stopping, reaching TvT from other devices, where the data lives, updating, and removing it.

Installing TvT on Debian, Ubuntu and their relatives: the package, starting it by hand and as a systemd service, other devices on your network, where the data lives, hardware encoding, updating, and removing it.

Installing the Docker version of TvT: loading the image, the run command on Windows, macOS, Linux, unraid and Synology, Docker Compose, the first run, other devices on your network, hardware encoding, and updating.

Video Locations in full: adding watch folders, the folder browser, every automation switch and its gear, the row menu, Upload videos, and transcode destinations.

The Manage Videos page in full: columns, sort, renaming, thumbnails, skip points, the actions menu and its customization, bulk selection, the bulk bar, and select all matching.

Categories, groups, genres, and tags in TvT: what each is for, creating and renaming them, adding videos, drag order at both levels, and Organize with AI up to the review step.

Search as you type, then the Filters panel: labels, Unassigned, folder location, thumbnail, kid friendly, length, and Combine, on the home page and on Manage Videos.

Captions and audio tracks in TvT: the player menu, renaming audio tracks and picking a default, and adding captions from the source, from Whisper, from a file, or by hand.

The Backup and Restore page: what a backup holds, creating one, the automatic schedule, download and upload, the restore confirmation and the safety backup, and delete.

The AI Settings page: Ollama and vLLM on your own hardware, OpenRouter, Claude, and OpenAI with your own key, Test connection and models, TheMovieDB key, and the Whisper models and OCR packs.

How profiles work in TvT: adding one, the picture, Kid profile, the daily time limit, Administrator, and what a Kids profile sees.

The System Activity page in full: the history of background work, the attention banner, cleanup, search and filters, row details and menus, runs, bulk actions, the settings panel, reset, and pause.

The Advanced page: the live application log with text and level filters, pause and follow, downloading the logs, and Terminate application with its confirmation.

The editor in TvT: select a range and cut it, fix its volume, brightness, or contrast, move and resize edits, insert video and audio, export a clip, apply, and restore the original.

The Customize Design page: the CSS and JS tabs, the live preview and its pages, snippets scoped to everyone or one profile, Run in preview, and Save, Discard, and Reset.