pyanimecli

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.
• 💻 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).

🛠 Prerequisites

• Python 3.11+

• VLC Media Player: Must be installed and accessible from your system's PATH. Download VLC

• Required CLI Utilities:

  • On Linux/macOS: wget
  • On Windows: curl (comes pre-installed on Windows 10+)

🧪 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

⚠️ 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.