Content-type: text/html Manpage of fixmp3

fixmp3

NAME

fixmp3 - A utility written in Perl to process an archive of MP3 files.

SYNTAX

fixmp3 [ --directory=<directory> | --file=<filename> ] [options]

DESCRIPTION

fixmp3 is a Perl script which aids in organizing a collection of MP3s. It searches through a specified directory recursively for MP3s and procedes with the options you specify. It can be used to create playlists, and rename your MP3s to a better convention.

The following section describes how one could use fixmp3.

Playlist
Create an alphabetical playlist with the filename you specify.

Rename Filenames
Rename your MP3 files according to the format you want. Formats you can specify are Artist_Name-Song_Title.mp3, Track_Number-Artist_Name-Song_Title.mp3, Artist_Name-Album_Name-Song_Title.mp3 (or a combination of those examples).

Fix MP3 Tags
Fix the MP3 tags, whether they are currently empty or not.

OPTIONS

-d, --directory=<directory>: Scans specified <directory> recursively for MP3 files.
-h, --help: Output help information and exit.
-v, --version: Output version information and exit.
-r, --recursive: Go through subdirectories recursively. The default is not recursive.
-p, --playlist=<filename>: Write an alphabetical playlist to the specified filename, for the MP3 files found in the <directory> to <filename>.
-n, --no-overwrite: Do not overwrite the playlist file. If not specified, the playlist file will be overwritten.
-c, --correct: Clean up the filenames of the MP3 files. The default format is Artist-Song.mp3 . You may specify other formats using the options detailed below. The Artist Name and Song Title are read from the tag of the MP3. If there is no tag present, the filename will not be replaced (you can edit the tags using options below).
--lowercase: Lowercase the resulting file names. Must be used in conjuction with the --correct option.
--tags: Alter missing tags (with user input) of MP3s, if any. If a MP3 is found to have no tag in <directory>, prompt the user if they would like to add one. If they do, ask the user for the Artist Name, Song Title, Album Title, and Comments. The information is then entered the tag into the MP3. This is interactive.
-e, --edit: Edit all tags. Whether each MP3 has a tag or not, ask the user if they would like to edit it. This is interactive.
-a, --album: Include the album name in the renamed file. If this option is used, --correct will be automatically turned on. The format will be Artist_Name-Album-Song.mp3 . The album name is read in from the MP3 tag. If not present, the album title will not be used.
--track: Include the track number in the renamed file. If this option is used, --correct will be automatically turned on. The format will be Track_Number-Artist_Name-Song_Title.mp3 . The user will be asked for the track number of each MP3 file.
-l, --logfile=<logfile>: Log the files processed and the actions caried out on them as well as tag information into the <logfile>.

FILES

/usr/local/bin/fixmp3

EXAMPLES

Listed below are some examples on how you could use fixmp3:

fixmp3 -d /mp3/random -p random.m3u
       - Create a playlist in random.m3u for all the MP3s found in /mp3/random .
          If the file random.m3u exists, overwrite it.
          With the -n option, random.m3u will not be overwritten.

fixmp3 -f=/mp3/10therea.mp3 --file=/mp3/09psycho.mp3 --tags
- If the files /mp3/10thearea and /mp3/09psycho.mp3 do not contain tags, alter them with user input.

fixmp3 --directory=/mp3/synthpop --tags
- Scan through /mp3/synthpop and if a MP3 is found without a tag, prompt the user for the attributes that make up the tag.

fixmp3 -d /mp3/VNV_Nation --playlist=vnv.m3u -c --tags
       - Scan through /mp3/VNV_Nation for MP3s recursively.
       - Create an alphabetical playlist for the MP3s found into the file vnv.m3u.
       - If no tags are present in a MP3, prompt the user to enter them.
       - Rename the files in the format Artist_Name-Song_Title.mp3 (parameters read from the tags).

fixmp3 -d /mp3/random --track --album
        - Scan through /mp3/random for MP3s recursively.
        - Prompt the user for the track name for each MP3.
        - Alter the filenames of the MP3s to match the
          format Track_Number-Artist_Name-Album_Name-Song_Title.mp3 .
        - If the album name cannot be read from the MP3 tags, fixmp3 will not use it.
          (You should probably use the --edit_all option to add an album name to the tag.)

fixmp3 -d /mp3/industrial --edit
- Alter all of the tags of each MP3 file in /mp3/industrial, whether they exist or not.

BUGS

Report bugs to <afra@prongs.org>

AUTHORS

Afra Ahmad <afra@prongs.org>

This document was created by man2html, using the manual pages.
Time: 23:12:53 GMT, October 18, 2001

fixmp3