TDiffff/ratatune

★ 0Forks 0RustGitHub ↗Compare

README

ratatune

Terminal music player with a modern TUI, forked from termusic by Larry Hao.

Status: WIP / 0.1.0-dev

Features

  • ratatui-based TUI with resizable panels and drag-to-resize nodes
  • Dropdown menu system with nested submenus (File, Playlist, View, Settings)
  • FFT visualizer with spectrometer (scrolling heatmap), mirror modes, and braille/block rendering
  • 21 built-in color themes (YAML-based, user-extensible)
  • Album art display in-terminal via ratatui-image
  • Multi-playlist management with sidebar panel and gRPC server backend
  • Audio analytics showing codec, sample rate, bit depth, and bitrate

Build

cargo build
cargo run

Requires mpv or gstreamer for audio playback. See the original termusic README for dependency details.

License

MIT — inherited from termusic.

Credits

Built on the excellent work of tramhao/termusic. The server, playback, and library crates are largely from the original project; the TUI is a full rewrite using ratatui.

Contributors

TDiffff

Issues