A terminal music player written in Rust.
Features:
- Scans your system for audio files
- TUI interface for browsing and playing music
- Playback controls with keyboard navigation
- Rust (1.56 or later)
- A directory containing audio files (MP3, FLAC, WAV, etc.)
git clone https://github.com/nebyu08/kyoka.git
cd kyokacargo build --releaseThis creates an optimized binary in target/release/kyoka.
cargo run --releaseIf all your music is in a particular directory, use:
cargo run --release -- --dir ~/MusicReplace ~/Music with the path to your music folder.
Navigate and control the music player using these keyboard shortcuts:
| Key | Action |
|---|---|
Tab |
Switch between screens |
↑/↓ |
Navigate songs |
G |
Move track down |
gg |
Move track up |
Enter |
Play selected song |
Space |
Pause/resume |
q |
Quit |
- ratatui - Terminal UI framework
- crossterm - Terminal handling
- rodio - Audio playback
- tokio - Async runtime
- walkdir - Filesystem traversal
- rayon - Parallel processing
MIT