A covergrid for the Music Player Daemon, focusing on albums instead of single tracks.
  • Python 97.3%
  • Meson 2%
  • CSS 0.7%
Find a file
2026-01-10 16:35:46 +01:00
data Center non-square album covers on grid views (close #112) 2026-01-10 16:34:13 +01:00
po Port UI to GTK 4 (close #85) 2024-05-23 13:02:51 +02:00
src Preserve aspect ratio of album covers in grid views (close #111) 2026-01-10 16:23:30 +01:00
.gitignore Use the build system “meson” (close #32) 2022-09-11 12:31:13 +02:00
CONTRIBUTING.textile Fix links, inline code and typos in the contribution guide 2018-09-02 10:05:37 +00:00
LICENSE Update website, links and e‑mail address 2018-03-20 22:40:10 +01:00
meson.build Bump version to 4.0.2 2026-01-10 16:35:46 +01:00
README.md Fix READMe to call meson’s “setup” command explicitly 2025-04-06 16:55:05 +02:00

CoverGrid

CoverGrid (mcg) is a client for the Music Player Daemon (MPD), focusing on albums instead of single tracks. It is not intended to be a replacement for your favorite MPD client but an addition to get a better album-experience.

Website: https://www.suruatoel.xyz/codes/mcg

License: GPL v3

Dependencies:

Additionally a MPD server (version >= 0.21.0) is required at runtime.

Building

Build the application with meson and ninja:

$ meson build
$ ninja -C build

Running/Testing

For testing the application and running it without (system-wide) installation, donwload/clone the code, build it with the --prefix option and install it with ninja:

$ meson setup --prefix $(pwd)/install build
$ ninja -C build
$ ninja -C build install

After that you can run it with mesons devenv command:

$ meson devenv -C build src/mcg

Installing

Install the application system-wide with meson (after building):

$ ninja -C build install

Note: On Linux using the distributions package manager is the preferred way of installing applications system-wide.

Screenshots

CoverGrid’s cover panel with album details and track list.

CoverGrid’s playlist panel with queued albums.

CoverGrid’s library panel showing the albums middle-sized.

CoverGrid’s library panel showing the albums small-sized.