mp3info(1)

NAME
mp3info - MP3 Information tool

SYNOPSIS
mp3info [ -option < value > ] filename[s]...

DESCRIPTION

This is a small tool to get and set MP3 information.

OPTIONS

-T  Do NOT get TAG Info. Use on slowseeking media, since TAG is at the very end of the file.

-s <0/1>
    Print info. Pretty much obsolete, as it always should be on. Defaults 1.

-f <format>
    Format of printed string. See README for details.

-F <Formatnumber>
    Predefined format of printed string. Try it out.

-w  Write TAG Info. Will write a TAG at the end of the file.

-W  Wipe TAG Info. Will wipe clean TAG Info. Overrides all other TAG Options, and turns -s off. To both wipe tag and display info, use -W -s 1

-n <name>
    Set song title. Implies -w. Will go away soon, use -t instead.

-t <name>
    Set song title. Alias for -n. Implies -w.

-a <artist>
    Set name of artist. Implies -w.

-l <album>
    Set album name. Implies -w.

-y <year>
    Sets published year. Implies -w.

-c <comment>
    Sets comment. Implies -w.

-g <genre>
    Set genre number. Implies -w.

-G <genrename>
    Set genre by name. Implies -w.

-p[format]
    Prints all the genres in 3 columns (default or format 0), 1 column (format 1) or 1 column without numbers (format 2). If you pass a negative format number, it will output something suitable for the dialog-using script. The negative format is primarily for internal use and is likely to change, so don't depend on it.

-N <format>
    Rename files according to format. Same format as -f. If this format expands to nothing, no rename will be done.

-e <format>
    Executes the command as made by format. If this expands to nothing, nothing will be done.

-P[numthreads]
    Plays file(s). Beta, and Linux only. If you compiled with splay and threads, you can specify the number of threads. If you used the l3dec player, you can send the player sighup and it will skip to the next file in the queue.

-R  Enables random play.

RETURNS

0   All Ok

1   Error opening file.

2   No SYNC Found.

3   Error writing TAG. (Disk full, maybe?)

4   Error wiping TAG. (Shouldn't happen)

5   Error renaming file.

FILES

$HOME/.mp3info.rc
    This file, if present, is used as the default format. This file can contain newlines and other special formatting characters if so desired.

BUGS
Well, there are no known bugs, but if a list of files is specified, and handling one of them produces an error, the program goes on, and returns the LAST error produced.

CREDITS
ID3 format by NamkraD/DC (erick@marble.net)

All the people who have sent me patches, comments and ideas

COPYRIGHT
This program is released under GPL

AUTHOR
    Thorvald Natvig
    thorvald@natvig.com