qmp3report(1)							 quelcom man pages						     qmp3report(1)

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)

quelcom 0.4.0							   february 2001						     qmp3report(1)