Overview

Yamtrack is a self-hosted tracker for everything you watch, read and play: films, TV shows, anime, manga, video games, books, comics and board games in a single library. Rather than one app per medium, you record a score, a status, start and end dates, and a note against each title, and Yamtrack keeps a history of when you added it, started it and finished it.

What it is not matters just as much: it stores metadata and your own progress, never the media itself — nothing is streamed or downloaded, and a title the catalogues do not know has to be added by hand as a custom entry. It is built for a household rather than a single person: every account tracks separately, lists can be shared and worked on together, and the whole thing runs as one container with Redis alongside it.

Key Features

• Nine media types in one tracker: films, TV, anime, manga, games, books, comics and board games, each with its own detail page and progress rules.
• Per-season and per-episode tracking: mark a whole show at once, or work through seasons and individual episodes.
• Rich records: score, status, progress, repeats (rewatches, rereads), start and end dates and a free-text note on every item.
• History: every change is logged, so you can see when a title was added, started, dropped or picked up again.
• Custom entries: add niche media that the supported APIs cannot find.
• Collaborative lists: group titles for any purpose and invite other accounts to contribute.
• Calendar with an iCalendar feed: upcoming releases in the app, subscribable from any calendar client through a .ics URL.
• Release notifications: Apprise covers Discord, Telegram, ntfy, Slack, email and more.
• Multi-user with flexible sign-in: separate accounts with their own tracking, OIDC and over a hundred social providers via django-allauth.
• Library integrations: Jellyfin, Plex and Emby plug in so what you watch is tracked automatically.
• Imports: Trakt, Simkl, MyAnimeList, AniList and Kitsu, with support for periodic automatic imports; CSV export and re-import for everything you track.

Why Use Yamtrack

The reason to run it is ownership: your watching and reading history lives in your own database instead of a streaming service’s account page, and it survives when a service closes or you move platform. Because every medium is in the same place, one search answers “have I already read, played or watched this?”, and the calendar pulls releases from all of them into one feed. Multi-user accounts and shared lists make it work for a household or a club rather than one person’s spreadsheet.

Typical Uses

• Replacing scattered spreadsheets and notes files with a single library.
• Keeping anime, manga and games next to films and books instead of in separate apps.
• Sharing a watchlist with a partner, or a reading list with a book club.
• Following upcoming releases through the calendar subscription rather than checking several sites.
• Mirroring what Jellyfin, Plex or Emby says you watched into a permanent record.

Getting Started

Yamtrack runs from a Compose file with two services: the application image ghcr.io/fuzzygrim/yamtrack and the Redis container it depends on. The app publishes port 8000, keeps its database in ./db mounted at /yamtrack/db, and needs a TZ and a SECRET value, with REDIS_URL pointing at the sidecar. SQLite is the default store and PostgreSQL is supported for larger installs. The current release is v0.26.3, and a public demo runs at yamtrack.fuzzygrim.com with demo as both username and password.