Repository files navigation

Gomu is intuitive, powerful CLI music player. It has embedded scripting languageand event hook to enable user to customize their config extensively.

• lightweight
• simple
• fast
• show audio files as tree
• queue cache
• vim keybindings
• youtube-dl integration
• audio file management
• customizable
• find music from youtube
• scriptable config
• download lyric
• id3v2 tag editor

If you are using ubuntu, you need to install alsa and required dependencies

$ sudo apt install libasound2-dev go

Optional dependencies can be installed by this command

$ sudo apt install youtube-dl

$ go get -u github.com/issadarkthing/gomu

For arch users, you can install from the AUR

usingyay:

$ yay -S gomu

usingaura:

$ sudo aura -A gomu

By default, gomu will look for audio files in~/music directory. If you wish to change to your desired location, edit~/.config/gomu/config fileand changemusic_dir = path/to/your/musicDir.

Each panel has it's own additional keybinding. To view the available keybinding for the specific panel use?

Gomu usesanko as its scripting language. You can readmore about scripting at ourwiki

Keybinds.def_g("ctrl_x",func() {out,err=shell(`echo "hello world"`)iferr!=nil {debug_popup("an error occured")    }info_popup(out)})

I just wanted to implement my own music player with a programming language i'm currently learning (Go). Gomu might not be stable as it in constant development. For now, it can fulfill basic music player functions such as:

• add and delete songs from queue
• create playlists
• skip
• play
• pause
• forward and rewind

• termusic (Written in rust and well maintained)

For songs downloaded by Gomu, the thumbnail will be embeded as Album cover. If you're not satisfied with the cover, you can edit it with kid3 and attach an image as album cover. Jpeg is tested, but other formats should work as well.

Hi! If you guys think the project is cool, you can buy me a coffee ;)

Seeking and more advanced stuff has not yet been implemented; feel free to contribute.