A covergrid for the Music Player Daemon, focusing on albums instead of single tracks.
Go to file
coderkun fac7a85566 Use the build system “meson” (close #32)
Replace the build system “setuptools” with “meson”.
2022-09-11 12:31:13 +02:00
data Use the build system “meson” (close #32) 2022-09-11 12:31:13 +02:00
po Use the build system “meson” (close #32) 2022-09-11 12:31:13 +02:00
src Use the build system “meson” (close #32) 2022-09-11 12:31:13 +02: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 Use the build system “meson” (close #32) 2022-09-11 12:31:13 +02:00
README.textile Use the build system “meson” (close #32) 2022-09-11 12:31:13 +02:00

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

h1. CoverGrid

CoverGrid (mcg) is a client for the "Music Player Daemon":http://www.musicpd.org (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":http://www.gnu.org/licenses/gpl.html v3

Dependencies:

* "Python":http://www.python.org 3
* "GTK":http://www.gtk.org 3 (>= 3.22) ("python-gobject":https://live.gnome.org/PyGObject)
* "Avahi":http://www.avahi.org (optional)
* "python-keyring":http://pypi.python.org/pypi/keyring (optional)
* "meson":https://mesonbuild.com/ and "ninja":https://ninja-build.org/ (building)

Additionally a "MPD":http://www.musicpd.org server (version >= 0.21.0) is required at runtime.


h2. Building

Build the application with _meson_ and _ninja_:

bc. $ meson build
$ ninja -C build


h2. 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@:

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

After that you can run it with _mesons_ @devenv@ command:

bc. $ meson devenv -C build src/mcg


h2. Installing

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

bc. $ ninja -C build install

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


h2. Screenshots

!https://suruatoel.xyz/images/mcg-cover-s.png(CoverGrid\u2019s cover panel with album details and track list.)!

!https://suruatoel.xyz/images/mcg-playlist.png(CoverGrid\u2019s playlist panel with queued albums.)!

!https://suruatoel.xyz/images/mcg-library-m.png(CoverGrid\u2019s library panel showing the albums middle-sized.)!

!https://suruatoel.xyz/images/mcg-library-s.png(CoverGrid\u2019s library panel showing the albums small-sized.)!