A TUI music player for your favourite local mp3 albums!
Project description
Demo Video
https://github.com/user-attachments/assets/4650b8ca-0aa9-4a08-a05f-a0ab646ecdcc
Insallation:
Requires:
- Python >=3.14
- pipx or uv (more building coming soon...)
macOS & Linux:
curl -fsSL https://raw.githubusercontent.com/rNADOMROOM22stopmotion/TUIman/main/install.sh | bash
Using pipx/ uv:
pipx install tuiman
or
uv tool install tuiman
(recommend installing using pipx to keep global space clean from dependencies)
Features
- Displays album art, lyrics, queue.
- Shuffle queue, play/pause, skip (next), back (previous).
- Live lyrics display.
- Automatically fetches song lyrics from LRCLIB if not embedded.
- Extracts and caches album cover from audio files.
- Recursively searches album directories.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
tuiman-1.2.12.tar.gz
(26.7 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
tuiman-1.2.12-py3-none-any.whl
(31.3 kB
view details)
File details
Details for the file tuiman-1.2.12.tar.gz.
File metadata
- Download URL: tuiman-1.2.12.tar.gz
- Upload date:
- Size: 26.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e352b16a7fe06665c026e74687e6bddb5324e2f492f3f77d16eb273c7e3e0298
|
|
| MD5 |
b80a557b9e9c3922b2225f8c9ce9c4e2
|
|
| BLAKE2b-256 |
3abc3d3c04866938884ead0127ceebf1539fc3127887a6fa94db99e66f07c05c
|
File details
Details for the file tuiman-1.2.12-py3-none-any.whl.
File metadata
- Download URL: tuiman-1.2.12-py3-none-any.whl
- Upload date:
- Size: 31.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
6b5af3deeff79bb1d710187bd69e52c55bdbd03536e5fe24f6093edf946597cd
|
|
| MD5 |
ef309aa808d4b7c5907a4ae53625cb36
|
|
| BLAKE2b-256 |
e546de4a9271f1e5c2fa3f5aa9b33debb61fa397d117217a7839dfd61d814989
|
