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