wrkmon 1.0.0__py3-none-any.whl

wrkmon/utils/stealth.py

@@ -0,0 +1,124 @@
+"""Stealth utilities for wrkmon - makes everything look like a dev tool."""
+
+import os
+import sys
+import random
+from typing import Optional
+
+
+class StealthManager:
+    """Manages stealth features for the application."""
+
+    # Fake process names that look like legitimate dev tools
+    FAKE_PROCESS_NAMES = [
+        "node-inspector",
+        "webpack-dev-srv",
+        "vite-hmr-watch",
+        "eslint-daemon",
+        "tsc-watch",
+        "pytest-runner",
+        "cargo-watch",
+        "go-build-srv",
+        "rust-analyzer",
+        "prettier-fmt",
+    ]
+
+    # Fake CPU/Memory stats ranges for the UI
+    CPU_RANGE = (12, 45)
+    MEM_RANGE = (35, 65)
+
+    def __init__(self):
+        self._original_title: Optional[str] = None
+
+    def get_pipe_name(self) -> str:
+        """Get the IPC pipe/socket name for mpv."""
+        if sys.platform == "win32":
+            return r"\\.\pipe\wrkmon-mpv"
+        else:
+            # Unix socket in runtime dir
+            runtime_dir = os.environ.get("XDG_RUNTIME_DIR", "/tmp")
+            return f"{runtime_dir}/wrkmon-mpv.sock"
+
+    def get_fake_process_name(self, video_title: str) -> str:
+        """Convert a video title to a fake process name."""
+        # Sanitize and truncate the title
+        name = video_title.lower()
+        # Replace spaces and special chars with hyphens
+        name = "".join(c if c.isalnum() else "-" for c in name)
+        # Remove consecutive hyphens
+        while "--" in name:
+            name = name.replace("--", "-")
+        # Trim and limit length
+        name = name.strip("-")[:30]
+        return name or "media-process"
+
+    def get_fake_pid(self) -> int:
+        """Generate a fake PID that looks realistic."""
+        return random.randint(1000, 65535)
+
+    def get_fake_cpu(self) -> int:
+        """Get a fake CPU usage percentage."""
+        return random.randint(*self.CPU_RANGE)
+
+    def get_fake_memory(self) -> int:
+        """Get a fake memory usage percentage."""
+        return random.randint(*self.MEM_RANGE)
+
+    def set_terminal_title(self, title: str = "wrkmon") -> None:
+        """Set the terminal window title."""
+        if sys.platform == "win32":
+            os.system(f"title {title}")
+        else:
+            # ANSI escape sequence for setting terminal title
+            sys.stdout.write(f"\033]0;{title}\007")
+            sys.stdout.flush()
+
+    def restore_terminal_title(self) -> None:
+        """Restore the original terminal title."""
+        if self._original_title:
+            self.set_terminal_title(self._original_title)
+
+    def get_mpv_args(self) -> list[str]:
+        """Get mpv arguments for stealth operation."""
+        return [
+            "--no-video",
+            "--no-terminal",
+            "--really-quiet",
+            f"--input-ipc-server={self.get_pipe_name()}",
+            "--idle=yes",
+            "--force-window=no",
+        ]
+
+    def format_status(self, status: str) -> str:
+        """Format a status string to look like a system status."""
+        status_map = {
+            "playing": "RUNNING",
+            "paused": "SUSPENDED",
+            "stopped": "STOPPED",
+            "buffering": "LOADING",
+            "ready": "READY",
+            "error": "FAILED",
+        }
+        return status_map.get(status.lower(), status.upper())
+
+    def format_duration(self, seconds: float) -> str:
+        """Format duration in a clean way."""
+        if seconds < 0:
+            return "--:--"
+        mins, secs = divmod(int(seconds), 60)
+        hours, mins = divmod(mins, 60)
+        if hours > 0:
+            return f"{hours}:{mins:02d}:{secs:02d}"
+        return f"{mins}:{secs:02d}"
+
+
+# Global stealth manager instance
+_stealth: Optional[StealthManager] = None
+
+
+def get_stealth() -> StealthManager:
+    """Get the global stealth manager instance."""
+    global _stealth
+    if _stealth is None:
+        _stealth = StealthManager()
+    return _stealth

wrkmon-1.0.0.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,41 @@
+wrkmon/__init__.py,sha256=X5ppzR6k_fMsxNUhNdnCjgV-UQvrY86IWvjaFrDGaqs,107
+wrkmon/__main__.py,sha256=27UFV2ULX5B8OO5b9HjCtTu5k6hdKXnQlCcNVwlYKto,116
+wrkmon/app.py,sha256=3-d2xtivTtOCw8EOBRzIsxQSW2Z6TWKQgY6dG3M2T28,20447
+wrkmon/cli.py,sha256=2K72I4PrgivPt4OP14XZjYjWNS7mvfTtcKf4YgZ2JZ4,8189
+wrkmon/core/__init__.py,sha256=50AiIHwvm2hVSBc5qkca7_k8taS4IIs_J8i0irz-rBo,269
+wrkmon/core/cache.py,sha256=-3ZH4GPQt1xk8huq50BuCNinTLFbZzRPXhPAEnmWZAs,6599
+wrkmon/core/player.py,sha256=ZeLvffoid8BUXZA9GDHt1YtQhzkmL9jlAhRfXtOc4AQ,9709
+wrkmon/core/queue.py,sha256=WgIkyi8uHRGLeX1mZoI8o10ABRrCSCLFiZRD20wCNzU,8563
+wrkmon/core/youtube.py,sha256=M0IvRErqec0RaVq58z07L45igxpbkqEiavkDQHAXzac,6215
+wrkmon/data/__init__.py,sha256=-geRAYau8OCtGztlSg4gNkmpNC1LEYbH5bI5y-4SYoo,194
+wrkmon/data/database.py,sha256=Ky1QRq5LZewRtWul_4qWJfoXbKbO7Nw--Ll9QKe9PrU,13448
+wrkmon/data/migrations.py,sha256=E2qBzEVrqp50b5WoQ1tB6hAPgLh50ZGq5YGSp06JPfE,4723
+wrkmon/data/models.py,sha256=C2rmdHnFr6BqRVjkWW6oZ2m6pSXrwMlp84l_7qxwj6A,4305
+wrkmon/ui/__init__.py,sha256=fy6EMFEEOA2k4rzEUsWl93hW_11bn1cYT29qVontggc,111
+wrkmon/ui/components.py,sha256=NaPQbDHnBM1LBZL_r5JcXvxEaCxwoizpMxWGFAAJTTs,7117
+wrkmon/ui/messages.py,sha256=0ds2nvaHQ6-2Ok8hfII6XlFkbNeAnCRFa7KldKZ4m8I,2352
+wrkmon/ui/theme.py,sha256=fVEVpokqEX3BmykS0KdndtjgV6NU8ZCYr7LHo0cH0qE,5260
+wrkmon/ui/screens/__init__.py,sha256=0_MX_qc8di-fRCm58b14nIV7X7iMZAJxfLIxYCwJo4I,316
+wrkmon/ui/screens/history.py,sha256=teRm0HhaWgHKXsu57XQRScgYqn_MvK9qA-5IBoWffRE,4831
+wrkmon/ui/screens/player.py,sha256=NPIV1oobtPdBZEHwpSTXUZeV8R1yrW02AVsoLuL3PZI,8046
+wrkmon/ui/screens/playlist.py,sha256=0m9kIUpJP4QHJTTzP_pKBuZS3gUfZZlhsWVy_iHZp4U,9676
+wrkmon/ui/screens/search.py,sha256=lYwTBbzrIW0amln0o9Hs-RtTt2FqHr2QasIVhxq3FKo,5626
+wrkmon/ui/views/__init__.py,sha256=WNHN2SDDk3f1k9VLHdpTbhWotRw_cCHVkR4-OtbfACo,308
+wrkmon/ui/views/history.py,sha256=j9keAwnOMSGoqFKlT21bpxJlhJqKNMfv7X7-eP80sb0,4895
+wrkmon/ui/views/playlists.py,sha256=5yvknFiQ7saaM_t28n-7JhY28lRxN6z3BFspSwXKyKA,9411
+wrkmon/ui/views/queue.py,sha256=_QmSfFrjFNcrNdfetTbojJpCwE3FPR-ed3bO9BsFlIs,6811
+wrkmon/ui/views/search.py,sha256=QiU3fcMUPb_Yr7fBHnM2FRUZOBuH8vx16r2B2TE2cjQ,5465
+wrkmon/ui/widgets/__init__.py,sha256=MZZLVqMv5cKOXhEJ-XZ3vVbrcLkg1wpFBtiIItv6HXE,250
+wrkmon/ui/widgets/header.py,sha256=vwZ1pRxROsWgXWaqdVne3_phiCfcCKeYEWg1ubrI7w8,1843
+wrkmon/ui/widgets/player_bar.py,sha256=AVw3xH3uNujjhaSo_L5QrtnrFtlVQnvVlj8k8vInx-8,4308
+wrkmon/ui/widgets/result_item.py,sha256=BroroFbMbT3qoH-Up1RJk3mfDwRCxNqodKgd_K1MeKM,3150
+wrkmon/utils/__init__.py,sha256=C1P1hbS96YERgJTw3zGqEayxwr0AFrDhCAuT0WtPO00,162
+wrkmon/utils/config.py,sha256=0v1VO8YFShFJcF5CQhHenKPVr_tm_r6JtaLJy39GRaE,5332
+wrkmon/utils/mpv_installer.py,sha256=HGS8Sq5ZJMCAZk2OTkHDo2ZyqzmXtaHoxR0guEdMstk,6227
+wrkmon/utils/stealth.py,sha256=EmI0-rUYhdV2fIZ2evwdPlSkqFT-Lq6fEX3ZqQH430A,3901
+wrkmon-1.0.0.dist-info/licenses/LICENSE.txt,sha256=0cLcTBgN-yLwY5jhlp8oK1wBxUCyIH7I4vst8RPxelw,1097
+wrkmon-1.0.0.dist-info/METADATA,sha256=TrZNZviQ7hL44v5IayqZLjd0lo4u5_O-VDXZf_tzxGs,6572
+wrkmon-1.0.0.dist-info/WHEEL,sha256=qELbo2s1Yzl39ZmrAibXA2jjPLUYfnVhUNTlyF1rq0Y,92
+wrkmon-1.0.0.dist-info/entry_points.txt,sha256=sI_CTRHFwhiEHh5BJZtpwiBsfQekpqXcXiT31wcdUZo,42
+wrkmon-1.0.0.dist-info/top_level.txt,sha256=lQvb7Xi0gQQ8R9z1IkR39vTdL-0jxZreD5McnnPFtLs,7
+wrkmon-1.0.0.dist-info/RECORD,,

wrkmon-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.10.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

wrkmon-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+wrkmon = wrkmon.cli:app

wrkmon-1.0.0.dist-info/licenses/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.dist-info/top_level.txt

@@ -0,0 +1 @@
+wrkmon