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.5.tar.gz (9.7 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.5-py3-none-any.whl (9.4 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: pyanimecli-1.0.5.tar.gz
  • Upload date:
  • Size: 9.7 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.5.tar.gz
Algorithm Hash digest
SHA256 3e91b7388f08cbaff63d85b5e3314cff2ab9c200d13751e6eab2e9d863fb4d46
MD5 d96777206ac9e3d6c9342ab3671e95c3
BLAKE2b-256 9256f159accbf6a26a01c4398ae0671e51ffe13124afb74356597ac11d164449

See more details on using hashes here.

File details

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

File metadata

  • Download URL: pyanimecli-1.0.5-py3-none-any.whl
  • Upload date:
  • Size: 9.4 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.5-py3-none-any.whl
Algorithm Hash digest
SHA256 79ce58fd94e3278e42e0180949e440f94227f26513bff379d64986f760cb8eb3
MD5 069e286a217f5eb66acaac6db2b033c7
BLAKE2b-256 21e8590373bcf8cb7156d4f606d1dd97a6abb3aae73e176f4afecfea04b964f9

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