Terminal music player with real-time audio visualizer themes

Navigation

Verified details

These details have been verified by PyPI
Maintainers
Avatar for sahil016 from gravatar.com sahil016

Unverified details

These details have not been verified by PyPI
Project links
Meta
  • License Expression: MIT
    SPDX License Expression
  • Author: Sahil Sonker
  • Tags curses , mpv , music , player , terminal , tui , visualizer
  • Requires: Python >=3.9
  • Provides-Extra: visualizer
Classifiers
Report project as malware

Project description

music-tui

A terminal music player with real-time audio visualizer themes, built with Python + mpv.

 ๐ŸŽต Music TUI   โ–ฒ Fire
โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€
โ–ถ CITYWLKR - Immortal                     Keys
  Song Two                                j / โ†“    Move down
  Song Three                              k / โ†‘    Move up
                                          Enter    Play selected
                                          Space    Play / Pause
                                          n        Next track
                                          p        Prev track
                                          โ† / โ†’   Seek ยฑ5 s
                                          +/-      Volume
                                          m        Mute
                                          s        Shuffle
                                          r        Repeat
                                          t        Next theme
                                          q        Quit
โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€
  โ–ฒโ–ฒ  โ–ˆโ–ˆโ–ˆโ–ˆ โ–ˆโ–ˆโ–ˆ  โ–ˆโ–ˆ  โ–ˆโ–ˆโ–ˆโ–ˆ โ–ฒโ–ฒโ–ฒ โ–ˆโ–ˆโ–ˆโ–ˆ  โ–ˆโ–ˆโ–ˆ โ–ฒโ–ฒ  โ–ˆโ–ˆโ–ˆโ–ˆ โ–ˆโ–ˆโ–ˆ โ–ˆโ–ˆ โ–ˆโ–ˆโ–ˆโ–ˆ
โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€
โ–ถ  CITYWLKR - Immortal
   01:23 / 03:45   36%
   โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘
   vol: +/-   mute: m   seek: โ†โ†’   theme: t

Features

  • Browse and play audio files from ~/Music (recursive)
  • Supports .mp3, .flac, .wav, .ogg, .m4a, .aac, .opus, .wma
  • 6 visualizer themes โ€” cycle with t:
    • โ–‡ Bars โ€” smooth sub-character bars, green โ†’ yellow โ†’ red
    • โˆฟ Wave โ€” filled waveform with a bright crest line
    • โ—ˆ Spectrum โ€” symmetric bars expanding from center
    • โŒ˜ Matrix โ€” green falling matrix characters
    • โ˜… Neon โ€” rainbow frequency bars
    • โ–ฒ Fire โ€” heat-gradient bars, white-hot at the base
  • Real FFT visualization from PulseAudio monitor (when sounddevice+numpy installed)
  • Animated fallback visualizer when audio capture is unavailable
  • Shuffle, repeat, seek, volume control

Requirements

  • Linux with mpv installed
  • Python 3.9+
# Ubuntu / Debian
sudo apt install mpv

Installation

pip install music-tui

For real-time FFT visualization (reads audio from PulseAudio):

pip install "music-tui[visualizer]"

Usage

music-tui

Drop audio files into ~/Music (any subfolder works) and launch.

Keyboard shortcuts

Key Action
j / โ†“ Move down
k / โ†‘ Move up
Enter Play selected
Space Play / Pause
n / p Next / Previous track
โ† / โ†’ Seek ยฑ5 seconds
+ / - Volume up / down
m Mute
s Toggle shuffle
r Toggle repeat
t Cycle visualizer theme
q Quit

License

MIT

Project details

Verified details

These details have been verified by PyPI
Maintainers
Avatar for sahil016 from gravatar.com sahil016

Unverified details

These details have not been verified by PyPI
Project links
Meta
  • License Expression: MIT
    SPDX License Expression
  • Author: Sahil Sonker
  • Tags curses , mpv , music , player , terminal , tui , visualizer
  • Requires: Python >=3.9
  • Provides-Extra: visualizer
Classifiers

Release history Release notifications | RSS feed

This version

0.1.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

music_tui-0.1.0.tar.gz (10.8 MB view details)

Uploaded Source

Built Distribution

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

music_tui-0.1.0-py3-none-any.whl (9.8 kB view details)

Uploaded Python 3

File details

Details for the file music_tui-0.1.0.tar.gz.

File metadata

  • Download URL: music_tui-0.1.0.tar.gz
  • Upload date:
  • Size: 10.8 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for music_tui-0.1.0.tar.gz
Algorithm Hash digest
SHA256 c9159d3998750d1013b1a0a51ea89a78300c2e093ee56e81c934555e09ea4f2a
MD5 0681e12ce8d5a8b8d6d11988ba5e047f
BLAKE2b-256 b444416188a094ed27a7246de7fd129b792d64d98901f8063e282c602b6340c1

See more details on using hashes here.

File details

Details for the file music_tui-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: music_tui-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 9.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for music_tui-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 0251adb1167490ea294c984bd0091817f122de115a7577bc7bc8cc3b3e582a2f
MD5 12b9337cc09ae4bac0591a9728e6f5af
BLAKE2b-256 a4fda40a47642e1427c6178ca66a09642eccad2aa8d2c39af05cfa8c25c36b96

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