Aniterm

Stream anime from your terminal.

Requirements

• mpv — video player
• yt-dlp — streaming
• curl_cffi — pip install aniterm[cloudflare] (needed for Cloudflare bypass)
• python3
• fzf — recommended for scrollable episode browser (apt/brew/pkg install fzf)

Install

pip install aniterm                    # from PyPI
pip install --upgrade aniterm          # update to latest
pip install aniterm[cloudflare]        # with Cloudflare bypass

Or run directly from the repo:

git clone https://github.com/amalxloop/aniterm.git
./aniterm/aniterm

Termux (Android)

pkg install mpv yt-dlp fzf python
pip install aniterm[cloudflare]

If your mpv doesn't support video (only null VO), aniterm auto-detects and opens the stream in Android's native video player.

Usage

aniterm <query>                   Search anime
aniterm <id>                      Browse episodes (fzf if installed)
aniterm <id> <ep>                 Play episode (subbed)
aniterm <id> <ep> -dub            Play dubbed episode
aniterm <id> <ep> -n              Next/prev prompt after playback
aniterm -i <query>                Interactive mode
aniterm <id> -i                   Pick episode interactively

Examples

aniterm cowboy bebop              # search (no keyword needed)
aniterm 1                         # list episodes
aniterm 1 1                       # play episode 1
aniterm 21 1000                   # play One Piece episode 1000
aniterm -i "attack on titan"      # interactive

Notes

• Episode counts for ongoing anime (e.g. One Piece) are derived from AniList's nextAiringEpisode data
• Transient 502 errors from the stream source are retried automatically (3 attempts with exponential backoff)
• -dub may be unavailable for some anime; returns a clear error message if so