wrkmon 1.0.0__tar.gz

wrkmon-1.0.0/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Umar Khan Yousafzai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

wrkmon-1.0.0/PKG-INFO

@@ -0,0 +1,193 @@
+Metadata-Version: 2.4
+Name: wrkmon
+Version: 1.0.0
+Summary: Stealth TUI YouTube audio player - stream music while looking productive
+Author-email: Umar Khan Yousafzai <umar@example.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.txt
+Requires-Dist: textual>=0.50.0
+Requires-Dist: typer>=0.9.0
+Requires-Dist: yt-dlp>=2024.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: pywin32>=306; sys_platform == "win32"
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Requires-Dist: ruff>=0.3.0; extra == "dev"
+Dynamic: license-file
+
+# wrkmon 🎵
+
+**Stealth TUI YouTube Audio Player** - Stream music while looking productive!
+
+A terminal-based YouTube audio player that runs completely hidden in the background. No visible windows, no distractions - just music.
+
+![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)
+
+## Features
+
+- 🔍 **YouTube Search** - Search and stream any YouTube audio
+- 👻 **Stealth Mode** - No visible windows, completely hidden playback
+- 🎨 **Beautiful TUI** - Clean terminal interface with keyboard controls
+- 📋 **Queue Management** - Add tracks, shuffle, repeat
+- 📜 **History & Playlists** - Track your listening history
+- ⌨️ **Keyboard Driven** - Full control without touching the mouse
+- 🖥️ **Cross-Platform** - Works on Windows, macOS, and Linux
+
+## Installation
+
+### Quick Install (Recommended)
+
+**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
+
+**Windows (Chocolatey):**
+```powershell
+choco install wrkmon
+```
+
+**Windows (winget):**
+```powershell
+winget install wrkmon
+```
+
+**macOS (Homebrew):**
+```bash
+brew install wrkmon
+```
+
+**Linux (Snap):**
+```bash
+sudo snap install wrkmon
+```
+
+**Linux (apt):**
+```bash
+sudo apt install wrkmon
+```
+
+### pip (All Platforms)
+
+```bash
+pip install wrkmon
+```
+
+> **Note:** If using pip, you need to install mpv separately:
+> - Windows: `winget install mpv` or `choco install mpv`
+> - macOS: `brew install mpv`
+> - Linux: `sudo apt install mpv`
+
+## Usage
+
+```bash
+wrkmon              # Launch the TUI
+wrkmon search "q"   # Quick search from terminal
+wrkmon play <id>    # Play a specific video
+wrkmon history      # View play 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 (in list) |
+| `Ctrl+C` | Quit |
+
+## Screenshots
+
+```
+┌─────────────────────────────────────────────────────────┐
+│  wrkmon                                    [Search]     │
+├─────────────────────────────────────────────────────────┤
+│  Search: lofi hip hop                                   │
+├─────────────────────────────────────────────────────────┤
+│  #   Process                          PID   Duration    │
+│  1   node_worker_847291              8472   3:24:15     │
+│  2   webpack_compile_process         9123   2:45:00     │
+│  3   eslint_daemon_runner            7834   1:30:22     │
+├─────────────────────────────────────────────────────────┤
+│  ▶ Now Playing: lofi hip hop beats    advancement █████░░░░░ 1:23:45 │
+│  F1 Search  F2 Queue  F5 Play/Pause  F9 Stop            │
+└─────────────────────────────────────────────────────────┘
+```
+
+## Why wrkmon?
+
+Ever wanted to listen to music at work but worried about monitoring software catching you? wrkmon disguises itself as a legitimate development process while streaming your favorite tunes in the background. The TUI looks like a process monitor, and the audio plays through mpv with no visible windows.
+
+## Requirements
+
+- Python 3.10+
+- mpv (automatically installed with package managers)
+
+## Development
+
+```bash
+# Clone the repo
+git clone https://github.com/Umar-Khan-Yousafzai/Wrkmon-TUI-Youtube.git
+cd Wrkmon-TUI-Youtube
+
+# Install in development mode
+pip install -e ".[dev]"
+
+# Run tests
+pytest
+```
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## Author
+
+**Umar Khan Yousafzai**
+
+---
+
+*Made with ❤️ for productive procrastinators everywhere*

wrkmon-1.0.0/README.md

@@ -0,0 +1,156 @@
+# wrkmon 🎵
+
+**Stealth TUI YouTube Audio Player** - Stream music while looking productive!
+
+A terminal-based YouTube audio player that runs completely hidden in the background. No visible windows, no distractions - just music.
+
+![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)
+
+## Features
+
+- 🔍 **YouTube Search** - Search and stream any YouTube audio
+- 👻 **Stealth Mode** - No visible windows, completely hidden playback
+- 🎨 **Beautiful TUI** - Clean terminal interface with keyboard controls
+- 📋 **Queue Management** - Add tracks, shuffle, repeat
+- 📜 **History & Playlists** - Track your listening history
+- ⌨️ **Keyboard Driven** - Full control without touching the mouse
+- 🖥️ **Cross-Platform** - Works on Windows, macOS, and Linux
+
+## Installation
+
+### Quick Install (Recommended)
+
+**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
+
+**Windows (Chocolatey):**
+```powershell
+choco install wrkmon
+```
+
+**Windows (winget):**
+```powershell
+winget install wrkmon
+```
+
+**macOS (Homebrew):**
+```bash
+brew install wrkmon
+```
+
+**Linux (Snap):**
+```bash
+sudo snap install wrkmon
+```
+
+**Linux (apt):**
+```bash
+sudo apt install wrkmon
+```
+
+### pip (All Platforms)
+
+```bash
+pip install wrkmon
+```
+
+> **Note:** If using pip, you need to install mpv separately:
+> - Windows: `winget install mpv` or `choco install mpv`
+> - macOS: `brew install mpv`
+> - Linux: `sudo apt install mpv`
+
+## Usage
+
+```bash
+wrkmon              # Launch the TUI
+wrkmon search "q"   # Quick search from terminal
+wrkmon play <id>    # Play a specific video
+wrkmon history      # View play 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 (in list) |
+| `Ctrl+C` | Quit |
+
+## Screenshots
+
+```
+┌─────────────────────────────────────────────────────────┐
+│  wrkmon                                    [Search]     │
+├─────────────────────────────────────────────────────────┤
+│  Search: lofi hip hop                                   │
+├─────────────────────────────────────────────────────────┤
+│  #   Process                          PID   Duration    │
+│  1   node_worker_847291              8472   3:24:15     │
+│  2   webpack_compile_process         9123   2:45:00     │
+│  3   eslint_daemon_runner            7834   1:30:22     │
+├─────────────────────────────────────────────────────────┤
+│  ▶ Now Playing: lofi hip hop beats    advancement █████░░░░░ 1:23:45 │
+│  F1 Search  F2 Queue  F5 Play/Pause  F9 Stop            │
+└─────────────────────────────────────────────────────────┘
+```
+
+## Why wrkmon?
+
+Ever wanted to listen to music at work but worried about monitoring software catching you? wrkmon disguises itself as a legitimate development process while streaming your favorite tunes in the background. The TUI looks like a process monitor, and the audio plays through mpv with no visible windows.
+
+## Requirements
+
+- Python 3.10+
+- mpv (automatically installed with package managers)
+
+## Development
+
+```bash
+# Clone the repo
+git clone https://github.com/Umar-Khan-Yousafzai/Wrkmon-TUI-Youtube.git
+cd Wrkmon-TUI-Youtube
+
+# Install in development mode
+pip install -e ".[dev]"
+
+# Run tests
+pytest
+```
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## Author
+
+**Umar Khan Yousafzai**
+
+---
+
+*Made with ❤️ for productive procrastinators everywhere*

wrkmon-1.0.0/pyproject.toml

@@ -0,0 +1,68 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "wrkmon"
+version = "1.0.0"
+description = "Stealth TUI YouTube audio player - stream music while looking productive"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+authors = [
+    { name = "Umar Khan Yousafzai", email = "umar@example.com" }
+]
+keywords = ["youtube", "audio", "player", "tui", "music", "stealth", "productivity", "terminal"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Intended Audience :: End Users/Desktop",
+    "Operating System :: OS Independent",
+    "Operating System :: Microsoft :: Windows",
+    "Operating System :: POSIX :: Linux",
+    "Operating System :: MacOS",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Multimedia :: Sound/Audio :: Players",
+]
+dependencies = [
+    "textual>=0.50.0",
+    "typer>=0.9.0",
+    "yt-dlp>=2024.0.0",
+    "rich>=13.0.0",
+    "pywin32>=306; sys_platform == 'win32'",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0.0",
+    "ruff>=0.3.0",
+]
+
+[project.scripts]
+wrkmon = "wrkmon.cli:app"
+
+[project.urls]
+Homepage = "https://github.com/Umar-Khan-Yousafzai/Wrkmon-TUI-Youtube"
+Documentation = "https://github.com/Umar-Khan-Yousafzai/Wrkmon-TUI-Youtube#readme"
+Repository = "https://github.com/Umar-Khan-Yousafzai/Wrkmon-TUI-Youtube"
+Issues = "https://github.com/Umar-Khan-Yousafzai/Wrkmon-TUI-Youtube/issues"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["wrkmon*"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "W"]
+ignore = ["E501"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]

wrkmon-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

wrkmon-1.0.0/tests/test_core.py

@@ -0,0 +1,105 @@
+"""Tests for core modules."""
+
+import pytest
+from wrkmon.core.queue import PlayQueue, QueueItem
+
+
+class TestPlayQueue:
+    """Tests for PlayQueue."""
+
+    def test_empty_queue(self):
+        queue = PlayQueue()
+        assert queue.is_empty
+        assert queue.length == 0
+        assert queue.current is None
+
+    def test_add_item(self):
+        queue = PlayQueue()
+        item = QueueItem(
+            video_id="test123",
+            title="Test Track",
+            channel="Test Channel",
+            duration=180,
+        )
+        pos = queue.add(item)
+        assert pos == 0
+        assert queue.length == 1
+        assert not queue.is_empty
+
+    def test_next_previous(self):
+        queue = PlayQueue()
+        for i in range(3):
+            queue.add(QueueItem(
+                video_id=f"test{i}",
+                title=f"Track {i}",
+                channel="Channel",
+                duration=100,
+            ))
+
+        # Start at beginning
+        queue.jump_to(0)
+        assert queue.current.video_id == "test0"
+
+        # Next
+        queue.next()
+        assert queue.current.video_id == "test1"
+
+        # Previous
+        queue.previous()
+        assert queue.current.video_id == "test0"
+
+    def test_shuffle(self):
+        queue = PlayQueue()
+        for i in range(5):
+            queue.add(QueueItem(
+                video_id=f"test{i}",
+                title=f"Track {i}",
+                channel="Channel",
+                duration=100,
+            ))
+
+        queue.shuffle()
+        assert queue.shuffle_mode
+        assert len(queue._shuffle_order) == 5
+
+        queue.unshuffle()
+        assert not queue.shuffle_mode
+
+    def test_repeat_modes(self):
+        queue = PlayQueue()
+        assert queue.repeat_mode == "none"
+
+        queue.cycle_repeat()
+        assert queue.repeat_mode == "one"
+
+        queue.cycle_repeat()
+        assert queue.repeat_mode == "all"
+
+        queue.cycle_repeat()
+        assert queue.repeat_mode == "none"
+
+    def test_clear(self):
+        queue = PlayQueue()
+        queue.add(QueueItem(
+            video_id="test",
+            title="Track",
+            channel="Channel",
+            duration=100,
+        ))
+        assert queue.length == 1
+
+        queue.clear()
+        assert queue.is_empty
+
+
+class TestQueueItem:
+    """Tests for QueueItem."""
+
+    def test_url_property(self):
+        item = QueueItem(
+            video_id="abc123",
+            title="Test",
+            channel="Channel",
+            duration=60,
+        )
+        assert item.url == "https://www.youtube.com/watch?v=abc123"

wrkmon-1.0.0/tests/test_utils.py

@@ -0,0 +1,63 @@
+"""Tests for utility modules."""
+
+import pytest
+from wrkmon.utils.stealth import StealthManager
+
+
+class TestStealthManager:
+    """Tests for StealthManager."""
+
+    def test_get_fake_process_name(self):
+        stealth = StealthManager()
+
+        # Normal title
+        name = stealth.get_fake_process_name("Lofi Hip Hop Beats")
+        assert name == "lofi-hip-hop-beats"
+
+        # Title with special characters
+        name = stealth.get_fake_process_name("Track [Official Video] (HD)")
+        assert "-" in name
+        assert "[" not in name
+        assert "]" not in name
+
+        # Long title should be truncated
+        name = stealth.get_fake_process_name("A" * 50)
+        assert len(name) <= 30
+
+    def test_get_fake_pid(self):
+        stealth = StealthManager()
+        pid = stealth.get_fake_pid()
+        assert 1000 <= pid <= 65535
+
+    def test_get_fake_stats(self):
+        stealth = StealthManager()
+
+        cpu = stealth.get_fake_cpu()
+        assert stealth.CPU_RANGE[0] <= cpu <= stealth.CPU_RANGE[1]
+
+        mem = stealth.get_fake_memory()
+        assert stealth.MEM_RANGE[0] <= mem <= stealth.MEM_RANGE[1]
+
+    def test_format_status(self):
+        stealth = StealthManager()
+
+        assert stealth.format_status("playing") == "RUNNING"
+        assert stealth.format_status("paused") == "SUSPENDED"
+        assert stealth.format_status("stopped") == "STOPPED"
+        assert stealth.format_status("unknown") == "UNKNOWN"
+
+    def test_format_duration(self):
+        stealth = StealthManager()
+
+        assert stealth.format_duration(0) == "0:00"
+        assert stealth.format_duration(65) == "1:05"
+        assert stealth.format_duration(3661) == "1:01:01"
+        assert stealth.format_duration(-1) == "--:--"
+
+    def test_get_mpv_args(self):
+        stealth = StealthManager()
+        args = stealth.get_mpv_args()
+
+        assert "--no-video" in args
+        assert "--idle=yes" in args
+        assert any("input-ipc-server" in arg for arg in args)

wrkmon-1.0.0/wrkmon/__init__.py

@@ -0,0 +1,4 @@
+"""wrkmon - Work Monitor: A developer productivity tool."""
+
+__version__ = "1.0.0"
+__app_name__ = "wrkmon"

wrkmon-1.0.0/wrkmon/__main__.py

@@ -0,0 +1,6 @@
+"""Entry point for running wrkmon as a module."""
+
+from wrkmon.cli import app
+
+if __name__ == "__main__":
+    app()