1. Kotora
  2. Anime tracker for Linux

An anime tracker for Linux

Kotora keeps your MyAnimeList list up to date while you watch in mpv, VLC, mpc-qt, Celluloid, Haruna or SMPlayer. It notices the episode with no setup and asks once before it records it. Native, light, free and open source.

Wayland and X11 · x86_64 and aarch64 · GPL-3.0 · no telemetry

Kotora's Now Playing page: Lanterns of Kirigaoka episode 6 of 12 playing in mpv, a progress bar with the 80% mark, Update to episode 6, and the parsed file name below. Kotora's Now Playing page: Lanterns of Kirigaoka episode 6 of 12 playing in mpv, a progress bar with the 80% mark, Update to episode 6, and the parsed file name below.
Now Playing: what is open in your player, how far in, and why it matched.

How it finds the episode

Kotora looks for players that have a video file open, so it works with no config and no plugins. It reads the file name with anitomy-ng (a Rust take on Taiga’s anitomy), checks the folder name and the season, and matches it to your list. Every match says why, and if it guessed wrong, “Wrong anime…” offers the closest titles and remembers your pick.

  • mpv. Seen by its open file. For the exact position and pause, precise detection adds one line to your mpv.conf (an IPC socket), only when you click it. Then an episode counts at 80 %.
  • VLC, mpc-qt, Celluloid, Haruna, SMPlayer. Through MPRIS, the desktop’s media interface, and by their open file. Nothing to set up. Other MPRIS players that report a file work too.
  • Not streaming sites. Kotora tracks local players; for the browser, use MAL-Sync.

At home on the Linux desktop

  • Tray icon. Close the window and Kotora keeps watching from the tray (KDE, waybar and most bars; GNOME needs the AppIndicator extension).
  • Start at login, in the background, through a normal XDG autostart entry.
  • Notifications with buttons: Update, Not now and Undo.
  • kot, a command line that talks to the running app over a Unix socket: kot now, kot confirm, kot +1, kot next. Bind it to keys or show it in your bar.
  • Play the next episode. Point Kotora at your anime folders and Watching rows get a ▶ that opens the next file.
  • Small. One Rust binary of about 30 MB, a GPU-drawn interface, no Electron and no web view, and next to no CPU at rest.
Kotora's settings: accounts with a MyAnimeList Client ID, update options, a Players card with a switch per player, Notifications with a switch per event, and Appearance. Kotora's settings: accounts with a MyAnimeList Client ID, update options, a Players card with a switch per player, Notifications with a switch per event, and Appearance.
Settings: when to ask, one switch per player, notifications and the theme.

Install on Linux

Arch Linux and its derivatives get Kotora from the AUR. On any other distro, build it with the install script; it takes a few minutes with Cargo. There is no AppImage or Flatpak yet.

Arch Linux

AUR

kotora builds from the release source.

$ yay -S kotora

It installs kotora, kot, the menu entry and the icons, and update with your system.

Any Linux

From source

Needs Rust, git, pkgconf and a Vulkan driver.

$ git clone https://github.com/hanami117/kotora
$ cd kotora && ./install.sh

Installs into ~/.local/bin with the menu entry. Run it again after git pull to update.

macOS

Disk image or Homebrew

Apple silicon, macOS 13 or later. Open the DMG and drag Kotora to Applications.

Download the DMG
$ brew install --cask hanami117/kotora/kotora

Kotora is not notarized yet: at the first start, open System Settings → Privacy & Security and click Open Anyway.

At the first start you sign in with MyAnimeList. MyAnimeList asks every app user for a free Client ID; Kotora’s Welcome page walks you through it in about a minute, with no file editing.

All downloads: the latest release on GitHub (source tarball and checksums too).

Questions

Which Linux players does Kotora support?

mpv, VLC, mpc-qt, Celluloid, Haruna and SMPlayer, and other players that report the open file over MPRIS. Kotora finds them by the video file they have open, with no setup.

Does it work on Wayland?

Yes. Kotora runs on Wayland and X11. Detection doesn't read window titles, so it works the same under GNOME, KDE Plasma, Hyprland, sway and others.

Do I need to edit my mpv config?

No. mpv is seen by its open file. Precise detection, which adds one line to mpv.conf for the exact position, is optional and only happens when you click it in Kotora.

Is there an AppImage or Flatpak?

Not yet. Today there is the AUR (kotora) and install.sh, which builds from source on any distro. An AppImage is planned for a later version.

More about Kotora