pytags(1)

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 --pattern, 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 set and removed explicitly with the --set and --remove options, respectively.

OPTIONS

--pattern=PATTERN

Tag files with metadata extrapolated from filenames using format
string PATTERN; see the section called "FORMAT STRINGS".

--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. Tags are set in order, so, if the same tag is
set more than once, the last one sticks. Be sure to use appropriate shell quoting.

--remove=TAG

Remove tags named TAG. May be specified more than once to indicate the removal of 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 --pattern is similar to the format string accepted by pytagsfs, except that a more limited set of substition characters are allowed:

n track number

a artist

t track title

l album title

y year of release

g genre

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 --pattern ´%n %a - %t [%l].flac´ *.flac

BUGS

See http://bugs.debian.org/src:pytagsfs for a current list. Bugs may be reported to the Debian bug tracking system at submit@bugs.debian.org or via the reportbug program.

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

2007-12-11 PYTAGS(1)