A covergrid for the Music Player Daemon, focusing on albums instead of single tracks. https://www.suruatoel.xyz/codes/mcg.html
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
Go to file
coderkun 92737cd045 Update requirements in README
Add the minimum required version of GTK and MPD to the requirements in
the README.
2 years ago
data Bump version to 3.0.1 2 years ago
locale Update translation catalogues 2 years ago
mcg Fix error handling to operate on error number 2 years ago
.gitignore Ignore files generated by “setuptools” 6 years ago
CONTRIBUTING.textile Fix links, inline code and typos in the contribution guide 5 years ago
LICENSE Update website, links and e‑mail address 5 years ago
README.textile Update requirements in README 2 years ago
setup.py Bump version to 3.0.1 2 years ago

README.textile

This file contains invisible Unicode characters!

This file contains invisible Unicode characters that may be processed differently from what appears below. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to reveal hidden characters.

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

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)
* "python-setuptools":https://pypi.python.org/pypi/setuptools (building)

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

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 distributions 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. Cover/image configuration

Since MPD itself does not provide the cover/image/album art binaries, yet, _mcg_ has to look for them itself. In order to find the images a base folder has to be configured on the Connection tab as “Image Directory”. This value can either be a local (absolute) folder (e.g. /home/user/music/) or an http URL (e.g. http://localhost/music/). _mcg_ then adds the (relative) folder of the audio file to this paths and tries different names for the actual file:

# the album name
# “cover”
# “folder”

The following file extensions are used:

# png
# jpg

The first combination that results in an existing file is used as cover image. If no matching file exists, _mcg_ will try to traverse the directory for any image file as fallback—this is done for local paths only though, not for http URLs.


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.)!