srgplayer 0.1.0__tar.gz

srgplayer-0.1.0/.gitignore

@@ -0,0 +1,10 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv

srgplayer-0.1.0/.python-version

@@ -0,0 +1 @@
+3.12

srgplayer-0.1.0/PKG-INFO

@@ -0,0 +1,10 @@
+Metadata-Version: 2.4
+Name: srgplayer
+Version: 0.1.0
+Summary: Terminal music player that streams from YouTube
+Author-email: Your Name <you@example.com>
+License: MIT
+Requires-Python: >=3.9
+Requires-Dist: python-mpv
+Requires-Dist: readchar
+Requires-Dist: yt-dlp

srgplayer-0.1.0/pyproject.toml

@@ -0,0 +1,22 @@
+[project]
+name = "srgplayer"
+version = "0.1.0"
+description = "Terminal music player that streams from YouTube"
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+authors = [
+    { name = "Your Name", email = "you@example.com" }
+]
+dependencies = [
+    "python-mpv",
+    "yt-dlp",
+    "readchar",
+]
+
+[project.scripts]
+srgplayer = "srgplayer:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"

srgplayer-0.1.0/src/srgplayer/__init__.py

@@ -0,0 +1,3 @@
+from srgplayer.player import main
+
+__all__ = ["main"]

srgplayer-0.1.0/src/srgplayer/player.py

@@ -0,0 +1,287 @@
+#!/usr/bin/env python3
+"""
+Terminal Music Player
+----------------------
+Search and stream songs from YouTube directly in your terminal,
+with simple single-key shortcuts to control playback.
+
+Requirements:
+    pip install python-mpv yt-dlp readchar --break-system-packages
+
+    Also requires the 'mpv' media player installed on your system
+    (python-mpv is just a binding to it):
+        Ubuntu/Debian:  sudo apt install mpv
+        macOS:          brew install mpv
+        Windows:        https://mpv.io/installation/ (add to PATH)
+
+Controls (press key, no Enter needed):
+    space   pause / resume
+    n       next song in queue
+    p       previous song in queue
+    a       search + add a song / playlist
+    l       list current queue
+    +/-     volume up / down
+    q       quit
+
+This version uses mpv's own native playlist engine to handle
+auto-advance to the next track. That's what mpv is built for, so
+it's far more reliable than trying to detect "song ended" from
+Python and manually calling play() again.
+"""
+
+import sys
+
+try:
+    import mpv
+    import yt_dlp
+    import readchar
+except ImportError as e:
+    print(f"Missing dependency: {e}")
+    print("Install with: pip install python-mpv yt-dlp readchar --break-system-packages")
+    sys.exit(1)
+
+
+class MusicPlayer:
+    def __init__(self):
+        self.player = mpv.MPV(
+            ytdl=True,
+            video=False,
+            input_default_bindings=False,
+            terminal=False,
+            osc=False,
+            keep_open="no",   # auto-advance to next playlist item at end of track
+        )
+        self.queue = []          # mirrors mpv's playlist: [{"title": str, "url": str}, ...]
+        self.current_index = -1
+
+        @self.player.property_observer('playlist-pos')
+        def _on_pos_change(_name, value):
+            if value is not None and 0 <= value < len(self.queue):
+                self.current_index = value
+                print(f"\n▶ Now playing: {self.queue[value]['title']}")
+
+    def _entry_to_url(self, e):
+        raw_url = e.get("url")
+        if raw_url and raw_url.startswith("http"):
+            return raw_url
+        vid_id = e.get("id")
+        if vid_id:
+            return f"https://www.youtube.com/watch?v={vid_id}"
+        return None
+
+    def search(self, query, limit=5):
+        ydl_opts = {
+            "quiet": True,
+            "no_warnings": True,
+            "extract_flat": "in_playlist",
+            "default_search": f"ytsearch{limit}",
+            "skip_download": True,
+        }
+        with yt_dlp.YoutubeDL(ydl_opts) as ydl:
+            info = ydl.extract_info(query, download=False)
+            entries = info.get("entries", [])
+            results = []
+            for e in entries:
+                if not e:
+                    continue
+                url = self._entry_to_url(e)
+                if not url:
+                    continue
+                results.append({"title": e.get("title", "Unknown title"), "url": url})
+            return results
+
+    def is_playlist_url(self, text):
+        return text.strip().startswith(("http://", "https://")) and "list=" in text
+
+    def search_playlists(self, query, limit=5):
+        from urllib.parse import quote
+        # sp=EgIQAw%3D%3D filters YouTube search results to playlists only
+        search_url = f"https://www.youtube.com/results?search_query={quote(query)}&sp=EgIQAw%3D%3D"
+        ydl_opts = {
+            "quiet": True,
+            "no_warnings": True,
+            "extract_flat": "in_playlist",
+            "skip_download": True,
+            "playlistend": limit,
+        }
+        with yt_dlp.YoutubeDL(ydl_opts) as ydl:
+            info = ydl.extract_info(search_url, download=False)
+            entries = info.get("entries", [])[:limit]
+            results = []
+            for e in entries:
+                if not e:
+                    continue
+                pl_id = e.get("id") or e.get("url")
+                url = e.get("url") or f"https://www.youtube.com/playlist?list={pl_id}"
+                if not url.startswith("http"):
+                    url = f"https://www.youtube.com/playlist?list={pl_id}"
+                results.append({"title": e.get("title", "Unknown playlist"), "url": url})
+            return results
+
+    def add_to_playlist(self, title, url, play_now=False):
+        """Add one song both to our display queue and mpv's real playlist."""
+        if play_now:
+            self.clear_queue()
+        self.queue.append({"title": title, "url": url})
+        mode = "append-play" if len(self.queue) == 1 else "append"
+        self.player.command("loadfile", url, mode)
+
+    def clear_queue(self):
+        self.player.command("playlist-clear")
+        self.player.command("stop")
+        self.queue = []
+        self.current_index = -1
+
+    def ask_play_now(self):
+        if not self.queue:
+            return True  # nothing playing yet, no need to ask
+        choice = input("[n]ow (clears current queue) or add to [e]nd? (e): ").strip().lower()
+        return choice == "n"
+
+    def import_playlist(self, url):
+        play_now = self.ask_play_now()
+        ydl_opts = {
+            "quiet": True,
+            "no_warnings": True,
+            "extract_flat": "in_playlist",
+            "skip_download": True,
+        }
+        print("Importing playlist (this can take a moment for long playlists)...")
+        with yt_dlp.YoutubeDL(ydl_opts) as ydl:
+            info = ydl.extract_info(url, download=False)
+            entries = info.get("entries", [])
+            added = 0
+            for e in entries:
+                if not e:
+                    continue
+                vid_url = self._entry_to_url(e)
+                if not vid_url:
+                    continue
+                # only clear the queue once, on the very first imported track
+                self.add_to_playlist(e.get("title", "Unknown title"), vid_url, play_now=(play_now and added == 0))
+                added += 1
+            print(f"Imported {added} songs from playlist.")
+
+    def add_song_interactive(self):
+        query = input(
+            "\nSearch a song, type 'playlist: <query>' to search playlists, "
+            "or paste a playlist URL: "
+        ).strip()
+        if not query:
+            return
+
+        if self.is_playlist_url(query):
+            self.import_playlist(query)
+            return
+
+        if query.lower().startswith("playlist:"):
+            pl_query = query.split(":", 1)[1].strip()
+            if not pl_query:
+                return
+            print("Searching playlists...")
+            results = self.search_playlists(pl_query)
+            if not results:
+                print("No playlists found.")
+                return
+            for i, r in enumerate(results):
+                print(f"  [{i}] {r['title']}")
+            choice = input("Pick a playlist to import (Enter to cancel): ").strip()
+            if not choice.isdigit():
+                return
+            idx = int(choice)
+            if 0 <= idx < len(results):
+                self.import_playlist(results[idx]["url"])
+            return
+
+        print("Searching...")
+        results = self.search(query)
+        if not results:
+            print("No results found.")
+            return
+        for i, r in enumerate(results):
+            print(f"  [{i}] {r['title']}")
+        choice = input("Pick number to add (Enter to cancel): ").strip()
+        if not choice.isdigit():
+            return
+        idx = int(choice)
+        if 0 <= idx < len(results):
+            play_now = self.ask_play_now()
+            self.add_to_playlist(results[idx]["title"], results[idx]["url"], play_now=play_now)
+            print(f"Added: {results[idx]['title']}")
+
+    def next_song(self):
+        try:
+            self.player.command("playlist-next", "weak")
+        except Exception:
+            print("\nAlready at the end of the queue.")
+
+    def prev_song(self):
+        try:
+            self.player.command("playlist-prev", "weak")
+        except Exception:
+            print("\nAlready at the start of the queue.")
+
+    def toggle_pause(self):
+        self.player.pause = not self.player.pause
+        state = "⏸ Paused" if self.player.pause else "▶ Playing"
+        print(f"\r{state}   ", end="", flush=True)
+
+    def list_queue(self):
+        print("\n--- Queue ---")
+        if not self.queue:
+            print("(empty)")
+        for i, s in enumerate(self.queue):
+            marker = "→" if i == self.current_index else " "
+            print(f" {marker} [{i}] {s['title']}")
+        print("-------------")
+
+    def volume(self, delta):
+        try:
+            self.player.volume = max(0, min(100, self.player.volume + delta))
+            print(f"\rVolume: {int(self.player.volume)}%   ", end="", flush=True)
+        except Exception:
+            pass
+
+    def run(self):
+        print("=== SRG Terminal Music Player ===")
+        print("Controls: [space]=pause/play  [n]=next  [p]=prev  [a]=add song/playlist")
+        print("          [l]=list queue      [c]=clear queue & stop  [+/-]=volume  [q]=quit")
+        print("Tip: at the prompt, type a song name to search songs,")
+        print("     'playlist: <query>' to search playlists,")
+        print("     or paste a playlist URL directly.")
+        print("     When adding, you'll be asked to play it now (clears the")
+        print("     current queue) or add it to the end.\n")
+
+        self.add_song_interactive()
+
+        while True:
+            key = readchar.readkey()
+            if key == " ":
+                self.toggle_pause()
+            elif key.lower() == "n":
+                self.next_song()
+            elif key.lower() == "p":
+                self.prev_song()
+            elif key.lower() == "a":
+                self.add_song_interactive()
+            elif key.lower() == "l":
+                self.list_queue()
+            elif key.lower() == "c":
+                self.clear_queue()
+                print("\nQueue cleared and playback stopped.")
+            elif key == "+":
+                self.volume(5)
+            elif key == "-":
+                self.volume(-5)
+            elif key.lower() == "q":
+                print("\nBye!")
+                self.player.terminate()
+                sys.exit(0)
+
+
+def main():
+    MusicPlayer().run()
+
+
+if __name__ == "__main__":
+    main()

srgplayer-0.1.0/uv.lock

@@ -0,0 +1,67 @@
+version = 1
+revision = 3
+requires-python = ">=3.9"
+resolution-markers = [
+    "python_full_version >= '3.10'",
+    "python_full_version < '3.10'",
+]
+
+[[package]]
+name = "python-mpv"
+version = "1.0.8"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/77/bc/6aa34c8805ff62e2fefc7d171563c60598aac215d5241186031a2c839935/python_mpv-1.0.8.tar.gz", hash = "sha256:017fa359da059c831a94c419083491903e6d2f7c81b9841c33c196cabf4b3fe3", size = 52680, upload-time = "2025-04-25T09:51:40.048Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/22/f3/4c632eaacebfc62ab9414586137aecf6c0ea2a1e99708cf5a4c0dec13ae0/python_mpv-1.0.8-py3-none-any.whl", hash = "sha256:b5296403e990fb7348df4ca2211937a030f524bf638657bda7e45a00bc2df0cd", size = 46169, upload-time = "2025-04-25T09:51:37.775Z" },
+]
+
+[[package]]
+name = "readchar"
+version = "4.2.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/ed/49/a10341024c45bed95d13197ec9ef0f4e2fd10b5ca6e7f8d7684d18082398/readchar-4.2.2.tar.gz", hash = "sha256:e3b270fe16fc90c50ac79107700330a133dd4c63d22939f5b03b4f24564d5dd8", size = 9762, upload-time = "2026-04-06T19:45:54.226Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/3d/ca/36133653e00939922dd1416f4c56177361289172a30563fcb9552c9ccde4/readchar-4.2.2-py3-none-any.whl", hash = "sha256:92daf7e42c52b0787e6c75d01ecfb9a94f4ceff3764958b570c1dddedd47b200", size = 9401, upload-time = "2026-04-06T19:45:52.993Z" },
+]
+
+[[package]]
+name = "srgplayer"
+version = "0.1.0"
+source = { editable = "." }
+dependencies = [
+    { name = "python-mpv" },
+    { name = "readchar" },
+    { name = "yt-dlp", version = "2025.10.14", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.10'" },
+    { name = "yt-dlp", version = "2026.7.4", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.10'" },
+]
+
+[package.metadata]
+requires-dist = [
+    { name = "python-mpv" },
+    { name = "readchar" },
+    { name = "yt-dlp" },
+]
+
+[[package]]
+name = "yt-dlp"
+version = "2025.10.14"
+source = { registry = "https://pypi.org/simple" }
+resolution-markers = [
+    "python_full_version < '3.10'",
+]
+sdist = { url = "https://files.pythonhosted.org/packages/03/b7/dab729345e22891e79294273bc59c5213a1ec87331f49cb82ccea2b1bc9f/yt_dlp-2025.10.14.tar.gz", hash = "sha256:b18436aa9bb6f04354fd78d31ad9eeaae8c81b6a859f07072b25c18cd6c25844", size = 3045272, upload-time = "2025-10-14T23:39:52.688Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/b0/19/399c85d29bd7b366b31ede82698f7963374e5a3842ae9de0cde6514506b0/yt_dlp-2025.10.14-py3-none-any.whl", hash = "sha256:0b9da17eda1bbf48e2315130043d7993fd4ca1c5a35571f8231da1a910c9c115", size = 3248664, upload-time = "2025-10-14T23:39:49.95Z" },
+]
+
+[[package]]
+name = "yt-dlp"
+version = "2026.7.4"
+source = { registry = "https://pypi.org/simple" }
+resolution-markers = [
+    "python_full_version >= '3.10'",
+]
+sdist = { url = "https://files.pythonhosted.org/packages/47/c5/9972af4b472b0d55badf841ebafd2f98944cb0ae0f46e11d01f363ea5b91/yt_dlp-2026.7.4.tar.gz", hash = "sha256:b094813404f87a9dd2186f00815231df32e5fd8a5403be0f807b3bb2d21a4432", size = 3049326, upload-time = "2026-07-04T22:42:14.837Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/f9/8a/cd4c9b02c10c563adfe78118310129641900e1cd6de888cfae2452072696/yt_dlp-2026.7.4-py3-none-any.whl", hash = "sha256:f11f2b11d5a8ac4059f9bdf29fa4407dc7c6bb00c5097e95ca22a7a9db518266", size = 3184705, upload-time = "2026-07-04T22:42:12.989Z" },
+]