FLACTAG(1) | FLACTAG(1) |
NAME¶
flactag - A tagger for whole album FLACs using data from the MusicBrainz serviceSYNOPSIS¶
flactag [options] flacfile [ flacfile ] [ flacfile ]RIPPING CDS TO FLAC¶
IMPORTANT: I think I found a bug in cueconvert which means that any FLAC files generated from CDs that used INDEX marks to separate tracks that didn’t have any pre-gap would generate invalid disc IDs. I would urge you to use the checkflac script provided to compare any disks you may have ripped with their FLAC files to ensure that the discids match correctly. Included in this release is a SED script which will massage the TOC file of a CD to work around this problem. Unfortunately, the only way to recover from this is to re-rip the CD.DESCRIPTION¶
The flactag command retrieves and writes tag information for a whole-album FLAC file. The data is retrieved from the MusicBrainz service. Additionally, if an Amazon ASIN is associated with the release, then cover art will be included in the FLAC file.OPTIONS¶
-v, --versionDisplay the software version.
-h, --help
Display brief usage information.
-d, --discid
Display the calculated disc ID for the
specified FLAC file and exit.
-s, --submit-url
Display the URL used to submit information for
this file to the MusicBrainz service. Use this to submit data for your CD if
the data returned does not match.
-c, --check
This option will compare the file’s tags
against those returned from the MusicBrainz service. A message will be
displayed indicating where the tags match or not.
-w, --write
This option implies --check. If the
files tags differ from those returned from the MusicBrainz service, the tags
will be written to the file.
-f, --force-write
If --write is specified then tags will be
written even if they appear to match those already in the file.
-r, --rename
The filename will be compared with that
specified by the rename rules, and if it doesn’t match, the file will be
renamed.
-o, --overwrite-existing
If --rename is specified then existing files
will be overwritten when renaming.
-O <discID>, --override-discid <discID>
Instead of calculating disc ID from the
cuesheet, flactag will use the provided disc ID to query MusicBrainz. Only one
FLAC file can be processed when this option is used.
BATCH MODE¶
flactag can be used in batch mode to process an entire music collection. For example, to check every FLAC file, write new tags and rename appropriately:INTERACTIVE MODE¶
If flactac is executed without any options, it will interactively process all FLAC files given as arguments.•The 'Albums' window. This will
contain a list of albums that match the DiskID for your FLAC file.
•The 'Tracks' window. This
contains a list of all the tracks on the currently selected album.
•The 'Tags' window. At startup,
this will contain a list of the tags currently found in your FLAC file. If
there are no tags present, then an empty set appropriate for the album will be
displayed. If you make changes to these tags, an asterisk ('*') will be
displayed to indicate that this information has been changed.
FILE RENAMING DETAILS¶
The following configuration file (~/.flactag) entries affect file renaming:•
BasePath - This is the root directory of where your music files
should be stored. (e.g. /var/spool/music)
•
SingleDiskFileName - This template is used to rename disks that are not
part of a multi-disk set.
•
MultiDiskFileName - This template is used to rename disks that are part
of a multi-disk set.
•
DirectoryCreatePermissions - The permissions to be set on any directory
that is created (e.g. 0755).
•
CreateCuesheetAfterRename - If set to true, flactag will generate a
cuesheet file to accompany the renamed FLAC file.
•
%A - This will be replaced with the artist name
•
%S - This will be replaced with the artist sort name
•
%T - This will be replaced with the album title
•
%D - This will be replaced with the disk number
•
%Y - This will be replaced with the year
•
%G - This will be replaced with the genre
•
%1 - This will be replaced with the first character of the artist sort
name
•
%E - This will be replaced by the appropriate filename extension (flac or
cue)
USING A DIFFERENT MUSICBRAINZ SERVER¶
To use a different MusicBrainz server (for example if you have a local mirror) you can set the Server and Port parameters in the configuration file.BUGS / LIMITATIONS / FUTURE ENHANCEMENTS¶
•Once changes are written to the FLAC
file, there is no way of reverting back to the original tags.
AUTHOR¶
Written byRESOURCES¶
Main web site: http://flactag.sourceforge.netCOPYING¶
Copyright (C) 2007-2012 Andy Hawkins Copyright (C) 2011-2012 Daniel PocockAUTHOR¶
Andy Hawkins <andy@gently.org.uk>Author.
06/30/2012 |