headless-music 1.1.1__py3-none-any.whl

headless_music-1.1.1.dist-info/METADATA

@@ -0,0 +1,115 @@
+Metadata-Version: 2.4
+Name: headless-music
+Version: 1.1.1
+Summary: headless music: for minimal cpu/gpu usage while listening to music
+Author: Rishav Ganguly
+License: MIT
+Project-URL: Homepage, https://github.com/imnotgoingtohindiclass/headless_music
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: yt-dlp
+Requires-Dist: spotipy
+Requires-Dist: python-mpv
+Requires-Dist: rich
+Requires-Dist: Pillow
+Dynamic: license-file
+
+# headless_music
+
+A Spotify-inspired, terminal-based music player. `headless_music` brings music to your terminal with full-color ASCII album art and an endless recommendation queue.
+
+## Features
+
+- Spotify-inspired terminal UI with a modern 3-panel layout (built with `rich`).
+- Color ASCII album art (when available from Spotify).
+- Playlist-first playback for Spotify or YouTube playlists.
+- Endless radio mode that queues recommendations after the playlist ends.
+- Smooth, pulsing progress bar showing playback and loading status.
+- First-run configuration wizard for easy setup.
+- Cross-platform: runs on systems with Python and `mpv`.
+
+## Prerequisites
+
+`mpv` is required as the audio backend.
+
+### macOS (Homebrew)
+```bash
+brew install mpv
+```
+
+### Ubuntu/Debian
+```bash
+sudo apt update && sudo apt install mpv
+```
+
+### Windows (Chocolatey)
+```bash
+choco install mpv
+```
+
+## Installation
+
+To install, simply use the Python package manager pip:
+```bash
+pip install headless_music
+```
+
+## Usage
+
+To start the player, type into your terminal
+```bash
+headless_music
+```
+
+On first launch a setup wizard will walk you through adding your Spotify API credentials. Obtain these from the Spotify Developer Dashboard: [https://developer.spotify.com/dashboard/](https://developer.spotify.com/dashboard/)
+
+## Controls
+
+| Key   | Action                                           |
+| ----- | ------------------------------------------------ |
+| Space | Play / Pause                                     |
+| n     | Next track                                       |
+| p     | Previous track                                   |
+| c     | Re-run the configuration wizard (stops playback) |
+| q     | Quit                                             |
+
+## Configuration
+
+* Spotify API credentials (Client ID, Client Secret) are required for full functionality.
+* The configuration wizard writes credentials to a user config file (see `config` in repo for format).
+* `mpv` path and additional mpv options can be set in the config.
+
+
+## Contribution
+
+Contributions are welcome. Please open issues for bugs or feature requests and submit pull requests against `main`. Follow the existing code style and include tests for new functionality.
+
+## License
+
+This project is licensed under the MIT License. See `LICENSE` for details.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+

headless_music-1.1.1.dist-info/RECORD

@@ -0,0 +1,21 @@
+headless_music/__init__.py,sha256=4fyggQuL5phizhj-oiAfTXiFXlRlmOSdqaFJ8QBRxhc,51
+headless_music/config.py,sha256=Hm2uyjx7Qrog_99gS1VQCgr7SMCUi_dY10EJVPcf7Z8,3772
+headless_music/headless_music.py,sha256=We-PXF2b7-nj_rTYIK50kXHjbYimDnIs8jtGBt6gx-s,29229
+headless_music/main.py,sha256=9s4j3eWZwPLmMPzVOcqXXu9eWopwD32cU5RwK7c--lQ,9456
+headless_music/player.py,sha256=OyHplV1-z0W_bDYqWFvEjgdMi_aXUdfSlSsUmNuPipE,2120
+headless_music/fetchers/__init__.py,sha256=t9h3vlekjXNntlbtL63Ldy9ydBDh667YIcpCVYDCaVg,119
+headless_music/fetchers/spotify.py,sha256=ckkX121wUuc9K6snhhLwXOmpEKEGwlXLgCCVrD9G36Y,6315
+headless_music/fetchers/youtube.py,sha256=et3HuCZXYv_I-sSQ4yL_SLYCqEznYzjip-XwsAfN4Xk,2130
+headless_music/ui/__init__.py,sha256=SHyvTqipe-DOdX4Xk1l2xjvS_6yx4BJLHq5_psbA-5I,385
+headless_music/ui/art.py,sha256=jRrhHCtxDrSPORNIrCCYhR6Z0ggua7jmWM0xwHmjyPI,2995
+headless_music/ui/layout.py,sha256=ZcDgBX5c3NHJ3zP1iGrkpQK8uRBOFK7rsH3ylv-i0Ac,402
+headless_music/ui/panels.py,sha256=P12LtNRxdnf_3Hx-Zs9e0aMyXF38JffmwMgZ3qz-eW4,3549
+headless_music/utils/__init__.py,sha256=VqXCZE26GRVLPPflkThlCTmPknv3vOkULsIab2Mmwis,215
+headless_music/utils/cache.py,sha256=Ppn0ERTvj7NLPMvFqJDsp1TzH6lbvP0gKbL8xABqPcM,547
+headless_music/utils/helpers.py,sha256=z7CqZbVwOIQHcSUbkWSzBGCyTy963hGT6b5Lir4wk_k,355
+headless_music-1.1.1.dist-info/licenses/LICENSE,sha256=kV4LgYz7rmq0cgAH8vfrR1F1lfPWEaZum6pIQTcOmIY,1100
+headless_music-1.1.1.dist-info/METADATA,sha256=8eeT7jCLmCIwZLIFqBpiTUDa2fB3QwaVDyF-Kn2p3cY,2810
+headless_music-1.1.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+headless_music-1.1.1.dist-info/entry_points.txt,sha256=nNFznC5vyh6gWb-EoQJ8p1ajCHGQr7owlCQcCQvBpjY,70
+headless_music-1.1.1.dist-info/top_level.txt,sha256=he0RYj9aHNV4GY9eO6ZB469_ISswOFbj8QuQFVEojyY,15
+headless_music-1.1.1.dist-info/RECORD,,

headless_music-1.1.1.dist-info/WHEEL

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

headless_music-1.1.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+headless_music = headless_music.headless_music:main

headless_music-1.1.1.dist-info/licenses/LICENSE

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

headless_music-1.1.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+headless_music