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.13.tar.gz
(26.8 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.13-py3-none-any.whl
(31.4 kB
view details)
File details
Details for the file tuiman-1.2.13.tar.gz.
File metadata
- Download URL: tuiman-1.2.13.tar.gz
- Upload date:
- Size: 26.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
20e63f2f6cc50fd70d027e8c3ee70de7d001c026729023c57fb2df96afcac6db
|
|
| MD5 |
268a1bcc96cfd8be6155ce97eb2a181f
|
|
| BLAKE2b-256 |
6024b66313ac5e2c4c11eed0a3b2c7d19917e804c3b5622e3b60c2410debdb66
|
File details
Details for the file tuiman-1.2.13-py3-none-any.whl.
File metadata
- Download URL: tuiman-1.2.13-py3-none-any.whl
- Upload date:
- Size: 31.4 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 |
19c514cab8121ed972dd653a775d5f70baef9eb94b7fe12b94001eeb152b1d32
|
|
| MD5 |
96cc528044b286c0186a93ac463e777d
|
|
| BLAKE2b-256 |
cfeecb84c803f14918224179a2795b033062c640c0236003787e4912f5904114
|
