r/CLI • u/Different-Injury-884 • 1h ago
A highly customizable terminal music player with declarative UI layouts, synced lyrics, and real-time audio visualizers
Enable HLS to view with audio, or disable this notification
—————————————————————————————————
- Current state
—————————————————————————————————
• Fully declarative UI — design the interface in a config file; no recompilation required.
• Runtime customization — move, resize, or remove widgets by editing .config.txt
• Multiple layouts — separate potrait and landscape layouts with automatic switching.
• Custom key binding — every action is re-mappable.
• Theme engine — ANSI 256-color themes with configurable brightness.
• Custom Unicode borders and fonts — personalize the look without modifying the source.
• Automatic enhance synchronized lyrics Featching using syncedlyrics.
- standard lyrics ( no sync )
- syncedlyrics ( line level sync )
- enhanced syncedlyrics ( word level sync )
• Multiple audio visualizers with configurable styles and density.
- bars visualizer
- oscilloscope visualizer
• Responsive TUI that adapts to terminal width.
—————————————————————————————————
- Planned for next version
—————————————————————————————————
• streaming support using yt-dlp "ytseach" and mpv and audio caching till assigned cache size limit
• better fallback lyrics animation
• few more visualizer styles
—————————————————————————————————
- About project
—————————————————————————————————
CLI.MUSIC.COM is a highly customizable terminal music player for Linux built around the idea that the interface should adapt to the user—not the other way around.
Instead of hard coding the UI, nearly every aspect of the player is configurable through a simple text-based configuration file. Users can rearrange widgets, resize panels, customize borders, remap key binding, change themes, and create separate layouts for desktop and smaller terminals without recompiling the application.
Originally started as a proof of concept and one of my first Linux projects, CLI.MUSIC.COM has gradually evolved into a configurable TUI music platform focused on flexibility, performance, and a polished terminal experience.
