coder-music-cli 0.1.0__py3-none-any.whl

coder_music_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,167 @@
+Metadata-Version: 2.4
+Name: coder-music-cli
+Version: 0.1.0
+Summary: A command-line music application for coders with daemon support, radio streaming, and AI-generated music
+Author-email: Luong Nguyen <luongnv89@gmail.com>
+Maintainer-email: Luong Nguyen <luongnv89@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/luongnv89/music-cli
+Project-URL: Repository, https://github.com/luongnv89/music-cli
+Project-URL: Documentation, https://github.com/luongnv89/music-cli#readme
+Project-URL: Issues, https://github.com/luongnv89/music-cli/issues
+Project-URL: Changelog, https://github.com/luongnv89/music-cli/releases
+Keywords: music,cli,daemon,radio,ai-music,focus,coding,background-music,lofi,productivity
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS
+Classifier: Programming Language :: Python :: 3
+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: Topic :: Multimedia :: Sound/Audio :: Players
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.0
+Requires-Dist: tomli>=2.0; python_version < "3.11"
+Requires-Dist: tomli-w>=1.0
+Provides-Extra: ai
+Requires-Dist: torch>=2.0; extra == "ai"
+Requires-Dist: transformers>=4.30; extra == "ai"
+Requires-Dist: audiocraft>=1.0; extra == "ai"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+Requires-Dist: black>=23.0; extra == "dev"
+Requires-Dist: ruff>=0.1; extra == "dev"
+Requires-Dist: mypy>=1.0; extra == "dev"
+Requires-Dist: bandit>=1.7; extra == "dev"
+Requires-Dist: pre-commit>=3.0; extra == "dev"
+Dynamic: license-file
+
+# music-cli
+
+[![PyPI version](https://badge.fury.io/py/coder-music-cli.svg)](https://badge.fury.io/py/coder-music-cli)
+[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+A command-line music player for coders. Background daemon with radio streaming, local MP3s, and AI-generated music.
+
+```bash
+music-cli play --mood focus    # Start focus music
+music-cli pause                # Pause for meeting
+music-cli resume               # Back to coding
+```
+
+## Installation
+
+```bash
+# Install from PyPI
+pip install coder-music-cli
+
+# Or with uv (faster)
+uv pip install coder-music-cli
+
+# Install FFmpeg (required)
+brew install ffmpeg      # macOS
+sudo apt install ffmpeg  # Ubuntu/Debian
+```
+
+### Optional: AI Music Generation
+
+```bash
+pip install 'coder-music-cli[ai]'  # ~5GB (PyTorch + MusicGen)
+```
+
+## Features
+
+- **Daemon-based** - Persistent background playback
+- **Multiple sources** - Local files, radio streams, AI generation
+- **Context-aware** - Selects music based on time of day and mood
+- **Simple config** - Human-readable text files
+
+## Quick Start
+
+```bash
+# Play
+music-cli play                    # Context-aware radio
+music-cli play --mood focus       # Focus music
+music-cli play -m local --auto    # Shuffle local library
+
+# Control
+music-cli pause | resume | stop | status
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `play` | Start playing (radio/local/ai/history) |
+| `stop` / `pause` / `resume` | Playback control |
+| `status` | Current track and state |
+| `next` | Skip track (auto-play mode) |
+| `volume [0-100]` | Get/set volume |
+| `radios` | List stations |
+| `history` | Playback log |
+| `moods` | Available mood tags |
+| `daemon start\|stop\|status` | Daemon control |
+
+## Play Modes
+
+```bash
+# Radio (default)
+music-cli play                     # Time-based selection
+music-cli play -s "deep house"     # By station name
+music-cli play --mood focus        # By mood
+
+# Local
+music-cli play -m local -s song.mp3
+music-cli play -m local --auto     # Shuffle
+
+# AI (requires [ai] extras)
+music-cli play -m ai --mood happy -d 60
+
+# History
+music-cli play -m history -i 3     # Replay item #3
+```
+
+## Moods
+
+`focus` `happy` `sad` `excited` `relaxed` `energetic` `melancholic` `peaceful`
+
+## Configuration
+
+Files in `~/.config/music-cli/`:
+
+| File | Purpose |
+|------|---------|
+| `config.toml` | Settings |
+| `radios.txt` | Station URLs |
+| `history.jsonl` | Play history |
+
+Add stations to `radios.txt`:
+```
+ChillHop|https://streams.example.com/chillhop.mp3
+Jazz FM|https://streams.example.com/jazz.mp3
+```
+
+## Documentation
+
+| Document | Description |
+|----------|-------------|
+| [User Guide](docs/user-guide.md) | Complete usage instructions |
+| [Architecture](docs/architecture.md) | System design and diagrams |
+| [Development](docs/development.md) | Contributing guide |
+
+## Requirements
+
+- Python 3.9+
+- FFmpeg
+
+## License
+
+MIT

coder_music_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,23 @@
+coder_music_cli-0.1.0.dist-info/licenses/LICENSE,sha256=iIY9i1SGhK_mpAtd2Nzdd67baxXIjlaqJiaJFL2d5o0,1069
+music_cli/__init__.py,sha256=PCuhKa5Q9i4mQGNtS4eRZCuxBYz4BBX-LO4QSSP2s_o,85
+music_cli/__main__.py,sha256=7GY6AI64Lg6R1c7yVpaYwP1U9LbnZPGXC1ROveNnuAg,115
+music_cli/cli.py,sha256=fMWJ784KNvpwkI_k4wGb3Fd7sVDUWoVbUvyxEJ6d70s,10622
+music_cli/client.py,sha256=9a_BEsvp1GRyQ6if_Tv_bwV4NBP08DXLTdo-LPN2wro,4999
+music_cli/config.py,sha256=wbwDng-C4gDi3B1v-ZKvg3M-8syv2OjXHM-d8vMgVqc,5947
+music_cli/daemon.py,sha256=2kVqsY8DTJ6DhUC0tWDMmTakdV1kT4DgkhEWXEEflD0,12327
+music_cli/history.py,sha256=2v5dDMbnXuBbOhf2Ek2dD7Im2oS5R1L5hyNIz6tQp7o,5269
+music_cli/context/__init__.py,sha256=uQvlGLyFxzJpqjhTf0oCbVd42bl_Ll0ytJgQqbIR7I0,166
+music_cli/context/mood.py,sha256=iQhwIgwqRNDRsriZz_ILp5D9JLt__yZvTQPHIQwglCg,4104
+music_cli/context/temporal.py,sha256=zWlOLg0zhF3yWETKEtmUYLw2hUqVMFxJzrrkZWy5VH8,4774
+music_cli/player/__init__.py,sha256=EKI00MbZeug1ZtS0Ma3Ze-DrqCb0eNtSq8pghDAFyl8,160
+music_cli/player/base.py,sha256=1DMk6p3xy3ghXx337b31bW2TmLrU14YbcTW8HaX35Uw,2951
+music_cli/player/ffplay.py,sha256=H0jYK2-JAuua8dl4Ngh0tLJHbQf0_n0dErXT5biXTEI,5739
+music_cli/sources/__init__.py,sha256=abbtRMuDv4hqXKS_lzSNXU7XE-w3_FgPYBeQ9VIBNzk,147
+music_cli/sources/ai_generator.py,sha256=MD3zDwJNrC8kqsOaMBaHaDc02U-35QrrdailEz5bkF0,6342
+music_cli/sources/local.py,sha256=dMVF7YioGVf_9ZueXx-6ka2MxLr-vqUBwFVZ684_llM,2218
+music_cli/sources/radio.py,sha256=cy28BIQALOqWOveR1XajiixJ4_23Co96ft5MeKJMxbw,2924
+coder_music_cli-0.1.0.dist-info/METADATA,sha256=xP8ETriaKuhY9rbtmU-exU_bd5M171fKOpVO-DLsCuY,5035
+coder_music_cli-0.1.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+coder_music_cli-0.1.0.dist-info/entry_points.txt,sha256=JD1XHz39p9-26ucEEUxNIkFGzDoKaylWyWGVLgjy3z0,49
+coder_music_cli-0.1.0.dist-info/top_level.txt,sha256=cdu7SF6N7YSi0428x8CBLwHVguKCpyKhvVDV9WRqnfo,10
+coder_music_cli-0.1.0.dist-info/RECORD,,

coder_music_cli-0.1.0.dist-info/WHEEL

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

coder_music_cli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+music-cli = music_cli.cli:main

coder_music_cli-0.1.0.dist-info/licenses/LICENSE

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

coder_music_cli-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+music_cli

music_cli/__init__.py

@@ -0,0 +1,3 @@
+"""music-cli: A command-line music application for coders."""
+
+__version__ = "0.1.0"

music_cli/__main__.py

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

music_cli/cli.py

@@ -0,0 +1,378 @@
+"""Command-line interface for music-cli."""
+
+import os
+import signal
+import subprocess
+import sys
+import time
+
+import click
+
+from . import __version__
+from .client import DaemonClient
+from .config import get_config
+from .daemon import get_daemon_pid, is_daemon_running
+from .player.ffplay import check_ffplay_available
+
+
+def ensure_daemon() -> DaemonClient:
+    """Ensure daemon is running and return client."""
+    if not is_daemon_running():
+        click.echo("Starting daemon...", err=True)
+        start_daemon_background()
+        # Wait a bit for daemon to start
+        for _ in range(10):
+            time.sleep(0.2)
+            if is_daemon_running():
+                break
+        else:
+            click.echo("Failed to start daemon", err=True)
+            sys.exit(1)
+
+    return DaemonClient()
+
+
+def start_daemon_background() -> None:
+    """Start the daemon in background."""
+    # Start daemon as subprocess
+    python = sys.executable
+    subprocess.Popen(
+        [python, "-m", "music_cli.daemon"],
+        stdout=subprocess.DEVNULL,
+        stderr=subprocess.DEVNULL,
+        start_new_session=True,
+    )
+
+
+@click.group()
+@click.version_option(__version__)
+def main():
+    """music-cli: A command-line music player for coders.
+
+    Play local MP3s, stream radio, or generate AI music based on your mood
+    and the time of day.
+    """
+    pass
+
+
+@main.command()
+@click.option(
+    "--mode",
+    "-m",
+    type=click.Choice(["local", "radio", "ai", "context", "history"]),
+    default="radio",
+    help="Playback mode",
+)
+@click.option("--source", "-s", help="Source file/URL/station name")
+@click.option(
+    "--mood",
+    type=click.Choice(["happy", "sad", "excited", "focus", "relaxed", "energetic"]),
+    help="Mood for context-aware playback",
+)
+@click.option("--auto", "-a", is_flag=True, help="Enable auto-play (shuffle local files)")
+@click.option("--duration", "-d", default=30, help="Duration for AI generation (seconds)")
+@click.option("--index", "-i", type=int, help="History entry index to replay")
+def play(mode, source, mood, auto, duration, index):
+    """Start playing music.
+
+    \b
+    Examples:
+      music-cli play                    # Play context-aware radio
+      music-cli play -m local -s song.mp3  # Play local file
+      music-cli play -m radio -s "chill"   # Play radio station by name
+      music-cli play --mood focus       # Play focus music
+      music-cli play -m ai --mood happy # Generate happy AI music
+      music-cli play -m history -i 3    # Replay 3rd item from history
+      music-cli play -m local --auto    # Shuffle local library
+    """
+    if not check_ffplay_available():
+        click.echo("Error: ffplay not found. Please install FFmpeg.", err=True)
+        click.echo("  macOS: brew install ffmpeg", err=True)
+        click.echo("  Linux: apt install ffmpeg", err=True)
+        sys.exit(1)
+
+    client = ensure_daemon()
+
+    try:
+        response = client.play(
+            mode=mode,
+            source=source,
+            mood=mood,
+            auto=auto,
+            duration=duration,
+            index=index,
+        )
+
+        if "error" in response:
+            click.echo(f"Error: {response['error']}", err=True)
+            sys.exit(1)
+
+        track = response.get("track", {})
+        title = track.get("title", track.get("source", "Unknown"))
+        source_type = track.get("source_type", "unknown")
+
+        click.echo(f"▶ Playing: {title} [{source_type}]")
+        if auto:
+            click.echo("  Auto-play enabled (shuffle mode)")
+
+    except ConnectionError as e:
+        click.echo(f"Error: {e}", err=True)
+        sys.exit(1)
+
+
+@main.command()
+def stop():
+    """Stop playback."""
+    client = ensure_daemon()
+
+    try:
+        response = client.stop()
+        if "error" in response:
+            click.echo(f"Error: {response['error']}", err=True)
+        else:
+            click.echo("⏹ Stopped")
+    except ConnectionError as e:
+        click.echo(f"Error: {e}", err=True)
+        sys.exit(1)
+
+
+@main.command()
+def pause():
+    """Pause playback."""
+    client = ensure_daemon()
+
+    try:
+        response = client.pause()
+        if "error" in response:
+            click.echo(f"Error: {response['error']}", err=True)
+        else:
+            click.echo("⏸ Paused")
+    except ConnectionError as e:
+        click.echo(f"Error: {e}", err=True)
+        sys.exit(1)
+
+
+@main.command()
+def resume():
+    """Resume playback."""
+    client = ensure_daemon()
+
+    try:
+        response = client.resume()
+        if "error" in response:
+            click.echo(f"Error: {response['error']}", err=True)
+        else:
+            click.echo("▶ Resumed")
+    except ConnectionError as e:
+        click.echo(f"Error: {e}", err=True)
+        sys.exit(1)
+
+
+@main.command()
+def status():
+    """Show current playback status."""
+    client = ensure_daemon()
+
+    try:
+        response = client.status()
+
+        if "error" in response:
+            click.echo(f"Error: {response['error']}", err=True)
+            sys.exit(1)
+
+        state = response.get("state", "unknown")
+        state_icons = {
+            "playing": "▶",
+            "paused": "⏸",
+            "stopped": "⏹",
+            "loading": "⏳",
+            "error": "❌",
+        }
+
+        click.echo(f"Status: {state_icons.get(state, '?')} {state}")
+
+        track = response.get("track")
+        if track:
+            title = track.get("title", track.get("source", "Unknown"))
+            source_type = track.get("source_type", "unknown")
+            click.echo(f"Track: {title} [{source_type}]")
+
+        volume = response.get("volume", 80)
+        click.echo(f"Volume: {volume}%")
+
+        if response.get("auto_play"):
+            click.echo("Auto-play: enabled")
+
+        mood = response.get("mood")
+        if mood:
+            click.echo(f"Mood: {mood}")
+
+        context = response.get("context", {})
+        time_period = context.get("time_period", "")
+        if time_period:
+            click.echo(f"Context: {time_period} / {context.get('day_type', '')}")
+
+    except ConnectionError as e:
+        click.echo(f"Error: {e}", err=True)
+        sys.exit(1)
+
+
+@main.command("next")
+def next_track():
+    """Skip to next track (auto-play mode only)."""
+    client = ensure_daemon()
+
+    try:
+        response = client.next_track()
+        if "error" in response:
+            click.echo(f"Error: {response['error']}", err=True)
+        else:
+            click.echo("⏭ Skipped to next track")
+    except ConnectionError as e:
+        click.echo(f"Error: {e}", err=True)
+        sys.exit(1)
+
+
+@main.command()
+@click.argument("level", type=int, required=False)
+def volume(level):
+    """Get or set volume (0-100).
+
+    \b
+    Examples:
+      music-cli volume      # Show current volume
+      music-cli volume 50   # Set volume to 50%
+    """
+    client = ensure_daemon()
+
+    try:
+        if level is not None:
+            response = client.set_volume(level)
+            click.echo(f"Volume: {response.get('volume', level)}%")
+        else:
+            vol = client.get_volume()
+            click.echo(f"Volume: {vol}%")
+    except ConnectionError as e:
+        click.echo(f"Error: {e}", err=True)
+        sys.exit(1)
+
+
+@main.command("radios")
+def list_radios():
+    """List available radio stations."""
+    client = ensure_daemon()
+
+    try:
+        stations = client.list_radios()
+
+        if not stations:
+            config = get_config()
+            click.echo(f"No stations configured. Add stations to: {config.radios_file}")
+            return
+
+        click.echo("Available radio stations:")
+        for station in stations:
+            click.echo(f"  {station['index']}. {station['name']}")
+
+    except ConnectionError as e:
+        click.echo(f"Error: {e}", err=True)
+        sys.exit(1)
+
+
+@main.command("history")
+@click.option("--limit", "-n", default=20, help="Number of entries to show")
+def list_history(limit):
+    """Show playback history."""
+    client = ensure_daemon()
+
+    try:
+        history = client.list_history(limit=limit)
+
+        if not history:
+            click.echo("No playback history yet.")
+            return
+
+        click.echo("Recent playback history:")
+        for entry in history:
+            idx = entry.get("index", "?")
+            title = entry.get("title") or entry.get("source", "Unknown")[:40]
+            source_type = entry.get("source_type", "?")
+            timestamp = entry.get("timestamp", "")[:16]  # Truncate to date/time
+            click.echo(f"  {idx}. [{timestamp}] {title} ({source_type})")
+
+        click.echo("\nReplay with: music-cli play -m history -i <number>")
+
+    except ConnectionError as e:
+        click.echo(f"Error: {e}", err=True)
+        sys.exit(1)
+
+
+@main.command("daemon")
+@click.argument("action", type=click.Choice(["start", "stop", "restart", "status"]))
+def daemon_control(action):
+    """Control the background daemon.
+
+    \b
+    Actions:
+      start   - Start the daemon
+      stop    - Stop the daemon
+      restart - Restart the daemon
+      status  - Check daemon status
+    """
+    if action == "status":
+        pid = get_daemon_pid()
+        if pid:
+            click.echo(f"Daemon is running (PID: {pid})")
+        else:
+            click.echo("Daemon is not running")
+
+    elif action == "start":
+        if is_daemon_running():
+            click.echo("Daemon is already running")
+        else:
+            start_daemon_background()
+            click.echo("Daemon started")
+
+    elif action == "stop":
+        pid = get_daemon_pid()
+        if pid:
+            os.kill(pid, signal.SIGTERM)
+            click.echo("Daemon stopped")
+        else:
+            click.echo("Daemon is not running")
+
+    elif action == "restart":
+        pid = get_daemon_pid()
+        if pid:
+            os.kill(pid, signal.SIGTERM)
+            time.sleep(0.5)
+        start_daemon_background()
+        click.echo("Daemon restarted")
+
+
+@main.command("config")
+def show_config():
+    """Show configuration file locations."""
+    config = get_config()
+
+    click.echo("Configuration files:")
+    click.echo(f"  Config:  {config.config_file}")
+    click.echo(f"  Radios:  {config.radios_file}")
+    click.echo(f"  History: {config.history_file}")
+    click.echo(f"  Socket:  {config.socket_path}")
+    click.echo(f"  PID:     {config.pid_file}")
+
+
+@main.command("moods")
+def list_moods():
+    """List available mood tags."""
+    from .context.mood import MoodContext
+
+    click.echo("Available moods:")
+    for mood in MoodContext.get_all_moods():
+        click.echo(f"  - {mood}")
+    click.echo("\nUse with: music-cli play --mood <mood>")
+
+
+if __name__ == "__main__":
+    main()