ytm-cli 0.5.0__tar.gz

ytm_cli-0.5.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Nguyen Luan
+
+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.

ytm_cli-0.5.0/PKG-INFO

@@ -0,0 +1,264 @@
+Metadata-Version: 2.4
+Name: ytm-cli
+Version: 0.5.0
+Summary: YouTube Music CLI tool with interactive terminal interface
+Author-email: thieuluan <thieuluan.dark@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/thieuluan1618/ytm
+Project-URL: Repository, https://github.com/thieuluan1618/ytm
+Project-URL: Issues, https://github.com/thieuluan1618/ytm/issues
+Keywords: youtube-music,cli,terminal,music-player,mpv
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+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: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Multimedia :: Sound/Audio :: Players
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: ytmusicapi
+Requires-Dist: rich
+Requires-Dist: mpv
+Requires-Dist: requests
+Requires-Dist: pyperclip
+Dynamic: license-file
+
+# YTM - YouTube Music CLI
+
+🎵 **A simple, interactive command-line tool for YouTube Music**
+
+Stream music directly from YouTube Music in your terminal with intuitive controls, playlist management, and smart filtering.
+
+![YTM CLI Player](image.png)
+
+![YTM CLI Lyrics](image-lyric.png)
+
+## ✨ Features
+
+- **🔍 Smart Search**: Search and play any song from YouTube Music
+- **🎮 Interactive Controls**: Play/pause, skip, go back with simple key presses
+- **📱 Vim-like Navigation**: Use `j/k` keys or arrow keys to navigate
+- **📋 Local Playlists**: Create and manage personal playlists
+- **👎 Smart Filtering**: Dislike songs to filter them from future results
+- **📜 Lyrics Display**: View lyrics while listening (press `l`)
+- **🎯 Radio Mode**: Automatic playlist generation based on your selection
+- **🤖 AI-Powered**: Natural language music requests and AI-generated playlists
+
+## 🚀 Quick Start
+
+### Requirements
+
+- Python 3.8+
+- [mpv media player](https://mpv.io/installation/) (must be installed system-wide)
+
+### Installation
+
+**One command with [uv](https://docs.astral.sh/uv/) (recommended):**
+
+```bash
+# Install from PyPI
+uvx ytm-cli "song name"
+
+# Or from source (no clone needed)
+uvx --from git+https://github.com/thieuluan1618/ytm.git ytm "song name"
+```
+
+<details>
+<summary>Alternative: clone and run locally</summary>
+
+```bash
+git clone https://github.com/thieuluan1618/ytm.git
+cd ytm
+uv run ytm "song name"
+```
+
+</details>
+
+<details>
+<summary>Alternative: one-shot setup scripts</summary>
+
+```bash
+git clone https://github.com/thieuluan1618/ytm.git
+cd ytm
+```
+
+These create the virtual environment, install dependencies, and configure the `ytm` command globally.
+
+**Linux/macOS:**
+
+```bash
+./setup.sh
+source ~/.zshrc  # or ~/.bashrc for bash
+```
+
+**Windows PowerShell:**
+
+```powershell
+.\setup.ps1
+. $PROFILE
+```
+
+**Windows Command Prompt:**
+
+```cmd
+setup.bat
+```
+
+After setup, use `ytm` from anywhere instead of `python -m ytm_cli`.
+
+</details>
+
+<details>
+<summary>Alternative: manual install</summary>
+
+```bash
+git clone https://github.com/thieuluan1618/ytm.git
+cd ytm
+python -m venv venv
+source venv/bin/activate  # Windows: venv\Scripts\activate
+pip install -r requirements.txt
+./setup_alias.sh          # or setup_alias.ps1 / setup_alias.bat
+```
+
+</details>
+
+### Basic Usage
+
+**Interactive search:**
+
+```bash
+ytm
+# Enter search query when prompted
+```
+
+**Direct search:**
+
+```bash
+ytm "your favorite song"
+```
+
+**Non-interactive mode (automation/scripting):**
+
+```bash
+ytm search "song name" --select 1           # Auto-select first result
+ytm search "song" -s 1 -v                   # With verbose output
+ytm search "song" -s 1 -v --log-file debug.log  # Save debug logs
+```
+
+> **Note:** If you haven't set up the alias, use `python -m ytm_cli` instead of `ytm`
+
+## 🎮 Controls
+
+### During Song Selection
+
+- `↑/↓` or `j/k` - Navigate through results
+- `Enter` - Select and play song
+- `q` - Quit
+
+### During Playback
+
+- `Space` - Play/pause
+- `n` - Next song
+- `b` - Previous song
+- `l` - Show lyrics
+- `a` - Add to playlist
+- `d` - Dislike song (skip and filter from future results)
+- `q` - Quit
+
+## 📋 Playlist Management
+
+**Create and manage playlists:**
+
+```bash
+ytm playlist list              # List all playlists
+ytm playlist create            # Create new playlist
+ytm playlist show "My Songs"   # View playlist contents
+ytm playlist play "My Songs"   # Play entire playlist
+ytm playlist delete "My Songs" # Delete playlist
+```
+
+**Add songs to playlists:**
+
+- Press `a` during song selection or playback
+- Choose existing playlist or create new one
+- Song added without interrupting playback
+
+## 🤖 AI Music Assistant
+
+Use natural language to search and create playlists powered by AI (supports Google Gemini, OpenAI, Anthropic):
+
+```bash
+ytm llm ask "play something chill for studying"       # AI picks and auto-plays
+ytm llm ask "upbeat pop songs for a workout"           # Natural language search
+ytm llm playlist "lo-fi beats for rainy days" --play   # AI-generated playlist
+ytm llm playlist "90s rock classics" -n 20             # 20-song playlist
+```
+
+Configure your provider in `config.ini`:
+
+```ini
+[llm]
+provider = google       # google, openai, or anthropic
+model = gemini-2.5-pro
+```
+
+## 🛠️ Configuration
+
+The app uses `config.ini` for customization:
+
+```ini
+[general]
+songs_to_display = 10
+show_thumbnails = true
+
+[mpv]
+# Add custom mpv flags
+flags = --no-video
+
+[playlists]
+directory = playlists
+```
+
+## 🎯 Philosophy
+
+**Keep it simple for the listener to enjoy music.** Features are designed to be:
+
+- **Intuitive**: Single-key shortcuts during playback
+- **Non-disruptive**: Actions don't interrupt your listening experience
+- **Consistent**: Same navigation patterns across all screens
+- **Quick**: Important features accessible with simple key presses
+
+## 🐛 Troubleshooting
+
+Having issues? Check out the [**Troubleshooting Guide**](TROUBLESHOOTING.md) for solutions to common problems:
+
+- 🔧 [Songs Skipping Continuously](TROUBLESHOOTING.md#songs-skipping-continuously)
+- 📦 [MPV Not Found](TROUBLESHOOTING.md#mpv-not-found)
+- 💻 [Terminal/Curses Errors](TROUBLESHOOTING.md#terminalcurses-errors)
+- 📝 [Using Verbose Logging](TROUBLESHOOTING.md#using-verbose-logging)
+
+**Quick diagnosis:**
+
+```bash
+# Enable verbose logging to see what's happening
+ytm search "test" -s 1 -v --log-file debug.log
+
+# Check versions
+mpv --version
+yt-dlp --version
+```
+
+## 📄 License
+
+This project is open source. Please check the license file for details.
+
+---
+
+**Enjoy your music! 🎵**

ytm_cli-0.5.0/README.md

@@ -0,0 +1,232 @@
+# YTM - YouTube Music CLI
+
+🎵 **A simple, interactive command-line tool for YouTube Music**
+
+Stream music directly from YouTube Music in your terminal with intuitive controls, playlist management, and smart filtering.
+
+![YTM CLI Player](image.png)
+
+![YTM CLI Lyrics](image-lyric.png)
+
+## ✨ Features
+
+- **🔍 Smart Search**: Search and play any song from YouTube Music
+- **🎮 Interactive Controls**: Play/pause, skip, go back with simple key presses
+- **📱 Vim-like Navigation**: Use `j/k` keys or arrow keys to navigate
+- **📋 Local Playlists**: Create and manage personal playlists
+- **👎 Smart Filtering**: Dislike songs to filter them from future results
+- **📜 Lyrics Display**: View lyrics while listening (press `l`)
+- **🎯 Radio Mode**: Automatic playlist generation based on your selection
+- **🤖 AI-Powered**: Natural language music requests and AI-generated playlists
+
+## 🚀 Quick Start
+
+### Requirements
+
+- Python 3.8+
+- [mpv media player](https://mpv.io/installation/) (must be installed system-wide)
+
+### Installation
+
+**One command with [uv](https://docs.astral.sh/uv/) (recommended):**
+
+```bash
+# Install from PyPI
+uvx ytm-cli "song name"
+
+# Or from source (no clone needed)
+uvx --from git+https://github.com/thieuluan1618/ytm.git ytm "song name"
+```
+
+<details>
+<summary>Alternative: clone and run locally</summary>
+
+```bash
+git clone https://github.com/thieuluan1618/ytm.git
+cd ytm
+uv run ytm "song name"
+```
+
+</details>
+
+<details>
+<summary>Alternative: one-shot setup scripts</summary>
+
+```bash
+git clone https://github.com/thieuluan1618/ytm.git
+cd ytm
+```
+
+These create the virtual environment, install dependencies, and configure the `ytm` command globally.
+
+**Linux/macOS:**
+
+```bash
+./setup.sh
+source ~/.zshrc  # or ~/.bashrc for bash
+```
+
+**Windows PowerShell:**
+
+```powershell
+.\setup.ps1
+. $PROFILE
+```
+
+**Windows Command Prompt:**
+
+```cmd
+setup.bat
+```
+
+After setup, use `ytm` from anywhere instead of `python -m ytm_cli`.
+
+</details>
+
+<details>
+<summary>Alternative: manual install</summary>
+
+```bash
+git clone https://github.com/thieuluan1618/ytm.git
+cd ytm
+python -m venv venv
+source venv/bin/activate  # Windows: venv\Scripts\activate
+pip install -r requirements.txt
+./setup_alias.sh          # or setup_alias.ps1 / setup_alias.bat
+```
+
+</details>
+
+### Basic Usage
+
+**Interactive search:**
+
+```bash
+ytm
+# Enter search query when prompted
+```
+
+**Direct search:**
+
+```bash
+ytm "your favorite song"
+```
+
+**Non-interactive mode (automation/scripting):**
+
+```bash
+ytm search "song name" --select 1           # Auto-select first result
+ytm search "song" -s 1 -v                   # With verbose output
+ytm search "song" -s 1 -v --log-file debug.log  # Save debug logs
+```
+
+> **Note:** If you haven't set up the alias, use `python -m ytm_cli` instead of `ytm`
+
+## 🎮 Controls
+
+### During Song Selection
+
+- `↑/↓` or `j/k` - Navigate through results
+- `Enter` - Select and play song
+- `q` - Quit
+
+### During Playback
+
+- `Space` - Play/pause
+- `n` - Next song
+- `b` - Previous song
+- `l` - Show lyrics
+- `a` - Add to playlist
+- `d` - Dislike song (skip and filter from future results)
+- `q` - Quit
+
+## 📋 Playlist Management
+
+**Create and manage playlists:**
+
+```bash
+ytm playlist list              # List all playlists
+ytm playlist create            # Create new playlist
+ytm playlist show "My Songs"   # View playlist contents
+ytm playlist play "My Songs"   # Play entire playlist
+ytm playlist delete "My Songs" # Delete playlist
+```
+
+**Add songs to playlists:**
+
+- Press `a` during song selection or playback
+- Choose existing playlist or create new one
+- Song added without interrupting playback
+
+## 🤖 AI Music Assistant
+
+Use natural language to search and create playlists powered by AI (supports Google Gemini, OpenAI, Anthropic):
+
+```bash
+ytm llm ask "play something chill for studying"       # AI picks and auto-plays
+ytm llm ask "upbeat pop songs for a workout"           # Natural language search
+ytm llm playlist "lo-fi beats for rainy days" --play   # AI-generated playlist
+ytm llm playlist "90s rock classics" -n 20             # 20-song playlist
+```
+
+Configure your provider in `config.ini`:
+
+```ini
+[llm]
+provider = google       # google, openai, or anthropic
+model = gemini-2.5-pro
+```
+
+## 🛠️ Configuration
+
+The app uses `config.ini` for customization:
+
+```ini
+[general]
+songs_to_display = 10
+show_thumbnails = true
+
+[mpv]
+# Add custom mpv flags
+flags = --no-video
+
+[playlists]
+directory = playlists
+```
+
+## 🎯 Philosophy
+
+**Keep it simple for the listener to enjoy music.** Features are designed to be:
+
+- **Intuitive**: Single-key shortcuts during playback
+- **Non-disruptive**: Actions don't interrupt your listening experience
+- **Consistent**: Same navigation patterns across all screens
+- **Quick**: Important features accessible with simple key presses
+
+## 🐛 Troubleshooting
+
+Having issues? Check out the [**Troubleshooting Guide**](TROUBLESHOOTING.md) for solutions to common problems:
+
+- 🔧 [Songs Skipping Continuously](TROUBLESHOOTING.md#songs-skipping-continuously)
+- 📦 [MPV Not Found](TROUBLESHOOTING.md#mpv-not-found)
+- 💻 [Terminal/Curses Errors](TROUBLESHOOTING.md#terminalcurses-errors)
+- 📝 [Using Verbose Logging](TROUBLESHOOTING.md#using-verbose-logging)
+
+**Quick diagnosis:**
+
+```bash
+# Enable verbose logging to see what's happening
+ytm search "test" -s 1 -v --log-file debug.log
+
+# Check versions
+mpv --version
+yt-dlp --version
+```
+
+## 📄 License
+
+This project is open source. Please check the license file for details.
+
+---
+
+**Enjoy your music! 🎵**

ytm_cli-0.5.0/pyproject.toml

@@ -0,0 +1,82 @@
+[build-system]
+requires = ["setuptools", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "ytm-cli"
+version = "0.5.0"
+description = "YouTube Music CLI tool with interactive terminal interface"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.8"
+authors = [
+    { name = "thieuluan", email = "thieuluan.dark@gmail.com" },
+]
+keywords = ["youtube-music", "cli", "terminal", "music-player", "mpv"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: End Users/Desktop",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Multimedia :: Sound/Audio :: Players",
+]
+dependencies = [
+    "ytmusicapi",
+    "rich",
+    "mpv",
+    "requests",
+    "pyperclip",
+]
+
+[project.urls]
+Homepage = "https://github.com/thieuluan1618/ytm"
+Repository = "https://github.com/thieuluan1618/ytm"
+Issues = "https://github.com/thieuluan1618/ytm/issues"
+
+[project.scripts]
+ytm = "ytm_cli.main:main"
+
+[tool.setuptools.packages.find]
+include = ["ytm_cli*"]
+
+[tool.ruff]
+# Set line length to match pylint (100 characters)
+line-length = 100
+target-version = "py38"
+
+[tool.ruff.lint]
+# Enable flake8 rules and other important checks
+select = [
+    "E",   # pycodestyle errors
+    "W",   # pycodestyle warnings
+    "F",   # pyflakes
+    "I",   # isort
+    "B",   # flake8-bugbear
+    "C4",  # flake8-comprehensions
+    "UP",  # pyupgrade
+]
+
+# Ignore specific rules that conflict with project style
+ignore = [
+    "E501",  # Line too long (handled by formatter)
+    "B008",  # Do not perform function calls in argument defaults
+]
+
+[tool.ruff.format]
+# Use double quotes for strings
+quote-style = "double"
+# Use 4 spaces for indentation
+indent-style = "space"
+# Keep existing line endings
+line-ending = "auto"
+
+[tool.ruff.lint.isort]
+# Group imports properly
+known-first-party = ["ytm_cli"]

ytm_cli-0.5.0/setup.cfg

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