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

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

Usually elisa should automatically find your media locations and show
them in the submenus under 'Folders' on its own. Anyway if it doesn't
or the directory is not accessible you can also add other locations,
that should appear in elisa. For that you simply have edit the
configuration file (if you run it without given a certain one, its
path is ~/.elisa/elisa.conf). There is a locations_builder-section. It
looks like that:

::

    [xmlmenu:locations_builder]
    locations = []
    auto_locations = 1

In this "locations" option, you can add your uris, like
'file:///home/ben/media/videos'.  Don't forget to add a comma (',')
between them. Then for example, it looks like this:

::

    [xmlmenu:locations_builder]
    locations = ['file:///home/ben/media/videos', 'file:///media/videos']
    auto_locations = 1

You can also disable the automatic lookup of media directories by
setting the auto_locations value to 0.  If you have more than one uri,
with the same ending, you probably want them to be named
differently. To do that, you need to set up a sub-section called the
same as the uri itself and you can add some other parameters like
this:

::

    [[file:///home/ben/media/videos]]
    label = 'Home Videos'
    only_media = ['video']
    location_type = 'local'

- the label is simply setting the label,
- the only_media let it only show up in the listed main-menu entries
  (currently there is 'video', 'audio', 'image').
- the location_type is the sub-directory where it shows up, like 'local'
  (for Folders) or 'internet' to show up under the Internet-Submenu in
  elisa.

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.
