


mp3info(1)                                             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.

       -p[format]
              Prints  all  the  genres  in  3 columns (default or



                       29th September 1997                      1





mp3info(1)                                             mp3info(1)


              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 primar-
              ily 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  com-
              piled  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  for-
              mat.  This file can contain newlines and other spe-
              cial 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



                       29th September 1997                      2





mp3info(1)                                             mp3info(1)


COPYRIGHT
       This program is released under GPL

AUTHOR
              Thorvald Natvig
              xeno@mix.hive.no



















































                       29th September 1997                      3


