Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/yktoo/ymuse
GTK client for Music Player Daemon (MPD) written in Go
https://github.com/yktoo/ymuse
go gtk3 linux mpd mpd-client
Last synced: 1 day ago
JSON representation
GTK client for Music Player Daemon (MPD) written in Go
- Host: GitHub
- URL: https://github.com/yktoo/ymuse
- Owner: yktoo
- License: apache-2.0
- Created: 2020-04-23T16:55:28.000Z (over 4 years ago)
- Default Branch: dev
- Last Pushed: 2024-08-05T08:17:21.000Z (3 months ago)
- Last Synced: 2024-10-25T09:12:09.377Z (22 days ago)
- Topics: go, gtk3, linux, mpd, mpd-client
- Language: Go
- Homepage: https://yktoo.com/en/software/ymuse/
- Size: 1.04 MB
- Stars: 255
- Watchers: 9
- Forks: 14
- Open Issues: 16
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: COPYING
Awesome Lists containing this project
README
[](https://github.com/yktoo/ymuse/releases/latest)
[](https://github.com/yktoo/ymuse/releases)
[](COPYING)
[](https://github.com/yktoo/ymuse/actions/workflows/go.yml)
[](https://goreportcard.com/report/github.com/yktoo/ymuse)
#  Ymuse
**Ymuse** is an easy, functional, and snappy GTK front-end (client) for [Music Player Daemon](https://www.musicpd.org/) written in Go. It supports both light and dark desktop theme.
[](https://res.cloudinary.com/yktoo/image/upload/blog/e6ecokfftenpwlwswon1.png)
It supports library browsing and search, playlists, streams etc.
[](https://res.cloudinary.com/yktoo/image/upload/blog/wqud8spomcmuduvgar9d.png)
[](https://res.cloudinary.com/yktoo/image/upload/blog/pnwj9nlucfuobw0vcv0l.png)
Watch Ymuse feature tour video:
[](https://www.youtube.com/watch?v=h0g2gk5DM8s)
## Installing
* If your distribution supports [snap packages](https://snapcraft.io/ymuse): `sudo snap install ymuse`
* Ubuntu (as of 23.04) or Debian Testing: `sudo apt install ymuse`
* A flatpak is available in the [Flathub repository](https://flathub.org/apps/details/com.yktoo.ymuse).
* Otherwise, you can use a binary package from the [Releases](https://github.com/yktoo/ymuse/releases) section.
## Building from source
### Requirements
* Go 1.22+
* GTK 3.24+
### Getting started
1. [Install Go](https://golang.org/doc/install)
2. Make sure you have the following build dependencies installed:
* `build-essential`
* `libc6`
* `libgtk-3-dev`
* `libgdk-pixbuf2.0-dev`
* `libglib2.0-dev`
* `gettext`
3. Clone the source and compile:
```bash
git clone https://github.com/yktoo/ymuse.git
cd ymuse
go generate
go build
```
4. Copy over the icons and localisations:
```bash
sudo cp -r resources/icons/* /usr/share/icons/
sudo cp -r resources/i18n/generated/* /usr/share/locale/
sudo update-icon-caches /usr/share/icons/hicolor/*
```
This will create the application executable `ymuse` in the project root directory, which you can run straight away.
## Packaging
### DEB and RPM
Requires `goreleaser` installed.
```bash
goreleaser release --clean --skip=publish [--snapshot]
```
### Flatpak
1. Install `flatpak` and `flatpack-builder`
2. `flatpak remote-add flathub https://flathub.org/repo/flathub.flatpakrepo`
3. `flatpak-builder dist /path/to/com.yktoo.ymuse.yml --force-clean --install-deps-from=flathub --repo=/path/to/repository`
4. Optional: make a `.flatpak` bundle:
`flatpak build-bundle /path/to/repository ymuse.flatpak com.yktoo.ymuse`
### Snap
Install and run `snapcraft` (it will also ask to install Multipass, which you'll have to confirm):
```bash
snap install snapcraft
snapcraft clean # Optional, when rebuilding the snap
snapcraft
```
## License
See [COPYING](COPYING).
## Credits
* Icon artwork: [Jeppe Zapp](https://github.com/mrzapp)
* [gotk3](https://github.com/gotk3/gotk3)
* [gompd](https://github.com/fhs/gompd) by Fazlul Shahriar
* [go-logging](https://github.com/op/go-logging) by Örjan Fors
* [goreleaser](https://goreleaser.com/) by Carlos Alexandro Becker et al.
## TODO
* Automated UI testing.
* Drag’n’drop of multiple tracks in the play queue.
* More settings.
* Multiple MPD connections support.