chadMueller / Nostalgex
git clone https://github.com/chadMueller/Nostalgex.git
v1.0.26 · 6d ago
Retro cable TV guide for your Plex, Jellyfin or Emby library. Native Apple TV app + web tuner.
—
stars, 24h
—
stars, 7 days
+130
stars, 30 days · #1,801
130
★ total
5
forks · 0 open issues
Star history starts 2026-10-20; the chart appears after the second daily snapshot.
LanguageSwift
LicenseMIT
Created2026-09-28 (22d ago)
Last pushtoday
Watchers0
OwnerUser
GitHub topics
Links
- GitHub: github.com/chadMueller/Nostalgex
- Homepage: https://www.nostalgex.app
- Releases · Issues · Hacker News mentions
README excerpt
# Nostalgex **Retro TV for your own movie and show library.** Free and open source, for Plex, Jellyfin and Emby. Nostalgex turns your library into 130+ channels in 14 bundles, plus a channel for every film series you own, with a real channel guide. Every channel plays on a set daily schedule, so tuning in feels like live TV. No account to make, and it never supplies any media of its own. ## Pick your way to watch | | Apple TV app | Web tuner | Docker container | |---|---|---|---| | **What it is** | An app for your TV and Siri Remote | Nostalgex in your browser | The web tuner, running on a computer at home | | **Best for** | Watching on a TV | Trying it right now, on a laptop or phone | Jellyfin or Emby setups the web tuner can't reach | | **Works with** | Plex, Jellyfin, Emby | Plex, Jellyfin, Emby | Plex, Jellyfin, Emby | | **Get it** | | Open the web tuner | Docker container guide | All three are free. Not sure? Use the app on a TV and the web tuner everywhere else. ## Apple TV app The best way to watch on a TV. Connect one or more servers, then flip channels with the Siri Remote. Needs tvOS 18 or later. **Quick start:** install Nostalgex from the App Store, connect your server, pick a channel. ## Web tuner Nothing to install. Works on computers and phones. **Quick start:** open nostalgex.app/web-tuner and sign in to your server. Plex just works. Jellyfin and Emby need a secure (https) address; if yours doesn't have one, use the Docker container instead. ## Docker container The same web tuner, packaged as a Docker container that runs on a computer at home, so it can reach servers the website can't. Most Plex users don't need it. **Quick start:** [code] Then open `http://YOUR-SERVER-IP:8080`. Step by step help is in the Docker container guide. **Latest: `tuner-v1.0.3`.** Holiday channels (MISTLETOE, CHRISTMAS SPECIALS, KIDS CHRISTMAS TV, TURKEY DAY), no more burned-in subtitles on Jellyfin and Emby, and the version shows at the bottom of Settings. Release notes. Already running it? `docker compose pull && docker compose up -d`. ## What's new in 1.0.26 The App Store went straight from 1.0.23 to 1.0.26, so this rolls up 1.0.24, 1.0.25 and 1.0.26. Full release notes - **The Docker container launched** as `tuner-v1.0.0`. It's on `tuner-v1.0.3` now. - **Emby is officially supported.** Thank you to the Emby community for all the logs and testing. - **Franchises.** Each film series in your library (Star Wars, Rocky, whatever you own) gets its own channel and its own switch in Settings. Server collections land in FRANCHISES or OTHER COLLECTIONS. NOTABLE STARS is retired. - **iCloud sync** (Settings > CONNECTION). Every Apple TV on your Apple ID shares the same lineup and settings. Off by default, and server logins never leave the device. - **REPORT PLAYBACK.** Shows what you're watching in your server's Now Playing and marks a film watched once you've seen most of it, without flooding Continue Watching. - **Phone web tuner.** Full width video, the gu