Self-hosted tracker for movies, series, anime and games – made for tracking together on the couch.
The guides live in the wiki:
- 🐳 Installation – Docker Compose, the
.envfile, API keys - 🔐 HTTPS and installing as an app – reverse proxy,
ORIGIN, home screen - ⬆️ Updating
- 👥 Users – several accounts on one installation, tracking together
- 💾 Backups and restore
- 📥 Import from Yamtrack
- 📤 Export – your library as a file, compatible with Yamtrack
- 🛡️ Privacy and security – what is sent where, how your data is stored
- 🔑 Reset your password
- 💻 Development – running hdtracker from source
What changed in each version: Changelog. What's planned: Roadmap.
- 🎬 Four separate areas – movies, series, anime and games, each with a library grouped by status (watching, paused, planned, completed, dropped). Don't track games or anime? Hide the areas you don't need.
- 📅 Dashboard – what was released recently and what is coming up: new episodes, new seasons, cinema and home releases, game releases.
- 📺 Episode tracking – tick off single episodes, whole seasons or entire shows; see upcoming episodes and announced seasons with dates, and get told when a new season is announced. Anime get episode titles and images too.
- 🧩 Anime as series – AniList lists every season, movie and OVA on its own; hdtracker stacks what belongs together into one poster, in search and library. Track one season and the others come along.
- 🙈 Spoiler protection – images and descriptions of episodes you have not watched yet are blurred (can be switched off).
- 🍿 Where to watch – streaming, rent and buy offers for your region (via JustWatch), with direct links where possible – one logo per service, no matter how many plans and channels it is listed under. For games: the stores that sell them, one tap away.
- 📡 What runs where – everything you watch or plan to watch, sorted by streaming service: tap Netflix and see what of it is there right now – and where you could rent or buy the rest. Hide the services you never use.
- 🧲 Filters – narrow an area down by genre, by streaming service or by who you track a title with – or all at once. Games also by store and platform.
- 🔎 Quick search – always at the top of the screen; on a computer, press / to start typing.
- 📄 Detail pages – runtime, genres, rating, release dates and similar titles.
- 📥 Import and export – take over your library from Yamtrack including statuses, watched episodes and anime progress, and download it again as a file Yamtrack can read.
- 🔔 Inbox and push notifications – the bell in the app collects what is new for you. On top of that, a message on your phone or computer when a new episode airs or a planned title is released, one by one or as a daily summary. No extra app, no third-party account – or, if you prefer, through Pushover, ntfy or a webhook (Gotify, Apprise, Home Assistant, …).
- 👥 Several users – an admin adds accounts for family or flatmates. Everybody gets a library, a dashboard, settings, notifications and a profile picture of their own; in the app nobody sees what the others track – unless you decide to share a title.
- 🛋️ Track together – invite somebody to a title and share its status and watched episodes from then on: one ticks off the episode, it is done for both. Everybody can go on alone again and keeps the state as a copy.
- 🛠️ Maintenance built in – release dates refresh nightly; optional scheduled database backups you can download; a server overview tells you whether anything needs attention.
- 🎨 Themes – follows your device (dark or light) by default; or pick dark, light, Tokyo Night, Dracula, SynthWave '84, Cyberpunk, Retro 95, Terminal and Breadbin.
- 🔒 Private – runs on your own server, all data in one SQLite file. No tracking, no cloud – what is sent where is documented. Your browser only ever talks to your own server, and repeated wrong passwords block the address they come from – also behind a reverse proxy.
| Dashboard | Library | Search |
|---|---|---|
| Details & where to watch | Episodes (spoiler protection) | What runs where |
|---|---|---|
Dark · Light · Tokyo Night · Retro 95 · Dracula · Cyberpunk · SynthWave '84 · Terminal · Breadbin
Screenshots with a demo library. Posters and data from TMDB, AniList and IGDB.
-
Create a folder and download the two files hdtracker needs – the
docker-compose.ymland a template for your settings, saved as.env:mkdir hdtracker && cd hdtracker curl -fsSLO https://raw.githubusercontent.com/dvnkln/hdtracker/main/docker-compose.yml curl -fsSL -o .env https://raw.githubusercontent.com/dvnkln/hdtracker/main/.env.example
-
Open
.envand fill it in: a randomSECRET, your API keys for TMDB and IGDB, your time zone andORIGIN– exactly the address you open the app with, e.g.http://192.168.1.50:3000. The file explains every line. -
Start it and open that address. On first start you create your account.
docker compose up -d
Where to get the keys and what every setting means: Installation guide.
Movie and series data from TMDB. This product uses the TMDB API but is not endorsed or certified by TMDB. Streaming availability by JustWatch. Game data from IGDB (store logos from Simple Icons, CC0), anime data from AniList; episode titles for anime are matched to TMDB with the community list anibridge-mappings (MIT).
Icons by Lucide, wordmark set in Outfit.
hdtracker is heavily AI-assisted, and I want to be upfront about that. Most of the code was written by Claude Code, Anthropic's AI coding assistant.
My part is the product side: what hdtracker should do, how it should look and feel, and how it should behave – from the layout and hover effects to things like loading data from the different services in parallel. I describe ideas and decisions, review and test every change in a running instance, and decide what goes into a release. The AI turns that into code, tests it and documents it.
If you find a bug or something that looks odd in the code, please open an issue – that helps.
GNU AGPL v3 – you may use, change and share hdtracker freely. If you distribute a modified version or offer it to others over a network, you have to publish your changes under the same license. This is a personal project, provided as-is without support or guarantees; if it's useful to you too, even better.