#music #music-player #tui #fuzzy-search #wav #terminal

app gonk

A simple terminal music player

7 releases

Uses new Rust 2021

new 0.0.7 May 11, 2022
0.0.6 Apr 30, 2022

#95 in Audio

Download history 101/week @ 2022-04-22 75/week @ 2022-04-29 50/week @ 2022-05-06

226 downloads per month

MIT license

5.5K SLoC


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.


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



sudo apt install libasound2-dev pkg-config build-essential


Not tested.

dnf install alsa-lib-devel pkgconfig


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!


~775K SLoC