2 unstable releases

0.1.2 Aug 13, 2022
0.0.9 May 25, 2022
0.0.6 Apr 30, 2022

#944 in Audio

CC0 license

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 reset to 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–26MB
~411K SLoC