Skip to main content

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...)
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.

Project details


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.0.8.tar.gz (13.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

tuiman-1.0.8-py3-none-any.whl (17.2 kB view details)

Uploaded Python 3

File details

Details for the file tuiman-1.0.8.tar.gz.

File metadata

  • Download URL: tuiman-1.0.8.tar.gz
  • Upload date:
  • Size: 13.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.8.18

File hashes

Hashes for tuiman-1.0.8.tar.gz
Algorithm Hash digest
SHA256 e49453e968def21f277c864fac44e15402c42a706b855d21263f5ad963c0d966
MD5 e8ee6169786a72d00f5d29d9dae322b8
BLAKE2b-256 031468b2c7b7c454c35e054199812a6040664556f0bdda049b6a9b4613bfe2b8

See more details on using hashes here.

File details

Details for the file tuiman-1.0.8-py3-none-any.whl.

File metadata

  • Download URL: tuiman-1.0.8-py3-none-any.whl
  • Upload date:
  • Size: 17.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.8.18

File hashes

Hashes for tuiman-1.0.8-py3-none-any.whl
Algorithm Hash digest
SHA256 44857d722f92cffd11ed757b432068a582a39a3ccbe091846b154f92d0f0136a
MD5 7fa253d1660e0ec3353736c418ad75d5
BLAKE2b-256 90bb402d078d0e41921b7ad0c271938068ca42424c3cd24984257b4bb8e29409

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page