Demo Video

tuiman.mp4

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.