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