mp3reorg is a command line utility for rearranging the locations and layout of mp3 files.
It provides a mechanism for creating a directory structure based on the information held within the standard ID3 tags from each mp3 file.
mp3reorg accepts the following command line parameters:
-i,--input 'dir'
Input directory. This is where mp3reorg will scan for .mp3 files.
-o,--output 'dir'
Output directory. Where the files will be moved/copied to. This directory is created for you if it doesn't exist.
-l,--list
List files only. The files themselves are not moved or copied anywhere.
-s,--show
Show ID3 tag information. Similar to the --list option, except the ID3 tag information is read from each file and displayed.
-m,--move
Move files (don't copy)
-t,--transform
Transform file names to match the information in the tag data. This affects the filename portion itself only.
-f,--filepattern 'pattern'
The new pattern for transformed filenames. Defaults to %A
-d,--dirpattern 'pattern'
The directory structure pattern. Defaults to %T
-p,--prune
Prune empty directories (only after move.) Any empty directories in the input directory are removed.
--verbose
Verbose output
-v,--version
Display program version information.
-h,--help
Display usage help information.
The file and directory patterns are made up from 3 of the bits of information extracted from the the ID3 tags.
The pattern itself consists of a string containing none, one or more of the specifiers listed below. Any other characters are copied verbatim.
%T is replaced by the song name
%A is replaced by the artist's name.
%L is replaced by the album name.
This document was generated from DocBook sources. The original is available from CVS, in the docs subdirectory.
This HTML version was generated using db2html --nochunks mp3reorg.xml > mp3reorg.html