linearr

Docker app from gillberg1111's Repository

Overview

Linearr — the missing show sequencer for Plex, Jellyfin, and Emby. Automated round-robin rotation and chronological crossover alignment for your episodes (and their movies). Configure Plex, Jellyfin, Emby, or any combination. With multiple backends configured, new playlists get per-backend checkboxes; targeted servers are mirrored independently using each server's own library state. Two sort modes per playlist: - Rotation: round-robin across shows (Show A S01E01, Show B S01E01, Show A S01E02, ...). - Air Date: chronological across every show. Multi-part crossovers stay aligned via "Part 1" / "Pt. 2" / "(N)" title parsing — perfect for "evening TV" mixes of the three Law and Order series, the Chicago shows, etc. Pick season ranges per show, opt in to specials, optionally include associated movies (auto-detected from your movie libraries by title match — e.g. "Psych: The Movie" attaches to Psych). Optional "Unwatched only" filter excludes episodes you've already watched. Live AJAX preview means every change updates the episode list immediately — no page reloads. Flip any playlist between sort modes or toggle the unwatched filter any time; already-watched episodes stay put, the future portion rebuilds. Edits show up as native playlists in every client (Plex AND Jellyfin). Background scheduler prunes watched episodes (keeping the last few around if you fell asleep). Safety: this app NEVER deletes media files or library items from Plex or Jellyfin — only playlists.

Runtime arguments

Web UI: http://[IP]:[PORT:5005]/
Network: bridge
Shell: sh
Privileged: false

Template configuration

WebUI PortPorttcp

Port for the rotator web UI.

Target: 5005
Default: 5005
Value: 5005

AppdataPathrw

Persistent state (SQLite DB + stable device id).

Target: /data
Default: /mnt/user/appdata/linearr
Value: /mnt/user/appdata/linearr

PLEX_URLVariable

Plex server URL (use the LAN IP, not plex.tv). Leave blank to disable Plex. Example: http://192.168.1.100:32400

PLEX_TOKENVariable

X-Plex-Token. See https://support.plex.tv/articles/204059436-finding-an-authentication-token-x-plex-token/ Leave blank to disable Plex.

JELLYFIN_URLVariable

Jellyfin server URL (LAN IP). Example: http://192.168.1.100:8096 Leave blank to disable Jellyfin.

JELLYFIN_USERNAMEVariable

Jellyfin username. (Linearr authenticates as a user because the API-key path is broken on the playlist endpoints we need.) Leave blank to disable Jellyfin.

JELLYFIN_PASSWORDVariable

Jellyfin password. Held in memory only; the resulting access token is never written to disk. Leave blank to disable Jellyfin.

EMBY_URLVariable

Emby server URL (LAN IP). Example: http://192.168.1.100:8096 Leave blank to disable Emby.

EMBY_API_KEYVariable

Emby API key. Create one in Emby Dashboard → Advanced → API Keys. Leave blank to disable Emby.

EMBY_USERNAMEVariable

Emby username (optional). Determines which user owns managed playlists. Leave blank to disable Emby.

WATCHED_KEEPVariable

How many recently-watched episodes to leave in each playlist as a fall-asleep buffer. Older watched episodes are pruned.

Default: 2
Value: 2

PRUNE_INTERVAL_MINUTESVariable

How often the background prune + auto-sync sweep runs, in minutes.

Default: 10
Value: 10

FRANCHISE_REFRESH_DAYSVariable

How often franchise definitions are refreshed from upstream sources, in days (default 7 = weekly).

Default: 7
Value: 7

AUTO_SYNCVariable

When true (default), the scheduler also splices newly-aired episodes and new seasons into managed playlists every PRUNE_INTERVAL_MINUTES. Set false to lock playlists until you edit them manually.

Default: true
Value: true

TV_LIBRARIESVariable

Comma-separated TV library names to source shows from (e.g. 'TV Shows,Dropout TV'). Leave blank for all TV libraries on every configured backend.

FLASK_SECRETVariable

Optional. Random string for Flask session cookies. Generate with: openssl rand -hex 32

Links

Template Support Registry Project

Details

Repository

ghcr.io/gillberg1111/linearr:latest

Registry

https://github.com/gillberg1111/linearr

Last Updated2026-06-01

First Seen2026-05-24

Run Linearr on Unraid.

Linearr is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.

Explore Unraid OS