Metadata-Version: 2.4
Name: aniterm
Version: 1.0.14
Summary: Stream anime from your terminal
License: GPL-3.0-only
Project-URL: Homepage, https://github.com/amalxloop/aniterm
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: cloudflare
Requires-Dist: curl_cffi; extra == "cloudflare"
Dynamic: license-file

# 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

```bash
pip install aniterm           # from PyPI
```

Or run directly from the repo:

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

### Termux (Android)

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

> Without `curl_cffi` (`pip install curl_cffi`), yt-dlp can't bypass Cloudflare — most streams will fail. Install it if possible.

## 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

```bash
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
