Skip to main content

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

Project description

pyanimecli

PyPI version Build License Downloads Python Versions

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

  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+)

🧪 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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pyanimecli-1.0.6.tar.gz (10.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

pyanimecli-1.0.6-py3-none-any.whl (10.6 kB view details)

Uploaded Python 3

File details

Details for the file pyanimecli-1.0.6.tar.gz.

File metadata

  • Download URL: pyanimecli-1.0.6.tar.gz
  • Upload date:
  • Size: 10.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.5

File hashes

Hashes for pyanimecli-1.0.6.tar.gz
Algorithm Hash digest
SHA256 409533f2cc234c6d36c563059c41bd9623d527bff41fa7c95ef280447e38471f
MD5 c7728a3f9d04b8f797e739b0a42e8373
BLAKE2b-256 b5c1a4b28b01b79a881950228219f426154df047dd290b10416a51c24df125df

See more details on using hashes here.

File details

Details for the file pyanimecli-1.0.6-py3-none-any.whl.

File metadata

  • Download URL: pyanimecli-1.0.6-py3-none-any.whl
  • Upload date:
  • Size: 10.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.5

File hashes

Hashes for pyanimecli-1.0.6-py3-none-any.whl
Algorithm Hash digest
SHA256 789aa8be3840b564f537d4f7abb8253f4366e234bc740495bef58a57889d0b86
MD5 36b3189017971ef0fe6507a39a0cecd5
BLAKE2b-256 665d1d9fa227984b3b4c0da1324e9174e9e16919e4425175f0a803928c599c48

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page