pyanimecli

A powerful command-line interface for searching, getting info, and watching anime directly from your terminal, powered by the YumaAPI.

---

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)

pip install pyanimecli

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

From Git (Latest)

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

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:

pyanimecli -h

---

Command Examples

1. Search for an anime:

pyanimecli -s "Attack on Titan"

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

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

3. Watch an episode:

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

pyanimecli -re

5. Browse Top Airing Anime:

pyanimecli -ta

6. Use Pagination:

pyanimecli -ta -p 2

7. List and Search Genres:

# List all genres
pyanimecli -g

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

8. View the Airing Schedule:

pyanimecli -sc 2025-07-04

9. Show Next Episode Info (with timezone):

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

# 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. Please respect the rights and policies of the original content providers.