1oggify(1) Oggify oggify(1)
2
3
4
6 oggify — convert audio to different formats, preserving organization
7
8
10 oggify [ options ] source_directory destination_directory
11
12
14 oggify is a program which assists in the conversion of audio collec‐
15 tions to different formats. It takes a directory containing audio files
16 of a given format and produces a directory with the same structure as
17 the original but with the audio files re-encoded in a different format.
18 It is intended to make it easy to keep up-to-date replicas of a collec‐
19 tion.
20
21
23 -s plugin
24 --source plugin
25 Use plugin as the source audio format. Default is "flac".
26
27 -o plugin
28 --output plugin
29 Use plugin as the output audio format. Default is "ogg".
30
31 -q n
32 --quality n
33 Set the output format quality to n. Default is 5.
34
35 -L
36 --follow-symlinks
37 Have OGGIFY follow symbolic links in the source directory tree.
38
39 -p
40 --pretend
41 Only print what OGGIFY will do, perform no action.
42
43 -r
44 --refresh
45 Re-encode files when the source file is newer than the output
46 file.
47
48 -t
49 --retag
50 Reapply audio tags (Vorbis Comments, ID3, etc) on output files
51 when the source file is newer.
52
53 -c
54 --clean
55 Remove output files that are encoded in a format different than
56 the one specified. If you've previously ran with the output set
57 to "ogg" and then run with the output set to "mp3" and use this
58 option, all of the Ogg Vorbis files will be deleted.
59
60 -P
61 --purge
62 Remove files in the destination that do not exist in the source.
63 Directories will only be removed if empty.
64
65 -n n
66 --nice n
67 nice(1) the OGGIFY processes to n. Default is 10.
68
69 -v
70 --verbose
71 Print out additional information about the actions being per‐
72 formed.
73
74 -h [plugin]
75 --help [plugin]
76 Display the standard help message and exit. If you specify plug‐
77 in , display the help for that plugin.
78
79 --version
80 Display the version and exit.
81
83 We assume that the user has a well organized directory of lossless
84 audio files in the FLAC format. The user needs to convert all of these
85 to MP3 and wants to preserve the organization and tags. By running
86 oggify the user now has the directory with MP3's as desired. (oggify -o
87 mp3)
88
89 Later the user has added new files to their collection and by running
90 oggify again the MP3 directory is updated with the new files, but no
91 old ones are re-encoded.
92
93 If certain tags in the source directory are updated, the user can pass
94 those changes on to the MP3's by running oggify with the re-tagging
95 option. (-t --retag)
96
97 If a bad rip occurred the updated files can be re-encoded by running
98 oggify with the refresh option. (-r --refresh)
99
101 Basic use. Find all flac files in one directory tree and create ogg
102 files in a similar directory tree:
103 oggify flacs oggs
104 Encode out to mp3:
105 oggify -o mp3 flacs mp3s
106 Encode at a higher quality, and do not nice:
107 oggify -q 8 -n 0 flacs oggs
108 Encode new files, and re-encode files that have been modified more
109 recently in the source. Remove files that are in the source, but in the
110 wrong output format.
111 oggify -o mp3 -c -r flacs mp3s
112 Encode and remove all files that do not exist in the source:
113 oggify -P flacs oggs
115 Scott Paul Robertson <spr@scottr.org>
116 http://scottr.org/oggify/
117
119 flac(1), oggenc(1), lame(1)
120
121
122
123 May 08, 2008 oggify(1)