A local web UI for ani-cli.

Search anime with cover art, browse episodes, resume from your watch history, and play in mpv or iina — from your browser. Dependency-free, one Python file. Playback is handled by ani-cli.

Install Launch app → View ani-cli

Install & run

With pipx — recommended. Isolated, handles PATH automatically:

brew install pipx && pipx ensurepath     # first time only
pipx install ani-gui
ani-gui

With Homebrew (macOS / Linux):

brew install rickwiththeportalgun/tap/ani-gui
ani-gui

With pip — on macOS you may need to add the scripts directory to PATH:

pip3 install ani-gui
export PATH="$HOME/Library/Python/$(python3 -c 'import sys;print(sys.version_info.minor)')/bin:$PATH"
ani-gui

From source:

git clone https://github.com/rickwiththeportalgun/ani-gui && cd ani-gui
./ani-gui

Running ani-gui starts the app at http://127.0.0.1:17390. Add /docs for this page.

What it does

Search with covers — results show artwork from AniList, MyAnimeList, or Wikipedia as a fallback.
Continue Watching — resumes the next episode straight from ani-cli's history.
Play or download — any episode opens in your chosen player (mpv, IINA, VLC).
Quality & language — best / 1080 / 720 / 480 / worst, sub or dub.
Update & health check — flags ani-cli updates, a missing binary, or no player.
Dependency-free — single Python file, standard library only.

Runs on your machine

ani-gui opens a local player on the computer running it, so it's meant to run on your own machine — not as a shared website. See the repo and DISTRIBUTION.md for details and packaging options.