Moovida - Bringing more together...

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

Moovida is an open source cross-platform media center solution designed
to be simple for people not particularly familiar with computers. With
Moovida 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.
- Moovida finds automatically medias on your network, from network
  drives, Windows Mediaplayer, etc.
- Detects automatically iPods, cameras, USB hard drives, etc.

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

- Python >= 2.4
- python-dev
- python-elementtree (for Python < 2.5)
- python-celementtree (for Python < 2.5)
- python-setuptools
- python-twisted >= 2.2
- python-twisted-web
- python-twisted-web2
- python-openssl
- python-pysqlite2 (for Python < 2.5)
- python-gtk2
- python-cairo
- python-pgm 0.3.12 https://core.fluendo.com/pigment/trac
- python-simplejson
- python-cssutils

  * for the development version of moovida, you should always use
    pigment-svn/python-pigment-svn

- GStreamer 0.10 + Python Bindings : http://gstreamer.freedesktop.org/
- libvisual0.4-plugins

- for a good looking font:

  * Liberation TrueType fonts

- for user default multimedia directories support:

  * xdg-user-dirs
  * python-xdg

- for UPnP support:

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

- for YouTube video streaming website support:

  * flashdemuxer for gstreamer (gstreamer0.10-flv)

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

  * gstreamer-plugins-bad 
  * gstreamer-plugins-ugly 
  * gstreamer-ffmpeg

- 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
  * for auto-plug support the hal-plugin

- for HAL (autoplugging) support:
 
  * hal and python-dbus

- for the Flickr plugin to work:

  * python-twill

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 Moovida
===============

If you are not installing Moovida and Pigment system-wide, you need to
set up a Pigment environment including the Python Bindings prior to
running Moovida. To do so, go in Pigment's 'pigment' subdirectory and run:

::

  $ ./misc/pgm-uninstalled


Optionally build Moovida locally, at least one C extension will be built
for DAAP playback:

::

  $ python setup.py build

Then running Moovida is as simple as executing the launcher script from
Moovida's top level directory:

::

  $ python elisa-core/bin/moovida


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

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

2. You can run:
    ::

      $ sudo python setup.py install


Media locations configuration
=============================

See the FIRST_RUN document.


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

If you want to hack on Moovida, just run the moovida launcher script in
elisa-core/bin/, it should launch without polluting your default environment.
No need for a local jail or PYTHONPATH adjustments.

When you make an update to moovida'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.