oggify man page

oggify — convert audio to different formats, preserving organization

Synopsis

oggify [ options ] source_directory destination_directory

Description

oggify is a program which assists in the conversion of audio collections to different formats. It takes a directory containing audio files of a given format and produces a directory with the same structure as the original but with the audio files re-encoded in a different format. It is intended to make it easy to keep up-to-date replicas of a collection.

Options

-s plugin
--source plugin
Use plugin as the source audio format. Default is "flac".
-o plugin
--output plugin
Use plugin as the output audio format. Default is "ogg".
-q n
--quality n
Set the output format quality to n. Default is 5.
-L
--follow-symlinks
Have OGGIFY follow symbolic links in the source directory tree.
-p
--pretend
Only print what OGGIFY will do, perform no action.
-r
--refresh
Re-encode files when the source file is newer than the output file.
-t
--retag
Reapply audio tags (Vorbis Comments, ID3, etc) on output files when the source file is newer.
-c
--clean
Remove output files that are encoded in a format different than the one specified. If you've previously ran with the output set to "ogg" and then run with the output set to "mp3" and use this option, all of the Ogg Vorbis files will be deleted.
-P
--purge
Remove files in the destination that do not exist in the source. Directories will only be removed if empty.
-n n
--nice n
nice(1) the OGGIFY processes to n. Default is 10.
-v
--verbose
Print out additional information about the actions being performed.
-h [plugin]
--help [plugin]
Display the standard help message and exit. If you specify plugin , display the help for that plugin.
--version
Display the version and exit.

Detailed Use Case

We assume that the user has a well organized directory of lossless audio files in the FLAC format. The user needs to convert all of these to MP3 and wants to preserve the organization and tags. By running oggify the user now has the directory with MP3's as desired. (oggify -o mp3)

Later the user has added new files to their collection and by running oggify again the MP3 directory is updated with the new files, but no old ones are re-encoded.

If certain tags in the source directory are updated, the user can pass those changes on to the MP3's by running oggify with the re-tagging option. (-t --retag)

If a bad rip occurred the updated files can be re-encoded by running oggify with the refresh option. (-r --refresh)

Examples

Basic use. Find all flac files in one directory tree and create ogg files in a similar directory tree:

oggify flacs oggs

Encode out to mp3:

oggify -o mp3 flacs mp3s

Encode at a higher quality, and do not nice:

oggify -q 8 -n 0 flacs oggs

Encode new files, and re-encode files that have been modified more recently in the source. Remove files that are in the source, but in the wrong output format.

oggify -o mp3 -c -r flacs mp3s

Encode and remove all files that do not exist in the source:

oggify -P flacs oggs

Authors

Scott Paul Robertson <spr@scottr.org>
http://scottr.org/oggify/

See Also

flac(1), oggenc(1), lame(1)

Info

May 08, 2008 Oggify