1. Download and install VLC. Make sure it works. Instructions and files can be found at the VLC website. Be aware that VLC will only load modules which have the exact same version as the main executable. Our pre-compiled binaries are for VLC version 0.8.1.
  2. If you can use a pre-compiled binary, download one from the project's downloads page.
  3. If you can't or don't want to use a pre-compiled binary, you can get the source from the same place. Since the source for vstream hasn't been officially released yet, you can get it from the CVS repository. Note that building the module from source requires the entire VLC source tree as well. There are further build notes within the source releases.
  4. Put the modules (.dll or .so or .dylib or whatever) into your VLC modules directory. On Unix machines, this is usually something like /usr/lib/vlc/demux for the libty module and /usr/lib/vlc/access for the libvstream module. On windows, this is the "plugins" directory located wherever you unzipped the VLC package.
  5. Run VLC. The modules should be loaded. You can now type things like this:
    • vlc tivo://my-tivo-address/plist and after a few seconds VLC's playlist will be filled with all available shows on your TiVo. Double-click on an entry and it starts playing! (Requires vserver running on your TiVo.)
    • vlc tivo://my-tivo-address/12345 where 12345 is the FSID of a program on your TiVo. The FSID can be obtained through many methods, including looking at the "properties" of an entry in your VLC playlist after issuing the "plist" command above. (Requires vserver running on your TiVo.)
    • vlc some-ty-file.ty to play a TY file
    • vlc some-ty-file.ty ':sout=#transcode{vcodec=mp4v,vb=512,acodec=mp3,ab=192}: std{access=file,mux=ps,url=outfile.mpg}' (all on one line) and your TY file will be transcoded into MPEG-4 video, MP3 audio, with the bitrates stated. There are dozens of combinations and other options. Check out VLC's documentation for more.
    On Unix systems and cygwin, you can specify -vvv on the command line and when VLC starts, it will tell you which modules have been loaded.

Known Bugs

Coming Soon