============
Q. Who created abcde? Who develops it nowadays?
-A. It was originally created by Robert Woodcook. He decided to give up
+A. It was originally created by Robert Woodcook. He decided to give up
maintaining it at some point in 2002 and Jesus Climent took over. In 2012,
Colin Tuckley and Steve McIntyre joined in to help. Contact
jesus.climent@hispalinux.es, colint@debian.org or 93sam@debian.org if you
1. INSTALLATION
============
-
+
Q. How can I install abcde on my system?
-A. To get abcde you can use a pre-packaged version, available for Debian,
+A. To get abcde you can use a pre-packaged version, available for Debian,
FreeBSD, OpenBSD, NetBSD and others.
In case you want to install your own release, you need to download the
source and install the complementary programs (abcde is just a frontend
Read the README files for a complete list of requirements.
Q. I have a problem, and I reported some time ago. Have you solved it already?
-A. Maybe. Try downloading the trunk of the development from
+A. Maybe. Try downloading the trunk of the development from
http://abcde.googlecode.com/svn/trunk/
-
+
Q. When are you going to release a new version?
A. When it is ready. I keep on having new ideas and adding them to the trunk
(stored in the URL above), so I dont release until all the ideas are
ID3TAGV=1
Q. Low on disk space?
-A. abcde has different algorithms to schedule ripping and encoding - to
+A. abcde has different algorithms to schedule ripping and encoding - to
optimize for disk conservation, use -l. You can also define
WAVOUTPUTDIR=/some/other/path to your /etc/abcde.conf or ~/.abcde.conf to
store the WAV files on another NFS shared fisk, for example.
Q. I would like to give the trackname and the artist_name directly to the
encoder (in my case oggenc), but found no documentation.
A. That is not possible, since abcde gets the information from CDDB database.
- You can create a template and fill it with the option "-n". Also, you can
+ You can create a template and fill it with the option "-n". Also, you can
get the CDDB entry and edit it yourself. abcde has also an option to drop
back to a template if you like none of the CDDB entries, selecting 0 from
the CDDB options.
Q. (Thanks to Amaya) Where are those options and settings defined? Why dont
you include a proper abcde.conf as an example?
A. I do. It should be installed under /etc/abcde.conf and contains more or
- less all the defaults abcde uses. You can use $(HOME)/.abcde.conf to
+ less all the defaults abcde uses. You can use $(HOME)/.abcde.conf to
override those defaults. More information can be obtained from the man page
which can be consulted using "man abcde".
-
+
Q. I keep on getting files with ".ogg.ogg" extension. What am I doing wrong?
A. The code for multiple-output adds automatically the extension of the
different outputs you select with the "-o" extension (or with OUTPUTTYPE
own. If you use the predefined ones (wget, curl and fetch) abcde will try
to use some defaults. Keep in mind that the output should go to the output
as standard output, to be saved in a file for later use.
-
+
If abcde seems to be ignoring your configuration options or not running
commands such as the encoder, you may have misquoted something. Config
options such as the following do not work:
Q. How can I separate the different output files I get using multiple-output
support?
-A. Use the OUTPUT variable in PLAYLISTFORMAT and OUTPUTFORMAT. It holds the
- different output file types you passed to abcde (i.e., ogg, mp3, flac)
+A. Use the OUTPUT variable in PLAYLISTFORMAT and OUTPUTFORMAT. It holds the
+ different output file types you passed to abcde (i.e., ogg, mp3, flac)
during playlist creation and file/directory creation.
Q. I have a CD with a data track, and abcde complaints it cannot read/encode
Q. I am requested to have "eject" when setting the speed although I do not use
it for anything.
-A. If you do not use cdparanoia, eject is used for setting the speed of the
+A. If you do not use cdparanoia, eject is used for setting the speed of the
cdrom drive. You can substitute it for "setcd" with "-x" as the argument,
- but you have to install it manually (setcd is, at least, available in
+ but you have to install it manually (setcd is, at least, available in
Debian).
Another way to get the same results is using the pre_read function, defined
in your /etc/abcde.conf file.
-
+
Q. I have a CD set with 1+ discs, and want to have them in the same directory,
sorted properly. What can abcde do for me?
A. Set abcde to rip the first CD and give it the option "-t 101". Use a generic
can use only the "-t ###" option and then move all the files to the same
directory, but the tag/comment information on the files will differ. If you
want the tagged track number to be set to the modified number you should use
- "-T ###".
+ "-T ###".
Even better! If you use "-W <cd_number>", abcde will put a comment to every
CD set ("CD <number>") and modify the number of the tracks both in the file
name and the tag/comment information.
FLAC file with an embedded cuesheet. Later on, you can use the command
"abcde -o vorbis -d flac-file.flac" to extract the individual tracks in
Ogg/Vorbis format. Of course you can select whatever format you want.
-
+
3. CDDB and Musicbrainz
====================
-Q. I need to go through an HTTP proxy for CDDB access.
-A. No problem, just export your http_proxy variable first so wget/fetch/curl
+Q. I need to go through an HTTP proxy for CDDB access.
+A. No problem, just export your http_proxy variable first so wget/fetch/curl
can see it.
Q. I already store CDDB entries in my hard disc. Can I make use of them?
choice to edit such template.
Q. How can I use some other CDDB information provider?
-A. abcde now uses FreeDB by default. To use a different FreeDB mirror or
+A. abcde now uses FreeDB by default. To use a different FreeDB mirror or
another CDDB service, change the CDDBURL option in your abcde.conf.
Q. After requesting CDDB data, I received several answers which seem to be
=======
Q. What formats can I encode my music to?
-A. As for version 2.2, abcde includes support for MP3, Ogg/Vorbis,
+A. As for version 2.2, abcde includes support for MP3, Ogg/Vorbis,
Ogg/Speex, Flac and MPP/MP+(Musepack). Support for AAC will be added once
an FLOSS encoder/decoder is working.
-Q. I want the new *put the newest and coolest codec there* format to be
+Q. I want the new *put the newest and coolest codec there* format to be
supported by abcde. Abcde is so cool but i want to encode also to this
new format...
A. Patches are welcome! ;)
source/free software, it should be fairly easy to integrate. Support for
AAC (m4p) should be the next one to be introduced.
-Q. I use Debian/RedHat/(put your Unix flavour here) and MP3 encoding is not
+Q. I use Debian/RedHat/(put your Unix flavour here) and MP3 encoding is not
working. What am I doing wrong?
A. Since MP3 is considered non-free (you get it for free, but hardware players
- and net broadcasters have to pay license fees), some release engineering
+ and net broadcasters have to pay license fees), some release engineering
groups and release management teams have decided not to provide MP3 encoding
tools.
These distributions or operative systems have decided to use Ogg/Vorbis as
the default encoding format, since it contains no (known) patent claims
and they are (supposed to be) completely Free (released under a BSD-like
license).
- However, there is no strong (at the moment) hardware support, although
- some groups and companies are strongly working on getting it, real soon
+ However, there is no strong (at the moment) hardware support, although
+ some groups and companies are strongly working on getting it, real soon
now. For that reason some people prefer to encode to MP3.
UPDATE *** UPDATE
There are known brands already selling Ogg/Vorbis portable players: Rio,
iRiver, Neuros, iAudio,...
Go buy one and you have no more reasons to use MP3.
-
+
If you are among those individuals, you might need to add support for MP3
encoding to your system:
Debian : check http://ftp.nerim.net/debian-marillat to install lame in your
Others : Please, help me here.
Q. Huh! Why is MPPENCODER (with MPP) and .mpc the extension?
-A. Dunno. You must ask the guys who created and defined the format. The
+A. Dunno. You must ask the guys who created and defined the format. The
standard is MPEGplus (MPP/MP+) but the files use .mpc extension.
-
-
+
+
4. MISC PROBLEMS
==== ========
Q. What happened with normalize?
-A. Normalize has changed its name under Debian, which is the GNU/Linux
+A. Normalize has changed its name under Debian, which is the GNU/Linux
distribution for developing abcde (well, is The GNU/Linux Distribution
i only use, at the moment). Now it is called normalize-audio.
If you are using some other flavour of OS, you need to change the name
A. Well, I have a Mac, but I use linux on it. I have not been able to find
a way to make it work there, since I do not have the development tools
installed. I have placed a basic support, but some user reports are just
- complaining about abcde not encoding the ripped tracks, as if
+ complaining about abcde not encoding the ripped tracks, as if
icedax/cdda2wav/cdparanoia/cddafs would never end reading them. If you have
such a system and experience problems, please, report them, and I will
try to work them out with your help.
--------
Q. I set KEEPWAVS to "y" but abcde insists on erasing my directory, along
with the wav tracks. What I am doing wrong?
-A. The default action set includes clean, which cleans the temp directory,
+A. The default action set includes clean, which cleans the temp directory,
if nothing goes wrong. Take the "clean" out from the action list and you
are done.
UPDATE: KEEPWAVS unselects now the clean action.
abcde.conf to change it.
Many of the questions related of problems executing abcde have been moved to the
-FAQ, which should be distributed along with this package. Reffer to that file
+FAQ, which should be distributed along with this package. Reffer to that file
for more help.
MAJOR CHANGES
* Added -z for debug.
* Added -f to force the removal of left files.
* CUE support has changed from a flag (-M) to an action (cue).
-
+
Changes in 2.3:
* Support for mkcue, to create a CUE sheet of the CD structure. It can be used
with "-1" to create a backup, so that later the original CD can be recreated.
corecodecs.org. It is supposed to be Free (not only free), and released under
the GPL...
* New "-t <number>" option for starting the numbering of the output files at a
- given starting number. Ideal for albums with more than one CD.
+ given starting number. Ideal for albums with more than one CD.
* New "-T <number>" option, similar to "-t" but also modifies the tag entries
on the files themselves.
* New "-w <COMMENT>" to add a comment to the tracks of a given CD rip. Use
system.
* New mungegenre function to switch off (or modify) the default behaviour of
transforming uppercase characters to lowercase.
-* cdparanoia permits performing a query to the CD drive and obtain a list of
+* cdparanoia permits performing a query to the CD drive and obtain a list of
valid audio tracks. So, now we perform such query and process the results.
-* Support for "None of the above" has been added with the "0" selection. A
+* Support for "None of the above" has been added with the "0" selection. A
template is created, and the selection to edit it is defaulted to "y".
New options in 2.1.19:
* ONETRACK mode has been introduced. Setting the flag "-1" will create a
single file with all the tracks from the CD.
-
+
Changes in 2.1.18:
* CDSPEED option defaults to eject. However, since cdparanoia has a built-in
* Initial (still incomplete) MacOSX support is on the works.
* A new tool (curl) has been added for MacOSX compatibility, as HTTPGET
option.
-
+
Options modified from 2.1.8 to 2.1.9:
* KEEPWAVS option now sets the clean to "no".
Options added/modified from 2.0.3 to 2.1.x:
-* -b use batch processing. It uses normalize-audio to adjust the volume of
+* -b use batch processing. It uses normalize-audio to adjust the volume of
the songs, and a -g gapless option from lame to remove gaps. Only available
for mp3+lame combination.
* a new "normalize" option has been added to -a, to normalize the volume.
OUTPUTFORMAT to create different directory structures and playlist names for
each of the output formats selected.
-* DYEAR can be used as DiskYear value in CDDB data. If the data is not supplied
+* DYEAR can be used as DiskYear value in CDDB data. If the data is not supplied
by the CDDB server, it can be added.
Other options that changed from 1.x to 2.x:
Steve McIntyre <93sam@debian.org>
abcde was originally created by Robert Woodcock <rcw@debian.org>
-
"file.ext" with the "-o" flag.
Keep in mind that the example above is only that, an example, and every ripper
-and encoder differs from in each other in the way they interact with pipes.
+and encoder differs from in each other in the way they interact with pipes.
For one reason, not all the rippers and encoders are supported by abcde: the
author (or the users) have not included support for them.
else
OUTPUTFILE="$(eval echo \""$ONETRACKOUTPUTFORMAT"\")"
fi
- else
+ else
if [ "$VARIOUSARTISTS" = "y" ]; then
OUTPUTFILE="$(eval echo \""$VAOUTPUTFORMAT"\")"
else
if [ "$VARIOUSARTISTS" = "y" ]; then
TPE2="Various"
fi
-
+
case "$ID3SYNTAX" in
id3);;
eyed3)
# FIXME # track numbers in mp3 come with 1/10, so we cannot
# happily substitute them with $TRACKNUM
# FIXME as well! # Older versions of eyeD3 (< 0.7.0) expect
- # --set-encoding and --set-text-frame so perhaps some version
- # sniffing would be useful. Might also be better to simply cut
+ # --set-encoding and --set-text-frame so perhaps some version
+ # sniffing would be useful. Might also be better to simply cut
# ties with the older eyeD3... Andrew.
# eyeD3 --comment syntax is also different in < and >= 0.7.0
run_command tagtrack-$OUTPUT-$1 nice $ENCNICE $TAGGER $TAGGEROPTS \
fi
if [ -n "$CDGENRE" ]; then
echo GENRE="$CDGENRE"
- fi
+ fi
echo TRACKNUMBER=${TRACKNUM:-$1}
if [ -n "$DISCNUMBER" ]; then
echo DISCNUMBER="$DISCNUMBER"
case "$COMMENTOUTPUT" in
*=*) echo "$COMMENTOUTPUT";;
*) echo COMMENT="$COMMENTOUTPUT";;
- esac
+ esac
fi
) | run_command tagtrack-$OUTPUT-$1 nice $ENCNICE \
$VORBISCOMMENT $VORBISCOMMENTOPTS -w \
fi
if [ -n "$CDGENRE" ]; then
echo GENRE="$CDGENRE"
- fi
+ fi
echo TRACKNUMBER="${TRACKNUM:-$1}"
if [ -n "$DISCNUMBER" ]; then
echo DISCNUMBER="$DISCNUMBER"
case "$COMMENTOUTPUT" in
*=*) echo "$COMMENTOUTPUT";;
*) echo COMMENT="$COMMENTOUTPUT";;
- esac
+ esac
fi
) | run_command tagtrack-$OUTPUT-$1 nice $ENCNICE $METAFLAC $METAFLACOPTS ${IMPORTCUESHEET:+--import-cuesheet-from="$ABCDETEMPDIR/$CUEFILE"} --import-tags-from=- "$ABCDETEMPDIR/track$1.$FLACOUTPUTCONTAINER"
;;
esac
;;
esac
- done
+ done
if checkerrors "nogap-encode"; then :; else
if [ ! "$KEEPWAVS" = "y" ] ; then
if [ ! "$KEEPWAVS" = "move" ] ; then
case "$2" in
%local*%)
case "$OPUSENCODERSYNTAX" in
- opusenc)
+ opusenc)
if [ "$(eval echo ${COMMENT})" != "" ]; then
case "$COMMENT" in
*=*) ;;
*) COMMENT="COMMENT=$COMMENT" ;;
- esac
+ esac
fi
# Tag the file at encode time, as it can't be done after encoding.
if [ "$DOTAG" = "y" ]; then
$RUN_COMMAND nice $EFFECTIVE_NICE $OPUSENCODER $OPUSENCODEROPTS --artist "$TRACKARTIST" --album "$DALBUM" --title "$TRACKNAME" --genre "$CDGENRE" --date "$CDYEAR" --comment TRACKNUMBER="$1" ${COMMENT:+--comment "$COMMENT"} "$IN" "$OUT"
else
- $RUN_COMMAND nice $EFFECTIVE_NICE $OPUSENCODER $OPUSENCODEROPTS "$IN" "$OUT"
+ $RUN_COMMAND nice $EFFECTIVE_NICE $OPUSENCODER $OPUSENCODEROPTS "$IN" "$OUT"
fi
;;
esac
case "$COMMENT" in
*=*) ;;
*) COMMENT="COMMENT=$COMMENT" ;;
- esac
+ esac
fi
# Tag the file at encode time, as it can't be done after encoding.
if [ "$DOTAG" = "y" ]; then
$RUN_COMMAND nice $EFFECTIVE_NICE $SPEEXENCODER $SPEEXENCODEROPTS "$IN" "$OUT"
fi
;;
- mpc)
+ mpc)
# MPP/MP+(Musepack) format (.mpc) is done locally, with inline
# tagging. Uses mpcenc for Musepack SV8 encoding, changed from
# Musepack SV7 which used mppenc....
$RUN_COMMAND nice $ENCNICE $AACENC $AACENCOPTS -if "$IN" -of "$OUT"
elif [ ! "$DOTAG" = "y" ]; then
$RUN_COMMAND nice $EFFECTIVE_NICE $AACENCODER $AACENCODEROPTS --artist "$TRACKARTIST" --album "$DALBUM" --title "$TRACKNAME" --track "$1" --genre "$CDGENRE" --year "$CDYEAR" --comment "$COMMENT" -o "$OUT" "$IN"
-
+
else
$RUN_COMMAND nice $ENCNICE $AACENCODER $AACENCODEROPTS -o "$OUT" "$IN"
fi
else
OUTPUTFILE="$(eval echo \""$ONETRACKOUTPUTFORMAT"\")"
fi
- else
+ else
if [ "$VARIOUSARTISTS" = "y" ]; then
OUTPUTFILE="$(eval echo \""$VAOUTPUTFORMAT"\")"
else
LEADIN=88200
i=0
N=0
-
+
while read line ; do
set -- $line
case "$1" in
esac
;;
esac
-
+
done
-
+
TRACKS=$i
LEADOUT=$(( $LEADOUT + $LEADIN ))
LENGTH=$(( $LEADOUT/75 - $TRACK1/75 ))
DISCID=$(( ( $N % 255 ) * 2**24 | $LENGTH * 2**8 | $TRACKS ))
printf "%08x %i" $DISCID $TRACKS
-
+
j=1
while [ $j -le $TRACKS ] ; do
eval echo -n "\" \$TRACK$j\""
echo cdparanoia-audio-tracks=$CDPARANOIAAUDIOTRACKS >> "$ABCDETEMPDIR/status"
fi
fi
-
+
# Create the discid file
echo "$TRACKINFO" > "$ABCDETEMPDIR/discid"
if checkstatus cddbmethod > /dev/null 2>&1 ; then :; else
do_localcddb ()
{
if checkstatus cddb-readcomplete && checkstatus cddb-choice >/dev/null; then :; else
-
+
CDDBLOCALSTATUS="notfound"
CDDBDISCID=$(echo $TRACKINFO | cut -d' ' -f1)
USELOCALRESP="y"
else
CDDBLOCALMATCH=none
fi
-
+
# If the user has selected to check a local CDDB repo, we proceed with it
case $CDDBLOCALMATCH in
multiple)
# List out disc title/author and contents
CDDBLOCALREAD="$ABCDETEMPDIR/cddblocalread.$X"
cat "$RESULT" > "${CDDBLOCALREAD}"
- {
+ {
echo -n "#$X: "
do_cddbparse "${CDDBLOCALREAD}"
echo ""
{
CDDBDISCID=$(echo $TRACKINFO | cut -d' ' -f1)
CDDBLOCALFILE="${CDDBLOCALDIR}/${CDDBDISCID}"
-
+
# Perform CDDB query if it hasn't already been done
if checkstatus cddb-querycomplete; then :; else
if [ "$CDDBAVAIL" = "n" ]; then
echo cddb-read-1-complete >> "$ABCDETEMPDIR/status"
echo cddb-choice=1 >> "$ABCDETEMPDIR/status"
;;
- esac
+ esac
echo "cddb-readcomplete" >> "$ABCDETEMPDIR/status"
fi
}
# It's all going to fit in one page, cat it
cat "$ABCDETEMPDIR/cddbchoices" >&2
fi
-
+
CDDBCHOICENUM=""
# Setting the choice to an impossible integer to avoid errors in the numeric comparisons
CDCHOICENUM=-1
fi
if [ "$EDITCDDB" = "y" ]; then
CDDBDATAMD5SUM=$($MD5SUM "$CDDBDATA" | cut -d " " -f 1);
-
+
# Use the debian sensible-editor wrapper to pick the editor that the
# user has requested via their $EDITOR environment variable
if [ -x "/usr/bin/sensible-editor" ]; then
case "$FLACENCODERSYNTAX" in
flac)
FLACENCODEROPTS="${FLACENCODEROPTSCLI:-$FLACOPTS}"
- FLACENCODER="$FLAC"
+ FLACENCODER="$FLAC"
if [ "$DOREPLAYGAIN" = "y" ]; then
FLACENCODEROPTS="${FLACENCODEROPTS} --replay-gain"
fi
# 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
#
# abcde-musicbrainz-tool
-#
+#
# Helper script for abcde to work with the MusicBrainz WS API (v2)
use strict;
printf("%s ", $disc->id());
printf("%d ", $disc->last_track_num() + 1 - $disc->first_track_num());
-
+
for ( my $i = $disc->first_track_num;
$i <= $disc->last_track_num; $i++ ) {
printf("%d ", $disc->track_offset($i));
print OUT "DTITLE=" . $a_artist. " / " . $release->title() . "\n";
print OUT "DYEAR=\n";
print OUT "DGENRE=\n";
-
+
my @tracks = @{$release->track_list()->tracks()};
for (my $i = 0; $i < scalar(@tracks); $i++) {
my $track = $tracks[$i];
print $id;
}
-
.B *
Repeat until finished
.P
-Alternatively,
+Alternatively,
.B abcde
can also grab a CD and turn it into a single FLAC file with an embedded
cuesheet which can be user later on as a source for other formats, and will be
.TP
.B \-o [filetype][:filetypeoptions]
Select output type. Can be "vorbis" (or "ogg"), "mp3", "flac", "spx", "mpc",
-"m4a", "wav" or "opus". Specify a comma-delimited list of output types to obtain
+"m4a", "wav" or "opus". Specify a comma-delimited list of output types to obtain
all specified types. See the OUTPUTTYPE configuration variable. One can pass
options to the encoder for a specific filetype on the command line separating
them with a colon. The options must be escaped with double-quotes.
.TP
.B \-W [number]
Concatenate CD\'s. It uses the number provided to define a comment "CD #" and
-to modify the numbering of the tracks, starting with "#01". For Ogg/Vorbis and
+to modify the numbering of the tracks, starting with "#01". For Ogg/Vorbis and
FLAC files, it also defines a DISCNUMBER tag.
.TP
.B \-z
will process the entire CD. Accepts ranges of track numbers -
"abcde 1-5 7 9" will process tracks 1, 2, 3, 4, 5, 7, and 9.
.SH OUTPUT
-Each track is, by default, placed in a separate file named after the track in a
-subdirectory named after the artist under the current directory. This can be
-modified using the OUTPUTFORMAT and VAOUTPUTFORMAT variables in your
-\fIabcde.conf\fR. Each file is given an extension identifying its compression
+Each track is, by default, placed in a separate file named after the track in a
+subdirectory named after the artist under the current directory. This can be
+modified using the OUTPUTFORMAT and VAOUTPUTFORMAT variables in your
+\fIabcde.conf\fR. Each file is given an extension identifying its compression
format, 'vorbis' for '.ogg', '.mp3', '.flac', '.spx', '.mpc', '.aac', '.wav' or '.opus'.
.SH CONFIGURATION
\fBabcde\fR sources two configuration files on startup - \fI/etc/abcde.conf\fR and
-\fI$HOME/.abcde.conf\fR, in that order.
+\fI$HOME/.abcde.conf\fR, in that order.
.PP
The configuration options stated in those files can be overridden by providing
the appropriate flags at runtime.
The configuration variables have to be set as follows:
.TP
.B VARIABLE=value
-Except when "value" needs to be quoted or otherwise interpreted. If other
-variables within "value" are to be expanded upon reading the configuration
-file, then double quotes should be used. If they are only supposed to be
+Except when "value" needs to be quoted or otherwise interpreted. If other
+variables within "value" are to be expanded upon reading the configuration
+file, then double quotes should be used. If they are only supposed to be
expanded upon use (for example OUTPUTFORMAT) then single quotes must be used.
-.TP
+.TP
All shell escaping/quoting rules apply.
.TP
Here is a list of options \fBabcde\fR recognizes:
Store local copies of the CDDB entries under the $CDDBLOCALDIR directory.
.TP
.B CDDBUSELOCAL
-Actually use the stored copies of the CDDB entries. Can be overridden using the
-"\-L" flag (if is CDDBUSELOCAL in "n"). If an entry is found, we always give
+Actually use the stored copies of the CDDB entries. Can be overridden using the
+"\-L" flag (if is CDDBUSELOCAL in "n"). If an entry is found, we always give
the choice of retrieving a CDDB entry from the internet.
.TP
.B SHOWCDDBFIELDS
Defaults to "year,genre".
.TP
.B OGGENCODERSYNTAX
-Specifies the style of encoder to use for the Ogg/Vorbis encoder. Valid options
+Specifies the style of encoder to use for the Ogg/Vorbis encoder. Valid options
are \'oggenc\' (default for Ogg/Vorbis) and \'vorbize\'.
This affects the default location of the binary,
the variable to pick encoder command-line options from, and where the options
files even you have requested the "clean" action.
.TP
.B PADTRACKS
-If set to "y", it adds 0's to the file numbers to complete a two-number
+If set to "y", it adds 0's to the file numbers to complete a two-number
holder. Useful when encoding tracks 1-9.
.TP
.B INTERACTIVE
If you wish to specify command-line options to any of the programs \fBabcde\fR uses,
set the following configuration file options: LAMEOPTS, TOOLAMEOPTS, GOGOOPTS,
BLADEENCOPTS, L3ENCOPTS, XINGMP3ENCOPTS, MP3ENCOPTS, VORBIZEOPTS, OGGENCOPTS,
-FLACOPTS, SPEEXENCOPTS, MPCENCOPTS, AACENCOPTS, OPUSENCOPTS, ID3OPTS, EYED3OPTS,
+FLACOPTS, SPEEXENCOPTS, MPCENCOPTS, AACENCOPTS, OPUSENCOPTS, ID3OPTS, EYED3OPTS,
MP3GAINOPTS, CDPARANOIAOPTS, CDDA2WAVOPTS, PIRDOPTS, CDDAFSOPTS, CDDBTOOLOPTS,
EJECTOPTS, DISTMP3OPTS, NORMALIZEOPTS, CDSPEEDOPTS, MKCUEOPTS, VORBISCOMMMENTOPTS,
METAFLACOPTS, DIFFOPTS, FLACGAINOPTS, VORBISGAINOPTS and HTTPGETOPTS.
Specifies the encoding format to output, as well as the default extension and
encoder. Defaults to "vorbis". Valid settings are "vorbis" (or "ogg")
(Ogg/Vorbis), "mp3" (MPEG-1 Audio Layer III), "flac" (Free Lossless Audio
-Codec), "spx" (Ogg/Speex), "mpc" (MPP/MP+ (Musepack)), "m4a" (for M4A (AAC)),
-"wav" (Microsoft Waveform) or "opus" (Opus Interactive Audio Codec). Values
+Codec), "spx" (Ogg/Speex), "mpc" (MPP/MP+ (Musepack)), "m4a" (for M4A (AAC)),
+"wav" (Microsoft Waveform) or "opus" (Opus Interactive Audio Codec). Values
like "vorbis,mp3" encode the tracks in both Ogg/Vorbis and MP3 formats. For example
.br
OUTPUTTYPE=vorbis,flac
.br
For each value in OUTPUTTYPE, \fBabcde\fR expands a different process for encoding,
-tagging and moving, so you can use the format placeholder, OUTPUT, to create
+tagging and moving, so you can use the format placeholder, OUTPUT, to create
different subdirectories to hold the different types. The variable OUTPUT will
be 'vorbis', 'mp3', 'flac', 'spx', 'mpc', 'm4a' and/or 'wav', depending on the
OUTPUTTYPE you define. For example
Specifies the format for completed Ogg/Vorbis, MP3, FLAC, Ogg/Speex, MPP/MP+
(Musepack) or M4A filenames. Variables are included using standard shell
syntax. Allowed variables are GENRE, ALBUMFILE, ARTISTFILE, TRACKFILE,
-TRACKNUM, and YEAR. Default is \'${ARTISTFILE}-${ALBUMFILE}/${TRACKNUM}-${TRACKFILE}\'.
+TRACKNUM, and YEAR. Default is \'${ARTISTFILE}-${ALBUMFILE}/${TRACKNUM}-${TRACKFILE}\'.
Make sure to use single quotes around this variable. TRACKNUM is automatically
zero-padded, when the number of encoded tracks is higher than 9. When lower,
you can force with '\-p' in the command line.
# System defaults for abcde version 2.2.x
# Nothing in this file is uncommented by default.
-#
+#
# If you wish to override these system-wide settings, create your own
# .abcde.conf file in your home directory.
#NOCDDBQUERY=n
# Select here if you want to use the locally stored CDDB entries.
-# This is useful if you do a lot of editing to those CDDB entries.
+# This is useful if you do a lot of editing to those CDDB entries.
# Also, other tools like Grip store CDDB entries under $HOME/.cddb,
# so they can be reused when ripping CDs.
#CDDBUSELOCAL="n"
# or "YEAR, GENRE"
#SHOWCDDBFIELDS=year,genre
-# Specify the style of encoder to use here -
+# Specify the style of encoder to use here -
# oggenc, vorbize - for OGGENCODERSYNTAX
# lame, gogo, bladeenc, l3enc, xingmp3enc, mp3enc - for MP3ENCODERSYNTAX
# flac - the only supported for FLACENCODERSYNTAX at the moment
# Options to call programs with:
-# If HTTPGET is modified, the HTTPGETOPTS options should also be defined
+# If HTTPGET is modified, the HTTPGETOPTS options should also be defined
# accordingly. If HTTPGET is changed, the default options will be set,
# if HTTPGETOPTS is empty or not defined.
#HTTPGET=wget
# OUTPUTTYPE can be any of a number of formats, either a single format
# (e.g. "ogg") or a combination of them separated with ","
-# (e.g. "flac,mp3"). Currently recognised and supported are:
+# (e.g. "flac,mp3"). Currently recognised and supported are:
# "flac", "m4a", "mp3, "mpc", "ogg", "opus", "spx", "vorbis", "wav"
#OUTPUTTYPE=ogg
#LOWDISK=n
# If set to y, enables batch mode normalization, which preserves relative
-# volume differences between tracks of an album.
+# volume differences between tracks of an album.
#BATCHNORM=n
# Enables nogap encoding when using the 'lame' encoder.
# Custom pre-read function
# By default it does nothing.
# You can set some things to get abcde function in better ways:
-# * Close the CD tray using eject -t (if available in eject and supported by
+# * Close the CD tray using eject -t (if available in eject and supported by
# your CD device.
-# * Set the CD speed. You can also use the built-in options, but you can also
+# * Set the CD speed. You can also use the built-in options, but you can also
# set it here. In Debian, eject -x and cdset -x do the job.
# KEEP IN MIND that executables included in pre_read must be in your $PATH or
# you have to define them with full /path/to/binary
-x Eject CD after all tracks are read
-w <comment>
Add a comment to the CD tracks
--W <#> Contatenate CDs: -T #01 -w "CD #"
+-W <#> Contatenate CDs: -T #01 -w "CD #"
-z Use debug CDROMREADERSYNTAX option (needs cdparanoia)
Tracks is a space-delimited list of tracks to grab.
# Puts the blurb content, if available, on stdout.
# Otherwise, returns "".
def checkstatus (string, file):
-
+
patern = re.compile("^"+string+"(=.*)?$")
try:
log("error","unknown error")
sys.stderr.write(usage % sys.argv[0])
sys.exit(1)
-
+
try:
#abcde.setup()
for opt, optarg in opts:
if opt == "-a": o_actions = optarg
if opt == "-b": o_batchnormalize = "y"
if opt == "-B": o_nobatchreplygain = "y"
- if opt == "-c":
+ if opt == "-c":
o_configfile = str(optarg)
try:
if not re.compile("\.\/").search(o_configfile):
if opt == "-s": o_showcddbfields = "y"
if opt == "-S": o_cdspeed = optarg
if opt == "-t": o_starttracknumber = optarg
- if opt == "-T":
+ if opt == "-T":
o_starttracknumber = optarg
o_starttracknumbertag = "y"
if opt == "-U": o_cddbproto = 5
log("error","opt -W must be an integer")
sys.exit(1)
- except:
+ except:
#log("error","arguments were not correct")
pass
query server proto user host disc-id tracks
Looks up disc on server (should be of form "http://host/~cddb/cddb.cgi")
remainder of command line is in the same form as that returned
- by the cd-discid program.
+ by the cd-discid program.
read server proto user host disc-id genre
CDDB file is dumped to stdout. File will contain an extra
#CATEGORY= line, which leaves it a valid CDDB file but which will
if the server supports given protocol. Most common values for proto
should be 5 and 3. With 3 you will not get DYEAR and DGENRE fields
in response.
- help
+ help
Display this.
EOF
}
case $COMMAND in
parse) # takes 1 argument, a filename, and dumps out a sh parseable version
CDDBFILE="$1"
-
+
set -e
# names chosen to match usage in abcde code
DISCID=$(grep ^DISCID= "$CDDBFILE" | cut -f2 -d= | tr -d \[:cntrl:\])
.SH NAME
cddb-tool \- Get CDDB information
.SH SYNOPSIS
-.B cddb-tool parse
+.B cddb-tool parse
.I file [-i|-d|-a|-t] [num|-c|-p]
.B cddb-tool template disc-id tracks
* Bumped to 2.4.2
* Fix Cue file always references "dummy.wav" bug
patch from Chris Chiappa (Closes: #459928).
- * Whitespace cleanup, replace single perl instance with sed
+ * Whitespace cleanup, replace single perl instance with sed
(Charles Steinkuehler)
* Fix leadin/leadout computation for cue files broken bug
Patch from Martin Michlmayr (Closes: #582175).
* Added iconv + converted to utf-8 the charset of a ready-to-send CDDB
entry (Closes: #345708).
* Added AAC (Mpeg4) support.
- * Small cd-discid update.
+ * Small cd-discid update.
-- Jesus Climent <jesus.climent@hispalinux.es> Thu, 19 Jan 2006 23:27:40 +0200
missing): Closes: #191475.
-- Jesus Climent <jesus.climent@hispalinux.es> Sat, 10 May 2003 07:49:22 +0000
-
+
abcde 2.1.2
* Documentation updates: Closes: #186230.
abcde 2.1.1
* New release.
-
+
-- Jesus Climent <jesus.climent@hispalinux.es> Mon, 17 Mar 2003 08:52:01 +0200
-
+
abcde 2.1.0-3
* Since abcde does not depend on eject, an execution test ([-x]) was added,