Module guide

Modules

Tater Tube keeps media, games, PC streaming, and local playback in separate focused modules. The main menu can show a matching Tater mascot for each one.

The Tube

Connect to Tater Tube Server for Tube TV channels, Newznab Stream discovery, local movie and TV libraries, music, resume history, and server-side transcoding.

Tube TVStream + LocalServer

Over The Air

Direct HDHomeRun playback with no guide screen. Pick OTA and it tunes like an old TV, with up/down channel changes and a channel OSD.

HDHomeRunLive TVOld-TV OSD

Video on Demand

Browse Emby, Jellyfin, or Plex libraries from a VCR-style interface with resume playback, TV Mode, editable custom channels, no-repeat local commercials, and optional mid-roll breaks.

Emby/JellyfinMid-RollCustom Channels

Public Access

Save public YouTube playlists, browse videos from the couch, and run TV Mode with shuffled playlist channels and no-repeat local commercial categories.

YouTube Playlistsyt-dlpCommercials

Tape Deck

A cassette-deck music player for Tater Tube Server, Emby/Jellyfin, or Plex albums, complete with album-as-tape browsing, audio-reactive VU visuals, and tape-style fast-forward.

Server MusicAlbumsVU Meter

Game Center

Browse RetroNAS/MiSTer ROM shares and launch supported systems straight into RetroArch without exposing the RetroArch menu.

RetroNASRetroArchControllers

PC Link

Pair with Sunshine through Moonlight, list host apps, and stream a stable Pi profile from a PC or Mac into the Tater Tube appliance.

SunshineMoonlightGame Streaming

Local Files

Browse local folders on the Pi and play common video files or playlists with loop and shuffle options.

Local VideoM3UShuffle
TV Mode

Three ways to turn a library into channels.

Each TV Mode keeps the same channel-up, channel-down, VCR overlay, and commercial-break feel while using the source that best fits the module.

Tube TV

Tater Tube Server plans one shared timeline for every paired player. It creates category channels, honors custom channel numbers, inserts server-hosted commercials, and keeps every box tuned to the same point in the schedule.

Server ScheduledShared ChannelsGuide CH 999

VoD TV Mode

Turn Plex, Emby, or Jellyfin movies and series into automatic or custom channels. Playback stays local to that Tater Tube box and supports selected commercial categories and optional mid-rolls.

Plex/Emby/JellyfinCustom ChannelsMid-Roll

Public Access TV Mode

Turn saved YouTube playlists into shuffled public-access channels and mix in selected local commercial categories between videos.

YouTubePlaylist ChannelsCommercials
Tube TV dial

A complete little cable system inside The Tube.

Custom channel 01 appears only when it is explicitly created. Automatic channels begin at 02, TaterText occupies the high channel pages, and the continuously scrolling Tater Guide lives on channel 999.

CH 01Optional custom channel
CH 02+Custom + automatic channels
100-888TaterText pages
CH 999Scrolling Tater Guide
Shared controls

Remote, controller, keyboard, and API control use one app shell.

The Pi image includes Argon IR defaults, Bluetooth controller pairing, a controller mapper, media keys, mpv OSD overlays, and a local HTTP API for companion apps.

Argon IR Bluetooth gamepads USB controllers HTTP API
Tater mascot holding a game controller
Controllers can navigate Tater Tube and map into RetroArch cores.