Skip to content
dvnklnPublic

About

Self-hosted tracker for movies, series, anime and games – made for tracking together on the couch.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

160 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

hdtracker

Version Docker image Checks License: AGPL-3.0

Self-hosted tracker for movies, series, anime and games – made for tracking together on the couch.

hdtracker on a desktop screen and two phones

📖 Documentation

The guides live in the wiki:

What changed in each version: Changelog. What's planned: Roadmap.

✨ Features

  • 🎬 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.

📱 Screenshots

Dashboard Library Search
Dashboard Anime library Search
Details & where to watch Episodes (spoiler protection) What runs where
Detail page Episodes What runs where

🎨 Themes

The same page in nine themes, side by side

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.

🐳 Quick start

  1. Create a folder and download the two files hdtracker needs – the docker-compose.yml and 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
  2. Open .env and fill it in: a random SECRET, your API keys for TMDB and IGDB, your time zone and ORIGIN – exactly the address you open the app with, e.g. http://192.168.1.50:3000. The file explains every line.

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

🙏 Data sources

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.

🤖 Built with AI

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.

📜 License

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.

About

Self-hosted tracker for movies, series, anime and games – made for tracking together on the couch.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages