Tater Tube

Install Guide

Tater Tube is meant to run from a ready-to-flash Raspberry Pi appliance image.

Choose An Image

  • Pi 4 NTSC Composite for North American and Japanese CRTs.
  • Pi 4 PAL Composite for PAL CRTs.
  • Pi 5 HDMI Auto for modern HDMI displays.

Download the latest image from the Images page or the latest GitHub release.

Flash The SD Card

Use Raspberry Pi Imager, Balena Etcher, or another image-writing tool to flash the .img.xz file to an SD card.

After flashing:

  • Connect the Pi to the intended display.
  • Connect network.
  • Connect audio.
  • Connect the Argon IR receiver or a keyboard/controller for first setup.
  • Boot the Pi.

Tater Tube starts automatically.

First Setup

Open Settings inside Tater Tube and configure the modules you want:

  • Appearance for theme, highlight color, mascot art, and clock.
  • Features for enabling or hiding modules.
  • System for updates, SSH, fan control, sleep timer, and clock.
  • Gamepad for Bluetooth pairing and controller mapping.

Media Setup

Video on Demand supports Emby, Jellyfin, and Plex.

Tape Deck uses Emby, Jellyfin, or Plex music libraries.

Public Access uses public YouTube playlist IDs or playlist URLs.

Over The Air uses HDHomeRun discovery or a configured device address.

Game Center uses a RetroNAS/MiSTer-style ROM share.

PC Link uses Sunshine on the host and Moonlight on the Pi.

Usenet uses a Newznab provider and a compatible stream endpoint.

Updates

Use:

Settings -> System -> Check For Updates

For SSH recovery, use the release installer:

bash <(curl -fsSL https://github.com/TaterTotterson/Tater-Tube/releases/latest/download/install.sh)

Local API

Check status:

curl http://tatertube.local:24024/api/v1/status

Search:

curl -sS http://tatertube.local:24024/api/v1/library/search \
  -H 'Content-Type: application/json' \
  -d '{"query":"batman","types":["movie","show","game"],"limit":10}'

Launch:

curl -sS http://tatertube.local:24024/api/v1/library/launch \
  -H 'Content-Type: application/json' \
  -d '{"id":"vod:movie:ITEM_ID"}'

If API auth is enabled, send Authorization: Bearer <token> or X-TaterTube-Token: <token>.

Recovery

SSH is enabled by default on the appliance image so the device can be debugged without reflashing.

Useful checks:

journalctl -u tatertube -b
sudo systemctl restart tatertube