7 releases
Uses new Rust 2021
new 0.0.7 | May 11, 2022 |
---|---|
0.0.6 | Apr 30, 2022 |
#95 in Audio
226 downloads per month
210KB
5.5K
SLoC
Gonk
A simple terminal music player.

✨ Features
- Vim-style key bindings
- Easy to use
- Fuzzy search
- Mouse support
- Cross-platform
- Plays FLAC, MP3, OGG, M4A and WAV
📦 Installation
MacOS has not been testing.
I recommend using a font with ligatures for the best experience.
crates.io
cargo install gonk
From source
Install the dependencies.
git clone https://github.com/zX3no/gonk
cd gonk
cargo install --path gonk
Add some music:
gonk add D:/Music
Dependencies
Debian:
sudo apt install libasound2-dev pkg-config build-essential
Fedora:
Not tested.
dnf install alsa-lib-devel pkgconfig
Alpine:
apk add pkgconf alsa-lib-dev alpine-sdk
⌨️ Key Bindings
Windows: %appdata%/gonk/gonk.toml
Linux: ~/.config/gonk/gonk.toml
Command | Key |
---|---|
Move Up | K / UP |
Move Down | J / Down |
Move Left | H / Left |
Move Right | L / Right |
Volume Up | W |
Volume Up | S |
Play/Pause | Space |
Previous | A |
Next | D |
Seek -10s | Q |
Seek 10s | E |
Delete Song | X |
Clear Queue | C |
Clear Except Playing | Shift + C |
Change Mode | Tab |
Search | / |
Quit | Ctrl + C |
? | Escape |
? | Backspace |
1, 2, 3
moves the queue margins forward. Shift + 1, 2, 3
moves them backwards.
⚒️ Troubleshooting
If your music player has broken lines, increase your zoom level or font size.
❤️ Contributing
Feel free to open an issue or submit a pull request!
Dependencies
~46MB
~775K SLoC