First run instructions 
======================

Media configuration
-------------------

After the first run of Elisa, edit `~/.elisa/elisa.conf` and add some media
locations in `[xmlmenu:locations_builder]` config section like shown
in the following example:

::

  [xmlmenu:locations_builder]
  locations = ['file:///data/mp3', 'file:///home/phil/media/movies', 'file:///home/phil/media/pictures']

  [[file:///data/mp3]]
  only_media = ['audio']

  [[file:///home/phil/media/pictures]]
  only_media = ['image']

  [[file:///home/phil/media/movies]]
  only_media = ['video']

Keyboard control
----------------

In all cases
++++++++++++

- to exit from Elisa, press q or escape key
- f : Toggle fullscreen

Menu hidden
+++++++++++

- Space bar : Show menu.

Menu active
+++++++++++

- Enter     : Action (play video ...)

List menu mode
++++++++++++++

- Up/Down: navigate in the current menu level
- Right: go to the top context bar
- Backspace: go to previous menu
- Enter: Play media if it's a media or navigate in the selected
  directory

Grid menu mode
++++++++++++++

The user can navigate in the 4 directions (up, down, left, right)
using the direction keys. When the first row of the grid is reached,
the user can enter the top context bar by hitting "Up" key once
more. When the last row of the grid is reached, the user can enter the
grid context bar by hitting "Down" key once more.

Navigation inside the grid context bar is horizontal, use Left/Right
keys to navigate in the 3 buttons. To activate a button, press
Enter. To leave the context bar, press Up key.

Cover flow menu mode
++++++++++++++++++++

- Left/Right: navigate in the current menu level
- Up: go to the top context bar
- Backspace: go to previous menu
- Enter: Play media if it's a media or navigate in the selected
  directory

Top context bar
+++++++++++++++

When navigating inside menus, there should always be a context bar
available on the top of the window. Navigation inside this bar is
horizontal, use Left/Right keys to navigate in the bar buttons. To
activate a button, press Enter. To leave the context bar, press Down
key.

Menu hidden and active player
+++++++++++++++++++++++++++++

- Left or v : Seek backward
- Right or b: Seek forward
- Up/Down   : Volume up/down
- Enter     : Play/pause
- x         : previous track of playlist
- c         : next track of playlist
- Space : Show the menu

Infrared remote controls (LIRC)
-------------------------------

Currently only Streamzap remotes are supported. To support other types
of remotes, create a new lircrc config file like
core/plugins/data/streamzap.lirc. Put the new file in ~/.elisa and
update ~/.elisa/elisa.conf accordingly in the [base.lirc_input] section.
