Episodes
Self-hosted TV show episode tracker allowing you to keep track of your favourite TV shows either continuing or ending.
Platform availability
Available on 1 of 10 platforms
- Unraid
- TrueNAS (not listed)
- Umbrel (not listed)
- ZimaOS (not listed)
- Proxmox (not listed)
- Helm (not listed)
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server (not listed)
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
59/100 Fair
- Maintained
- 84last commit 23 days ago
- Popular
- 2415 GitHub stars
- Easy to install
- 351 install platform, install notes, Docker image
- Light to run
- 501.5 GB minimum RAM
- Security check
- 85no serious findings, CI
Availability: platform listings confirmed today, links checked 29 days ago
- GitHub stars
- 15
- Open issues
- 3
- Last commit
- 2026-10-29
- License
- MIT
- Activity
- declining
Checked 9 days ago - source: GitHub (bryangerlach/Episodes)
Resources & Compatibility
Minimum requirements: 1.5 GB RAM, 16 GB disk. ARM (e.g. Raspberry Pi) is not supported.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- Android companion app An Android companion app (a simple webview) is available from the bryangerlach/episodes_android releases page; on first open, enter your Episodes server URL and make sure it ends with a trailing '/' (e.g. https://example.com/). source
Fetched 39 days ago - each note links to its source
Variants
Alternatives
No alternatives collected yet.
Common questions
Which port should I change when running Episodes with Docker Compose?
Change only the host side of the port mapping unless you know what you are doing. For example, if you want to access it from port 8080, map it as 8080:3000.
How do I configure CSRF_TRUSTED_ORIGINS for access from a browser or reverse proxy?
Set CSRF_TRUSTED_ORIGINS to the origins where you will access the server. You can list multiple origins separated by spaces, such as your local host and public domain.
How does the Android app connect to Episodes?
Open the simple webview Android app and enter your server URL when it opens. The URL must end with a slash.
Can Episodes mark episodes watched automatically from Jellyfin?
Yes. Install the official Jellyfin Webhook plugin, point it to the Episodes webhook endpoint with your exact user profile name, and select Playback Stop. Jellyfin will push a notification when an episode finishes playing.
How do I delay shows in Watch Next for streaming release timing?
Set a Watch Delay on a show to make it appear in Watch Next a chosen number of days after release. If the show arrives on streaming one day after the normal release, set the delay to 1.
Answers sourced from github.com
Community
- simple selfhosted solution to listen to offline Podcast episodes - Reddit (reddit)
- r/selfhosted on Reddit: Introducing The Self-Host Cast, a podcast ... (reddit)
Collected 53 days ago - public community threads