pyTivo
[pyTivo.git] / README
blob6b54447f05aab7d800b8bed3adc4af79bf7a334c
1 Ver 147\r
2 \r
3 ---Changes\r
4 - Duration has been added\r
5 so now the green bar on the bottom of the screen is accurate.  I thought this would help the deleting problem but it didn't.\r
6 \r
7 - Single form of code\r
8 so now this works with no changes on linux and windows\r
9 \r
10 - ffmpeg entry in config file\r
11 allows you to move ffmpeg and allows a single version of code for multiple platforms\r
13 ---Description\r
15 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
17 ---Download\r
19 http://armooo.net/~armooo/pyTivo/pyTivo.zip\r
21 ---Requirements\r
23 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
25 Python - http://www.python.org/download/\r
26 - You need at least version 2.4 of python\r
28 pywin32 (only to install as a service) - http://sourceforge.net/project/showfiles.php?group_id=78018&package_id=79063 \r
29 - Windows users only and only if you intend to install as a service\r
31 ---Usage\r
33 You need to edit pyTivo.conf in 3 places\r
35 1. ffmpeg=\r
36 2. [<name of share>]\r
37 3. path=\r
39 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
40 path is the absolute path to your media\r
42 run pyTivo.py\r
44 ---To install as a service in Windows\r
46 run pyTivoService.py --startup auto install\r
48 ---To remove service\r
50 run pyTivoService.py remove\r
52 ---Known Problems\r
54 - Only one pyTivo server per network\r
55 GUID in beacons hardcoded. So only 1 server per network. This will be fixed soon.\r
57 - Max MPEG size\r
58 The max mpeg2 output size is 6000000000 bytes (hard coded in container.tmpl). \r
59 It seems that unlike sending photos and music when sending video the tivo needs to know the size of video before hand. So we lie and tell the tivo that it is 6000000000 bytes. The tivo will stop downloading when it hits this size. If the download stops before it it reaches what it thinks is the end it will try resuming the download (HTTP Range header). I return a 404 when the tivo trys to resume and it will give up. You may see an error when you reach the end of the file.\r
61 - Files delete before you watch them\r
62 Currently the only way to end a stream to the TiVo involves sending a 404. This is true for all transcoders currently.  Some people will see an error at the end of all of their streamed videos which says "Transfer Interrupted" this is only becuase TiVo thinks the file is larger than it is.\r
63 As a side effect of this some peoples videos will also delete before they watch them.  As far as I can tell the only way to keep a file is to play it all the way to the end as it is streaming to you.  If the file finishes streaming and you are not watchin it, it will delete itself before you watch it.  \r
64 My only suggestion is to either pause the stream on the TiVo and turn off the TV and come back and watch it.  Or get a wired connection so that you can watch the streams live.\r
66 - Now Playing List disappears\r
67 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
68 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
70 ---Notes\r
71 Most of the work has been done by armooo.  Updates in this version were contributed by krkeegan.