mcg/README.textile

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.coderkun.de/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 ("python-gobject":https://live.gnome.org/PyGObject)
* "Avahi":http://www.avahi.org (optional)
* "python-keyring":http://pypi.python.org/pypi/keyring (optional)
* "python-setuptools":https://pypi.python.org/pypi/setuptools (building)


h2. Building

Build the application with _setuptools_:

bc. $ python3 setup.py build


h2. Running/Testing

For testing the application and running it without (system-wide) installation, donwload/clone the code, build it as described above and then use _setuptools_ to install it for the current user:

bc. $ python3 setup.py develop --user

After that you can run it with

bc. $ ~/.local/bin/mcg

or if _~/.local/bin/_ is on your PATH

bc. $ mcg


h2. Installing

Install the application system-wide with _setuptools_:

bc. # python3 setup.py install

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


h2. Packaging

Create a distribution package with _setuptools_:

bc. $ python3 setup.py sdist


h2. Screenshots

!https://www.coderkun.de/images/mcg-cover.png(Cover)!

!https://www.coderkun.de/images/mcg-playlist.png(Playlist)!

!https://www.coderkun.de/images/mcg-library-m.png(Library (middle-sized))!

!https://www.coderkun.de/images/mcg-library-s.png(Library (small-sized))!