NAME
pytags - set and remove tags on media files from filename and options
SYNOPSIS
pytags [OPTIONS] file [file...]
DESCRIPTION
pytags is a simple, general-purpose tool for setting and removing media
file tags. With no options, pytags prints a tag summary for all files
specified on the command line. Options can be used to set and remove
tags on files.
Using --format, it is easy to change or create tags on by parsing
metadata from filenames according to an arbitrary format string. This
makes it simple to tag files that are consistently named.
Additionally, tags can be manipulated directly with the --add, --set,
and --remove options. These options are processed in order, so options
specified later on the command-line may cause values set by earlier
options to be overwritten. These options must appear after the
--format, if it is used.
OPTIONS
--add=EXPR
Append a tag value all files according to EXPR. EXPR should be an
expression like “artist=Foo”. May be specified multiple times to
add multiple values.
--format=FORMAT
Tag files with metadata extrapolated from filenames using format
string FORMAT; see the section called “FORMAT STRINGS”. This option
must be specified before --add, --set, or --remove.
--set=EXPR
Set a single tag on all files according to EXPR. EXPR should be an
expression like “artist=Foo”. May be specified multiple times to
set multiple tags. --set cannot be used to specify multiple values
for a single tag. To do that, use --remove followed by multiple
--add options.
--remove=TAG
Remove tags named TAG. May be specified more than once to remove
multiple tags.
-h, --help
Show summary of options and exit.
-v, --version
Show version of program and exit.
FORMAT STRINGS
The format string expected by --format is the same as that for
pytagsfs. See the pytagsfs manual page for more information.
EXAMPLES
Remove the genre tag from all .ogg files in the current directory.
$ pytags --remove genre *.ogg
Set the artist and album tag on all .mp3 files, and remove the genre
tag.
$ pytags --set artist=Foo --set album=Bar --remove genre *.mp3
Tag all of the .flac files in the current directory. All such files are
assumed to be in the format "tracknum artist - trackname [album].flac".
$ pytags --format '%n %a - %t [%l].flac' *.flac
BUGS
Please report bugs on launchpad at
http://launchpad.net/products/pytagsfs/+bugs.
pytags relies on mutagen (the underlying Python tags library) to choose
an appropriate tag format for the files being tagged. This cannot
currently be overridden.
SEE ALSO
pytagsfs(1)
AUTHOR
Forest Bond
Author.
COPYRIGHT
Copyright © 2007, 2008, 2009
[FIXME: source] 2009-12-04