Clarify encoding using single track FLAC and cue sheet

Demonstrate how to specify encoding outputs from the commandline
when using a single track FLAC with the -d option. Thanks to
shantiq for the report and suggested fix.

Moved abcde.py to examples/abcde.py

Ready for any Python Master to take up Jesus Climent's work.

Start development for abcde 2.7.1

Release version 2.7

Add 'Andrew Strong' as man page contributor

Add 'Andrew Strong' to copyright notices

Remove USEPIPES from debian/docs

This file was folded into the FAQ document.

Clarify abcde maintainers in FAQ

Add upstream changelog summary for 2.7-1

Remove TODO file, removed upstream

Licensing cleanup to match upstream

Clarify the old "public domain" mention in the license, now removed
upstream.

Update the Vcs- fields to point to current upstream

Clean up licensing statements

Extend my copyright claims
Remove the old "shall become public domain" notice. I've been hacking
on abcde as GPL for a number of years, so let's go that route.

Older versions are still available under public domain if desired.

Remove Jesus and Colin from Maintainer and Uploaders fields

Merge latest versions of Debian packaging files

Cleaned up the suggested post_encode () embedding

Thanks to raztus for suggesting a more sane variable name...

cue2discid: Python 3 fixes

cue2discid: Fix possibly undefined variables

Changelog updates...

White space fix...

Rewrite the mungefilename function

The function has been overhauled and now makes more sense
syntactically and allows better for 'correct' filenames under
Windows and Linux. It aims now to:

 1. Delete any dots preceding the title
 2. Replace all spaces with an underscore
 3. Delete a grab bag of characters which variously Windows
    and Linux do not permit

Thanks to Andreas Kusalananda Kahari for this and also thanks
to Andrew Willis for the report which triggered the rewrite.
This closes Issue 135.

Remove the TODO document

git blame demonstrates that this file has not been added to for
10 years. It is out of date and I suspect of no further use in
continuing abcde development.

Badge the upcoming release as 2.7 rather than 2.6.1

The amount of new features and bug fixes justify a bigger
point upgrade.

Update README in preparation for release

Clarify the mungefilename function documentation

Rewrite the comments on the mungefilename in the sample abcde.conf
file. Thanks to Reuben Thomas for the notification and suggested
fix. This closes Issue 125.

Redirection renovations

Thanks to basinilya for the patch which resolves Issue 134.

Album art: screen for 1x1 gif from Amazon

When there is no cover image on Amazon there should be an error
message. Instead a 1x1 pixel gif is provided for download which
is used by abcde as album art. This patch provides a simple size
test which will delete the troublesome gif and then allow glyrc
to download. Thanks to Johannes Gernemann for the patch which
resolves Issue 141.

TRACKTOTAL written to ogg files

Explanatory notes concerning TRACKTOTAL

Total tracks written to meta tag in flac encoding

This fixes Issue 76, thanks to monkth for the notification.

Clarification for USEPIPES in the FAQ

Added a list of encoders and rippers tested successfully with
USEPIPES.

USEPIPES information added to the abcde FAQ doc

Edits also to abcde man page and altered reference in abcde
itself.

Corrects FDKAACENCOPTS option in sample abcde.conf

Fix for 'fallback' fdkaac bitrate

The previously set fallback bitrate for encoding with fdkaac was
set incorrectly. Thanks to Doug Mcmahon for the report.

Add 'getalbumart' to the -a options in abcde -h

The file KNOWN.BUGS removed

git blame reveals that this file was created in 2004 and has not been
edited since. It has not reflected any of the bugs in the last 10 years
and I suspect will not be used in future development.

Album art (Part 3 of3)

Documentation for getalbumart. The most instructive document
will be the abcde FAQ.

Album art (Part 2 of3)

Major enhancements of the new getalbumart function which for the
most part will require ImageMagick:

 1.The use of ImageMagick's 'identify' to give a user configurable
   commandline description of the album art
 2.The use of ImageMagick's 'display' to give a user configurable
   visual display of the album art
 3.The ability to manually download a different image using either
   URL or local path
 4.The ability to convert image formats, or to simply modify the
   downloaded album art, using ImageMagick's 'convert'

More detail on these options and on getalbumart in general will
come in the final commit of the album art updates. Thanks to
Richard for all of his hard work on this!!

Added an alternative commandline option for getalbumart

Now getalbumart can be called from the commandline as follows:

  abcde -o mp3:-V2 -G

as well as the slightly more cumbersome:

  abcde -o mp3:-V2 -a default,getalbumart

More informations coming on these options in the FAQs...

Updates to the man pages for libcdio (cd-paranoia)

Support for ripping with libcdio's cd-paranoia

Support added for ripping with the GNU Compact Disc
Input and Control library (libcdio) as requested by
both gentoo and NixOS. The utility used is cd-paranoia
and can best be called from a conf file as follows:

  CDROMREADERSYNTAX=libcdio
  CD_PARANOIA=cd-paranoia
  CDPARANOIAOPTS="--never-skip=40 --verbose"

with the CD_PARANOIA variable giving the correct path
to cd-paranoia. I believe that cd-paranoia uses the same
options as cdparanoia but if I am proven incorrect this
will need to be rectified...

Clarify mp3 tagging options

More information on GLYRCOPTS...

Album art (Part 1 of3)

Automated downloading of album art in up to three steps:

 1. If CDDMETHOD is musicbrainz cover is downloaded
    from coverartarchive by MBID
 2. If method 1 fails download is tried from amazon
    by ASIN
 3. If 1 and 2 fail or CDDBMETHOD is cddb, album will
    be downloaded using glyrc by artist + album title

Thanks to Johannes Gernemann for the patch and thanks
to Richard for further development of the patch.
This partially addresses Issue 33 which will be fully
addressed in Parts 2 & 3 of this series of commits.

Final whitespace fix (hopefully)

Readability and white space fixes in dotag ()

Fix for encoding with bladeenc and usepipes

Encoding with bladeenc and usepipes has been broken for a while:

Commit: edc5c93e46663d19d8dd7d8b6eba38de2f9fe5ee

This commit places the correct stdin option and alters the bladeenc
options to allow bladeenc and usepipes to work.

Fix for broken ripping with dagrab

This kick-starts ripping with dagrab, broken for some time. I
suspect some deeper work is required in do_cdread () however.
This closes issue 140.

mp3gain removed from 'Recommends' in Debian/control

In Debian mp3gain has been removed so it is also removed from
the install information. This fixes Debian issue #767868.

Fix for diskutil selecting wrong disk on OS X

On OS X after inserting an audio cd if a USB disk was connected
abcde will think the USB disk is the audio CD. Thanks to Richard
for the fix which closes Issue 139.

Error checking and documentation for abcde-musicbrainz-tool

Added some error checking and documentation for the
abcde-musicbrainz-tool. Thanks yet again to Matthias
Andree for this work! Closes issue 138.

Bitrate given for FDKAACENCOPTS

fdkaac chokes without either a bitrate or bitrate-mode
specified so a bitrate is set to avoid failed encode (if
no option specified for FDKAACENCOPTS in ~/.abcde.conf).

Final white space fix...

Adjustments to pird ripping after recent usepipes fix

Thanks again to Karsten Heinze for this fix and for the great
cd ripper pird:

https://github.com/karheinz/pird

Readability and white space corrections in do_encode ()

Readability: white space fixes

Backwards compatability for those still using AACENCOPTS

aac renovations part two...

a. New variables for m4a/aac encoding options to be
   manipulated from a users ~/.abcde.conf file:
    1. FAACENCOPTS for faac encoding options
    2. NEROAACENCOPTS for neroAacEnc options
    3. FDKAACENCOPTS for fdkaacenc options
   Note that these options replace the now obsolete
   AACENCOPTS.
b. New check for NeroAacTag when using neroAacEnc

c. faac, neroAacEnc and fdkaac added to usepipes,

aac encoding within abcde now almost complete...

Minor correction to usepipe syntax

Several additions to usepipes

The following encoders have been added to usepipes:

 1. mp3enc: mp3
 2. speexenc: Speex
 3. mpcenc: Musepack SV8
 4. wavpack: WavPack

The cd ripper cdda2wav (icedax) has also been added.

Fix for broken usepipes

'Usepipes' has been broken for many years, this patch simply
represents a partial revert for the original breakage:

Commit: 900a8efeddb238a1e67fec41857e3d2594227dde

This allows usepipes to run again but exposes abcde to the
issue on macosx10 which this commit tried to rectify:

https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=527191

So some more attention will be required here. Tested with
cdparanoia and cdda2wav which were both fine, I presume
icedax is also fine. dagrab failed but I see that is also
broken in release version 2.6. Pird and cddafs remain
to be tested.

Rectify some crucial WavPack typos

Suggested encoding options for mp3enc

Suggested encoding options for mp3enc added to the sample
abcde.conf. Last release of mp3enc in 1998 but it still
works flawlessly with a modern abcde!

Allows for cleaner handling +/- Comment with WavPack

Suggested encoding options for l3enc

Suggested encoding options for l3enc added to the sample
abcde.conf. Congratulations to abcde which in 2015 still
works with l3enc which saw its final release in 1997!

Fix the apetag check

Plus minor syntax correction to changelog.

Several very small edits to sample abcde.conf

  1. Changed System 'defaults' to 2.6.x
  2. Applied # to previously missed wv options
  3. Shuffled a few variables to their proper location
  4. Added replaygain to 'actions' section
  5. Changed several instances of xENCODER to xENCODERSYNTAX
  6. Corrected APENCOPTS to '-c4000'
  7. Made the aac options a little more readable
  8. Segregated the reasonably complex mp3 tagging options a little

Minor Musepack encoding cleanup

Several very small adjustments to Musepack encoding:

  1. Allow for +/- comment field
  2. Allow for tag and no tag
  3. Remove a final mention of 'mppgain' from man pages

Fix for -o option use with options and multiple outputs

This allows for commandline options such as the following:
       abcde -o 'flac:-8,mp3:-b 320'
Thanks to Matthias Andree for yet another quality patch!
This closes Issue 136.

Changelog updates

Replaygain for WavPack files

The addition of wvgain allows replaygain for WavPack files. By
default this allows 'track gain', we also use an option to add
'album gain' tagging as well.

Replaygain fix for Musepack

Replaygain for Musepack was still set for SV7's replaygain and
thus broken under SV8. This commit changes support to SV8's mpcgain.

Add $APENCODER and $APETAG to abcde checks

Particularly important for apetag which is not that
commonly packaged...

Monkey's Audio encoding (re-)added

Encoding to Monkey's Audio (ape) using Monkey's Audio
Console (mac). Tagging with Robert Muth's 'apetag'.
Thanks to Shantiq for testing.

Temporarily revert Monkey's Audio commit....

This reverts commit f851f580b1ac9356a1c32d2d1791a3b6c899b2d6.

Monkey's Audio (ape) encoding added

Encoding to Monkey's Audio (ape) format now supported using
Monkey's Audio Console Front End (mac). Tagging uses APEv2
tags from Robert Muth's apetag application.

Changelog updates

Musepack encoding syntax improved readability.

Simplify opus tagging options

This rectifies Issue 133.

Allow cleaning when OUTTPUTYPE=wav
Thanks to Roger rogerx.oss<at>gmail.com for
highlighting the problem and demonstrating the
solution. This closes Issue 94.

CDDBLOCALRECURSIVE is required for local CDDB search

Clarify that CDDBLOCALRECURSIVE should be set to "y"
for local CDDB search. Thanks to Reuben Thomas for
the notification.

This closes Issue 121.

Add WavPack to debian/control

Remove AtomicParsley from debian/control

eyeD3: Set only one date when tagging

Use only 'recording date' rather than couple with
'release date'. This is the default for ide3v2 and
makes more sense than having two dates in place.

Changelog updates

Explanatory notes: faac and mp4v2

Allow fdkaac to tag 'Recorded date' for CDYEAR.

eyeD3: Use a 'Year' tag that common applications will read.

eyeD3 currently uses TDRL 'release year' for CDDB's Date
entry which applications such as vlc and Audacious ignore.
This patch allows the same value to also be written as
TDRC 'recording date' which vlc and Audacious will read.

Thanks to Reuben Thomas for finding the issue and
demonstrating the fix. This closes Issue 126.

Standardise suggested encoder options in abcde.conf

WavPack details added to abcde.conf

Changelog updates.

Fix for flac floating point error.

Thanks to rwvtveer for the report and the workaround.
This fixes Issue 113.

mp3 tagging: giving some more options

This update allows 3 different ways to tag mp3 files
using ID3TAGV:

  * id3v2.4 using eyeD3 (set in abcde as the default)
  * id3v2.3 using id3v2
  * id3v1 using id3

Thanks to Adriaan for this patch which fixes issue 101.

Support for WavPack added. Closes issue 123.

eyeD3 version switch < 0.7 vs. >= 0.7

Thanks to Matthias Andree for this patch which
accomodates mp3 tagging with both pre and post
0.7 eyeD3 versions.

This rectifies Issue 116 and Issue 120

aac encoding renovations:

  * Faac encoding with & without libmp4v2 rectified
  * neroAacEnc 'formally' added to abcde, tagging with neoAacTag
  * FDK AAC encoding introduced using fdkaac, inline tagging used
  * AtomicParsley temporarily removed as not currently needed

Thanks to Doug Mcmahon for assistance with the above changes...

Branding the development version: 2.6.1-UNRELEASED

Drop EXTRAVERBOSE debugging noise

Remove stale -B option comment

Man page escape syntax fix