A terminal-based music player written in Rust using ratatui and crossterm.
Navigate your filesystem, browse audio files, and play music — all in the terminal.
- TUI interface with multiple screens
- Library view
- File browser
- Playlist (coming soon)
- Navigate directories using keyboard
- Dotfiles are hidden by default
- Modular, extensible codebase
- Persistent library
Library Screenshot 1
Library Screenshot 2
Browser Screenshot 1
git clone git@github.com:ducks/shelltrax.git
cd shelltrax
cargo run| Key | Action |
|---|---|
1 |
Go to Library |
5 |
Go to Browser |
| Key | Action |
|---|---|
a |
Add file/dir to playlist |
| Key | Action |
|---|---|
Tab |
Toggle focus left/right |
Enter |
Play selected track |
c |
Toggle pause/resume |
n |
Next song |
p |
Toggle autoplay |
Backspace |
Go up a directory (Browser) |
Space |
Toggle artist/album view |
Up/Down |
Navigate lists |
- Hide dotfiles
- Prevent duplication
- Library persistence
- Audio playback via
rodio - Autoplay
- Sort directories before files
- Playlist screen with queue
- Footer bar with help / now playing
- Config file for keybindings and paths
- Save/restore last visited directory
- Match more
cmuskeybindings and behaviors (e.g.Tab,v,:)