SPOOL

SPOOL

Your household's own Trakt — movies, TV & anime, tracked on a server you own. Self-hosted, Docker Compose, five containers, running in minutes.

Get started View on GitHub
Spool dashboard showing streak, up next, watching, and watchlist rows

Everything a household tracker needs

No accounts to pay for, no data leaving your own server.

📊

Dashboard

Continue watching, up next, watchlist, and personalized recommendations — one page, no digging.

🎬

Movies & TV / Anime

Trending, popular, upcoming, and top rated — live from TMDB, with trailers, media galleries, and Watching/Watchlist/History tabs.

📅

Calendar

New episodes, season premieres, and movie releases synced nightly for anything you're tracking.

📋

Lists

Shared and private lists, plus "Surprise me" to jump to a random title from your watchlist.

📈

Stats

Watch streaks, genre/year breakdown, an activity heatmap, achievement badges, and taste compatibility with other profiles.

🎁

Recommend to a housemate

Send a title to another profile — including as an anonymous "mystery" recommendation.

🎌

Anime enrichment

Score, studio, source, and filler/recap badges from MyAnimeList, with automatic season-numbering reconciliation against TMDB.

📰

Household activity feed

A day-grouped timeline of everyone's watches, binges, and list activity, with a leaderboard.

🔄

Trakt / Simkl / Nuvio sync

OAuth or email/password connect with a daily background sync, or import a CSV export with column-mapping and a preview step.

🔐

Two-factor authentication

TOTP via any authenticator app, QR or manual setup, and one-time backup codes.

🔌

Scrobble & Reports API

A generic webhook for any player or script, plus a read-only API for external tools like spool-wrapped.

👥

Multiple profiles

Every household member gets their own history, lists, and stats on one shared instance.

🐳

Docker Compose

Five containers — app, worker, scheduler, Postgres, Redis. One command to run it all.

See it running

Real renders against seeded demo data — nothing mocked up.

Movies & TV trending grid
Movies & TV — trending, live from TMDB
Title detail page with cast and lists
Title detail — cast, lists, recommend to a housemate
Stats page with streaks and genre breakdown
Stats — streaks, genre breakdown, watch time
Calendar page with upcoming releases
Calendar — episodes, premieres, movie releases

Quick start

The whole install — no separate app-server setup.

git clone https://github.com/aljaz-h/spool-tracker.git
cd spool-tracker
./setup.sh   # or .\setup.ps1 on Windows

Writes a working .env (random secret key + DB password, prompts for your hostname) and brings the stack up. See the Quick start guide for manual configuration, Trakt/Simkl setup, and deploying without cloning the repo.