Your own private Trakt, Letterboxd, and Goodreads — in one app, on your own hardware.
Track movies, TV, anime, books, comics, manga, games, board games, music, and podcasts in one place.

Live demo · Install · Docs · Discord · Releases · Sponsor

Floppy is a self-hosted media tracker and diary for everything you watch, read, play, and listen to. Log what you finish, see what to pick up next, and get a yearly recap of how you spent your time. Connect Plex, Jellyfin, Emby, Pocket Casts, or Last.fm and your history fills itself in.

It is free and open source. You run it on a computer or server at home and open it from any browser, on desktop or phone. Your data never leaves your machine unless you connect a service that needs it.

A look around

Home — what you're in the middle of, what's next, and rows you choose.	Statistics — a recap of your year, by media type, day, and hour.
Lists — private, public, or smart lists that fill themselves.	Collection — what you own, down to the format and resolution.
Calendar — upcoming episodes and releases for everything you track.	On your phone — built for mobile, and installable as an app.

Light and dark themes follow your device; switch with the moon icon or under Settings → Appearance.

What it does

• One library for every kind of media. Movies and TV through to music albums, podcast episodes, board games, and comics — each with pages, progress, and ratings that fit it.
• Knows what's next. In-progress shows show the next episode and time left; the calendar and optional notifications tell you when new ones arrive.
• History that fills itself in. Plays from Plex, Jellyfin, Emby, Pocket Casts, and Last.fm are logged automatically. Manual check-ins take one tap.
• Recaps worth reading. Hours by media type, streaks, top people, and year-over-year comparisons.
• Lists you can share. Public pages, RSS feeds, and smart lists built from rules.
• Your collection, too. Track physical and digital copies alongside what you've watched or read, with Plex collection sync.
• Recommendations from your own taste. Discover rows learn from what you rate and finish, and you can send requests to Seerr in one click.
• Bring your history with you. Import from Trakt, TV Time, Simkl, IMDb, MyAnimeList, AniList, Goodreads, StoryGraph, Steam, PlayStation, Xbox, and more. Export everything to CSV at any time.

The full feature tour on the wiki lists everything, including multi-user accounts, OIDC sign-in, a REST API, and an MCP server.

Try it

The live demo is open — sign in with username demo and password demodemo. It's one shared account, so what you add is visible to everyone else trying it.

Install

Floppy runs on a computer or server you leave on. You open it from any browser on your network. One guided installer covers the common setups. Paste the same line on Windows, macOS, or Linux; it selects the right installer.

The installer asks a few plain questions and asks before it installs anything. It never asks for a password or API key. It finishes with Floppy open in your browser.

Open PowerShell on Windows or Terminal on macOS/Linux. Paste this entire line and press Enter:

echo "\" | Out-Null; irm 'https://raw.githubusercontent.com/dannyvfilms/Floppy/latest/scripts/install.ps1' -ErrorAction Stop | iex; #" >/dev/null; bash -c 'p=$(mktemp) || exit; cleanup() { rm -f "$p"; }; trap cleanup EXIT; curl -fsSL https://raw.githubusercontent.com/dannyvfilms/Floppy/latest/scripts/install.sh -o "$p" && bash "$p"'

Phones and tablets

Once Floppy is running, open it in your phone's browser and add it to your home screen. Step-by-step guide.

If you know what you're doing

• Docker Compose works for Unraid, Synology and Portainer too. SECRET is the only setting you must fill in.
• Docker Run if you don't use Compose.
• Deployment reference covers PostgreSQL, reverse proxies, environment variables, upgrades and troubleshooting.
• What the installer does, step by step.

Privacy and trust

Your library, ratings, and activity stay in the database you run. Floppy has no analytics and no central update check. It does contact metadata providers (such as TMDB) to look up titles and artwork, and connected services receive what their features need. Run it for yourself or people you trust, and turn off sign-ups after creating your account. Details: security notes · reporting a vulnerability.

Coming from Yamtrack?

Floppy started as a fork of Yamtrack. Yamtrack CSV exports import directly under Settings → Import, and existing containers of this project keep working after the rename — just move to the ghcr.io/dannyvfilms/floppy image. Migration notes.

Building on Floppy

Floppy has a REST API at /api/v1 and an MCP server for AI assistants. Start with the API and MCP guide; your running instance serves its own API index at /api/docs/. Download tools can read lists and report owned media (FlexGet guide).

Community and support

Questions and ideas: Discord is the place to share setups and help each other out. Bugs and feature requests: open an issue. Contributing: code, docs, and polish are welcome — see the contributing guide. Sponsoring: support Floppy on GitHub Sponsors. Starring the repository helps more people find it. The card refreshes daily from GitHub Sponsors public data.

Thank you to everyone who has contributed to Floppy and to Yamtrack before it.

Configuration and deployment

The full operator reference moved to docs/deployment.md. Links into the old sections of this page land here:

• Docker Compose example · Docker Run · Portainer and Unraid
• SQLite data paths · SQLite startup and migration preparation · PostgreSQL · Persistence checklist
• Environment variables · Running on a small host · Reverse proxy setup
• Floppy can't reach Redis · Startup diagnostics · I updated and my login is gone
• Upgrading container images · Verifying a published image · Docker image tags
• Developing locally: contributing guide

License

AGPL-3.0.

Origins and AI use

Floppy began as a fork of FuzzyGrim/Yamtrack and still shares its foundation and data model; this repository keeps the fork link. It has since grown into its own project. Thanks to FuzzyGrim and Yamtrack's contributors for the groundwork.

Floppy uses AI coding agents for implementation, tests, and documentation under maintainer direction. This describes Floppy's development, not all inherited Yamtrack history. PRs should disclose the model/workflow used and record human review only when it actually occurred. Agent reviews and passing checks are not independent security certification.