mp3manage 2.1.3
mp3manage [OPTIONS] FILENAME(S)
mp3manage tries to rename and tag music files in a useful way. This includes
setting the permissions correctly, eliminating disturbing whitespace, generating
playlists of the processed files, moving them to a specified directory and
ensuring that filenames have one of the formats 'Artist - Title.mp3',
'Artist - Track No. - Title.mp3' or 'Title (Artist).mp3'.
Because of the flexible, easily extendable design of mp3manage, it is likely that
we will add other features in the future.
Options that are marked with ! can be negated to turn an option off (as in --noperm).
Options marked with + can be used multiple times.
Except where otherwise mentioned, all options are disabled by default.
- --upper, -u
-
Uppercase the first letter of every word. In combination with --lower all other
letters will be lowercase.
- --lower, -l
-
Lowercase filenames. In combination with --upper the first letter of every word
will be uppercase, everything else lowercase. Be careful if you use --upper and --lower
together: It may seem that uppercasing the first letter of every word is enough
but this will clobber strings that intentionally contain uppercase in the middle
of a word. See --safestring to make this safer.
- --safestring!, --safe!
-
Handle strings with special care when changing upper- / lowercase. Enabled by
default. The following cases are handled:
-
if a word is only uppercase, it is left untouched
-
if a string that is enclosed by special characters is only uppercase, it is left
untouched
-
the string 'McX...' is left untouched, where X is any uppercase character
- --track!
-
Include track numbers in filenames (they will be removed otherwise). Enabled by default.
- --recursive, -r
-
Process the contents of directories recursively.
- --output NUMBER, -o NUMBER
-
Choose output format. 1 for 'Artist - Title.mp3', 2 for 'Title (Artist).mp3'
Warning: Information about the track cannot be kept in the filename with the
second format and therefore will be lost.
- --input NUMBER, -i NUMBER
-
Select where artist, title, etc. information is taken from. 1 for filename, 2
for tag.
-
ID3v1 and ID3v2 are supported for MP3 music files, the standard Ogg Vorbis
tags for .ogg-files. If there is both an ID3v1 and an ID3v2 tag, the ID3v2
tag is used by default. The filename is used by default for retrieving
information. See --id3version for information about changing this behaviour,
please also read the section about --id3version for a warning about using
tags of MP3 files.
- --id3version NUMBER, --id3v NUMBER
-
Select which ID3 tag version should be preferred: 1 for ID3v1, 2 for ID3v2. ID3v2 is
selected by default.
-
Warning: Since ID3v1 fields are only 30 characters long,
information could be truncated when using ID3v1 tags and is then written into
all other tags and into the filename so that all information that exceeds 30
characters is lost.
- --extension STRING, --ext STRING
-
Add extensions of files that this program should edit. By default these extensions
are 'mp3', 'ogg', 'wma' and 'vqf'. This option can be used multiple times and adds
the given extensions to this list.
- --perm!
-
Set permissions (0755 for directories, 0644 for files). Enabled by default.
- --setid3!
-
Set both ID3v1- and ID3v2-tags (--noid3 turns both off). Enabled by default.
- --setid3v1!
-
Set ID3v1-tag. Enabled by default.
- --setid3v2!
-
Set ID3v2-tag. Enabled by default.
- --setogg!
-
Set Ogg Vorbis tag. Enabled by default.
-
You need to have the vorbiscomment binary from the vorbistools package, at least
version 1.0 RC2, in your path for Ogg Vorbis tagging to work.
- --underscore, -s
-
Convert '_' to space.
- --apostrophy!
-
Convert backticks to apostrophies (` -> '). Enabled by default.
- --test, --debug, -d
-
Don't write anything to disk. This is useful for testing purposes and if you
don't yet trust this program as it can't break anything if this option is turned
on.
- --verbose+, -v+
-
Increase verbosity level by 1. Default level is 1. Verbosity levels:
-
(-q) No output.
-
Output only a summary for each file that was changed. This is the default.
-
(-v) Outputs what the program is changing in detail.
-
(-vv) Lots of debugging output, even if nothing is done.
-
(-vvv) Additionally output all information that could be retrieved about each file.
- --quiet, -q
-
Set verbosity level to zero (no output).
- --playlist FILE
-
Write relative pathnames to FILE (produces .pls-style simple playlist).
- --exclude STRING, --exc STRING
-
Filenames that contain this string are not included in the playlist that is created
by --playlist. You can use this option multiple times:
-
mp3manage /music/* --playlist --exc Britney --exc 'Atomic Kitten' --exc 'No Angels'
- --sort [PATH]
-
Put all music files into a subdirectory of PATH. If the path is not suplied, the value
of the environment variable MP3DIR will be used instead. All songs of one artist / group will
be put into one subdirectory of PATH:
-
``Cypress Hill - I Wanna Get High.mp3'' will be moved to ``PATH/Cypress Hill''.
- --windows
-
Replace all these characters in filenames: /\:<>?*| instead of only replacing the slash ('/').
- --advice
-
Get advice.
Written by Magnus von Koeller <magnus@vonkoeller.de>, extended and documented by
Nikolas Scheuer <nscheuer@gmx.net>.
Please visit our website at http://mp3manage.sourceforge.net or our SourceForge
project website at http://sf.net/projects/mp3manage
There are no known bugs. If you can't find more, you're free to create your own.
Please report bugs at our bug-report system ( http://sf.net/projects/mp3manage/ )
or to Magnus von Koeller <magnus@vonkoeller.de>.
Main program and framework:
Copyright 2001-2004, Magnus von Koeller
Playlist generation, mp3-file sorting & some additional things:
Copyright 2001, Nikolas Scheuer
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License version 2 as
published by the Free Software Foundation.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA