gitmyhub

ani-cli

Shell ★ 13k updated 29d ago

A cli tool to browse and play anime

A command-line tool that lets you search for anime by name and stream episodes directly in your terminal using your local video player, with no browser required.

Shellffmpegfzfmpvsetup: easycomplexity 2/5

Ani-cli is a command-line tool that lets you search for and watch anime directly from your terminal. It works by scraping the streaming site allmanga.to and piping the video to a local player like mpv or VLC. You type a show name, pick from the search results, choose an episode, and it starts playing.

The tool is a shell script, so it runs on Linux, macOS, and Android (via the Termux app) with straightforward installs, and with more setup on Windows and iOS. Linux users can install it through native package managers on Debian, Fedora, Arch, Gentoo, and OpenSuse. Mac users can install via Homebrew. The project tracks this as Tier 1 support for Linux, Mac, and Android (solid, used by the maintainers themselves) and Tier 2 for Windows and the rest (officially supported but with more friction).

There is a companion feature called Ani-Skip that automatically detects and skips opening and ending credits, which is optional to configure. A syncplay integration lets you watch anime together with other people in sync, which the README briefly mentions as a use case.

The tool relies on a few external dependencies: mpv or a compatible player for video, ffmpeg for processing streams, and fzf for the fuzzy search menu that appears when you type a query. On macOS, the README recommends iina as a player instead of mpv, since it integrates better with the operating system.

If you see a "No results found" error, the first step is running to update to the latest version, since the scraping relies on the current structure of the source site and may break when the site changes. The project has a Discord community and Matrix channel.

Where it fits