#! /usr/bin/env perl
# $Id$
+# $URL$
=head1 NAME
-B<fa-flacd>, B<fa-rip>, B<fa-tags> - archive CDs to single FLAC files
+B<fa-flacd> - archive CDs to single FLAC files
=head1 SYNOPSIS
-B<fa-flacd> [B<-jv>]
-
-B<fa-rip>
-
-B<fa-tags> ID TRACKCOUNT OFFSET [OFFSET ...] LENGTH
+B<fa-flacd> [B<-j> I<jobs>] [B<-v>]
=cut
use warnings;
use File::Basename;
-use Getopt::Std; $Getopt::Std::STANDARD_HELP_VERSION = 1;
+use Getopt::Long qw(:config gnu_getopt no_ignore_case);
use POSIX ':sys_wait_h';
+use Pod::Usage;
-our $VERSION = 1;
-
+my $debug;
my $verbose;
my @jobs;
my @finished;
sub verbose {
- $verbose and map({ print(STDERR $_) } @_);
+ $verbose and print(STDERR $_) for @_;
}
# Return the ARTIST, ALBUM, and DATE followed by a list of all the
my $value;
my $artist;
my $album;
- my $date;
+ my $discnum;
my @tags;
verbose("Opening tags file $fn\n");
($tag, $value) = split(/=/, $_, 2);
- if (/^ARTIST=/) {
+ if (/^ARTIST=/i) {
$artist = $value;
verbose("ARTIST $artist from $fn\n");
- } elsif (/^ALBUM=/) {
+ } elsif (/^ALBUM=/i) {
$album = $value;
- verbose("ALBUM $album from $fn\n");
- } elsif (/^DATE=/) {
- $date = $value;
- verbose("DATE $date from $fn\n");
+ verbose("ALBUM $album from $fn\n"); # cperl-mode sucks "
+ } elsif (/^DISCNUMBER=/i) {
+ $discnum = int($value);
+ verbose("DISCNUMBER $discnum from $fn\n");
}
}
close(TAGS) or die("close($fn): $!");
- return ($artist, $album, $date, @tags);
+ return ($artist, $album, $discnum, @tags);
}
# Process the fa-rip output in the directory DIR.
my $dir = shift;
my $artist;
my $album;
- my $date;
+ my $discnum;
my @tags;
+ my $outfile;
my $status;
verbose("Renaming $dir/tags\n");
rename("$dir/tags", "$dir/using-tags")
or die("rename($dir/tags, $dir/using-tags): $!");
- ($artist, $album, $date, @tags) = get_tags("$dir/using-tags");
+ ($artist, $album, $discnum, @tags) = get_tags("$dir/using-tags");
verbose("mkdir($artist)\n");
-d $artist or mkdir($artist) or die("mkdir($artist): $!");
verbose("chdir($dir)\n");
chdir($dir) or die("chdir($dir): $!");
+ $outfile = "$album";
+ defined($discnum) and $outfile .= " (disc $discnum)";
+ $outfile =~ s/\//_/g;
+
verbose("Running flac\n");
- $status = system('flac', '-o', "../$artist/$album.flac-tmp",
+ $status = system('flac', '-o', "../$artist/$outfile.flac-tmp",
'--delete-input-file', '-V', '--cuesheet',
'cue', '--no-padding', '--best',
map({ ('-T', $_) } @tags),
'wav');
- if (WIFEXITED($status) and ($status = WEXITSTATUS($status)) != 0) {
- die("flac: $status");
+ if (WIFEXITED($status)) {
+ if (($status = WEXITSTATUS($status)) != 0) {
+ die("flac exited with status $status");
+ }
} elsif (WIFSIGNALED($status)) {
die("flac killed with signal ", WTERMSIG($status));
} elsif (WIFSTOPPED($status)) {
die("flac stopped with signal ", WSTOPSIG($status));
+ } else {
+ die("Major horkage on system(flac): \$? = $? \$! = $!");
}
verbose("Cleaning up $dir\n");
unlink('using-tags') or die("unlink(using-tags): $!");
unlink('cue') or die("unlink(cue): $!");
- rename('toc', "../$artist/$album.toc")
- or die("rename(toc, ../$artist/$album.toc): $!");
- rename('log', "../$artist/$album.log")
- or die("rename(log, ../$artist/$album.log): $!");
+ rename('log', "../$artist/$outfile.log")
+ or die("rename(log, ../$artist/$outfile.log): $!");
chdir('..') or die("chdir(..): $!");
- rmdir($dir) or die("rmdir($dir): $!");
- rename("$artist/$album.flac-tmp", "$artist/$album.flac")
- or die("rename($artist/$album.flac-tmp, $artist/$album.flac): $!");
+ rename("$artist/$outfile.flac-tmp", "$artist/$outfile.flac")
+ or die("rename($artist/$outfile.flac-tmp, $artist/$outfile.flac): $!");
+
+ if (-x "$dir/post-processor") {
+ verbose("Running './$dir/post-processor $artist/$outfile.flac'\n");
+ system("./$dir/post-processor", "$artist/$outfile.flac");
+ unlink("$dir/post-processor") or die("unlink($dir/post-processor): $!");
+ }
+
+ rmdir($dir) or die("rmdir($dir): $!");
return 0;
}
sub reaper {
my $pid;
- while (($pid = waitpid(0, WNOHANG)) > 0) {
+ while (($pid = waitpid(-1, WNOHANG)) > 0) {
push(@finished, [$pid, $?]);
}
my $dir = shift;
my $pid;
- $pid = fork();
- if (not defined($pid)) {
- die("fork: $!");
- } elsif ($pid == 0) {
- $SIG{CHLD} = 'IGNORE';
+ if (not $debug) {
+ $pid = fork();
+ if (not defined($pid)) {
+ die("fork: $!");
+ }
+ }
+
+ if ($debug or $pid == 0) {
+ $SIG{CHLD} = 'DEFAULT';
open(STDERR, ">$dir/log") or die("open(STDERR, >$dir/log): $!");
exit(flac($dir));
}
verbose("$pid finished (");
if (WIFEXITED($status)) {
- verbose('exited ', WEXITSTATUS($status));
+ verbose('exited with status ', WEXITSTATUS($status));
} elsif (WIFSIGNALED($status)) {
- verbose('signalled ', WTERMSIG($status));
+ verbose('killed with signal ', WTERMSIG($status));
} elsif (WIFSTOPPED($status)) {
- verbose('stopped ', WSTOPSIG($status));
+ verbose('stopped with signal ', WSTOPSIG($status));
}
verbose(")\n");
}
MAIN: {
- my %opts;
-
- $opts{'j'} = 4;
- $opts{'v'} = 0;
- if (not getopts('j:v', \%opts)) {
- print("usage: flacd [-jN -v]\n");
- exit(2);
- }
-
- $verbose = $opts{'v'};
-
- flacloop($opts{'j'});
+ my $jobs;
+ my $help;
+
+ $jobs = 4;
+ GetOptions(
+ 'debug|X' => \$debug,
+ 'jobs|j=i' => \$jobs,
+ 'verbose|v' => \$verbose,
+ 'help|h|?' => \$help,
+ ) or pod2usage();
+ $help and pod2usage(-exitstatus=>0, -verbose=>1);
+
+ flacloop($jobs);
}
\f
=head1 DESCRIPTION
-B<fa-flacd>, B<fa-rip>, and B<fa-tags> together comprise
-B<flac-archive>, a system for archiving audio CDs to single FLAC
-files. B<fa-flacd> is the guts of the system. It runs in the
-directory where the audio archives are stored, scanning for new CDs to
-encode and rename; it never exits. B<fa-rip> generates the inputs for
-B<fa-flacd>: the ripped WAV file, Vorbis tags, and a cuesheet.
-B<fa-tags> is not meant to be run directly; B<fa-rip> uses it to
-generate the candidate Vorbis tags.
-
-All three programs expect to be run from the same directory. They use
-that directory to manage directories named by artist and by disc ID.
-Intermediate files are written to the disc ID directory. B<fa-flacd>
-processes the disc ID directories into per-album files in the artist
-directories.
-
-=head2 FA-FLACD
-
-B<fa-flacd> does not exit; it runs until the user kills it. Every 5
-seconds it scans its current directory for directories with a file
-called "tags" and creates a processing job for each one. The number
-of jobs B<fa-flacd> attempts to run is controlled by the B<-j> option
-and defaults to 4. B<fa-flacd> will print diagnostic output when the
-B<-v> option is given.
+B<fa-flacd> and B<fa-rip> together comprise B<flac-archive>, a system
+for archiving audio CDs to single FLAC files. B<fa-flacd> is the guts
+of the system. It runs in the directory where the audio archives are
+stored, scanning for new ripped CDs to encode and rename; it never
+exits. B<fa-rip> generates the inputs for B<fa-flacd>: the ripped WAV
+file, Vorbis tags, and a cuesheet.
+
+Both programs expect to be run from the same directory. They use that
+directory to manage directories named by artist. Intermediate files
+are written to temporary directories here. B<fa-flacd> processes the
+temporary directories into per-album files in the artist directories.
+
+Every 5 seconds, B<fa-flacd> scans its current directory for
+directories with a file called "tags" and creates a processing job for
+each one. The number of jobs B<fa-flacd> attempts to run is
+controlled by the B<-j> option and defaults to 4. B<fa-flacd> will
+print diagnostic output when the B<-v> option is given.
A processing job first renames the directory's "tags" file to
"using-tags" so that B<ra-flacd> will not try to start another job for
condition and renames "using-tags" back to "tags". Next, it encodes
the "wav" file to a FLAC file, using the "cue" file for the cuesheet
and "using-tags" for Vorbis tags. Any diagnostic output is saved in
-the "log" file. Finally, the "cue" and "log" files are moved to the
-artist directory (and named by album) and the ID directory is removed.
-
-=head2 FA-RIP
-
-B<fa-rip> uses C<cd-discid(1)> to retrieve the disc ID and track
-information. It creates a directory named by ID for storage of its
-intermediate files. It passes the C<cd-discid(1)> output as
-command-line arguments to B<fa-tags> in the background. It then uses
-C<cdrdao(1)> to create the "cue" file in the background. Finally, it
-execs C<cdparanoia(1)> to rip the CD to the "wav" file.
-
-In order for this CD to be processed by B<fa-flacd>, the user must
-create a "tags" file. This is usually done by renaming one of the
-candidate-tags files and deleting the others.
-
-=head2 FA-TAGS
-
-B<fa-tags> uses C<cddb-tool(1)> (from the B<abcde> package) to
-populate candidate-tags files. These are numbered in the order of
-entries read from CDDB, e.g. candidate-tags-1, candidate-tags-2, etc.
-B<fa-tags> also creates candidate-tags-0, which has the correct fields
-for this CD (including correct number of TITLE= lines), but with all
-fields blank.
-
-B<fa-tags> expects the output of C<cd-discid(1)> as command-line
-arguments. That is, the disc ID, number of tracks, list of track
-offsets, and total length of the CD in seconds.
-
-=head1 ENVIRONMENT
+the "log" file. Finally, B<fa-flacd> moves the "cue" and "log" files
+to the artist directory (named by album) and removes the temporary
+directory.
+
+If the temporary directory contains an executable file named
+"post-processor", B<fa-flacd> executes that file with the relative
+path to the output FLAC file as an argument. The output files are in
+their final location when "post-processor" starts. Possible uses are
+running B<flac2mp3>, moving the output files to a different location,
+removing the lock file, or adding to a database. The standard input,
+output, and error streams are inherited from B<fa-flacd>, so they may
+be connected to anything from a tty to /dev/null. This means that you
+may want to redirect these streams, if you want to save them or do any
+logging.
+
+=head1 OPTIONS
=over 4
-=item CDDBURL
+=item B<-j> [B<--jobs>] I<jobs>
-B<fa-tags> uses this to retrieve candidate Vorbis tags. Defaults to
-"http://freedb.freedb.org/~cddb/cddb.cgi".
+Run up to I<jobs> jobs instead of the default 4.
-=item CDDEV
+=item B<-v> [B<--verbose>]
-B<fa-rip> uses this to rip audio and save the cuesheet for a CD. It
-makes some effort to check some common device names for FreeBSD,
-Linux, and NetBSD by default.
+Print diagnostic information.
=back
=head1 AUTHORS
-Written by Eric Gillespie <epg@pretzelnet.org>. B<fa-tags> contains
-code from B<abcde>, which bears the following notice:
-
-# Copyright (c) 1998-2001 Robert Woodcock <rcw@debian.org>
-# Copyright (c) 2003-2004 Jesus Climent <jesus.climent@hispalinux.es>
-# This code is hereby licensed for public consumption under either the
-# GNU GPL v2 or greater, or Larry Wall's Artistic license - your choice.
+Written by Eric Gillespie <epg@pretzelnet.org>.
-B<flac-archive> is hereby licensed for public consumption under either
-the GNU GPL v2 or greater, or Larry Wall's Artistic license - your
-choice.
+flac-archive is free software; you may redistribute it and/or modify
+it under the same terms as Perl itself.
=cut
projects / flac-archive / blobdiff