INSTALL

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

$Id$


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


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

   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 / Ubuntu :

  Freevo is part of Debian and of Ubuntu; to install it, run
  # apt-get install freevo
  as root.



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/doc/Installation