Skip to content

Quick Start

Zach Hubbard edited this page Oct 13, 2026 · 2 revisions

Quick Start

Your first channel

  1. Install and open RerunTV (see Installation) and work through the first-run setup.
  2. In Channel Setup, open the LINEUP tab and click + ADD CHANNEL.
  3. Click ADD FOLDER and pick a folder of videos from your own library. The app scans it and reads each file's length. This takes a moment on a large folder.
  4. Repeat for more channels (or ADD FOLDER again to merge more folders into one channel). Click a channel's name or number to rename or renumber it.
  5. Click START WATCHING (bottom right).

You are now surfing live TV: the picture you land on is where the channel would be if its folder had been looping since you created it. Press S any time to go back to setup.

Things to try first

Key What it does
↑ / ↓ Change channel
G Open the program guide
T Time machine: rewind or fast-forward (enable it in Box Settings first)
C Toggle the CRT effect
? Open the TV menu
H Hide or show the hint bar

All keys are listed on Keyboard Controls.

No media handy? Use the demo library

RerunTV ships no video, so there is a generated demo lineup (five channels of synthetic test video and tones, nothing copyrighted).

Easiest: download RerunTV-demo-library.zip from the latest release, unzip it somewhere permanent, and add each folder as a channel (the zip has a README.txt with the steps).

Or generate it yourself from a source checkout. You need ffmpeg on your PATH.

npm install
node scripts/make-demo-library.js demo-library

Then in the app open Channel Setup, add a channel per folder under demo-library/, and press Start Watching. Pass --seconds 60 for shorter clips that generate faster, and --config <userDataFolder> to also write a ready-made channel lineup. That lineup also turns off the channel-change static and CRT flicker.

Where next

Clone this wiki locally