====================
 Elisa technical FAQ
====================

.. contents::
.. sectnum::


iPod plugin
===========

The iPod plugin allows to browse and play music stored on a given
iPod, if it has some :) To enable it you need at least libgpod_ and
its Python bindings. The iPod Elisa plugin is enabled by default, so
you shouldn't need to update the Elisa config. Once plugged in, Elisa
will show your iPod in the "Audio" menu.

If you still don't see your iPod in Elisa, please check that you have
a working hal/dbus/gnome-volume-manager trio. If you don't, you need
to manually add the mounted ipod in the music locations option:

::

  [base:audio_activity]
  locations = ['file://./sample_data/music', 'ipod:///media/ipod']

To get dbus/hal support, you'll need to install HAL, DBUS and
python-dbus. To check if they are working, simply plug your iPod on
the computer and if you see the iPod icon appear on the desktop, it's
good to go.

.. _libgpod: http://www.gtkpod.org/libgpod.html
  

DAAP plugin
===========

The DAAP plugin allows Elisa to browse and play remote music files
served by iTunes and friends on the local network. To enable this
plugin you'll need to checkout the Subversion repository of
PythonDAAP_:

::

  svn co https://jerakeen.org/svn/tomi/Projects/PythonDaap
  cd PythonDaap
  python setup.py install

.. _PythonDAAP: http://jerakeen.org/code/PythonDaap

To enable the DAAP plugin, edit the media_providers option:

::

  media_providers = ['base:daap_media',...]


If you want DAAP shares to appear automatically in Elisa, you'll need
to install DBUS/Avahi, python-dbus, python-avahi and start
avahi-daemon. If you don't want to install those, edit the elisa
config and supply some DAAP locations:

::

  [base:audio_activity]
  locations = ['file://./sample_data/music', 'daap://host:port']

On Ubuntu Edgy avahi-daemon isn't automatically started. To make it
happen:

::

  $ sudo echo "AVAHI_DAEMON_START=1" > /etc/default/avahi-daemon 
  $ sudo /etc/init.d/avahi-daemon start

Flickr plugin
=============

The flickr plugin allows Elisa to browse and search the Flickr_ images
sharing website. To enable and use it you need a Flickr account, twill
and flickrpc. 

Check out flickrpc:

::

  $ bzr co http://burtonini.com/bzr/flickrpc/


Check out twill:

::

  $ darcs get http://darcs.idyll.org/~t/projects/twill/

To configure the plugin, edit elisa.conf, as usual:

::

  media_providers = ['flickr:flickr_media', ...]

  [flickr:flickr_media]
  login = 'myflickrlogin'
  password = 'myflickrpassword'
  
Configure your PYTHONPATH so that Elisa will find Twill and flickrpc:

::
  
  $ export PYTHONPATH="/path/to/twill:/path/to/flickrpc:$PYTHONPATH"
  $ elisa


.. _Flickr: http://flickr.com
