pystardust/ani-cli

★ 12,386ShellAudience · generalComplexity · 2/5Setup · easy

Mindmap

mindmap
  root((ani-cli))
    What it does
      Search anime
      Stream episodes
      Skip credits
      Sync with friends
    Dependencies
      mpv or VLC
      ffmpeg
      fzf fuzzy search
    Platforms
      Linux
      macOS
      Android Termux
      Windows
    Installation
      Homebrew
      Package managers
      Termux

mindmap root((ani-cli)) What it does Search anime Stream episodes Skip credits Sync with friends Dependencies mpv or VLC ffmpeg fzf fuzzy search Platforms Linux macOS Android Termux Windows Installation Homebrew Package managers Termux

Click or tap to explore — scroll the page freely

Things people build with this

USE CASE 1

Search for any anime show by title and start streaming an episode directly from your terminal in seconds.

USE CASE 2

Automatically skip opening and ending credits while watching using the built-in Ani-Skip integration.

USE CASE 3

Watch anime in sync with friends using the syncplay integration without leaving the command line.

USE CASE 4

Install on Android via Termux to stream anime on a mobile device from the terminal.

Tech stack

Shellffmpegfzfmpv

Getting it running

Difficulty · easy Time to first run · 5min

Requires mpv or a compatible video player, ffmpeg, and fzf to be installed before use, Windows setup has more steps than Linux or Mac.

License not specified in the explanation, check the repository directly before using in a project.

In plain English

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.

Copy-paste prompts

Prompt 1

I just installed ani-cli on Arch Linux. Walk me through searching for 'Attack on Titan', picking season 2 episode 3, and getting it playing in mpv.

Prompt 2

How do I configure Ani-Skip in ani-cli so that opening and ending credits are skipped automatically every episode?

Prompt 3

I'm getting 'No results found' errors in ani-cli. What are the most common causes and how do I fix them?

Prompt 4

How do I set up ani-cli on macOS with iina as the player instead of mpv, using Homebrew?

Open on GitHub → Explain another repo

← pystardust on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.