FuzzyGrim/Yamtrack

A self hosted media tracker.

Python

3,705

2,736 commits

updated Oct 14, 2026

See the code

README

Yamtrack

App Tests Docker Image CodeFactor Codecov GitHub

Yamtrack is a self hosted media tracker for movies, tv shows, anime, manga, video games, books, comics, and board games.

πŸ“š Documentation

The full documentation is available at fuzzygrim.github.io/Yamtrack.

πŸš€ Demo

You can try the app at yamtrack.fuzzygrim.com using the username demo and password demo.

✨ Features

  • 🎬 Track movies, tv shows, anime, manga, games, books, comics, and board games.
  • πŸ“Ί Track each season of a tv show individually and episodes watched.
  • ⭐ Save score, status, progress, repeats (rewatches, rereads...), start and end dates, or write a note.
  • πŸ“ˆ Keep a tracking history with each action with a media, such as when you added it, when you started it, when you started watching it again, etc.
  • ✏️ Create custom media entries, for niche media that cannot be found by the supported APIs.
  • πŸ“‚ Create personal lists to organize your media for any purpose, add other members to collaborate on your lists.
  • πŸ“… Keep up with your upcoming media with a calendar, which can be subscribed to in external applications using a iCalendar (.ics) URL.
  • πŸ”” Receive notifications of upcoming releases via Apprise (supports Discord, Telegram, ntfy, Slack, email, and many more).
  • 🐳 Easy deployment with Docker via docker-compose with SQLite or PostgreSQL.
  • πŸ‘₯ Multi-users functionality allowing individual accounts with personalized tracking.
  • πŸ”‘ Flexible authentication options including OIDC and 100+ social providers (Google, GitHub, Discord, etc.) via django-allauth.
  • πŸ¦€ Integration with Jellyfin, Plex and Emby to automatically track new media watched.
  • πŸ“₯ Import from Trakt, Simkl, MyAnimeList, AniList and Kitsu with support for periodic automatic imports.
  • πŸ“Š Export all your tracked media to a CSV file and import it back.

πŸ“± Screenshots

HomepageCalendar
Homepagecalendar
Media List GridMedia List Table
List GridList Table
Media DetailsTracking
Media DetailsTracking
Season DetailsTracking Episodes
Season DetailsTracking Episodes
ListsStatistics
ListsStatistics
Create Manual EntriesImport Data
Create Manual EntriesImport Data

🐳 Installing with Docker

Download the default docker-compose.yml file from the repository, update the environment values, and start Yamtrack:

docker compose up -d

The default Compose file uses SQLite, which is enough for most personal installs. For full SQLite, PostgreSQL, and reverse proxy setup instructions, see the Setup documentation.

πŸ’» Development

Development instructions are available in the Development documentation.

πŸ’ͺ Support the Project

There are many ways you can support Yamtrack's development:

⭐ Star the Project

The simplest way to show your support is to star the repository on GitHub. It helps increase visibility and shows appreciation for the work.

πŸ› Bug Reports

Found a bug? Open an issue on GitHub with detailed steps to reproduce it. Quality bug reports are incredibly valuable for improving stability.

πŸ’‘ Feature Suggestions

Have ideas for new features? Share them through GitHub issues. Your feedback helps shape the future of Yamtrack.

πŸ§ͺ Contributing

Pull requests are welcome! Whether it's fixing typos, improving documentation, or adding new features, your contributions help make Yamtrack better for everyone.

β˜• Donate

If you'd like to support the project financially:

ko-fi

django
docker
docker-compose
media-tracker
postgresql
self-hosted
sqlite
tailwindcss

FuzzyGrim/Yamtrack

A self hosted media tracker.

Python

3,705

2,736 commits

updated Oct 14, 2026

See the code

README

Yamtrack

App Tests Docker Image CodeFactor Codecov GitHub

Yamtrack is a self hosted media tracker for movies, tv shows, anime, manga, video games, books, comics, and board games.

πŸ“š Documentation

The full documentation is available at fuzzygrim.github.io/Yamtrack.

πŸš€ Demo

You can try the app at yamtrack.fuzzygrim.com using the username demo and password demo.

✨ Features

  • 🎬 Track movies, tv shows, anime, manga, games, books, comics, and board games.
  • πŸ“Ί Track each season of a tv show individually and episodes watched.
  • ⭐ Save score, status, progress, repeats (rewatches, rereads...), start and end dates, or write a note.
  • πŸ“ˆ Keep a tracking history with each action with a media, such as when you added it, when you started it, when you started watching it again, etc.
  • ✏️ Create custom media entries, for niche media that cannot be found by the supported APIs.
  • πŸ“‚ Create personal lists to organize your media for any purpose, add other members to collaborate on your lists.
  • πŸ“… Keep up with your upcoming media with a calendar, which can be subscribed to in external applications using a iCalendar (.ics) URL.
  • πŸ”” Receive notifications of upcoming releases via Apprise (supports Discord, Telegram, ntfy, Slack, email, and many more).
  • 🐳 Easy deployment with Docker via docker-compose with SQLite or PostgreSQL.
  • πŸ‘₯ Multi-users functionality allowing individual accounts with personalized tracking.
  • πŸ”‘ Flexible authentication options including OIDC and 100+ social providers (Google, GitHub, Discord, etc.) via django-allauth.
  • πŸ¦€ Integration with Jellyfin, Plex and Emby to automatically track new media watched.
  • πŸ“₯ Import from Trakt, Simkl, MyAnimeList, AniList and Kitsu with support for periodic automatic imports.
  • πŸ“Š Export all your tracked media to a CSV file and import it back.

πŸ“± Screenshots

HomepageCalendar
Homepagecalendar
Media List GridMedia List Table
List GridList Table
Media DetailsTracking
Media DetailsTracking
Season DetailsTracking Episodes
Season DetailsTracking Episodes
ListsStatistics
ListsStatistics
Create Manual EntriesImport Data
Create Manual EntriesImport Data

🐳 Installing with Docker

Download the default docker-compose.yml file from the repository, update the environment values, and start Yamtrack:

docker compose up -d

The default Compose file uses SQLite, which is enough for most personal installs. For full SQLite, PostgreSQL, and reverse proxy setup instructions, see the Setup documentation.

πŸ’» Development

Development instructions are available in the Development documentation.

πŸ’ͺ Support the Project

There are many ways you can support Yamtrack's development:

⭐ Star the Project

The simplest way to show your support is to star the repository on GitHub. It helps increase visibility and shows appreciation for the work.

πŸ› Bug Reports

Found a bug? Open an issue on GitHub with detailed steps to reproduce it. Quality bug reports are incredibly valuable for improving stability.

πŸ’‘ Feature Suggestions

Have ideas for new features? Share them through GitHub issues. Your feedback helps shape the future of Yamtrack.

πŸ§ͺ Contributing

Pull requests are welcome! Whether it's fixing typos, improving documentation, or adding new features, your contributions help make Yamtrack better for everyone.

β˜• Donate

If you'd like to support the project financially:

ko-fi

django
docker
docker-compose
media-tracker
postgresql
self-hosted
sqlite
tailwindcss

Significant stargazers

(top 24 of 43)

Jan-Erik Rediger

1,035 followers Β· starred Jan 2026

Rob Loach

570 followers Β· starred Apr 2026

Daniel Tschinder

491 followers Β· starred Feb 2026

Jakub Kuczys

128 followers Β· starred Sep 2026