# 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
```
Raw data
{
"_id": null,
"home_page": "https://github.com/lyraxial/kyouka",
"name": "kyouka-cli",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": null,
"keywords": "youtube, downloader, media, player, cli",
"author": "vyx",
"author_email": "kiyoshi.dev31@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/57/8b/c2b77b5b305282e03d4f690fa15ded417bfae5b745a6722563f67b401088/kyouka_cli-1.0.0.tar.gz",
"platform": null,
"description": "# Kyouka - YouTube Downloader and Media Player\r\n\r\nKyouka is a command-line tool for downloading YouTube videos and playing media files.\r\n\r\n## Features\r\n- Download YouTube videos as MP4\r\n- Download audio as high-quality MP3\r\n- Play media files with different player options\r\n- Rename and manage downloaded files\r\n\r\n## Installation\r\n\r\n### Basic Installation (audio only)\r\n```bash\r\npip install kyouka\r\n```\r\nFull Installation (with video support)\r\n```bash\r\npip install kyouka[full]\r\n```\r\nNote: For full video playback support, you'll need:\r\n\r\nVLC media player installed on your system\r\n\r\nTkinter (usually included with Python)\r\n\r\nUsage\r\nRun the CLI interface:\r\n\r\n```bash\r\nkyouka\r\n```\r\nCommand-line options:\r\n```bash\r\nkyouka --download \"https://youtube.com/...\" # Download video\r\nkyouka --download_audio \"https://youtube.com/...\" # Download audio only\r\nkyouka --list # List downloaded media\r\nkyouka --play \"filename.mp4\" # Play a media file\r\nkyouka --rename \"oldname.mp4\" \"newname.mp4\" # Rename a file\r\nkyouka --delete \"filename.mp4\" # Delete a file\r\n```\r\nPlayer Options:\r\nPlayer (Audio and Video - Recommended) - Requires VLC\r\n\r\nBuilt-in Video Player (no audio) - Requires OpenCV\r\n\r\nAudio Player (no video) - Requires VLC\r\n\r\nTroubleshooting\r\nIf video players don't work, install VLC: https://www.videolan.org/\r\n\r\nOn Linux, install Tkinter: sudo apt install python3-tk\r\n\r\n### Installation Instructions for Users\r\n\r\n1. **Install Python** (if not already installed):\r\n - Download from https://python.org/downloads\r\n - Make sure to check \"Add Python to PATH\" during installation\r\n\r\n2. **Install Kyouka**:\r\n```bash\r\n# For basic audio functionality:\r\npip install kyouka\r\n\r\n# For full video support:\r\npip install kyouka[full]\r\n```\r\nInstall VLC (for best experience):\r\n\r\nDownload from https://www.videolan.org/vlc/\r\n\r\nRun Kyouka:\r\n\r\n```bash\r\nkyouka\r\n```\r\nFor Developers\r\nTo install from source:\r\n\r\n```bash\r\ngit clone https://github.com/lyraxial/kyouka.git\r\ncd kyouka\r\npip install .[full] # For full features\r\n```\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "yt tl ripoff for ur terminal",
"version": "1.0.0",
"project_urls": {
"Homepage": "https://github.com/lyraxial/kyouka",
"Issues": "https://github.com/lyraxial/kyouka/issues",
"Repository": "https://github.com/lyraxial/kyouka"
},
"split_keywords": [
"youtube",
" downloader",
" media",
" player",
" cli"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "d3e43b2ca4bf127a182d442f3db2acd921db3366158b04b90374b59a55154e2c",
"md5": "77127e488a84eb805499cedce6cfebea",
"sha256": "4d009e9172639261b79d7cababcb5e7e45f67de0babf94b7c82478c5ec49ed54"
},
"downloads": -1,
"filename": "kyouka_cli-1.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "77127e488a84eb805499cedce6cfebea",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 13286,
"upload_time": "2025-08-17T20:01:37",
"upload_time_iso_8601": "2025-08-17T20:01:37.985603Z",
"url": "https://files.pythonhosted.org/packages/d3/e4/3b2ca4bf127a182d442f3db2acd921db3366158b04b90374b59a55154e2c/kyouka_cli-1.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "578bc2b77b5b305282e03d4f690fa15ded417bfae5b745a6722563f67b401088",
"md5": "ccda33c366a59d2492eb6d37f727c1e2",
"sha256": "3b5fa7de0f59ab7d7fb16c017ac9895315db9b8bc51a69cddf4881a4182f7bbf"
},
"downloads": -1,
"filename": "kyouka_cli-1.0.0.tar.gz",
"has_sig": false,
"md5_digest": "ccda33c366a59d2492eb6d37f727c1e2",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 14323,
"upload_time": "2025-08-17T20:01:39",
"upload_time_iso_8601": "2025-08-17T20:01:39.570276Z",
"url": "https://files.pythonhosted.org/packages/57/8b/c2b77b5b305282e03d4f690fa15ded417bfae5b745a6722563f67b401088/kyouka_cli-1.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-17 20:01:39",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "lyraxial",
"github_project": "kyouka",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "kyouka-cli"
}
JSON
