Merge branch 'master' into subfolders-8.3
[pyTivo.git] / README
blob13ef8265da0a1879d2fc60528bb01a928781518f
1 ---Changes\r
2 - Transfer End Properly\r
3 \r
4 - File Sizes are estimated now. Sending 6gig estimates for a 400meg file caused TiVo to unnecessarily dump shows for space. New estimation will generally still be over but by a reasonable amount now.\r
5 \r
6 - Ratios are altered.  Filed that are almost 4:3 or 16:9 will be crammed into those formats, looks better on TV and streching image by less than 1% is not noticable.\r
7 \r
8 - Padding for videos that have a lower ratio than 4:3 is added. This allows for black bars on left and right for oddly shaped movies.\r
9 \r
10 ---Description\r
12 pyTivo lets you stream most videos from yout PC to your unhacked tivo. It uses the HMO server protocol. It will guess if your video is 4:3 or 16:9 and pad your video if it thinks it is needed (looked good on my tests). It will not transcode an mpeg that is supported by your tivo.\r
14 ---Download\r
16 http://armooo.net/~armooo/pyTivo/pyTivo.zip\r
18 ---Requirements\r
20 OS = Anything that will run python and ffmpeg, which I think is anything.  I have it running on linux, I know windows works as well.\r
22 Python - http://www.python.org/download/\r
23 - You need at least version 2.4 of python\r
25 pywin32 (only to install as a service) - http://sourceforge.net/project/showfiles.php?group_id=78018&package_id=79063 \r
26 - Windows users only and only if you intend to install as a service\r
28 ---Usage\r
30 You need to edit pyTivo.conf in 3 places\r
32 1. ffmpeg=\r
33 2. [<name of share>]\r
34 3. path=\r
36 ffmpeg should be the full path to ffmpeg including filename.  For windows users the exe has been included and is in the plugins/video directory.\r
37 path is the absolute path to your media\r
39 run pyTivo.py\r
41 ---To install as a service in Windows\r
43 run pyTivoService.py --startup auto install\r
45 ---To remove service\r
47 run pyTivoService.py remove\r
49 ---Known Problems\r
51 - Now Playing List disappears\r
52 This seems to be an error with the TiVo software.  But what happens is that the NPL is replaced with the directory listing of your pyTivo server.  Very odd.\r
53 Workaround - go to the bottom of the page and either select "Recently Deleted" or your pyTivo server that is listed and then hit the left arrow.  Your NPL will be back to normal\r
55 ---Notes\r
56 Most of the work has been done by armooo.  With minor updates by KRKeegan.