Skip to content

zX3no/gonk

Folders and files

NameName
Last commit message
Last commit date

Latest commit

d61e4f4 · Jan 7, 2025
Jul 31, 2022
Jan 1, 2025
Oct 6, 2024
Jan 7, 2025
Jun 22, 2022
Dec 23, 2023
Jan 7, 2025
Dec 21, 2023
Aug 19, 2022
Aug 23, 2024
Aug 6, 2024

Repository files navigation

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
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
Select All Control + A
Add song to queue Enter
Add selection to playlist Shift + Enter
-
Queue 1
Browser 2
Playlists 3
Settings 4
Search /
Exit Search Escape | Tab
-
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 reset to reset your database. If this doesn't work, you can reset the database by deleting %appdata%/gonk/ or ~/gonk on 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!