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.1.11.tar.gz
(23.4 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.1.11-py3-none-any.whl
(27.6 kB
view details)
File details
Details for the file tuiman-1.1.11.tar.gz.
File metadata
- Download URL: tuiman-1.1.11.tar.gz
- Upload date:
- Size: 23.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a27676cb2ae4ab9261dbe7b553ed5699b60cd8266d7b6947d0ff6d2a1fad1114
|
|
| MD5 |
d3febd9a23625f2fb0a3183c00f6a8b4
|
|
| BLAKE2b-256 |
4890ef16dd1765ff8a27cf13e54d8920b23708319ed0b07a341d439888cbc0ab
|
File details
Details for the file tuiman-1.1.11-py3-none-any.whl.
File metadata
- Download URL: tuiman-1.1.11-py3-none-any.whl
- Upload date:
- Size: 27.6 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 |
4275d13d06ca105077f42572cec1553148d1170c1f3a21521a782cc1c00b5e52
|
|
| MD5 |
cdfe81e1842214f5a8e8bd6e6b26752a
|
|
| BLAKE2b-256 |
753207691b03a29319fb722f5952070433468367d9215e480bab223586f75d2a
|
