mpdthumb: Fix failure when readpicture/albumart both return data.

If a file has both embedded cover art and cover art in its directory,
both commands will return data and mpdthumb prints two lines instead
of one as expected.  Fix this by skipping the check for albumart data
if valid readpicture data was returned.

mpdmenu: Add thumbnails to standalone recording menus.

I think in typical usage cover images for standalone recordings will be
embedded and different for each file.  It's more like a list of 1-track
albums rather than a list of tracks from the same album, so probably
nice to add the images.

mpdmenu: Use embedded cover art.

If the server supports embedded cover art, all we need to do now is
pass --embedded to the thumbnailer and everything will Just Work™

mpdmenu: Add MusicBrainz links for the current track.

Having a feature to directly open relevant track and artist
pages on the web seems quite handy.

mpdmenu: Improve support for standalone recordings.

Standalone recordings have a slightly different metadata structure from
tracks associated with releases.  Let's handle them by presenting all the
standalone recordings for an artist together as if they were an actual
release by that artist.

mpdthumb: Add support for embedded cover art.

MPD has recently gained the "readpicture" command in order to retrieve
cover images embedded in files.  This works very similarly to albumart.

We now have the necessary features in mpdexec to implement this in
mpdthumb.  When the --embedded option is supplied, the script will
first try readpicture, then albumart for each file specified.

mpdexec: Add "verbose" option to print commands sent to MPD.

In order to add readpicture support to the thumbnailer in addition to
albumart, we need a better way to distinguish which commands returned
what results from the server.

An easy way to do that is to just print the commands.

mpdexec: Add support for readpicture command in download mode.

mpdthumb: Fix compatibility with newer MPD versions.

It seems that recent MPD servers have made backward-incompatible changes
to the albumart command.

Specifically, the cache check currently sends an absurdly huge offset to
avoid downloading a pointless and unnecessary multi-KB blob for every
image it is querying.  While this worked well with older servers, new
servers now reject such commands with an error instead of returning
useful information.

Fortunately, newer servers also implement the "binarylimit" command to
reduce the amount of data transferred.  For some reason we can't ask the
server to send less than 64 bytes but whatever, it is probably good
enough.

So work around the problem by testing whether the server supports
binarylimit, and use the new method if it does.  Otherwise use the
old method.  Command-line options are provided to force the behaviour
one way or the other (which avoids the extra round trip to the server).

mpdreload: Handle playlist load errors better.

When using the "load" command to load tracks from a stored playlist,
there is no guarantee that MPD will actually successfully load them.
This can occur, for example, if a playlist is created and then some
of the files in it are removed from the database.

Such failures are not reported directly by the protocol.  The "load"
command will succeed but you just get less tracks added to the play
queue.  This gets mpdreload confused as it no longer has an accurate
picture of the exact queue positions.

Solve this by querying the new queue length after tracks are loaded
from the playlist.  This allows mpdreload to determine the number of
failures and adjust the expected positions accordingly.

mpdreload: Fix batch deletion when there are still loads pending.

The batch deletion did not take into account the possibility that
some or all of the playlist may still need to be loaded afterwards
(this happens when there are tracks at the end of the target playlist
which are not in the current play queue).

This resulted in erroneous operation.  Fix that up.

And separate the batch loading into a separate routine to hopefully
clarify what the various track indices are so future me understands.

mpdthumb: Add --help and --version options.

mpdreload: Protocol optimizations.

Try harder to send fewer commands to the MPD server.  In particular:

* We can submit commands to batch-load subranges from the target
  playlist into the play queue, then move them as a group into the
  final location.

* We don't need to send move commands for tracks that are already in
  the correct final position, which helps when reloading a playlist
  very similar to the current play queue.

* By arranging for all unwanted tracks to be shifted to the end of
  the play queue during the consolidation process, these can all be
  deleted with a single command.

mpdreload: Simplify script operation.

This script doesn't need any metadata other than filenames and queue
IDs, so we don't need to store anything else in its data structures.

We can also ask MPD not to send us most unneeded information which
speeds things up a lot.

Fix print_usage file handle in the perl scripts.

Due to an off-by-one error all the perl scripts are printing the usage
line to standard error in the --help output, instead of standard output
as expected.  Fix that up.

Factor out mpd_exec from some of the perl scripts.

The simple mpd_exec function can be easily moved into the MPDHacks
module.  Leave out the one in mpdexec.pl as it is more sophisticated
to handle things like binary downloads and probably not needed for
common code.

Factor out MPD connection code.

Instead of having three different copies of the MPD connection code in
the perl scripts, let's put it all in one place.  Now mpdreload is no
longer the only script that supports UNIX socket connections.

Fix quoting of single quotes in MPD protocol.

Single quotes have to be quoted in the protocol, but were forgotten.

This is easy enough to fix but isn't helped by the fact that there
are three different copies of this bug on the perl side, so let's
split out that function into a new module and fix it there.

mpdreload: New script to refresh MPD play queue from a playlist.

This script implements the effect of clearing the current play queue
and then loading a playlist, except that the play queue is not wiped
during the process which avoids losing playback state unnecessarily.

mpdmenu: Pass top menu name into submenu generation.

This enables names based on the original menu name to be generated.
Specifically, the KillMenuMPD function is now based on the original
menu name, and the toplevel album menu is now actually the same menu
as the corresponding entry in the artist menu.

mpdmenu: Use MBIDs for track matching instead of name matching.

Instead of guessing based on titles, match tracks by their work MBID.

This makes the title menu significantly simpler as we remove all the
title-specific special cases.  This approach gives results pretty close
to what we got originally (much better in some cases), but currently
things like different symphony movements which used to show up in the
menu are not handled.

mpdmenu: Use MBIDs for artists instead of name matching.

This enables much more accurate artist menus, working properly with
variant spellings and whatnot.

mpdmenu: Use MBIDs for albums instead of name matching.

This enables much more accurate album menus, e.g., fully distinguishing
between multiple versions of the same release that would previously be
merged together into a single display.

This also adjusts the album menu to use modern MPD database query
features, so we can correctly display all tracks from the album
regardless of the state of the play queue.

mpdmenu: Restructure things a bit.

Restructure the basic program flow and update the top menu generation
using more helper functions and stuff, including a slight change to the
menu layout.  More to come.

mpdmenu: Retrieve cover art from MPD.

Recent versions of MPD support retrieving cover art, which means we
(mostly) don't need to have the music directory mounted to poke around
in it.  Augment mpdexec with support for binary transfers in order to
retrieve this cover art, and implement a new thumbnailer script which
makes use of this functionality.

Mostly, because the function to launch geeqie in the scans directory
still requires poking in the music dir.  But all the menu images should
be displayed just from the connection to MPD now.

As a bonus, the new script is quite a bit faster than the old one, too.

mpdmenu: Factor out thumbnail generation.

Prep work for making use of MPD albumart, move all calls to the
thumbnailer into a single function, and adapt the menus to call
the function once to generate an entire list of cover art.

Drop the use of the --image option in the thumbnailer by poking at
the cover art directly, since this will no longer work with MPD
albumart.

mpdmenu: Use FindBin module to locate auxiliary scripts.

With this separated from my FVWM config, the other scripts can be
located using FindBin assuming everything lives in the same directory.

Relicense MPD scripts.

It's the dawn of a new era.  I'm separating these scripts from my FVWM
configuration in preparation for some big overhauls.  Going forward,
as these are basically standalone programs in their own right we'll
be using the GNU General Public License.

(Leave thumbnail.zsh alone because the first order of business is to
kill it off).

MPD script updates.

Fix compatibility with latest perl which removes the 'encoding' pragma.

And improve mpdexec.pl to be a bit more flexible: command-line arguments
will be correctly quoted for MPD, and also add a mode to accept commands
on standard input which helps performance with long command sequences.

thumbnailer: Follow only one level of symbolic link.

Since my music is all in git annex now, the thumbnailer follows the
cover art symlinks all the way to the annex object directory.  This is
less than helpful, since the intention was to locate the album scan
directory.  Change the --image mode to just read the link once and
then stop.

scripts: Add copyright header to thumbnail.zsh.

mpdmenu: Replace all uses of mpc with mpdexec.

May as well eliminate this dependency.

mpdmenu: Use a specialized script to send playid commands to MPD.

This avoids the dependency on a patched mpc.

mpdmenu: Add support for classical movements to the title menu.

mpdmenu: Use geeqie instead of gqview.

Use /usr/bin/env in zsh #! lines.

Fix handling of & in FVWM menus.

& is only magic in the _first_ field of an FVWM menu, hence it should only
be escaped in those circumstances.

mpdmenu: Update title menu cases.

mpdmenu: Update title menu cases.

mpdmenu: Update title menu cases.

mpdmenu: remove whitespace at end of lines.

mpdmenu: don't bail out when MPD doesn't give us a songid.

This occurs when MPD is running, but hasn't played a song yet.  Make the
menu usable to start the player in this case.

scripts: remove hardcoded music directory from thumbnail.zsh.

Use a MUSIC environment variable and fall back to /home/music.  The fvwm
config sets this at startup.

Update thumbnail.zsh to use zsh conventions.

thumbnail.sh should be thumbnail.zsh.

mpdmenu: Use IO::Socket::INET6 to support IPv6 as well as IPv4.

Fix stuff for systems without bash as /bin/sh

Fix mpdmenu to work with the new scripts directory.

Move scripts into their own subdirectory.

Initial Commit.