Skip to main content

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.29

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.29
File Size Uploaded
aniterm-1.0.29.tar.gz 24.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for aniterm 1.0.29
File Interpreter ABI Platform
aniterm-1.0.29-py3-none-any.whl Python 3 none any Details

Total release size: 47.5 kB

Release files / aniterm-1.0.29.tar.gz

Download URL aniterm-1.0.29.tar.gz
Size 24.1 kB
Tags Source
SHA-256 checksum
How to use checksums
c807e3b05b039bab4c2ae04af924732fc2a27ee03b8718cbed00be80fdda5233
BLAKE2b-256 checksum
How to use checksums
e6434f3ba7c3366004053c0ad5729e5ef824d9dab21e7a5cbe51359d5ca54d35
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.10 {"installer":{"name":"uv","version":"0.12.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Arch Linux","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

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

Download URL aniterm-1.0.29-py3-none-any.whl
Size 23.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
604b8517b91bbc0e3421e310e8ba28612efda9aaf2c3075621ca19ce5a0806fd
BLAKE2b-256 checksum
How to use checksums
1d96a6317840a0586ccbc7b5f3cf2e6c851c703b3f0ed0c4b76799e7d2c66510
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.10 {"installer":{"name":"uv","version":"0.12.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Arch Linux","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release history Release notifications | RSS feed

This release

1.0.29 This release

2 release files

1.0.28

2 release files

1.0.27

2 release files

1.0.26

2 release files

1.0.17

2 release files

1.0.15

2 release files

1.0.14

2 release files

1.0.13

2 release files

1.0.12

2 release files

1.0.11

2 release files

1.0.10

2 release files

1.0.9

2 release files

1.0.8

2 release files

1.0.7

2 release files

1.0.6

2 release files

1.0.5

2 release files

1.0.4

2 release files

1.0.3

2 release files

1.0.2

2 release files

1.0.1

2 release files

1.0.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page