Metadata-Version: 2.4
Name: kyouka-cli
Version: 1.0.0
Summary: yt tl ripoff for ur terminal
Home-page: https://github.com/lyraxial/kyouka
Author: vyx
Author-email: kiyoshi.dev31@gmail.com
License: MIT
Project-URL: Homepage, https://github.com/lyraxial/kyouka
Project-URL: Repository, https://github.com/lyraxial/kyouka
Project-URL: Issues, https://github.com/lyraxial/kyouka/issues
Keywords: youtube,downloader,media,player,cli
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Multimedia :: Video
Classifier: Topic :: Internet :: WWW/HTTP
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: yt-dlp>=2023.1.6
Requires-Dist: pygame>=2.0.0
Requires-Dist: pillow>=8.0.0
Provides-Extra: full
Requires-Dist: opencv-python>=4.5.0; extra == "full"
Requires-Dist: python-vlc>=3.0.0; extra == "full"
Dynamic: author-email
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python

# Kyouka - YouTube Downloader and Media Player

Kyouka is a command-line tool for downloading YouTube videos and playing media files.

## Features
- Download YouTube videos as MP4
- Download audio as high-quality MP3
- Play media files with different player options
- Rename and manage downloaded files

## Installation

### Basic Installation (audio only)
```bash
pip install kyouka
```
Full Installation (with video support)
```bash
pip install kyouka[full]
```
Note: For full video playback support, you'll need:

VLC media player installed on your system

Tkinter (usually included with Python)

Usage
Run the CLI interface:

```bash
kyouka
```
Command-line options:
```bash
kyouka --download "https://youtube.com/..."         # Download video
kyouka --download_audio "https://youtube.com/..."   # Download audio only
kyouka --list                                       # List downloaded media
kyouka --play "filename.mp4"                        # Play a media file
kyouka --rename "oldname.mp4" "newname.mp4"         # Rename a file
kyouka --delete "filename.mp4"                      # Delete a file
```
Player Options:
Player (Audio and Video - Recommended) - Requires VLC

Built-in Video Player (no audio) - Requires OpenCV

Audio Player (no video) - Requires VLC

Troubleshooting
If video players don't work, install VLC: https://www.videolan.org/

On Linux, install Tkinter: sudo apt install python3-tk

### Installation Instructions for Users

1. **Install Python** (if not already installed):
   - Download from https://python.org/downloads
   - Make sure to check "Add Python to PATH" during installation

2. **Install Kyouka**:
```bash
# For basic audio functionality:
pip install kyouka

# For full video support:
pip install kyouka[full]
```
Install VLC (for best experience):

Download from https://www.videolan.org/vlc/

Run Kyouka:

```bash
kyouka
```
For Developers
To install from source:

```bash
git clone https://github.com/lyraxial/kyouka.git
cd kyouka
pip install .[full]  # For full features
```
