Episodes

Self-hosted TV show episode tracker allowing you to keep track of your favourite TV shows either continuing or ending.

  • Media Applications
  • Media Servers
  • Other
  • Productivity
  • Tools & Utilities
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

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

Collected 53 days ago - public community threads