Built for how you watch
Whether it's local files or streaming, Ryuuji keeps up.
Finds your player automatically
mpv, VLC, MPC-HC, Kodi, PotPlayer. Over 20 players on Linux and Windows, plus streaming services like Crunchyroll and Netflix in your browser.
Handles even the messiest filenames
The parser strips fansub tags, version numbers, and resolution markers, then fuzzy-matches against your library. Creative naming conventions won't trip it up.
Syncs to your tracking service
Connect MyAnimeList, AniList, or Kitsu and your progress syncs automatically after each episode. Already have a list somewhere? Import it in one click and pick up right where you left off.
Your data stays on your machine
Your library and watch history live in a local database with no account required. Tracking services are there if you want them, not because you need them.
How it works
Three steps happen automatically in the background while you watch.
Detect
Finds your player
Scans for running media players like mpv, VLC, and Kodi. Watching in a browser? It picks up Crunchyroll, Netflix, and more from the active tab, no extensions needed.
Recognize
Parses the filename or browser tab
Extracts the title and episode number from messy fansub names. Fuzzy matching handles small differences, and a built-in relations database remaps multi-season numbering.
Update & Sync
Saves and syncs your progress
Your episode progress is saved locally and logged in your watch history. Connected to MAL, AniList, or Kitsu? The update gets pushed there too.
Try it yourself
Type any anime filename and see what the parser extracts.
Works with what you already use
No extensions, no plugins.
Does Ryuuji need to be running all the time?
Yes. Ryuuji runs quietly in the background and scans for active media players every few seconds. If nothing is playing, it idles with minimal resource usage.
Will it detect anime I'm streaming?
Yes. Ryuuji supports Crunchyroll, Netflix, Jellyfin, Plex, Hidive, and Bilibili in Firefox, Chrome, Edge, and Brave. No browser extension required. It reads the active tab title directly.
Can I use it without MAL, AniList, or Kitsu?
Absolutely. Ryuuji works fully offline with its local database. Your library, watch history, and progress are all stored on your machine. Tracking services are optional. Connect them if you want cloud sync, skip them if you don't.
How does it handle weird episode numbering?
Ryuuji includes an embedded anime-relations database that maps continuous episode numbers to per-season numbering. So if your file says episode 26 but it's actually season 2 episode 1, Ryuuji figures that out automatically.
My media player isn't listed. Can I add it?
Yes. Add a new entry to ~/.config/ryuuji/players.toml with the player's executable name, window class, and a title regex. No code changes needed. Ryuuji picks it up on the next scan.
Is macOS supported?
Not yet. Ryuuji currently supports Linux and Windows. macOS support depends on finding a reliable way to detect active media players on that platform.
Get Ryuuji
Download and start watching. Ryuuji tracks your progress from the first episode.
What's included
- Automatic player detection
- Local anime library
- MAL, AniList & Kitsu sync
- Season browser
- Torrent RSS monitor
Or build from source: