1 unstable release
| 0.1.2 | Aug 13, 2022 |
|---|
#947 in Audio
Used in 2 crates
40KB
1K
SLoC
Gonk
A terminal music player.
⚠️ Warning
- This is a place where I test new ideas. I would not recommend using this as your music player.
✨ Features
- Easy to use
- Plays FLAC, MP3 and OGG
- 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
Building from Source
Linux is currently unsupported.
git clone https://github.com/zX3no/gonk
cd gonk
cargo install --path gonk --features "strip"
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 Down | S |
| Mute | Z |
| Play/Pause | Space |
| Previous | A |
| Next | D |
| Seek -10s | Q |
| Seek 10s | E |
| Clear queue | C |
| Clear except playing | Shift + C |
| Add song to queue | Enter |
| Add song to playlist | Shift + Enter |
| - | |
| Queue | 1 |
| Browser | 2 |
| Playlists | 3 |
| Settings | 4 |
| Search | / |
| Exit Search | Escape |
| - | |
| Delete song/playlist | X |
| Delete without confirmation | Shift + X |
| - | |
| Move song margin | F1 / Shift + F1 |
| Move album margin | F2 / Shift + F2 |
| Move artist margin | F3 / Shift + F3 |
| - | |
| Update database | U |
| Quit player | Ctrl + C |
⚒️ Troubleshooting
-
Gonk doesn't start after an update.
Run
gonk resetto reset your database. If this doesn't work, you can reset the database by deleting%appdata%/gonk/or~/gonkon linux. -
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
~6.5MB
~176K SLoC