mad-play 0.1.0__tar.gz

mad_play-0.1.0/PKG-INFO

@@ -0,0 +1,67 @@
+Metadata-Version: 2.3
+Name: mad-play
+Version: 0.1.0
+Summary: Play music in the terminal like a divine madman!
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+
+# Mad Play
+
+**Play your music from the terminal like a Divine Madman!**
+
+[![PyPI - Version](https://img.shields.io/pypi/v/-.svg)](https://pypi.org/project/mad-play)
+[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/-.svg)](https://pypi.org/project/mad-play)
+
+-----
+
+## Installation
+
+```console
+pip install mad_play
+```
+
+## Usage
+
+For ease of use you could add an alias to your `.bashrc`, for example:
+
+```bash
+alias = mp="mad-play"
+```
+
+Remember to close and re-open your terminal or run:
+
+```bash
+source ~/.bashrc
+```
+
+Then open your terminal where the music is. To play a file:
+
+```bash
+mp funkytown.mp3
+```
+
+If you have a list of filenames in a text file, one filename per line and you have given it the .playlist extension, you can start playing it by:
+
+```bash
+mp bebop.playlist
+```
+
+Or just play every audio file in a folder like so:
+
+```bash
+mp mongolian/
+```
+
+press `space` to pause and resume, `n` for next tune, `b` to go back and `q` to quit.
+
+## Project scope
+
+Dead simple terminal audio player that plays audio files from anywhere on your computer, with playlists edited as plain text files and the ability to play everything in a folder. The player has intuitive controls and does not require learning exotic key-bindings.
+
+## Contribute
+
+This is a fun, simple project, but very useful all the same. It's a single python file with code that is fairly easy to catch. Mind you, it's early days and everything very raw. The Divine Madman invites you all to tinker, suggest improvements within the scope of the project and contribute improvements if doing so tickles your fancy! 
+
+## License
+
+`-` is distributed under the terms of the [MIT](https://spdx.org/licenses/MIT.html) license.

mad_play-0.1.0/README.md

@@ -0,0 +1,60 @@
+# Mad Play
+
+**Play your music from the terminal like a Divine Madman!**
+
+[![PyPI - Version](https://img.shields.io/pypi/v/-.svg)](https://pypi.org/project/mad-play)
+[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/-.svg)](https://pypi.org/project/mad-play)
+
+-----
+
+## Installation
+
+```console
+pip install mad_play
+```
+
+## Usage
+
+For ease of use you could add an alias to your `.bashrc`, for example:
+
+```bash
+alias = mp="mad-play"
+```
+
+Remember to close and re-open your terminal or run:
+
+```bash
+source ~/.bashrc
+```
+
+Then open your terminal where the music is. To play a file:
+
+```bash
+mp funkytown.mp3
+```
+
+If you have a list of filenames in a text file, one filename per line and you have given it the .playlist extension, you can start playing it by:
+
+```bash
+mp bebop.playlist
+```
+
+Or just play every audio file in a folder like so:
+
+```bash
+mp mongolian/
+```
+
+press `space` to pause and resume, `n` for next tune, `b` to go back and `q` to quit.
+
+## Project scope
+
+Dead simple terminal audio player that plays audio files from anywhere on your computer, with playlists edited as plain text files and the ability to play everything in a folder. The player has intuitive controls and does not require learning exotic key-bindings.
+
+## Contribute
+
+This is a fun, simple project, but very useful all the same. It's a single python file with code that is fairly easy to catch. Mind you, it's early days and everything very raw. The Divine Madman invites you all to tinker, suggest improvements within the scope of the project and contribute improvements if doing so tickles your fancy! 
+
+## License
+
+`-` is distributed under the terms of the [MIT](https://spdx.org/licenses/MIT.html) license.

mad_play-0.1.0/pyproject.toml

@@ -0,0 +1,14 @@
+[project]
+name = "mad-play"
+version = "0.1.0"
+description = "Play music in the terminal like a divine madman!"
+readme = "README.md"
+requires-python = ">=3.13"
+dependencies = []
+
+[project.scripts]
+mad-play = "mad_play.player:main"
+
+[build-system]
+requires = ["uv_build>=0.12.3,<0.13.0"]
+build-backend = "uv_build"

mad_play-0.1.0/pyproject.toml.orig

@@ -0,0 +1,14 @@
+[project]
+name = "mad-play"
+version = "0.1.0"
+description = "Play music in the terminal like a divine madman!"
+readme = "README.md"
+requires-python = ">=3.13"
+dependencies = []
+
+[project.scripts]
+mad-play = "mad_play.player:main"
+
+[build-system]
+requires = ["uv_build>=0.12.3,<0.13.0"]
+build-backend = "uv_build"

mad_play-0.1.0/src/mad_play/__main__.py

@@ -0,0 +1,5 @@
+from .player import main
+
+
+if __name__ == "__main__":
+    main()

mad_play-0.1.0/src/mad_play/player.py

@@ -0,0 +1,186 @@
+import os
+import select
+import signal
+import subprocess
+import sys
+import termios
+import tty
+from pathlib import Path
+
+AUDIO_EXTENSIONS = {
+    ".mp3",
+    ".wav",
+    ".ogg",
+    ".flac",
+    ".m4a",
+    ".aac",
+}
+
+
+def get_files(input_path):
+    path = Path(input_path).resolve()
+
+    if path.is_dir():
+        return sorted(
+            file_path
+            for file_path in path.iterdir()
+            if file_path.is_file()
+            and file_path.suffix.lower() in AUDIO_EXTENSIONS
+        )
+
+    if path.suffix.lower() == ".playlist":
+        return load_playlist(path)
+
+    return [path]
+
+
+
+def load_playlist(path):
+    playlist_path = Path(path).resolve()
+    base_dir = playlist_path.parent
+
+    files = []
+
+    for line in playlist_path.read_text().splitlines():
+        line = line.strip()
+
+        # Ignore blank lines and comments
+        if not line or line.startswith("#"):
+            continue
+
+        file_path = Path(line)
+
+        if not file_path.is_absolute():
+            file_path = base_dir / file_path
+
+        files.append(file_path)
+
+    return files
+
+
+def play_file(file_path, input_stream):
+    print(f"\nPlaying: {file_path}")
+
+    player = subprocess.Popen([
+        "ffplay",
+        "-nodisp",
+        "-autoexit",
+        "-loglevel", "quiet",
+        str(file_path),
+    ])
+
+    paused = False
+
+    try:
+        while player.poll() is None:
+            ready, _, _ = select.select([input_stream], [], [], 0.1)
+
+            if not ready:
+                continue
+
+            key = input_stream.read(1).lower()
+
+            if key in (" ", "space"):
+                if paused:
+                    os.kill(player.pid, signal.SIGCONT)
+                    paused = False
+                    print("\rResumed ")
+                else:
+                    os.kill(player.pid, signal.SIGSTOP)
+                    paused = True
+                    print("\rPaused  ")
+
+            elif key == "n":
+                # Next song
+                if paused:
+                    os.kill(player.pid, signal.SIGCONT)
+
+                player.terminate()
+                player.wait()
+                return "next"
+
+            elif key == "b":
+                # Previous song
+                if paused:
+                    os.kill(player.pid, signal.SIGCONT)
+
+                player.terminate()
+                player.wait()
+                return "previous"
+
+            elif key == "q":
+                # Stop the entire playlist
+                if paused:
+                    os.kill(player.pid, signal.SIGCONT)
+
+                player.terminate()
+                player.wait()
+                return "stop"
+
+    finally:
+        if player.poll() is None:
+            if paused:
+                os.kill(player.pid, signal.SIGCONT)
+
+            player.terminate()
+            player.wait()
+
+    # The song finished naturally
+    return "finished"
+
+
+def main():
+    if len(sys.argv) != 2:
+        print(f"Usage: python3 {sys.argv[0]} <file, folder, or playlist>")
+        sys.exit(1)
+
+    files = get_files(sys.argv[1])
+
+    if not files:
+        print("No audio files found.")
+        return
+
+    fd = sys.stdin.fileno()
+    old_terminal_settings = termios.tcgetattr(fd)
+
+    try:
+        tty.setcbreak(fd)
+
+        terminal_settings = termios.tcgetattr(fd)
+        terminal_settings[3] &= ~termios.ECHO
+        termios.tcsetattr(fd, termios.TCSADRAIN, terminal_settings)
+
+        print("Commands: p = pause/resume, n = next, b = previous, s = stop")
+
+        index = 0
+
+        while 0 <= index < len(files):
+            file_path = files[index]
+
+            if not file_path.is_file():
+                print(f"\nSkipping missing file: {file_path}")
+                index += 1
+                continue
+
+            action = play_file(file_path, sys.stdin)
+
+            if action == "stop":
+                break
+
+            elif action == "previous":
+                if index > 0:
+                    index -= 1
+                # At the first song, restart it
+                continue
+
+            elif action in ("next", "finished"):
+                index += 1
+
+    finally:
+        termios.tcsetattr(fd, termios.TCSADRAIN, old_terminal_settings)
+        print("\nDone.")
+
+
+if __name__ == "__main__":
+    main()
+