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.