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.

1

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.

2

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.

3

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.

Examples

Parsed fields will appear here

Works with what you already use

No extensions, no plugins.

MyAnimeList Crunchyroll mpv Firefox MPC-HC PotPlayer Jellyfin Celluloid SMPlayer AniList Haruna
VLC Netflix Kodi Chrome MPC-BE Hidive KMPlayer GOM Player Kitsu QMPlay2 GNOME Videos
Plex Edge Bilibili Brave Clapper Dragon Player Parole Baka MPlayer Elisa Windows Media Player WMP (New)
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.

.AppImage, .deb, .rpmRequires libdbus-1-dev for MPRIS detection
.exe installer, portable

What's included

  • Automatic player detection
  • Local anime library
  • MAL, AniList & Kitsu sync
  • Season browser
  • Torrent RSS monitor

Or build from source:

$ cargo install --git https://github.com/umarudotdev/ryuuji ryuuji-gui