oggify man page
oggify — convert audio to different formats, preserving organization
oggify [ options ] source_directory destination_directory
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.
- -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.
Have OGGIFY follow symbolic links in the source directory tree.
Only print what OGGIFY will do, perform no action.
Re-encode files when the source file is newer than the output file.
Reapply audio tags (Vorbis Comments, ID3, etc) on output files when the source file is newer.
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.
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.
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.
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)
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:
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.
Encode and remove all files that do not exist in the source:
oggify -P flacs oggs
Scott Paul Robertson <email@example.com> http://scottr.org/oggify/
flac(1), oggenc(1), lame(1)