# ani-cli

> Shell-based CLI that searches, streams and downloads anime from hianime in mpv, VLC or IINA, with Syncplay support for watching with friends.

Stars: 14.1k · Language: Shell · License: GPL-3.0 · Categories: Network

- Repository: https://github.com/pystardust/ani-cli
- Page: https://www.trmn.sh/tools/ani-cli

## Install

- Homebrew: `brew tap pystardust/ani-cli https://github.com/pystardust/ani-cli.git`
- Homebrew: `brew trust pystardust/ani-cli`
- Homebrew: `brew install ani-cli && brew install --cask iina`
- apt (Debian 13/unstable): `sudo apt install ani-cli`
- AUR (Arch): `yay -S ani-cli`

## Overview

ani-cli is a command-line program for browsing and watching anime from the terminal. It scrapes the site hianime and plays the selected episodes in an external video player. It is written as a shell script and uses fzf for interactive selection, with mpv (or IINA on macOS, and VLC on some platforms) for playback. Downloading is supported through yt-dlp, and ffmpeg is listed as a dependency.

The tool supports watching alone or with friends, using Syncplay for synchronized playback. It includes an Ani-Skip integration for skipping intros and outros. Running `ani-cli -h` shows the available options, and `ani-cli -U` updates the tool, which the README recommends as the first step when something breaks. If a request fails with "Blocked by cloudflare", the README says to install curl-impersonate.

Platform support is split into tiers. Linux, macOS and Android (via Termux) are tier 1. Windows (through Git Bash in Windows Terminal with scoop), WSL, iOS, Steam Deck, FreeBSD and Ubuntu Touch are tier 2. Packages are available for Debian, Fedora (copr), Arch (AUR), Gentoo (GURU), openSUSE, Homebrew, Termux and scoop. It is aimed at terminal users who want to find and stream anime without a browser.

### Installation

```bash
# via Homebrew
brew tap pystardust/ani-cli https://github.com/pystardust/ani-cli.git
brew trust pystardust/ani-cli
brew install ani-cli && brew install --cask iina
```

```bash
# via apt (Debian 13/unstable)
sudo apt install ani-cli
```

```bash
# via AUR (Arch)
yay -S ani-cli
```

## Alternatives

- [Nmap](https://www.trmn.sh/tools/nmap.md): Network scanner for host discovery, port scanning, service and OS detection, with a scripting engine (NSE) for extra checks. (C, 13.9k stars)
- [Gobuster](https://www.trmn.sh/tools/gobuster.md): Go-based brute-forcing tool for web directories/files, DNS subdomains, virtual hosts, S3/GCS buckets, TFTP files, and custom fuzzing. (Go, 14.3k stars)
- [sshuttle](https://www.trmn.sh/tools/sshuttle.md): Transparent proxy that tunnels traffic to a remote network over ssh, acting as a VPN substitute without requiring admin access on the remote side. (Python, 13.6k stars)
- [subfinder](https://www.trmn.sh/tools/subfinder.md): Passive subdomain enumeration tool written in Go that queries online sources, with JSON output, wildcard elimination, and STDIN/STDOUT support. (Go, 14.7k stars)
- [dirsearch](https://www.trmn.sh/tools/dirsearch.md): Web path brute-forcer that discovers hidden directories and files on web servers using customizable wordlists (15.0k stars)

---

Canonical: https://www.trmn.sh/tools/ani-cli
