Content-type: text/html Manpage of DIR2OGG

DIR2OGG

NAME

dir2ogg - Convert MP3, WAV, and M4A files to OGG format

SYNOPSIS

dir2ogg [ options ] filename [filename2] [...] [directory]

DESCRIPTION

dir2ogg converts MP3, M4A, and WAV files to the open-source OGG format. dir2ogg is a python script that simply binds together mpg123, faad, and oggenc making it easier for the user to convert his/her music files. OGGs are about 15 to 20 percent smaller than MP3 files, with the same relative audio quality. dir2ogg can be called with the -d flag at the command line to convert a whole directory at once, or given MP3, M4A, and/or WAV filenames as arguments, dir2ogg will convert only those files.

dir2ogg can also convert WAV and M4A files to OGG format by adding the -w and -m command line flags respectively. Note that converting M4A files requires you to have faad installed. These flags are used with the -d flag to convert an entire directory of MP3, M4A, and or WAV files. These flags are not neccesary unless using -d.

Keep in mind that converting from MP3 or M4A to OGG is a conversion between two lossy formats. This is fine if you just want to free up some disk space, but if you're a hard-core audiophile you may be disappointed. I really can't notice a difference in quality with 'naked' ears myself. You should do your conversion, then compare with the original before erasing them.

Options

-h or --help
print quick usage details to the screen.
-d or --directory
convert all MP3 files in [directory]. WAV and M4A files will be converted if used with the -w and -m command line flags.
-p or --preserve-wavs
preserve all WAV files. By default they are deleted.
-m or --convert-m4as
convert M4A files to OGG. Only used with -d. Requires faad.
-w or --convert-wav
convert WAV files to OGG. Only used with -d.
-n or --no-mp3
ignore MP3 files when converting a directory. Only used with -d.
-qN or --quality=N
OGG quality. N is a number between 1 and 10. Default is 4.
-x or --delete-mp3
delete original MP3 file after conversion.
-a or --delete-m4a
delete original M4A file after conversion.
-s or --shell-protect
create shell-protected filenames. Spaces are converted to underscores.
-v or --verbose
increase dir2ogg's verbosity.

FILES

none

SEE ALSO

mpg123(1), oggenc(1), faad(1)

BUGS

Due to expected strangeness when resolving relative pathnames, it is recommended to cd to the directory you wish to act upon and use '.' to denote the current directory. This will be fixed in the next release.

This script will choke if you have certain special characters in your filenames. Characters known to break the script are: ( ) & " ' * ;

Keep in mind how bash will interpret these characters when naming/renaming your files. dir2ogg should terminate (somewhat) gracefully when it catches one of these characters, but I wouldn't count on it. Please send bug reports to dir2ogg [at] badcomputer [dot] no-ip [dot] com

AUTHOR

Darren Kirby (bulliver [at] badcomputer [dot] no-ip [dot] com)

This document was created by man2html, using the manual pages.
Time: 00:42:59 GMT, September 28, 2004