2 unstable releases
| 0.1.2 | Aug 13, 2022 |
|---|---|
| 0.0.9 | May 25, 2022 |
| 0.0.6 |
|
#1147 in Audio
28 downloads per month
360KB
9K
SLoC
Gonk
A terminal music player.
⚠️ Warning
- Gonk is under heavy development. Expect breaking changes.
✨ Features
- Easy to use
- Windows and Linux support (WASAPI, ALSA, Jack)
- Plays FLAC, MP3, OGG, M4A and WAV
- Fuzzy search
- Vim-style key bindings
- Mouse support
📦 Installation
I recommend a font with ligatures for the best experience.
Download the latest release and add some music.
gonk add ~/Music
From Source
Debian: sudo apt install libasound2-dev pkg-config build-essential libjack-jackd2-dev
Windows: Nothing required
git clone https://github.com/zX3no/gonk
cd gonk
cargo install --path gonk
gonk
⌨️ Key Bindings
| 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 | X |
| Delete without confirmation | Shift + X |
| Clear queue | C |
| Clear except playing | Shift + C |
| Change Mode | Tab |
| Settings | , |
| Playlists | . |
| Search | / |
| Add to playlist | Shift + Enter |
| Update database | U |
| Quit | Ctrl + C |
| Move song | 1 / Shift + 1 |
| Move album | 2 / Shift + 2 |
| Move artist | 3 / Shift + 3 |
⚒️ Troubleshooting
-
Gonk doesn't start after an update.
Run
gonk resetto reset your database. -
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
~13–27MB
~432K SLoC