lxmms2 Copyright (c) 2005-2010 Johannes Heimansberg
Website: http://wejp.k.vu/
Released under the GNU General Public License v2.

0. Introduction

With lxmms2 it is possible to control XMMS2 with a LIRC compatible 
remote control.

1. Compiling lxmms2

To compile lxmms2 you will need at least XMMS2 DrDolittle and LIRC 
(tested with 0.7.0 and 0.7.2). You can compile lxmms2 by running "make" 
from within the source directory. If your XMMS2 header files are not 
located at /usr/local/include/xmms2 you need to modify line 7 of the 
Makefile. With "make install" you can install lxmms2 to /usr/local/bin.

2. Using lxmms2

If you don't know how to setup LIRC itself please read the LIRC documentation.
Assuming your LIRC is setup properly, there are two things left to get lxmms2
working.

2.1 Modifying your ~/.lircrc file

For each function you want to control with your remote control you'll need
to add a section like this to the .lircrc file:

begin
    prog = lxmms2
    button = PLAY
    config = toggle_play_pause
end

Where "PLAY" in this case is the name of the button on your remote control.
"toggle_play_pause" is the action that should take place on a button press.
Possible actions are:

play (starts playback)
pause (pauses playback)
toggle_play_pause (toggles pause and starts playback 
                   if XMMS2 is not playing at all)
toggle_pause (toggles pause)
stop (stops playback)
next (advances to the next track)
prev (goes back to the previous track)
volume_up (increases the volume)
volume_down (decreases the volume)

2.2 Starting lxmms2

You can either run lxmms2 manually or add it to the ~/.config/xmms2/startup.d/ 
folder. Adding lxmms2 to that folder starts it everytime you start the XMMS2 
daemon. The recommended way to do that is making a symlink in 
~/.config/xmms2/startup.d/ to the lxmms2 binary.

