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

Metadata

Release files for aniterm 1.0.28

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for aniterm 1.0.28
File	Size	Uploaded
aniterm-1.0.28.tar.gz	23.4 kB	Jul 11, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for aniterm 1.0.28
File	Interpreter	ABI	Platform	Reset
aniterm-1.0.28-py3-none-any.whl 22.9 kB Jul 11, 2026	Python 3	none	any	Details

Total release size: 46.3 kB

Release files / aniterm-1.0.28.tar.gz

Download URL	aniterm-1.0.28.tar.gz
Size	23.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`eabc07fe77d0a3eed816cd832a079c63e1c3c3d510a056dc84cee1c7f934b264`
BLAKE2b-256 checksum How to use checksums	`1be4398510eddbc05a2eb97f36af8d3a9caa8d960b2553699fee5b1b69a15f34`
Upload date	Jul 11, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.14.6`

Release files / aniterm-1.0.28-py3-none-any.whl

Download URL	aniterm-1.0.28-py3-none-any.whl
Size	22.9 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`3689a0ef5840fbe7f6c71e9dfa41107e72df3a240330da91069d2281a4a7173c`
BLAKE2b-256 checksum How to use checksums	`d3b8cf775880d123915eec5299c086e02288dd55fba3ed60fd3c476cf7372a27`
Upload date	Jul 11, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.14.6`