oidua(1) [debian man page]
OIDUA(1) General Commands Manual OIDUA(1) NAME
oidua - audio file metadata lister SYNOPSIS
oidua [options] directory [...] DESCRIPTION
lists meta data of audio files. What information and how it is presented is customizable. It is possible to format output in csv, html, xml or for human beings. OPTIONS
-B, --bg COLOR Set HTML background color -D, --date Display datestamp header --debug Output debug trace to stderr -e, --exclude DIRECTORY Exclude directory from search -f, --file FILE write output to file -h, --help Display help message -H, --html HTML output --ignore-bad Don't list files that cause Audiotype failure -i, --ignore-case Case-insensitive directory sorting -I, --indent N Set indent to N -m, --merge Merge identical directories Basedirs with identical names are merged. This Means that all their subdirs are considered being subdirs of a single directory, and therefore sorted and displayed together. If there are duplicate names among the subdirs then those are also merged. -o, --output STRING Set output format to STRING Anything enclosed by brackets is considered a field. A field must have the following syntax: [TAG] [TAG,WIDTH] [TAG,WIDTH,SUFFIX] [TAG,SUFFIX] TAG is any of the following characters: a list of bitrates in Audiolist compatible format b bitrate with suffix (i.e. 192k) B bitrate in bps d depth; distance from respective basedir f number of audio files (including spacers) l length in minutes and seconds L length in seconds m time of last change M time of last change in seconds since the epoch n directory name (indented) N directory name p profile P full path q quality s size with suffix (i.e. 65.4M) S size in bytes t file type T bitrate type: ~ mixed files C constant bitrate L lossless compression V variable bitrate WIDTH defines the exact width of the field. The output is cropped to this width if needed. Negative values will give left aligned output. Cropping is always done on the right. SUFFIX lets you specify a unit to be concatenated to all non-empty data. Other interpreted sequences are: [ [ ] ] new line tab character Unescaped brackets are forbidden unless they define a field. Note: If you have any whitespace in your output string you must put it inside quotes or otherwise it will not get parsed right. -q, --quiet Omit progress indication -s, --strip Strip output of field headers and empty directories -S, --stats Display statistics results -t, --time Display elapsed time footer -T, --text COLOR Set HTML text color -V, --version Display version -w, --wildcards Expand wildcards in basedirs REPORTING BUGS
Report bugs to Sylvester Johansson <sylvestor@telia.com> SEE ALSO
http://oidua.suxbad.com/ AUTHOR
oidua was written by Sylvester Johansson and Mattias Paeivaerinta This manual page was written by Erik Wenzel <erik@debian.org> for the Debian GNU/Linux system (but may be used by others). May 15, 2007 OIDUA(1)
Check Out this Related Man Page
oggenc(1) Vorbis Tools 1.0 oggenc(1) NAME
oggenc - encode audio into the Ogg Vorbis format SYNOPSIS
oggenc [ -hrQ ] [ -B raw input sample size ] [ -C raw input number of channels ] [ -R raw input samplerate ] [ -b nominal bitrate ] [ -m minimum bitrate ] [ -M maximum bitrate ] [ -q quality ] [ --resample frequency ] [ --downmix ] [ -s serial ] [ -o output_file ] [ -n pat- tern ] [ -c extra_comment ] [ -a artist ] [ -t title ] [ -l album ] [ -G genre ] input_files ... DESCRIPTION
oggenc reads audio data in either raw, WAV, or AIFF format and encodes it into an Ogg Vorbis stream. If the input file "-" is specified, audio data is read from stdin and the Vorbis stream is written to stdout unless the -o option is used to redirect the output. By default, disk files are output to Ogg Vorbis files of the same name, with the extension changed to ".ogg". This naming convention can be overridden by the -o option (in the case of one file) or the -n option (in the case of several files). Finally, if none of these are available, the output filename will be the input filename with the extension (that part after the final dot) replaced with ogg, so file.wav will become file.ogg OPTIONS
-h, --help Show command help. -r, --raw Assume input data is raw little-endian audio data with no header information. If other options are not specified, defaults to 44.1kHz stereo 16 bit. See next three options for how to change this. -B n, --raw-bits=n Sets raw mode input sample size in bits. Default is 16. -C n, --raw-chan=n Sets raw mode input number of channels. Default is 2. -R n, --raw-rate=n Sets raw mode input samplerate. Default is 44100. --raw-endianness n Sets raw mode endianness to big endian (1) or little endian (0). Default is little endian. -Q, --quiet Quiet mode. No messages are displayed. -b n, --bitrate=n Sets encoding to the bitrate closest to n (in kb/s). -m n, --min-bitrate=n Sets minimum bitrate to n (in kb/s). -M n, --max-bitrate=n Sets maximum bitrate to n (in kb/s). --managed Set bitrate management mode. This turns off the normal VBR encoding, but allows hard or soft bitrate constraints to be enforced by the encoder. This mode is much slower, and may also be lower quality. It is primarily useful for creating files for streaming. -q n, --quality=n Sets encoding quality to n, between -1 (low) and 10 (high). This is the default mode of operation, with a default quality level of 3. Fractional quality levels such as 2.5 are permitted. Normal quality range is 0 - 10. --resample n Resample input to the given sample rate (in Hz) before encoding. Primarily useful for downsampling for lower-bitrate encoding. --downmix Downmix input from stereo to mono (has no effect on non-stereo streams). Useful for lower-bitrate encoding. --advanced-encode-option optionname=value Sets an advanced option. See the Advanced Options section for details. -s, --serial Forces a specific serial number in the output stream. This is primarily useful for testing. -o output_file, --output=output_file Write the Ogg Vorbis stream to output_file (only valid if a single input file is specified) -n pattern, --names=pattern Produce filenames as this string, with %a, %t, %l, %G replaced by artist, title, album respectively (see below for specifying these). Also, %% gives a literal %. -c comment, --comment comment Add the string comment as an extra comment. This may be used multiple times, and all instances will be added to each of the input files specified. -a artist, --artist artist Set the artist comment field in the comments to artist. -G genre, --genre genre Set the genre comment field in the comments to genre. -d date, --date date Sets the date comment field to the given value. This should be the date of recording. -N n, --tracknum n Sets the track number comment field to the given value. -t title, --title title Set the track title comment field to title. -l album, --album album Set the album comment field to album. Note that the -a, -t, and -l options can be given multiple times. They will be applied, one to each file, in the order given. If there are fewer album, title, or artist comments given than there are input files, oggenc will reuse the final one for the remaining files, and issue a warning in the case of repeated titles. ADVANCED ENCODER OPTIONS
Oggenc allows you to set a number of advanced encoder options using the --advanced-encoder-option option. These are intended for very advanced users only, and should be approached with caution. They may significantly degrade audio quality if misused. Not all these options are currently documented. bitrate_average_window=NN Set the managed bitrate window to NN seconds. The bitrate will be forced to the specified average over a floating window of this length. May be fractional (e.g. 3.5) lowpass_frequency=NN Set the lowpass frequency to NN kHz. EXAMPLES
Simplest version. Produces output as somefile.ogg: oggenc somefile.wav Specifying an output filename: oggenc somefile.wav -o out.ogg Specifying a high-quality encoding averaging 256 kbps (but still VBR). oggenc infile.wav -b 256 out.ogg Specifying a maximum and average bitrate, and enforcing these. oggenc infile.wav --managed -b 128 -M 160 out.ogg Specifying quality rather than bitrate (to a very high quality mode) oggenc infile.wav -q 6 out.ogg Downsampling and downmixing to 11 kHz mono before encoding. oggenc --resample 11025 --downmix infile.wav -q 1 out.ogg Adding some info about the track: oggenc somefile.wav -t "The track title" -a "artist who performed this" -l "name of album" -c "OTHERFIELD=contents of some other field not explictly supported" This encodes the three files, each with the same artist/album tag, but with different title tags on each one. The string given as an argu- ment to -n is used to generate filenames, as shown in the section above. This example gives filenames like "The Tea Party - Touch.ogg": oggenc -b 192 -a "The Tea Party" -l "Triptych" -t "Touch" track01.wav -t "Underground" track02.wav -t "Great Big Lie" track03.wav -n "%a - %t.ogg" Encoding from stdin, to stdout (you can also use the various tagging options, like -t, -a, -l, etc.): oggenc - AUTHORS
Program Author: Michael Smith <msmith@labyrinth.net.au> Manpage Author: Stan Seibert <indigo@aztec.asu.edu> BUGS
Reading type 3 wav files (floating point samples) probably doesn't work other than on intel (or other 32 bit, little endian machines). SEE ALSO
ogg123(1) 2002 July 19 oggenc(1)