NAME

       qmp3report - report mp3 files and directories

SYNOPSIS

       qmp3report [option]... file...

DESCRIPTION

       qmp3report reads mp3 files or directories containing mp3 files and gives information about
       them. qmp3report can output the reports with plain text  or  in  html  format.  using  the
       latter format, you can navigate your mp3 directories with a web browser.

OPTIONS

       -a, --all
              report all files, not just files with suffix mp3.

       -A, --show-all
              implies  --show-dirs,  --show-files  and  --summary.  show  report  for  files  and
              directories and a summary report.

       -d, --dirs
              show a report for every directory containing reported files/directories. note  that
              if  option --all is not set, only will be reported those directories containing mp3
              files.

       -f, --files
              show a report for every reportable file (see --all).

       -h, --help
              show a brief help and exit.

       -H, --html
              output in html format (default is plain text).

       -r, --recursive
              scan directories.

       -s, --summary
              show a summary report.

       -S, --split
              split  report  across  visited  directories.  qmp3report  leaves  in  each  visited
              directory  a  file  with the report for that directory, independently of the output
              format. the name of the report file is the name of  the  directory  with  extension
              .txt or .html depending on the selected output format.

       -v, --verbose
              show more detailed info.

       -V, --version
              show version and exit.

BUGS

       variable  bit  rate  (vbr)  streams  are detected by reading the initial (5) frames in the
       stream. if their bit rate field differs, the entire stream is read to compute the duration
       time with accuracy (see manual info for qmp3info).

       if vbr is not detected, qmp3report reads only the first frame in the stream and calculates
       the duration supposing that (1) the entire stream is composed by valid frames and (2)  all
       the  frames  have  the  same  bit  rate. this is a fast way to compute the duration of the
       stream, but it is not exact: there's an error of 0.3% aprox.

       the htmlize function, which converts file names in a suitable form for  html  format  (ie.
       replacing spaces with %20), is not bulletproof.

       tests  have  been  done only with mpeg version 1 layer iii streams, though it may (or not)
       work with other versions or layers.

AUTHOR

       dmanye@etse.urv.es
       http://www.etse.urv.es/~dmanye/quelcom/quelcom.html

SEE ALSO

       qmp3info(1), qmp3join(1), qmp3cut(1), qmp3check(1)
       qwavinfo(1), qwavjoin(1), qwavcut(1), qwavsilence(1), qwavfade(1), qwavheaderdump(1)