pyanimecli 1.2.7
A powerful command-line interface for searching, getting info, and watching anime directly from your terminal.
License: MIT

# pyanimecli
![PyPI version](https://img.shields.io/pypi/v/pyanimecli.svg)
![Build](https://github.com/princevegetadev/pyanimecli/actions/workflows/publish.yml/badge.svg)
![License](https://img.shields.io/pypi/l/pyanimecli.svg)
[![Downloads](https://img.shields.io/pepy/dt/pyanimecli)](https://pepy.tech/project/pyanimecli)
[![Visit website](https://img.shields.io/badge/Visit-website-green)](https://pyanimecli.vercel.app)


A powerful command-line interface for searching, getting info, and watching anime directly from your terminal, powered by the [YumaAPI](https://yumaapi.vercel.app/).

<img width="500" height="500" alt="pyanimecli" src="https://github.com/user-attachments/assets/1007f6a2-f3c9-4f9c-97d6-2139e2958c75" />

---


## Features

- **Search:** Find any anime by title.
- **Detailed Info:** Descriptions, episode lists, genres, and more.
- **Stream with VLC:** Watch subbed or dubbed episodes in VLC Media Player.
- **Automatic Subtitles:** Automatically loads subtitles for subbed streams.
- **Discover:** Browse recently updated episodes, top airing anime, and spotlight series.
- **Explore:** Search by genre or studio.
- **Schedule:** View airing schedules by date.
- **Next Episode:** See countdowns and local/UTC air times for upcoming episodes (with timezone support).
- **Trailers:** Fetch and play anime trailers (auto-installs yt-dlp if missing).
- **Cross-Platform:** Works on Linux, macOS, and Windows.
- **Rich Formatting:** Clean, colorful, and easy-to-read output in your terminal.

---

## Installation

### From PyPI (Recommended)


```bash
pip install pyanimecli
````

> Make sure your `pip` points to Python 3.11+ (e.g., use `pip3` if needed).

### From Git (Latest)

```bash
pip install git+https://github.com/princevegetadev/pyanimecli.git
```

> This installs the latest commit from the repository’s main branch.

---

## Prerequisites

1. **Python 3.11+**
2. **VLC Media Player:** Must be installed and accessible from your system's PATH. [Download VLC](https://www.videolan.org/vlc/)
3. **Required CLI Utilities:**

   * On **Linux/macOS**: `wget`
   * On **Windows**: `curl` (comes pre-installed on Windows 10+)
4. **FFmpeg**

---

## Usage

Get a full list of commands:

```bash
pyanimecli -h
```

---

### Command Examples

#### 1. Search for an anime:

```bash
pyanimecli -s "Attack on Titan"
```

#### 2. Get detailed info for an anime (using the ID from the search results):

```bash
pyanimecli -i "attack-on-titan-3d"
```

#### 3. Watch an episode:

```bash
# Watch a subbed episode
pyanimecli -w "attack-on-titan-3d$episode$571" sub

# Watch a dubbed episode
pyanimecli -w "attack-on-titan-3d$episode$571" dub
```

#### 4. Browse Recently Updated Episodes:

```bash
pyanimecli -re
```

#### 5. Browse Top Airing Anime:

```bash
pyanimecli -ta
```

#### 6. Use Pagination:

```bash
pyanimecli -ta -p 2
```

#### 7. List and Search Genres:

```bash
# List all genres
pyanimecli -g

# Search for anime in the 'action' genre
pyanimecli -gs "action"
```


#### 8. View the Airing Schedule:

```bash
pyanimecli -sc 2025-07-04
```

#### 9. Show Next Episode Info (with timezone):

```bash
# Show next episode info (default timezone BST)
pyanimecli -ne dragon-ball-super-1692

# Specify timezone (e.g., UTC)
pyanimecli -ne dragon-ball-super-1692 UTC
```

#### 10. Get and Play Anime Trailers:

```bash
# Show trailer info
pyanimecli -tr dragon-ball-super-1692

# Play trailer (auto-installs yt-dlp if missing)
pyanimecli -tr dragon-ball-super-1692 play
```

---

## Disclaimer

This tool is created for educational purposes only. All content is sourced from the publicly available [YumaAPI](https://yumaapi.vercel.app/). Please respect the rights and policies of the original content providers.