Ticket #10199: nuvexportrc

File nuvexportrc, 15.4 KB (added by zeloise@…, 14 years ago)

nuvexportrc

Line 
1# nuvexportrc:
2#
3# This file contains the configuration for nuvexport, and should be
4# installed as /etc/nuvexportrc. You can also copy this file to
5# ~/.nuvexportrc, where nuvexport will look first, if you wish to create
6# settings local to a specific user.
7# I try to use this file to document all of the commandline options
8# supported by nuvexport, but it is quite likely that a few slip through
9# here and there unnoticed. Feel free to poke around in the code for
10# add_arg() calls to see all of the available options.
11#
12# Anything placed within the <nuvexport> section will be interpreted as a
13# global option. Use this section for options that don't relate
14# specifically to any particular exporter.
15
16<nuvexport>
17
18# Set export_prog to ffmpeg or mencoder, depending on your
19# preference of program for exports. This is equivalent to --ffmpeg or
20# --mencoder
21 #export_prog=ffmpeg
22 export_prog=mencoder
23
24 # Any other parameters set in this file are equivalent to using the
25 # equivalent setting as a commandline option. For boolean options like
26 # --deinterlace (--nodeinterlace), use deinterlace=yes (or no, true or
27 # false) instead. Actual commandline options will override anything in this file.
28
29 # Preferred mode -- if you don't set this, nuvexport will ask you what you would like to do.
30 # Use --mode or any of the mode symlinks (like nuvexport-xvid) to override.
31 mode=xvid # xvid
32
33 # Setting underscores to yes will convert whitespace in filenames to an
34 # underscore character (which some people seem to prefer)
35 underscores=no
36
37 # Setting require_cutlist to yes will tell nuvexport to show only those
38 # recordings that have a cutlist
39 #require_cutlist=no
40
41 # By default, nuvexport picks what it thinks is a good name for your file
42 # (doing its best to avoid printing "Untitled" into the filename).
43 # Setting name will let you change the output format of the filename
44 # generated by nuvexport. Even after this formatting, nuvexport will
45 # still do some basic replacements to make sure that illegal filename
46 # characters (eg. /\:*?<>|) are replaced with a dash (or " with a ').
47 # The following format variables are supported:
48 # %T -> Title (show name)
49 # %S -> Subtitle (episode name)
50 # %R -> Description
51 # %C -> Category
52 # %U -> RecGroup
53 # %hn -> Hostname of the machine where the file resides
54 # %c -> Channel: MythTV chanid
55 # %cn -> Channel: channum
56 # %cc -> Channel: callsign
57 # %cN -> Channel: channel name
58 # %y -> Recording start time: year, 2 digits
59 # %Y -> Recording start time: year, 4 digits
60 # %n -> Recording start time: month
61 # %m -> Recording start time: month, leading zero
62 # %j -> Recording start time: day of month
63 # %d -> Recording start time: day of month, leading zero
64 # %g -> Recording start time: 12-hour hour
65 # %G -> Recording start time: 24-hour hour
66 # %h -> Recording start time: 12-hour hour, with leading zero
67 # %H -> Recording start time: 24-hour hour, with leading zero
68 # %i -> Recording start time: minutes
69 # %s -> Recording start time: seconds
70 # %a -> Recording start time: am/pm
71 # %A -> Recording start time: AM/PM
72 # %ey -> Recording end time: year, 2 digits
73 # %eY -> Recording end time: year, 4 digits
74 # %en -> Recording end time: month
75 # %em -> Recording end time: month, leading zero
76 # %ej -> Recording end time: day of month
77 # %ed -> Recording end time: day of month, leading zero
78 # %eg -> Recording end time: 12-hour hour
79 # %eG -> Recording end time: 24-hour hour
80 # %eh -> Recording end time: 12-hour hour, with leading zero
81 # %eH -> Recording end time: 24-hour hour, with leading zero
82 # %ei -> Recording end time: minutes
83 # %es -> Recording end time: seconds
84 # %ea -> Recording end time: am/pm
85 # %eA -> Recording end time: AM/PM
86 # %py -> Program start time: year, 2 digits
87 # %pY -> Program start time: year, 4 digits
88 # %pn -> Program start time: month
89 # %pm -> Program start time: month, leading zero
90 # %pj -> Program start time: day of month
91 # %pd -> Program start time: day of month, leading zero
92 # %pg -> Program start time: 12-hour hour
93 # %pG -> Program start time: 24-hour hour
94 # %ph -> Program start time: 12-hour hour, with leading zero
95 # %pH -> Program start time: 24-hour hour, with leading zero
96 # %pi -> Program start time: minutes
97 # %ps -> Program start time: seconds
98 # %pa -> Program start time: am/pm
99 # %pA -> Program start time: AM/PM
100 # %pey -> Program end time: year, 2 digits
101 # %peY -> Program end time: year, 4 digits
102 # %pen -> Program end time: month
103 # %pem -> Program end time: month, leading zero
104 # %pej -> Program end time: day of month
105 # %ped -> Program end time: day of month, leading zero
106 # %peg -> Program end time: 12-hour hour
107 # %peG -> Program end time: 24-hour hour
108 # %peh -> Program end time: 12-hour hour, with leading zero
109 # %peH -> Program end time: 24-hour hour, with leading zero
110 # %pei -> Program end time: minutes
111 # %pes -> Program end time: seconds
112 # %pea -> Program end time: am/pm
113 # %peA -> Program end time: AM/PM
114 # %oy -> Original Airdate: year, 2 digits
115 # %oY -> Original Airdate: year, 4 digits
116 # %on -> Original Airdate: month
117 # %om -> Original Airdate: month, leading zero
118 # %oj -> Original Airdate: day of month
119 # %od -> Original Airdate: day of month, leading zero
120 # %f -> full path to the filename
121 # %% -> a literal % character
122 filename=%T - %S
123
124 # By default, nuvexport uses an American-style date to represent showtimes
125 # in lists and filenames. Use --date to override that with the format of
126 # your choosing. See the UnixDate section `perldoc Date::Manip` for formatting options.
127 #date=%m/%d, %i:%M %p
128 #date=%y%m%d
129
130 # Nuvexport has the option to crop a percentage of the border of each
131 # recording in order to get rid of the unsightly edges of the tv signal.
132 # The default 1.5% approximates the overscan of an average TV, but you can
133 # alter this from 0 to 5% to fit your preferences. Please keep in mind
134 # that this amount is removed prior to making any aspect conversions like
135 # removing black bars from 4:3 recordings to make a 16:9 export.
136 crop_pct = 1.5
137
138 # Alternatively, you can override the general crop_pct to crop a different
139 # amount from specific sides of the recording.
140 #crop_top = 2
141 #crop_right = 2
142 #crop_bottom = 2
143 #crop_left = 2
144
145 # You can also override the output aspect ratio. This is useful in
146 # combination with crop_top=12.5 and crop_bottom=12.5 to remove the black
147 # bars from the top/bottom of recordings broadcast in fake widescreen.
148 out_aspect = 16:9
149
150 # Export a matching .txt file, which mythvideo can use to import
151 # information about your exports, since it likely can't look them up in imdb.
152 save_info = yes
153
154 # Include recordings from some special recgroups that wouldn't normally be
155 # available for export.
156 #show_deleted = yes
157 #show_livetv = yes
158
159 # Uncomment this setting to disable the encode's progress display. You
160 # should really only use this on the commandline for cron/user jobs where
161 # you don't want the progress updates to fill up a log or email.
162 #noprogress = no
163 noprogress = yes
164
165</nuvexport>
166
167
168
169# The sections below work as above, with each more specific section
170# overriding the more generic.
171
172<generic>
173 # Default to export to the current directory
174 #path = .
175 #path = /_x/Mediux/zdvb/mythexport
176 path = /_x/Mediux/z
177
178 # Use the cutlist (not to be confused with the commercial flag list) when exporting.
179 use_cutlist = yes
180
181 # Tell mythcommflag to generate a cutlist from the commercial flags before exporting.
182 # Don't forget to enable use_cutlist above, too.
183 gencutlist = no # default = yes
184
185 # Contrary to popular belief, enabling multipass will not make your recordings look better.
186 # What it will do, however is guarantee that the bitrate you choose will be the average bitrate of your entire encode
187 # (meaning that your exports will end up being about the same size per-minute),
188 # and that you will receive the best overall quality for a files of the same size.
189 multipass = yes
190
191 # Disabling noise reduction can speed up your exports dramatically, but at the expense of some quality.
192 # For your convenience, this is also aliased on the commandline as
193 # --denoise (or --nodenoise), as well as --noise_reduction.
194 noise_reduction = no # default = no
195
196 # Deinterlace the video so that it looks better on software players.
197 deinterlace = yes
198
199 # Crop about 2% from the border of the recording before encoding.
200 # This is done to get rid of part of the broadcast signal that is usually obscured by the tv's overscan.
201 crop = yes
202
203 # You can create settings for each export module type.
204 # These are the second-most generic sections,
205 # and will only be reached if there are no matches in the full or generic module names.
206 # If you have a particularly dirty signal, you might want to try to disable fast_denoise
207 # (it's actually part of yuvdenoise, which the ffmpeg exporters call).
208 # It can be almost twice as slow as the default "fast" normal noise reduction,
209 # but it considerably more effective.
210 # The latest version of yuvdenoise (which is called directly by the ffmpeg exporters)
211 # does not support this option, so it is ignored in that case.
212 fast_denoise = yes
213
214 # If nuvexport is having trouble detecting the *input* aspect ratio of your recordings
215 # (MythTV used to hard-code all software-encoded files as 1:1 regardless of the true aspect),
216 # set this option to one of the following:
217 #force_aspect = [ 1:1 4:3 16:9 2.21:1 ]
218
219</generic>
220
221
222<ffmpeg>
223 # ffmpeg is almost twice as fast if you disable noise reduction
224 #noise_reduction = no
225
226 # By default, nuvexport's ffmpeg module lets ffmpeg handle deinterlacing.
227 # I've found that this provides the best results, but if you wish to let
228 # yuvdenoise do it instead, set deint_in_yuvdenoise to a true value.
229 #deint_in_yuvdenoise = no
230</ffmpeg>
231
232
233<mencoder>
234</mencoder>
235
236################################################################################
237
238# You can also create settings for generic export module names.
239# These will only be overridden by full module names.
240
241<XviD>
242 vbr = yes # Enable vbr to get the multipass/quantisation options
243 # (enabling multipass or quantisation automatically enables vbr)
244 multipass = yes # You get either multipass or quantisation; multipass will override
245 quantisation = 3 # 4 through 6 is probably right... 1..31 are allowed (lower is better quality) (6)
246 a_bitrate = 192 # Audio bitrate of 128 kbps, 192 kbps (128) [192]
247 v_bitrate = 1000 # Remember, quantisation overrides video bitrate (768) [1000]
248 width = 720 # Height adjusts automatically to width, according to aspect ratio (512-->512x384)
249 # 720x512 - 720x576 - 1024x768
250 height = auto
251</XviD>
252
253# The mp3 bitrate used by MythTV's software encoder is 128, so there is no
254# real need to go any higher in exports.
255# You can, of course, turn this up if you get your recordings from other sources.
256<MP3>
257 bitrate = 192 # (128) [192]
258</MP3>
259
260################################################################################
261
262# If you want to provide settings for a very specific export module,
263# you can use its full name, and it will override any more generic settings.
264
265
266# The MP4 encoder for ffmpeg has a few options unique to itself
267<ffmpeg::MP4>
268 # Codec to use (mpeg4 or h264).
269 # Please note that h264 support requires the SVN version of ffmpeg (not CVS!).
270 # In fact, even the mpeg4 codec works better with the SVN version.
271 # Note: The h.264 files exported by nuvexport seem to play fine on ipods,
272 # but lack the atom necessary to be recognized by iTunes,
273 # so you will have to find other means to get the exports onto your ipod (gtkpod works great).
274 mp4_codec = h264 # mp4_codec = mpeg4
275
276 # Framerate to use: auto, 25, 23.97, 29.97. PAL will always be 25 fps,
277 # and auto will set 29.97 for everything over 320x288 and 23.97 for the rest.
278 mp4_fps = auto
279
280 # Enable ipod compatibility mode. Aside from forcing a max resolution of 640x480,
281 # this basically just sets motion detection reference frames
282 # (-refs) to 2 instead of 7 (the ipod can only handle 2),
283 # and thus a small drop in motion detection quality.
284 ipod = yes
285</ffmpeg::MP4>
286
287
288# As does the PSP exporter
289<ffmpeg::PSP>
290 psp_fps = low # PSP framerate (high=29.97, low=14.985)
291 psp_resolution = 320x240 # PSP resolution (320x240, 368x208 or 400x192)
292 psp_bitrate = high # PSP video bitrate (high=768, low=384)
293 psp_thumbnail = yes # Create a thumbnail to go with the PSP video export?
294</ffmpeg::PSP>
295
296# You can also add flags to the mencoder option
297<mencoder::XviD>
298 vbr = yes # Enable vbr to get the multipass/quantisation options
299 # (enabling multipass or quantisation automatically enables vbr)
300 multipass = no # You get either multipass or quantisation; multipass will override (no)
301 quantisation = 3 # 4 through 6 is probably right... 1..31 are allowed (lower is better quality) (6)
302 a_bitrate = 192 # Audio bitrate of 128 kbps, 192 kbps (128) [192]
303 v_bitrate = 1000 # Remember, quantisation overrides video bitrate (768) [1000]
304 width = 720 # Height adjusts automatically to width, according to aspect ratio (512-->512x384)
305 # 720x512 - 720x576 - 1024x768
306 height = auto
307</mencoder::XviD>
308
309
310<mencoder::H264MP3>
311 vbr = yes # Enable vbr to get the multipass/quantisation options
312 # (enabling multipass or quantisation automatically enables vbr)
313 multipass = no # You get either multipass or quantisation; multipass will override (no)
314 quantisation = 3 # 4 through 6 is probably right... 1..31 are allowed (lower is better quality) (6)
315 a_bitrate = 128 # Audio bitrate of 128 kbps, 192 kbps (128) [192]
316 v_bitrate = 768 # Remember, quantisation overrides video bitrate (768) [1000]
317 width = 720 # Height adjusts automatically to width, according to aspect ratio (512-->512x384)
318 # 720x512 - 720x576 - 1024x768
319 height = auto
320</mencoder::H264MP3>
321
322################################################################################
323# You can also make specific profiles called with the --profile parameter
324# that will override other config options (but not commandline arguments).
325# For example, you could make a profile that would encode your favorite
326# show with your favorite settings.
327<profile::sample>
328 title = test
329 export_prog = transcode
330# export_prog = ffmpeg
331 mode = xvid
332 confirm = true
333</profile::sample>
334
335# Or crop the black bars off of the top/bottom of fake widescreen shows.
336<profile::samplewide>
337 title = test
338 export_prog = ffmpeg
339 mode = mp4
340 out_aspect = 16:9
341 crop_pct = 0
342 crop_top = 12.5
343 crop_bottom = 12.5
344 width = 528
345 height = 360
346</profile::samplewide>