# Episodes

Episodes is a self-hosted media applications app. Self-hosted TV show episode tracker allowing you to keep track of your favourite TV shows either continuing or ending. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/2252/episodes

## Description

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.

## Health score

59/100 (Fair), based on 5 of 5 factors.
- Maintained: 84 (last commit 23 days ago)
- Popular: 24 (15 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 50 (1.5 GB minimum RAM)
- Security check: 85 (no serious findings, CI)

## Links

- Docker Hub: https://hub.docker.com/r/bryangerlach/episodes
- GitHub: https://github.com/bryangerlach/Episodes
- Unraid: https://ca.unraid.net/apps/episodes-189rzoc18nxf0o?q=Episodes

## 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.

---
Source: Our Local Host (https://ourlocalhost.com/app/2252/episodes), the self-hosted and open-source app directory.
