|
|
MP3PLOT(1) mp3plot User Manual MP3PLOT(1)
NAME
mp3plot - creates a plot of the bitrate distribution of MP3 files
SYNOPSIS
mp3plot [-i] {input.mp3}
mp3plot [-g] [-i] {input.mp3} [-p plotter name] [-o output.png]
mp3plot [{-h | --help} | {-V | --version}]
DESCRIPTION
mp3plot creates a plot (textual or graphical) of the bitrate
distribution of an MP3 file; i.e. it displays which proportion of the
audio file uses each of the possible bitrates.
The plot can serve e.g. to compare an audio source as encoded by
different encoders or settings; or to display how the chosen (average)
bitrate was achieved by the encoder.
By default the plot is printed to the console. If mp3plot is compiled
with the appropriate libraries, it can also create a graphical plot in
a png image.
OPTIONS
The program follows the usual GNU command line syntax, with long
options starting with two dashes (`-´). A summary of options is
included below.
[-i] inputfile.mp3, [--input] inputfile.mp3
Plot inputfile.mp3.
-i / --input is implied if not used (e.g.
$ mp3plot -i input.mp3
is equivalent to
$ mp3plot input.mp3
-o output.png, --output output.png
Save plot image to output.png.
Ignored if the console plotter is used. If omitted will default to
the input filename with ".png" appended.
-g, --image
Output to a png image file.
By default the png will be named after the mp3 file and placed on
the same directory as it, e.g. "/music/some file.mp3" will produce
"/music/some file.mp3.png". Use --output to choose the output
filename.
-p plotter_name, --named-plotter plotter_name
Choose the plotter with plotter_name.
Only required to hand-pick an image plotter when both GD and Magick
plotters have been compiled in. Use "list" to display a list of
available plotters, e.g.:
$ mp3plot -p list
Avilable plotters:
* console: textual, printed
* magick: graphical, file output
* gd: graphical, file output
By default, when a plotter is not explicitly chosen, if -g is used
an image plotter will be chosen (magick if present, gd otherwise).
When -g isn´t used, the console plotter will be used.
console is always available, while both magick and gd can be
included or excluded at the time of compilation.
If a plotter not available is requested, mp3plot will exit with an
error. e.g. if the Magick module wasn´t compiled in:
$ mp3plot -p magick
[...]
mp3plot: No plotter with such name available</screen>
-h, --help
Show summary of options.
-V, --version
Show version of program and extra compilation information
(libraries used, their versions, compilation date and compiler).
--old-colourscheme, --old-colorscheme
Use the older set of colours (used up 0.5.0) for graphical plot
output.
BUGS
You can report any bugs to the author at outlyer@gmail.com (or visit
the upstream site http://p.outlyer.net/mp3plot/ for more details).
SEE ALSO
Upstream site: http://p.outlyer.net/mp3plot/
mp3stat: https://signal-lost.homeip.net/projects/
AUTHOR
Toni Corvera <outlyer@gmail.com>
mp3plot author
COPYRIGHT
Copyright © 2007, 2009 Toni Corvera
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU General Public License, Version 2 or (at
your option) any later version published by the Free Software
Foundation.
mp3plot 06/22/2009 MP3PLOT(1)
[top]
|
Vote for polarhome |
