Metadata-Version: 2.4
Name: wrkmon
Version: 1.2.0
Summary: Stealth TUI YouTube audio player - stream music while looking productive
Author-email: Umar Khan Yousafzai <umerfarooqkhan325@gmail.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/Umar-Khan-Yousafzai/Wrkmon-TUI-Youtube
Project-URL: Documentation, https://github.com/Umar-Khan-Yousafzai/Wrkmon-TUI-Youtube#readme
Project-URL: Repository, https://github.com/Umar-Khan-Yousafzai/Wrkmon-TUI-Youtube
Project-URL: Issues, https://github.com/Umar-Khan-Yousafzai/Wrkmon-TUI-Youtube/issues
Keywords: youtube,audio,player,tui,music,stealth,productivity,terminal
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: Operating System :: OS Independent
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: MacOS
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Multimedia :: Sound/Audio :: Players
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: textual>=0.50.0
Requires-Dist: typer>=0.9.0
Requires-Dist: yt-dlp>=2025.1.0
Requires-Dist: rich>=13.0.0
Requires-Dist: packaging>=21.0
Requires-Dist: Pillow>=9.0.0
Requires-Dist: pywin32>=306; sys_platform == "win32"
Requires-Dist: dbus-next>=0.2.3; sys_platform == "linux"
Requires-Dist: pynput>=1.7.6; sys_platform == "win32" or sys_platform == "darwin"
Provides-Extra: dev
Requires-Dist: pytest>=8.0.0; extra == "dev"
Requires-Dist: ruff>=0.3.0; extra == "dev"
Dynamic: license-file

# wrkmon

**Terminal-based YouTube Music Player** - Listen to music right from your terminal!

A beautiful TUI (Terminal User Interface) for streaming YouTube audio. No browser needed, just your terminal.

![License](https://img.shields.io/badge/license-MIT-blue.svg)
![Python](https://img.shields.io/badge/python-3.10%2B-blue.svg)
![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey.svg)
![PyPI](https://img.shields.io/pypi/v/wrkmon.svg)

## Features

- Search and stream YouTube audio
- Beautiful terminal interface
- Queue management with shuffle/repeat
- Play history and playlists
- Keyboard-driven controls
- Cross-platform (Windows, macOS, Linux)

## Installation

### pip (Recommended)

```bash
pip install wrkmon
```

> **Note:** You also need mpv installed:
> - Windows: `winget install mpv`
> - macOS: `brew install mpv`
> - Linux: `sudo apt install mpv`

### Quick Install Scripts

**Windows (PowerShell):**
```powershell
irm https://raw.githubusercontent.com/Umar-Khan-Yousafzai/Wrkmon-TUI-Youtube/main/install.ps1 | iex
```

**macOS / Linux:**
```bash
curl -sSL https://raw.githubusercontent.com/Umar-Khan-Yousafzai/Wrkmon-TUI-Youtube/main/install.sh | bash
```

### Package Managers

```powershell
# Windows (Chocolatey)
choco install wrkmon

# macOS (Homebrew) - coming soon
brew install wrkmon

# Linux (Snap) - coming soon
sudo snap install wrkmon
```

## Usage

```bash
wrkmon              # Launch the TUI
wrkmon search "q"   # Quick search
wrkmon play <id>    # Play a video
wrkmon history      # View history
```

## Keyboard Controls

| Key | Action |
|-----|--------|
| `F1` | Search view |
| `F2` | Queue view |
| `F3` | History view |
| `F4` | Playlists view |
| `F5` | Play / Pause |
| `F6` | Volume down |
| `F7` | Volume up |
| `F8` | Next track |
| `F9` | Stop |
| `F10` | Add to queue |
| `/` | Focus search |
| `Enter` | Play selected |
| `a` | Add to queue |
| `Ctrl+C` | Quit |

## Screenshots

```
┌─────────────────────────────────────────────────────────┐
│  wrkmon                                    [Search]     │
├─────────────────────────────────────────────────────────┤
│  Search: lofi beats                                     │
├─────────────────────────────────────────────────────────┤
│  #   Title                              Channel Duration│
│  1   Lofi Hip Hop Radio               ChilledCow 3:24:15│
│  2   Jazz Lofi Beats                  Lofi Girl 2:45:00│
│  3   Study Music Playlist             Study     1:30:22│
├─────────────────────────────────────────────────────────┤
│  ▶ Now Playing: Lofi Beats              advancement █████░░░░░ 1:23:45 │
│  F1 Search  F2 Queue  F5 Play/Pause  F9 Stop            │
└─────────────────────────────────────────────────────────┘
```

## Requirements

- Python 3.10+
- mpv media player

## Development

```bash
git clone https://github.com/Umar-Khan-Yousafzai/Wrkmon-TUI-Youtube.git
cd Wrkmon-TUI-Youtube
pip install -e ".[dev]"
pytest
```

## License

MIT License - see [LICENSE](LICENSE) for details.

## Author

**Umar Khan Yousafzai**

---

*Enjoy your music!*
