| blob | 2859186120155e063f28217cdaa4b14efcc8fbf8 |
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">\r
2 <html>\r
3 <head>\r
4 \r
5 <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">\r
6 <title>pyTivo Web Configuration</title>\r
7 \r
8 \r
9 <script language="javascript" type="text/javascript">\r
10 function switchDiv(pass, type){ hideallids(type);\r
11 showDiv(pass);\r
12 }\r
13 function hideallids(type){\r
14 //loop through the array and hide each element by id\r
15 var divs = document.getElementsByTagName('div');\r
16 for (var i=0;i<divs.length;i++){\r
17 if(divs[i].id.match(type)){\r
18 hideDiv(divs[i].id);\r
19 }\r
20 } }\r
21 function hideDiv(pass) {\r
22 var divs = document.getElementsByTagName('div');\r
23 for(i=0;i<divs.length;i++){\r
24 if(divs[i].id.match(pass)){//if they are 'see' divs\r
25 if (document.getElementById) // DOM3 = IE5, NS6\r
26 divs[i].style.visibility="hidden";// show/hide\r
27 else\r
28 if (document.layers) // Netscape 4\r
29 document.layers[divs[i]].display = 'hidden';\r
30 else // IE 4\r
31 document.all.hideshow.divs[i].visibility = 'hidden';\r
32 }\r
33 }\r
34 }\r
35 function showDiv(pass) {\r
36 var divs = document.getElementsByTagName('div');\r
37 for(i=0;i<divs.length;i++){\r
38 if(divs[i].id == pass){\r
39 if (document.getElementById)\r
40 divs[i].style.visibility="visible";\r
41 else\r
42 if (document.layers) // Netscape 4\r
43 document.layers[divs[i]].display = 'visible';\r
44 else // IE 4\r
45 document.all.hideshow.divs[i].visibility = 'visible';\r
46 }\r
47 }\r
48 }\r
49 </script>\r
50 </head>\r
51 \r
52 \r
53 <body style="background-color: rgb(250, 250, 250);">\r
54 \r
55 <p align="center"><font size="6">pyTivo Web\r
56 Configuration</font> <a href="#">help</a></p>\r
57 <center>\r
58 <table style="background-color: rgb(255, 255, 255);text-align: left; margin-left: auto; margin-right: auto;" border="0" cellpadding="0" cellspacing="4">\r
59 \r
60 <tbody>\r
61 \r
62 <tr>\r
63 \r
64 <td style="border-right: 1px dotted rgb(153, 153, 153); vertical-align: top;">\r
65 <div id="leftframe" style="position: relative; text-align: center; width: 200px;">\r
66 <form name="select_section">Sections\r
67 <select name="section" size="7">\r
68 <option value="set-server">Global Server Settings</option>\r
69 #for $name, $data in $shares_data\r
70 <option value="set-share-$name">$name</option>\r
71 #end for\r
72 #for $name, $data in $tivos_data\r
73 <option value="set-tivo-$name">$name</option>\r
74 #end for\r
75 </select>\r
76 \r
77 <input name="B3" value="Edit Section" type="button" onclick="switchDiv(select_section.section.options[select_section.section.selectedIndex].value, 'set-');return true;"> <input name="B1" value="Delete Section" type="button"><input name="B2" value="Add Section" type="button"></form>\r
78 \r
79 <hr>Administration\r
80 <form method="post">\r
81 <p align="center"><input name="B1" value="Save Changes" type="button"><input name="B2" value="Restart pyTivo" type="submit"></p>\r
82 \r
83 </form>\r
84 \r
85 View Raw File </div>\r
86 \r
87 </td>\r
88 \r
89 <td style="vertical-align: top;">\r
90 <div id="settings" style="width: 300px; overflow: scroll; height: 400px; position: relative;">\r
91 <form method="post">\r
92 <div id="set-server" style="text-align: center;position: absolute; left: 0px; top: 0px; visibility: hidden;">Global\r
93 Server Settings<br>\r
94 \r
95 <hr style="width: 100%; height: 2px;"> \r
96 #for $key in $server_known\r
97 #if $key in $server_data\r
98 <p>$key : <input size="20" name="$key" value="$server_data[$key]" onfocus="switchDiv('help-$key', 'help-');return true;" type="text"></p>\r
99 \r
100 #else\r
101 <p>$key : <input size="20" name="$key" value="" onfocus="switchDiv('help-$key', 'help-');return true;" type="text"></p>\r
102 \r
103 #end if\r
104 #end for\r
105 <hr> \r
106 #for $key in $server_data \r
107 #if not $key in $server_known\r
108 <p> $key : \r
109 <input size="20" name="$key" value="$server_data[$key]" onfocus="switchDiv('help-$key', 'help-');return true;" type="text"></p>\r
110 \r
111 #end if \r
112 #end for \r
113 </div>\r
114 \r
115 #for $name, $data in $shares_data\r
116 <div id="set-share-$name" style="text-align: center;position: absolute; left: 0px; top: 0px; visibility: hidden;">[<input size="20" name="title" value="$name">]<br>\r
117 <hr style="width: 100%; height: 2px;">\r
118 #for $key in $shares_known\r
119 #if $key in $data\r
120 <p>$key : <input size="20" name="$key" value="$data[$key]" onfocus="switchDiv('help-$key', 'help-');return true;" type="text"></p>\r
121 \r
122 #else\r
123 <p>$key : <input size="20" name="$key" value="" onfocus="switchDiv('help-$key', 'help-');return true;" type="text"></p>\r
124 \r
125 #end if\r
126 #end for\r
127 \r
128 <hr> \r
129 #for $key in $data \r
130 #if not $key in $shares_known\r
131 <p> $key : \r
132 <input size="20" name="$key" value="$data[$key]" onfocus="switchDiv('help-$key', 'help-');return true;" type="text"></p>\r
133 \r
134 #end if \r
135 #end for\r
136 \r
137 </div>\r
138 #end for\r
139 \r
140 #for $name, $data in $tivos_data\r
141 <div id="set-tivo-$name" style="text-align: center;position: absolute; left: 0px; top: 0px; visibility: hidden;">[<input size="20" name="title" value="$name">]<br>\r
142 <hr style="width: 100%; height: 2px;">\r
143 #for $key in $tivos_known\r
144 #if $key in $data\r
145 <p>$key : <input size="20" name="$key" value="$data[$key]" onfocus="switchDiv('help-$key', 'help-');return true;" type="text"></p>\r
146 \r
147 #else\r
148 <p>$key : <input size="20" name="$key" value="" onfocus="switchDiv('help-$key', 'help-');return true;" type="text"></p>\r
149 \r
150 #end if\r
151 #end for\r
152 \r
153 <hr> \r
154 #for $key in $data \r
155 #if not $key in $tivos_known\r
156 <p> $key : \r
157 <input size="20" name="$key" value="$data[$key]" onfocus="switchDiv('help-$key', 'help-');return true;" type="text"></p>\r
158 \r
159 #end if \r
160 #end for\r
161 \r
162 </div>\r
163 #end for\r
164 \r
165 </form>\r
166 \r
167 </div>\r
168 \r
169 </td>\r
170 \r
171 <td style="border-left: 1px dotted rgb(153, 153, 153); vertical-align: top;">\r
172 <div id="sidesections" style="width: 400px; position: relative;"><!-- HELP SECTIONS -->\r
173 <div id="help-instructions" style="position: absolute; left: 0px; top: 0px; visibility: visible;">\r
174 <p align="center"><strong>Instructions</strong>\r
175 </p>\r
176 \r
177 Instructions and sample settings will appear here when you click on the\r
178 settings boxes</div>\r
179 \r
180 <div id="help-port" style="position: absolute; left: 0px; top: 0px; visibility: hidden;">\r
181 <p align="center"><strong>port</strong> </p>\r
182 \r
183 <p> <strong>Default Setting:</strong> None,\r
184 must be entered. Distributed conf file uses 9032<br>\r
185 \r
186 <strong>Valid Entries:</strong> Valid port number<br>\r
187 \r
188 <strong>Required:</strong> Yes, without a port\r
189 setting in the conf file pyTivo will not start.<br>\r
190 \r
191 <strong>Skill:</strong> Basic<br>\r
192 \r
193 <strong>Description:</strong> The port which pyTivo\r
194 uses to serve your files. Can be changed if it conflicts with another\r
195 program. It is reported on Ubuntu that this port is already used so you\r
196 may need to change it to something like port=9254.<br>\r
197 \r
198 <strong>Example Settings:</strong> 9032 </p>\r
199 \r
200 </div>\r
201 \r
202 <div id="help-guid" style="position: absolute; left: 0px; top: 0px; visibility: hidden;">\r
203 <p align="center"><strong>guid</strong> </p>\r
204 \r
205 <p> <strong>Default Setting:</strong> 123456<br>\r
206 \r
207 <strong>Valid Entries:</strong> Any 6 digit number<br>\r
208 \r
209 <strong>Required:</strong> Generally NO, will default\r
210 to '123456' if left blank. If you use more than one pyTivo server on\r
211 the same network a different random number is required here.<br>\r
212 \r
213 <strong>Skill:</strong> Advanced<br>\r
214 \r
215 <strong>Description:</strong> A unique identifier\r
216 used in the beacon to identify this server. If you have 2 or more\r
217 pyTivo servers on one network each server must use its own unique\r
218 identifier.<br>\r
219 \r
220 <strong>Example Settings:</strong> Any 6 digit\r
221 number. </p>\r
222 \r
223 </div>\r
224 \r
225 <div id="help-ffmpeg" style="position: absolute; left: 0px; top: 0px; visibility: hidden;">\r
226 <p align="center"><strong>ffmpeg</strong>\r
227 </p>\r
228 \r
229 <p> <strong>Default Setting:</strong> There is\r
230 none.<br>\r
231 \r
232 <strong>Valid Entries:</strong> Operating system path<br>\r
233 \r
234 <strong>Required:</strong> Yes! <br>\r
235 \r
236 <strong>Skill:</strong> Basic<br>\r
237 \r
238 <strong>Description:</strong> This is the full path\r
239 to your ffmpeg binary. For windows users ffmpeg is distributed with\r
240 pyTivo and is in the plugins/video folder<br>\r
241 \r
242 <strong>Example Settings:</strong> <span class="underline">Linux</span> = /usr/bin/ffmpeg | <span class="underline">Windows</span> = c:\Program\r
243 Files\pyTivo\plugins\video\ffmpeg_mp2.exe </p>\r
244 \r
245 </div>\r
246 \r
247 <div id="help-beacon" style="position: absolute; left: 0px; top: 0px; visibility: hidden;">\r
248 <p align="center"><strong>beacon</strong>\r
249 </p>\r
250 \r
251 <p> <strong>Default Setting:</strong>\r
252 255.255.255.255<br>\r
253 \r
254 <strong>Valid Entries:</strong> A Subnet or Listen<br>\r
255 \r
256 <strong>Required:</strong> No, defaults to\r
257 255.255.255.255<br>\r
258 \r
259 <strong>Skill:</strong> Advanced<br>\r
260 \r
261 <strong>Description:</strong> The subnet which the\r
262 beacon should broadcast on. Most people can leave this at the default\r
263 setting. If set to listen will accept incoming TCP requests.<br>\r
264 \r
265 <strong>Example Settings:</strong> 255.255.255.255 </p>\r
266 \r
267 </div>\r
268 \r
269 <div id="help-hack83" style="position: absolute; left: 0px; top: 0px; visibility: hidden;">\r
270 <p align="center"><strong>hack83</strong>\r
271 </p>\r
272 \r
273 <p> <strong>Default Setting:</strong> False<br>\r
274 \r
275 <strong>Valid Entries:</strong> True/False<br>\r
276 \r
277 <strong>Required:</strong> No<br>\r
278 \r
279 <strong>Skill:</strong> Moderate<br>\r
280 \r
281 <strong>Description:</strong> Available in the <a class="wiki" href="/wiki/SubFoldersBranch">SubFoldersBranch</a>.\r
282 Allows TiVos with software 8.3 and above to display subfolders as users\r
283 are accustomed too prior to the 8.3Software glitch. If you use this\r
284 then you don't need to use <a href="http://pytivo.armooo.net/wiki/ConfigurepyTivo#auto_subshares">auto_subshares</a>.\r
285 <strong>Warning:</strong> navigating folders too fast\r
286 with this setting enabled may cause <a class="wiki" href="/wiki/TiVo">TiVo</a> to reboot. <br>\r
287 \r
288 <strong>Example Settings:</strong> True/False </p>\r
289 \r
290 </div>\r
291 \r
292 <div id="help-debug" style="position: absolute; left: 0px; top: 0px; visibility: hidden;">\r
293 <p align="center"><strong>debug</strong>\r
294 </p>\r
295 \r
296 <p> <strong>Default Setting:</strong> False<br>\r
297 \r
298 <strong>Valid Entries:</strong> True/False<br>\r
299 \r
300 <strong>Required:</strong> No<br>\r
301 \r
302 <strong>Skill:</strong> Advanced<br>\r
303 \r
304 <strong>Description:</strong> Will create a file\r
305 named debug.txt in the base folder of pyTivo. This file will contain\r
306 debug information helpful in diagnosing problems. Generally only\r
307 necessary if you are having a problem and the information is requested\r
308 by support staff.<br>\r
309 \r
310 <strong>Example Settings:</strong> True/False </p>\r
311 \r
312 </div>\r
313 \r
314 <div id="help-optres" style="position: absolute; left: 0px; top: 0px; visibility: hidden;">\r
315 <p align="center"><strong>optres</strong>\r
316 </p>\r
317 \r
318 <p> <strong>Default Setting:</strong> False<br>\r
319 \r
320 <strong>Valid Entries:</strong> True/False<br>\r
321 \r
322 <strong>Required:</strong> No<br>\r
323 \r
324 <strong>Skill:</strong> Moderate<br>\r
325 \r
326 <strong>Description:</strong> Allows for the use of\r
327 the Optimal Resolution in transcoding. By setting optes = true pyTivo\r
328 will treat the <a href="http://pytivo.armooo.net/wiki/ConfigurepyTivo#height">height</a>\r
329 and <a href="http://pytivo.armooo.net/wiki/ConfigurepyTivo#width">width</a>\r
330 settings in the conf file as a maximum. If the video to be transcoded\r
331 has smaller dimensions that are closer to other acceptable TiVo\r
332 dimensions then pyTivo will use these dimensions. This allows for\r
333 faster transcoding and small files when the initial video is a lower\r
334 quality.<br>\r
335 \r
336 <strong>Example Settings:</strong> True/False </p>\r
337 \r
338 </div>\r
339 \r
340 <div id="help-audio_br" style="position: absolute; left: 0px; top: 0px; visibility: hidden;">\r
341 <p align="center"><strong>audio_br</strong>\r
342 </p>\r
343 \r
344 <p> <strong>Default Setting:</strong> 192K<br>\r
345 \r
346 <strong>Valid Entries:</strong> Any valid Bit rate.\r
347 Up to 384K for SD TiVos. Up to 448K for HD TiVos.<br>\r
348 \r
349 <strong>Required:</strong> No<br>\r
350 \r
351 <strong>Skill:</strong> Advanced<br>\r
352 \r
353 <strong>Description:</strong> This allows you to\r
354 choose the default server audio bit rate used in transcoding. The\r
355 default is likely fine for most users. Users with HD units and high\r
356 quality videos to transcode will want to use higher value. Higher\r
357 values may slow down transcoding and will increase the file size.\r
358 Increased file sizes take up more room on the <a class="wiki" href="/wiki/TiVo">TiVo</a> and take longer to transfer\r
359 over the network.<br>\r
360 \r
361 <strong>Example Settings:</strong> 192K, 384K, 448K. </p>\r
362 \r
363 </div>\r
364 \r
365 <div id="help-max_audio_br" style="position: absolute; left: 0px; top: 0px; visibility: hidden;">\r
366 <p align="center"><strong>max_audio_br</strong>\r
367 </p>\r
368 \r
369 <p> <strong>Default Setting:</strong> 448K<br>\r
370 \r
371 <strong>Valid Entries:</strong> Any valid Bit rate. <br>\r
372 \r
373 <strong>Required:</strong> No<br>\r
374 \r
375 <strong>Skill:</strong> Advanced<br>\r
376 \r
377 <strong>Description:</strong> This sets the maximum\r
378 audio bit rate that can be sent to the <a class="wiki" href="/wiki/TiVo">TiVo</a>. Files having a higher bit\r
379 rate will be transcoded to ensure <a class="wiki" href="/wiki/TiVo">TiVo</a> compatibilty. <br>\r
380 \r
381 <strong>Example Settings:</strong> 384K, 448K. </p>\r
382 \r
383 </div>\r
384 \r
385 <div id="help-video_br" style="position: absolute; left: 0px; top: 0px; visibility: hidden;">\r
386 <p align="center"><strong>video_br</strong>\r
387 </p>\r
388 \r
389 <p> <strong>Default Setting:</strong> 4096K\r
390 for SD <a class="wiki" href="/wiki/TiVo">TiVo</a>'s,\r
391 8192K for HD <a class="wiki" href="/wiki/TiVo">TiVo</a>'s<br>\r
392 \r
393 <strong>Valid Entries:</strong> Any valid Bit rate.\r
394 1024K = 1Mi<br>\r
395 \r
396 <strong>Required:</strong> No<br>\r
397 \r
398 <strong>Skill:</strong> Advanced<br>\r
399 \r
400 <strong>Description:</strong> This allows you to\r
401 choose the default server video bit rate used in transcoding. FFmpeg\r
402 does not strictly follow this bit rate, there is a certain level of\r
403 tolerance that is allowed. Also a low quality file will always have a\r
404 low bit rate. The default is likely fine for most users. Higher values\r
405 may slow down transcoding and will increase the file size. Increased\r
406 file sizes take up more room on the <a class="wiki" href="/wiki/TiVo">TiVo</a> and take longer to transfer\r
407 over the network.<br>\r
408 \r
409 <strong>Example Settings:</strong> 4096K, 8Mi, 12Mi </p>\r
410 \r
411 </div>\r
412 \r
413 <div id="help-max_video_br" style="position: absolute; left: 0px; top: 0px; visibility: hidden;">\r
414 <p align="center"><strong>max_video_br</strong>\r
415 </p>\r
416 \r
417 <p> <strong>Default Setting:</strong> 17408k<br>\r
418 \r
419 <strong>Valid Entries:</strong> Any valid Bit rate.\r
420 1024K = 1Mi<br>\r
421 \r
422 <strong>Required:</strong> No<br>\r
423 \r
424 <strong>Skill:</strong> Advanced<br>\r
425 \r
426 <strong>Description:</strong> This allows you to\r
427 choose the maximum bit rate and is more strict than the <a href="http://pytivo.armooo.net/wiki/ConfigurepyTivo#video_br">video_br</a>\r
428 setting above. However setting this can cause buffer overflows and can\r
429 cause issues with ffmpeg. In addition to setting the ffmpeg maxrate\r
430 option, this setting is used to determine if the video bitrate of the\r
431 source video file is too high for the <a class="wiki" href="/wiki/TiVo">TiVo</a>. Otherwise compatible\r
432 mpeg's with a video bitrate above this setting will be transcoded\r
433 rather than sent to the <a class="wiki" href="/wiki/TiVo">TiVo</a>\r
434 untouched. Raising this setting much higher than the default will likly\r
435 result in pixelation during playback. Recommended only for skilled\r
436 users. <strong>Note:</strong> there is a report that\r
437 ffmpeg throws an error with 17Mi but accepts 17408K just fine. <br>\r
438 \r
439 <strong>Example Settings: 17408k</strong> </p>\r
440 \r
441 </div>\r
442 \r
443 <div id="help-width" style="position: absolute; left: 0px; top: 0px; visibility: hidden;">\r
444 <p align="center"><strong>width</strong>\r
445 </p>\r
446 \r
447 <p> <strong>Default Setting:</strong> 544<br>\r
448 \r
449 <strong>Valid Entries:</strong> Any valid pixel\r
450 dimension. Setting will be rounded to nearest acceptable <a class="wiki" href="/wiki/TiVo">TiVo</a>\r
451 dimension<br>\r
452 \r
453 <strong>Required:</strong> No<br>\r
454 \r
455 <strong>Skill:</strong> Moderate<br>\r
456 \r
457 <strong>Description:</strong> Allows you to choose\r
458 the output dimension of the transcoded videos. SD units are limited to\r
459 544 and below. Likely HD users will want to choose a higher value.\r
460 Higher values may slow down transcoding and will increase the file\r
461 size. Increased file sizes take up more room on the TiVo and take\r
462 longer to transfer over the network.<br>\r
463 \r
464 <strong>Example Settings:</strong> 1920, 1440, 1280,\r
465 720, 704, 544, 480, 352. </p>\r
466 \r
467 </div>\r
468 \r
469 <div id="help-height" style="position: absolute; left: 0px; top: 0px; visibility: hidden;">\r
470 <p align="center"><strong>height</strong>\r
471 </p>\r
472 \r
473 <p> <strong>Default Setting:</strong> 480<br>\r
474 \r
475 <strong>Valid Entries:</strong> Any valid pixel\r
476 dimension. Setting will be rounded to nearest acceptable <a class="wiki" href="/wiki/TiVo">TiVo</a>\r
477 dimension<br>\r
478 \r
479 <strong>Required:</strong> No<br>\r
480 \r
481 <strong>Skill:</strong> Moderate<br>\r
482 \r
483 <strong>Description:</strong> Allows you to choose\r
484 the output dimension of the transcoded videos. SD units are limited to\r
485 480 and below. Likely HD users will want to choose a higher value.\r
486 Higher values may slow down transcoding and will increase the file\r
487 size. Increased file sizes take up more room on the TiVo and take\r
488 longer to transfer over the network.<br>\r
489 \r
490 <strong>Example Settings:</strong> 1080, 720, 480 </p>\r
491 \r
492 </div>\r
493 \r
494 <div id="help-ffmpeg_prams" style="position: absolute; left: 0px; top: 0px; visibility: hidden;">\r
495 <p align="center"><strong>ffmpeg_prams</strong>\r
496 </p>\r
497 \r
498 <p> <strong>Default Setting:</strong> -vcodec\r
499 mpeg2video -r 29.97 -b %(video_br)s -maxrate %(max_video_br)s -bufsize\r
500 %(buff_size)s %(aspect_ratio)s -comment pyTivo.py -ac 2 -ab\r
501 %(audio_br)s -ar 44100 -f vob -<br>\r
502 \r
503 <strong>Valid Entries:</strong> A valid ffmpeg command<br>\r
504 \r
505 <strong>Required:</strong> No<br>\r
506 \r
507 <strong>Skill:</strong> Very Advanced<br>\r
508 \r
509 <strong>Description:</strong> This allows you to\r
510 control the parameters passed to ffmpeg. Most users will be just fine\r
511 with the default setting. Some HD users are experimenting with the\r
512 following line:<br>\r
513 \r
514 -vcodec mpeg2video -maxrate %(max_video_br)s -qscale 1.2 -bufsize\r
515 %(buff_size)s -comment pyTivo.py -acodec ac3 -ab %(audio_br)s -ar 48000\r
516 -f vob -<br>\r
517 \r
518 The major difference is that this does not alter the dimensions of the\r
519 video. The native height and width setting of the video used to\r
520 transcode the video. This will only work for HD and S3 units. So far\r
521 there has not been any report of dimensions which the HD units will not\r
522 accept. Additionally this line increases the audio frequency setting to\r
523 48000 too. <strong>Example Settings:</strong> See Above\r
524 and the forum. </p>\r
525 \r
526 </div>\r
527 \r
528 <div id="help-bufsize" style="position: absolute; left: 0px; top: 0px; visibility: hidden;">\r
529 <p align="center"><strong>bufsize</strong>\r
530 </p>\r
531 \r
532 <p> <strong>Default Setting:</strong> 1024k<br>\r
533 \r
534 <strong>Valid Entries:</strong> Any valid byte size<br>\r
535 \r
536 <strong>Required:</strong> No<br>\r
537 \r
538 <strong>Skill:</strong> Very Advanced<br>\r
539 \r
540 <strong>Description:</strong> Allows you to set the\r
541 buffer size used by ffmpeg. I don't know much about this setting, but\r
542 from what I can tell it is rather touchy and should only be edited by\r
543 advanced users.<br>\r
544 \r
545 <strong>Example Settings:</strong> 1024k<br>\r
546 \r
547 </p>\r
548 \r
549 </div>\r
550 \r
551 <div id="help-type" style="position: absolute; left: 0px; top: 0px; visibility: hidden;">\r
552 <p align="center"><strong>type</strong> </p>\r
553 \r
554 <p> <strong>Default Setting:</strong> None<br>\r
555 \r
556 <strong>Valid Entries:</strong> Video, Music, or any\r
557 other valid plugin name.<br>\r
558 \r
559 <strong>Required:</strong> Yes<br>\r
560 \r
561 <strong>Skill:</strong> Basic<br>\r
562 \r
563 <strong>Description:</strong> Sets the type of share\r
564 that this will be. This must be set to something otherwise pyTivo will\r
565 not start.<br>\r
566 \r
567 <strong>Example Settings:</strong> Video or Music </p>\r
568 \r
569 </div>\r
570 \r
571 <div id="help-path" style="position: absolute; left: 0px; top: 0px; visibility: hidden;">\r
572 <p align="center"><strong>path</strong> </p>\r
573 \r
574 <p> <strong>Default Setting:</strong> None<br>\r
575 \r
576 <strong>Valid Entries:</strong> Any operating system\r
577 path<br>\r
578 \r
579 <strong>Required:</strong> Yes<br>\r
580 \r
581 <strong>Skill:</strong> Basic<br>\r
582 \r
583 <strong>Description:</strong> Sets the base path to\r
584 your media content. While pyTivo will start with an invalid path your\r
585 shares will not work at all.<br>\r
586 \r
587 <strong>Example Settings:</strong> <span class="underline">Windows</span> = C:\videos | <span class="underline">Linux</span> = /home/user/media </p>\r
588 \r
589 </div>\r
590 \r
591 <div id="help-subshares" style="position: absolute; left: 0px; top: 0px; visibility: hidden;">\r
592 <p align="center"><strong>auto_subshares</strong>\r
593 </p>\r
594 \r
595 <p> <strong>Default Setting:</strong> false<br>\r
596 \r
597 <strong>Valid Entries:</strong> True/False<br>\r
598 \r
599 <strong>Required:</strong> No<br>\r
600 \r
601 <strong>Skill:</strong> Moderate<br>\r
602 \r
603 <strong>Description:</strong> Subfolders of the share\r
604 paths you define will be seen by pyTivo and displayed as subfolders in\r
605 the Now Playing List. This is an alternative to the <a href="http://pytivo.armooo.net/wiki/ConfigurepyTivo#hack83">hack83</a>\r
606 setting which enables the <a class="wiki" href="/wiki/SubFoldersBranch">SubFoldersBranch</a><br>\r
607 \r
608 <strong>Example Settings:</strong> True/False </p>\r
609 \r
610 </div>\r
611 \r
612 <div id="help-precache" style="position: absolute; left: 0px; top: 0px; visibility: hidden;">\r
613 <p align="center"><strong>precache</strong>\r
614 </p>\r
615 \r
616 <p> <strong>Default Setting:</strong> false<br>\r
617 \r
618 <strong>Valid Entries:</strong> True/False<br>\r
619 \r
620 <strong>Required:</strong> No<br>\r
621 \r
622 <strong>Skill:</strong> Moderate<br>\r
623 \r
624 <strong>Description:</strong> In order to verify that\r
625 the video files present on your computer were compatible with ffmpeg in\r
626 older versions pyTivo would query ffmpeg for each file. While this\r
627 information was cached it still caused a delay in the initial loading\r
628 of a list of files. This precache setting forced pyTivo to inspect each\r
629 video prior to starting the pyTivo server. However, this had two\r
630 drawbacks. 1. It took time as much as two minutes before pyTivo was\r
631 ready to accept requests. 2. It did not update the cache if new files\r
632 were added while the pyTivo server was running. <br>\r
633 \r
634 In the more recent releases, anything after Feb 16, 2008, pyTivo no\r
635 longer needs to query ffmpeg when creating a file list. Instead pyTivo\r
636 has a list of accepted video format extensions. If the file extension\r
637 falls within this list it is displayed on the TiVo. This achieves the\r
638 same speed increase as the precache method without the delay in loading\r
639 the pyTivo server. <br>\r
640 \r
641 There are still two drawbacks to this method. 1. The video file must\r
642 have an extension that is in the list. There is a possibility that a\r
643 new video file extension could come out before pyTivo is updated. 2.\r
644 Incomplete or video files with errors will still appear in the TiVo\r
645 listing if they have the correct extension, even though they are not\r
646 valid files. Both of these concerns are minimal. 1. Very few new\r
647 formats of video files come out very often. And all extensions are\r
648 stored in the video.ext file which is easily edited. 2. When viewing\r
649 the file details before transferring the pyTivo server queries ffmpeg\r
650 to make sure it is valid. If the file is not valid it will show up as a\r
651 copyrighted file and transferring it will be prevented by TiVo. <br>\r
652 \r
653 It is recommended that you leave precaching turned off as it is no\r
654 longer needed.<br>\r
655 \r
656 <strong>Example Settings:</strong> True/False </p>\r
657 \r
658 </div>\r
659 \r
660 <div id="help-aspect169" style="position: absolute; left: 0px; top: 0px; visibility: hidden;">\r
661 <p align="center"><strong>aspect169</strong>\r
662 </p>\r
663 \r
664 <p> <strong>Default Setting:</strong> True<br>\r
665 \r
666 <strong>Valid Entries:</strong> True/False<br>\r
667 \r
668 <strong>Required:</strong> No<br>\r
669 \r
670 <strong>Skill:</strong> Moderate<br>\r
671 \r
672 <strong>Description:</strong> Most TiVos, even S2,\r
673 can handle 16:9 videos perfectly. Some S2s are known not to handle 16:9\r
674 and will default to false in this setting. If you are experiencing\r
675 major distortion you can try setting this to false. Likely mos users\r
676 will not have to mess with this.<br>\r
677 \r
678 <strong>Example Settings:</strong> True/False </p>\r
679 \r
680 </div>\r
681 \r
682 <div id="help-shares" style="position: absolute; left: 0px; top: 0px; visibility: hidden;">\r
683 <p align="center"><strong>shares</strong>\r
684 </p>\r
685 \r
686 <p> <strong>Default Setting:</strong> Blank,\r
687 which is equivalent to allow all shares on this TiVo.<br>\r
688 \r
689 <strong>Valid Entries:</strong> The name of any share\r
690 in your pyTivo.conf file. A comma separated list.<br>\r
691 \r
692 <strong>Required:</strong> No<br>\r
693 \r
694 <strong>Skill:</strong> Easy<br>\r
695 \r
696 <strong>Description:</strong> Only the shares listed\r
697 in this setting will be visible on this TiVo. Will ignore invalid\r
698 shares. If no valid shares are listed or the setting does not exist,\r
699 all shares will be visible on this TiVo.<br>\r
700 \r
701 <strong>Example Settings:</strong> Movies, Kids Stuff\r
702 </p>\r
703 \r
704 </div>\r
705 \r
706 <!-- END HELP SECTIONS --> </div>\r
707 \r
708 </td>\r
709 \r
710 </tr>\r
711 \r
712 </tbody>\r
713 </table>\r
714 </center>\r
715 </body>\r
716 </html>\r