1oggify(1)                           Oggify                           oggify(1)
2
3
4

NAME

6       oggify — convert audio to different formats, preserving organization
7
8

SYNOPSIS

10       oggify [ options ] source_directory destination_directory
11
12

DESCRIPTION

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

OPTIONS

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

DETAILED USE CASE

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

EXAMPLES

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

AUTHORS

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

SEE ALSO

119       flac(1), oggenc(1), lame(1)
120
121
122
123                                 May 08, 2008                        oggify(1)
Impressum