GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  DIR2OGG (1)

NAME

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

CONTENTS

Synopsis
Description
     General Options
     Conversion options
Bugs
Authors
Contributors

SYNOPSIS

dir2ogg [ options ] ( filename [filename2] ... || directory [directory2] ... || [cdrom-device] ... )

DESCRIPTION

dir2ogg converts MP3, M4A, WMA 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 any number of directories at once, or given MP3, M4A, WMA, and/or WAV filenames as arguments, dir2ogg will convert only those files. If converting WAV, M4A or WMA files with -d you must add the -w, -m or -W command line flags respectively. These flags are not neccesary unless using -d. Note that converting M4A files requires you to have faad installed, and converting WMA files requires mplayer.

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.

    General 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. This option is for compatibility purposes only and does not need to be specified anymore.
-r or --recursive
  like -d but descends recursively into directories.
-c or --cdda
  Convert an audio CD into ogg. You may pass the device as an argument to the script (default: /dev/cdrom). Requires cdparanoia orq icedax or mplayer
-p or --preserve-wav
  preserve all WAV files. By default they are deleted.
-P or --no-pipe
  Do not use pipes to send data from the decoder to the encoder, use temporary wav files instead.
--delete-input
  Delete the input file after conversion
-v or --verbose
  increase dir2ogg’s verbosity.
-Q or --quiet
  Do not display progress messages, except the name of the file which is currently converted. Some decoders provide no way to disable messages and thus may still display some.

    Conversion options

--convert-all
  Convert all supported audio files found in the directories given on the command-line to Ogg Vorbis.
-f or --convert-ape
  Convert all APE (Monkey’s Audio) files found in the directories given on the command-line to Ogg Vorbis, using either ogg123 or flac or mplayer.
-f or --convert-flac
  Convert all FLAC (Free Lossless Audio Codec) files found in the directories given on the command-line to Ogg Vorbis, using ogg123 or flac or mplayer.
-m or --convert-m4a
  convert all M4A (MPEG-4 Audio) files found in the directories given on the command-line to Ogg Vorbis, using faad or mplayer. For decoding ALAC (Apple Lossless) files, ’alac-decoder’ may be used.
-m or --convert-mpc
  convert all MPC (MusePack) files found in the directories given on the command-line to Ogg Vorbis, using mpcdec or mplayer.
-W or --convert-wma
  Convert all WMA (Windows Media Audio) files found in the directories given on the command-line to Ogg Vorbis, using mplayer.
-w or --convert-wav
  Convert all WAV files found in the directories given on the command-line to Ogg Vorbis.
-V or --convert-wv
  Convert all WV (WavPack) files found in the directories given on the command-line to Ogg Vorbis.
-n or --no-mp3
  ingore all MP3 files found in directories given on the command-line.
--(ape|cd|flac|m4a|mp3|mpc|wma|wv)-decoder=COMMAND
  Set the decoder you want to use for one filetype, e.g.: --mp3-decoder=lame. Run dir2ogg --help to see the available decoders.
-qN or --quality=N
  OGG quality. N is a number between -1 and 10. Default is 3. Decimals are OK (ie: 3.7)
-t or --smart-mp3
  Try to use the same quality as the input file. MP3 input only!

SEE ALSO

mpg123(1), mplayer(1), oggenc(1)

BUGS

Enter you bug reports in Launchpad at https://bugs.launchpad.net/dir2ogg

AUTHORS

0.10 and newer: Julian Andres Klode <jak@jak-linux.org>
0.9.3 and older: Darren Kirby <d@badcomputer.org>
 

CONTRIBUTORS

original wma support: Cameron Stone <camerons@cse.unsw.edu.au>
smart-mp3: Marek Palatinus <marek@palatinus.cz>
 
Search for    or go to Top of page |  Section 1 |  Main Index


dir2ogg 0.11.8 DIR2OGG (1) 2009-08-04

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.