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

Uploaded Python 3

File details

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

File metadata

  • Download URL: pyanimecli-1.0.7.tar.gz
  • Upload date:
  • Size: 11.0 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.7.tar.gz
Algorithm Hash digest
SHA256 de6dfe0ddb715c6e3953f17b06bbd55c2cd7f42c4969a56b8c8ab152f06c4c4a
MD5 a3ab51cc9f756b7ba8c0c53a271eb976
BLAKE2b-256 1a4d4b88dd5736805bf3d6d3d04450f98466fbe789e55f5370fab247b37da80c

See more details on using hashes here.

File details

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

File metadata

  • Download URL: pyanimecli-1.0.7-py3-none-any.whl
  • Upload date:
  • Size: 10.7 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.7-py3-none-any.whl
Algorithm Hash digest
SHA256 e01f367622f0d5d5de18993c71eb6b320a8cbcd4aec61e454ba3e5ad6a3609cf
MD5 91b1ebdfcbf40cae908288e0e4266ac0
BLAKE2b-256 97a53b40efa14ad44b753debc8ffebf36290c4c907a0dce0b879d179efa351e2

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