Installation instructions for Freevo
------------------------------------

$Id: INSTALL,v 1.35 2003/11/11 01:48:45 krister Exp $


Detailed help is in the Freevo Wiki at
http://freevo.sourceforge.net/cgi-bin/moin.cgi/DocumentationPage


Short description:
------------------

1. Using the runtime package:

   If you only want to test Freevo, you can download the runtime
   package, which contains all Python modules needed to run Freevo. You
   only need some extra applications like MPlayer.

   You can download the runtime from the Freevo download page at
   http://sourceforge.net/project/showfiles.php?group_id=46652&release_id=194955

   Then run 'freevo install <path-to-runtime.tgz>' to install the
   runtime into Freevo.


2. Installing Freevo into the system:

   To install Freevo, run 'python setup.py install' as root. If you
   don't want to install Freevo, you can also start Freevo directly in
   the unpacked tarball. 

   You need to have all dependencies installed.




Dependencies:
-------------

Freevo has many dependencies. Based on your distribution, it's more or
less easy to install everything.


o Redhat 9 (and maybe other RPM based distributions)

  There is a list of needed RPMs to install Freevo in
  contrib/rpm/freevo-deps.txt.



o Gentoo:

  You need to update your portage tree with some missing packages. Get
  rsync-freevo at http://freevo.sourceforge.net/gentoo/rsync-freevo
  and start it. You should get a Freevo ebuild. Now you can run
  'emerge freevo' to install Freevo.



o Debian:

  A Debian apt source is available and includes all the dependencies
  you'll need.
  You should add this to your /etc/apt/sources.list file:

  deb http://freevo.sourceforge.net/debian unstable main
  deb http://marillat.free.fr/ unstable main

  (The second source provides mplayer and other multimedia packages)

  Then, simply run apt-get update && apt-get install Freevo to fetch
  all the dependencies you'll need to run Freevo.



o If you want to install Freevo on a different distribution, here is
  a list of all dependencies (some have other dependencies in turn, check the
  website for details)

  Python 2.2.2 or higher	http://www.python.org/
  Pygame                        http://www.pygame.org/
  Imaging (PIL)			http://www.pythonware.com/products/pil/
  Twisted			http://twistedmatrix.com/
  mmpython                      http://www.sf.net/projects/mmpython
  pylirc (optional)             http://pylirc.sourceforge.net/


  External programs (all are optional except MPlayer)

  MPlayer                       http://www.mplayerhq.hu/
  Xine                          http://www.xinehq.de/
  XMLTV				http://membled.com/work/apps/xmltv/  
  tvtime                        http://tvtime.sourceforge.net/
  
  You can find more details on
  http://freevo.sourceforge.net/cgi-bin/moin.cgi/DocumentationPage_2fInstallDeps