'\" t
.\"     Title: pytags
.\"    Author: Forest Bond
.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
.\"      Date: 2009-12-04
.\"    Manual: [FIXME: manual]
.\"    Source: [FIXME: source]
.\"  Language: English
.\"
.TH "PYTAGS" "1" "2009\-12\-04" "[FIXME: source]" "[FIXME: manual]"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
pytags \- set and remove tags on media files from filename and options
.SH "SYNOPSIS"
.HP \w'\fBpytags\fR\ 'u
\fBpytags\fR [OPTIONS] \fIfile\fR [\fIfile\fR\&.\&.\&.]
.SH "DESCRIPTION"
.PP

\fBpytags\fR
is a simple, general\-purpose tool for setting and removing media file tags\&. With no options,
\fBpytags\fR
prints a tag summary for all files specified on the command line\&. Options can be used to set and remove tags on files\&.
.PP
Using
\fB\-\-format\fR, 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\&.
.PP
Additionally, tags can be manipulated directly with the
\fB\-\-add\fR,
\fB\-\-set\fR, and
\fB\-\-remove\fR
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
\fB\-\-format\fR, if it is used\&.
.SH "OPTIONS"
.PP
\fB\-\-add\fR=EXPR
.RS 4
Append a tag value all files according to EXPR\&. EXPR should be an expression like \(lqartist=Foo\(rq\&. May be specified multiple times to add multiple values\&.
.RE
.PP
\fB\-\-format\fR=FORMAT
.RS 4
Tag files with metadata extrapolated from filenames using format string FORMAT; see
the section called \(lqFORMAT STRINGS\(rq\&. This option must be specified before
\fB\-\-add\fR,
\fB\-\-set\fR, or
\fB\-\-remove\fR\&.
.RE
.PP
\fB\-\-set\fR=EXPR
.RS 4
Set a single tag on all files according to EXPR\&. EXPR should be an expression like \(lqartist=Foo\(rq\&. May be specified multiple times to set multiple tags\&.
\fB\-\-set\fR
cannot be used to specify multiple values for a single tag\&. To do that, use
\fB\-\-remove\fR
followed by multiple
\fB\-\-add\fR
options\&.
.RE
.PP
\fB\-\-remove\fR=TAG
.RS 4
Remove tags named TAG\&. May be specified more than once to remove multiple tags\&.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
Show summary of options and exit\&.
.RE
.PP
\fB\-v\fR, \fB\-\-version\fR
.RS 4
Show version of program and exit\&.
.RE
.SH "FORMAT STRINGS"
.PP
The format string expected by
\fB\-\-format\fR
is the same as that for
\fBpytagsfs\fR\&. See the
\fBpytagsfs\fR
manual page for more information\&.
.SH "EXAMPLES"
.PP
Remove the genre tag from all \&.ogg files in the current directory\&.
.sp
.if n \{\
.RS 4
.\}
.nf
$ pytags \-\-remove genre *\&.ogg
.fi
.if n \{\
.RE
.\}
.PP
Set the artist and album tag on all \&.mp3 files, and remove the genre tag\&.
.sp
.if n \{\
.RS 4
.\}
.nf
$ pytags \-\-set artist=Foo \-\-set album=Bar \-\-remove genre *\&.mp3
.fi
.if n \{\
.RE
.\}
.PP
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"\&.
.sp
.if n \{\
.RS 4
.\}
.nf
$ pytags \-\-format \*(Aq%n %a \- %t [%l]\&.flac\*(Aq *\&.flac
.fi
.if n \{\
.RE
.\}
.SH "BUGS"
.PP
Please report bugs on launchpad at http://launchpad\&.net/products/pytagsfs/+bugs\&.
.PP
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\&.
.SH "SEE ALSO"
.PP

\fBpytagsfs\fR(1)
.SH "AUTHOR"
.PP
\fBForest Bond\fR
.RS 4
Author.
.RE
.SH "COPYRIGHT"
.br
Copyright \(co 2007, 2008, 2009
.br