Open-Source DevOps · FuzzyGrim

Yamtrack

Yamtrack is a self-hosted media tracker for movies, TV shows, anime, manga, games, books, comics, and board games, written in Python with Django. It supports multi-user accounts, integrations with Jellyfin/Plex/Emby, imports from Trakt/MyAnimeList/AniList, and deployment via Docker with SQLite or PostgreSQL.

Talk to DEV.co Discuss Implementation

Source: GitHub — github.com/FuzzyGrim/Yamtrack

GitHub stars

215

Forks

Python

Primary language

AGPL-3.0

License (OSI-approved)

Key facts

Objective fields from the source. Values we can't verify are shown as “Unknown” rather than guessed.

Field	Value
Repository	FuzzyGrim/Yamtrack
Owner	FuzzyGrim
Primary language	Python
License	AGPL-3.0 — OSI-approved
Stars	3k
Forks	215
Open issues	326
Latest release	v0.25.3 (2026-05-25)
Last updated	2026-07-03
Source	https://github.com/FuzzyGrim/Yamtrack

What Yamtrack is

A Django-based web application using Python, PostgreSQL/SQLite, and TailwindCSS frontend, deployed as containerized services via Docker Compose. Supports OAuth/OIDC authentication via django-allauth, iCalendar subscriptions, Apprise notifications, and data import/export workflows.

Quickstart

Get the Yamtrack source

Clone the repository and explore it locally.

terminalbash

1git clone https://github.com/FuzzyGrim/Yamtrack.git2cd Yamtrack3# follow the project's README for install & configuration

Need it deployed, integrated, or customized instead? DEV.co ships production installs.

Best use cases

Personal Media Library Management

Track watched/read/played media across multiple content types with detailed per-season TV tracking, scoring, progress, and personal notes. Ideal for individuals wanting a self-hosted alternative to Trakt or MyAnimeList.

Multi-User Household or Small Community Tracking

Multi-user functionality with individual accounts and collaborative lists enables families or friend groups to organize shared media watchlists and coordinate viewing. OIDC/social auth simplifies onboarding.

Home Media Server Integration

Automatic tracking from Jellyfin, Plex, or Emby integrations eliminates manual logging when media is watched on home servers. Pairs well with existing media server deployments.

Implementation considerations

AGPL-3.0 license: any modifications deployed on a network must have source code made available to users. Confirm compliance requirements before customization.
PostgreSQL recommended for production (SQLite default for personal use); plan database strategy and backups before deployment.
Multi-user auth via django-allauth supports 100+ social providers; configure OIDC or social OAuth in environment variables.
Apprise notification setup requires external service configuration (Discord, Telegram, email, etc.); test notification delivery in staging.
Data imports from Trakt, MyAnimeList, AniList, Kitsu support periodic sync; verify API credentials and rate limits before automation.

When to avoid it — and what to weigh

Requirement for Proprietary/Commercial Use Without Source Disclosure — AGPL-3.0 requires any network-accessible modifications or hosted derivatives to release modified source code. If you need closed-source hosting or modifications, AGPL is incompatible.
Zero-Downtime Enterprise Deployment at Scale — While Docker-composable, Yamtrack is architected for small-to-medium self-hosted instances. No evidence of HA/clustering, load balancing, or enterprise SLA guarantees. Not suitable for large-scale SaaS.
Offline-First or Mobile-Native Application — This is a web application; mobile support is browser-based. No native iOS/Android app or offline sync capability evident from documentation.
Security-Critical or PCI/HIPAA Regulated Environments — No security audit, penetration test results, or compliance certifications documented. Unsuitable for systems requiring regulatory compliance without independent security review.

License & commercial use

AGPL-3.0 (GNU Affero General Public License v3.0): This is a copyleft, network-aware license. It requires that any modified version deployed over a network must make source code available to users. Commercial use is permitted only if you comply with source code disclosure obligations or use the unmodified upstream version.

AGPL-3.0 permits commercial use of the unmodified software under the license terms (source code transparency required). However, any commercial hosted service or modified deployment must offer source code to users. Proprietary forks or closed-source SaaS built on Yamtrack are not allowed without explicit separate licensing from the copyright holder (requires review and negotiation).

DEV.co evaluation signals

Editorial assessment — not user reviews. Directional, with an explicit confidence level.

Signal	Assessment
Maintenance	Active
Documentation	Strong
License clarity	Clear
Deployment complexity	Low
DEV.co fit	Good
Assessment confidence	High

Security considerations

No public security audit, penetration test, or vulnerability disclosure policy documented. AGPL source is available for review. Standard Django security practices (CSRF, XSS, SQL injection prevention) likely applied but not independently verified. Self-hosted deployment shifts responsibility to operator for network security, TLS configuration, secret management, and dependency updates. Assess threat model and conduct security review before handling sensitive media metadata.

Alternatives to consider

Trakt

Proprietary, cloud-hosted, closed-source. No self-hosting option. Larger user base and social features; suitable if cloud dependency and proprietary licensing acceptable.

Letterboxd

Cloud-hosted, film-focused alternative with strong social/discovery features. No self-hosting, no TV/anime/game tracking. Better for casual movie tracking and curation.

MyAnimeList

Closed-source cloud service for anime and manga tracking. Larger anime community but limited to anime/manga; Yamtrack is more general-purpose and self-hosted.

Software development agency

Build on Yamtrack with DEV.co software developers

Yamtrack offers a self-hosted, privacy-respecting alternative to cloud media trackers. Evaluate your AGPL compliance requirements, database needs, and integration expectations before deployment. Review security considerations and test multi-user auth in staging. Contact Devco's web or DevOps specialists for custom setup, compliance assessment, or production hardening.

Talk to DEV.co

Related open-source tools

Surfaced by semantic similarity across the DEV.co open-source index.

yubal yt-fts Watcharr

Related on DEV.co

Explore the category and the services that help you build with it.

Open-Source DevOps Web App Development Cloud Deployment & DevOps API Development Talk to DEV.co

Yamtrack FAQ

Can I use Yamtrack commercially in a SaaS product?

AGPL-3.0 permits SaaS use only if you provide source code access to users. If you modify Yamtrack for commercial hosting, you must make those modifications public. Unmodified instances are allowed. Requires legal review for complex commercial arrangements.

What database should I choose, SQLite or PostgreSQL?

SQLite is fine for single-user or small personal instances. PostgreSQL is recommended for production multi-user deployments due to concurrency and reliability. Both are documented and supported via Docker Compose.

How do I automatically track media from my Plex/Jellyfin server?

Yamtrack integrates with Jellyfin, Plex, and Emby. You configure webhooks or polling in your media server settings to send watched events to Yamtrack's API. Setup instructions are in the documentation; test in staging first.

Is there a mobile app?

No native iOS/Android app. Access is via web browser on mobile devices. Responsive design is likely present but not explicitly confirmed; inspect screenshots or test before deployment.

Work with a software development agency

DEV.co is a software development agency delivering custom software development services to companies building on open source. Our software developers and web developers design, integrate, and ship production systems — spanning web development, APIs, AI, data, and cloud. If Yamtrack is part of your open-source devops roadmap, our team can implement, customize, migrate, and maintain it.

Ready to Self-Host Your Media Library?

Talk to DEV.co Schedule a Consultation