🎵 Tsuki Free Music CLI
Tsuki Free Music CLI is a 100% free, interactive terminal music player built for Windows (CMD, PowerShell, Windows Terminal) using Python, YouTube Music (yt-dlp), Pygame/WMPlayer Audio Engine, and Rich.
[!NOTE] No Spotify Premium, No Developer API Keys, and No Accounts Required! Stream and play full high-quality audio directly inside your terminal window for free.
🌟 Key Features
- 📻 Infinite YouTube Radio Autoplay: When your search list or queue ends, the player automatically fetches related recommendation songs from YouTube and keeps playing infinitely like YouTube Music Radio!
- ✨ Auto Clean & Clear Terminal UI: Automatically clears the terminal screen (
cls) when searching, playing, or viewing playlists to keep your CLI UI crisp, uncluttered, and elegant! - 📁 Local JSON Playlists (Max 2 Limit): Create up to 2 custom local playlists stored in
%APPDATA%\tsuki-music\library.json. - ⌨ Keyboard Arrow Controls: In the live
nowplayingscreen, use arrow keys to control music instantly:[→]Right Arrow: Skip to Next Song[←]Left Arrow: Skip to Previous Song[↑]Up Arrow: Increase Volume[↓]Down Arrow: Decrease Volume[Space / P]: Pause / Resume Audio[Q]: Exit Live Screen
⚡ Superfast Command Shortcuts
Inside tsuki:
| Shortcut | Full Command | Description | Example |
|---|---|---|---|
s <query> |
search <query> |
Search YouTube Music | s After Dark |
↑ / ↓ + ENTER |
Interactive Track Selection | Highlight & play song directly with arrow keys | Press ↑ / ↓ then ENTER |
<number> |
play <number> |
Play song number directly | 10 or 1 |
np |
nowplaying |
Open live Now Playing screen (with [→] [←] [↑] [↓] arrow controls) |
np |
pcr <name> |
playlist create <name> |
Create new custom playlist (Max 2 allowed) | pcr "Chill Mix" |
pl |
playlists |
List custom playlists | pl |
pl 1 / pl 2 |
`playlist view <1 | 2>` | View songs in playlist #1 or #2 by serial number |
pp 1 / pp 2 |
`playlist play <1 | 2>` | Play playlist #1 or #2 by serial number with Infinite Autoplay |
padd 1 3 |
`playlist add <1 | 2> ` | Add song #3 from search to playlist #1 |
v<0-100> |
volume <0-100> |
Change volume percentage | v50 or v100 |
🚀 Quickstart Guide
Install CLI & Dependencies
pip install -e .
Launch Interactive Mode
tsuki
🧪 Run Unit Tests
pytest tests/test_music.py
1 maintainer
Metadata
1 maintainer
Release files for tsuki-music 1.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| tsuki_music-1.0.0.tar.gz | 19.1 kB | Without provenance | Details for tsuki_music-1.0.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| tsuki_music-1.0.0-py3-none-any.whl | Python 3 | none | any | Details for tsuki_music-1.0.0-py3-none-any.whl |
Total release size: 39.4 kB
Release files / tsuki_music-1.0.0.tar.gz
| Download URL | tsuki_music-1.0.0.tar.gz |
|---|---|
| Size | 19.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f0d1d820db647813f93ed80498564df3eca50e626efafd648fea3dec4eb034de
|
|
BLAKE2b-256 checksum How to use checksums |
fe8cbc91895d28d0c83a429ee23ec060d22b8d25cb3e405f94261cd4dc99bf57
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.4
|
Release files / tsuki_music-1.0.0-py3-none-any.whl
| Download URL | tsuki_music-1.0.0-py3-none-any.whl |
|---|---|
| Size | 20.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f00ea02f2e66e57c95eaae74a89cab54c54e7d336d67460c447ec91472cb33bf
|
|
BLAKE2b-256 checksum How to use checksums |
6bbd66b4f6752f4b5a9892d83d9875c910e5185cad4f6dd2cc5b4e4d0ba82132
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.4
|
Security for tsuki-music 1.0.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
