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.11.tar.gz
(23.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.11-py3-none-any.whl
(27.9 kB
view details)
File details
Details for the file tuiman-1.2.11.tar.gz.
File metadata
- Download URL: tuiman-1.2.11.tar.gz
- Upload date:
- Size: 23.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e14ae0f4552ce5813c28dad4ee24f1b0a60b9ecd9daf2d5a93b30b7399702389
|
|
| MD5 |
1d47b993c495382017c95f9fe52c4dde
|
|
| BLAKE2b-256 |
f374dbe47f0af74b6cb2cc03dd48e48e92be3c9d013af57c56e52ad164e38e4f
|
File details
Details for the file tuiman-1.2.11-py3-none-any.whl.
File metadata
- Download URL: tuiman-1.2.11-py3-none-any.whl
- Upload date:
- Size: 27.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
48b3a97681adc05439ddaa56e328cf5e76b98b5f8c6bd753b36f78a017c75408
|
|
| MD5 |
de24f46d54c6a6f8029e3725e877317d
|
|
| BLAKE2b-256 |
b4741202d1c960d4fcd48d0d072e19165088c8930787208ed5e8c5512c4a1274
|
