🎵 Rithmos

Music in your terminal, made simple

🎧 What is Rithmos?

A lightweight CLI music player that uses your existing audio collection. Built with Rust for speed and efficiency.

🚀 Features

🎶 Play MP3, FLAC, and WAV files
📁 Automatic music directory detection
🔄 Shuffle playback with smart history
🎚️ Volume control (+/- 10% increments)
🔁 Multiple repeat modes (Off/One/All)
📊 Interactive terminal UI with progress bar
⚡ Near-instant startup

🎮 Controls

↑/↓ or j/k: Navigate playlist
Space: Play/Pause
+/−: Adjust volume
R: Toggle shuffle
L: Cycle repeat modes
Q: Quit

🏃‍♀️ Running Program

You can run this software with "rithmos [directory for your music]!

📦 Tech Stack

Rust (core functionality)
rodio (audio playback)
symphonia (audio metadata)
ratatui (terminal UI)