Start here

Setup

Tater Tube is intended to run as an appliance image. Flash first, then configure modules from Settings inside the app.

1. Download

Open the latest GitHub release and choose the NTSC, PAL, or Pi 5 HDMI image for your display.

2. Flash

Use Raspberry Pi Imager, Balena Etcher, or dd to write the `.img.xz` to an SD card.

3. Boot

Connect the display, audio, remote receiver, and network, then boot directly into Tater Tube.

Normal update path

Existing images update from inside Tater Tube.

Use Settings, System, Check For Updates. The updater refreshes the app, helpers, runtime packages, RetroArch cores, Moonlight, Bluetooth support, boot splash, IR, fan control, and display setup.

SSH update fallback

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

Tater Tube boot screen — The image boots into Tater Tube and keeps SSH available for recovery.