Elisa - Enjoy your media from your sofa

What it is
==========

Elisa is an open source cross-platform media center solution designed
to be simple for people not particularly familiar with computers. With
Elisa you can enjoy:

- Watch your pictures with previews and nicely animated slideshows.
- Watch your movies and video clips as well as online ones.
- Manage your music collection by artists or albums covers.
- Watch DVDs with total menu support.
- Elisa finds automatically medias on your network, from network
  drives, ITunes, Windows Mediaplayer, Rhythmbox, etc.
- Detects automatically IPods, cameras, USB hard drives, etc.

Dependencies
============

- Python >= 2.4
- python2.4-dev
- python-setuptools
- python-imaging
- python-twisted >= 2.2
- python-twisted-web
- python-gnome2-extras
- python-pysqlite2
- GStreamer 0.10 + Python Bindings : http://gstreamer.freedesktop.org/
- Pigment 0.3.0 : cf https://core.fluendo.com/pigment/trac
- TrueType font "MgOpen Cosmetica"
- for UPnP support:

  * Coherence : cf https://coherence.beebits.net/

- for covers retrieval via Amazon:

  * python-elementtree
  * python-celementtree

- optional dependencies (useful to play some exotic formats and dvds):

  * gstreamer-plugins-bad 
  * gstreamer-plugins-ugly 
  * gstreamer-ffmpeg
  * TagPy : http://news.tiker.net/software/tagpy

- for LIRC support:

  * lirc
  * liblircclient0
  * pylirc

- for DAAP support (remote iTunes music browsing) support:

  * PythonDAAP: http://jerakeen.org/code/PythonDaap/
  * dbus, python-dbus, avahi and python-avahi for discovery support (optional)

- for iPod support  

  * libgpod
  * python-gpod
  * hal and python-dbus for hotplug support (optional)


You can check if you already have gst-python by doing the following
command on a shell:

:: 

  $ python -c "import gst"

If this command returns nothing, you are good to go.


Running Elisa
=============

If you are not installing Elisa and Pigment system-wide, you need to
set up a Pigment environment prior to running Elisa. To do so, go in
Pigment directory and run:

::

  $ ./misc/pgm-uninstalled


Then running Elisa is as simple as running elisa.py from the Elisa
directory:

::

  $ python elisa.py


System-wide deployment
======================

1. Ensure you have all dependencies installed (including a system-wide
   setuptools)

2. You can run:
    ::

      $ sudo python setup.py install



Development mode
================

If you want to hack on Elisa, just run elisa.py, it should launch
without polluting your default environment. No need for a local jail
or PYTHONPATH adjustments.

When you make an update to elisa's setup.py, especially about entry
points, you need to run:

::

  $ python setup.py egg_info

This command will update the elisa.egg-info metadata directory.
