Hi,

I've committed some changes, adding more functions to the LIRC client, in sync  
with the latest improvements by Toni Arnold. Also added support for IRKick: 
the KDE LIRC daemon as an alternative to the internal LIRC client. 

Attached is a draft for the documentation. I would appreciate if you can 
review and comment it. I would add it to the Handbook, eventually. Where can 
it fit better?

Regards,
Pedro

Using infrared remote controls with Rosegarden
==============================================

Rosegarden can use infrared remote controls for some functions, like transport 
buttons and track navigation. There is an internal LIRC client that can be 
optionally compiled into the program. This internal LIRC support may be useful 
when you don't use the KDE desktop with Rosegarden, or when you don't want to 
use IRKick (the KDE LIRC Server daemon). If you already use an infrared remote 
control with other KDE applications with IRKick, you may use also Rosegarden in 
the same way.

LIRC Daemon Setup
-----------------

First, it is necessary to install and configure the LIRC (Linux Infrared Remote 
Control) daemon. See http://www.lirc.org documentation about how to configure 
the lircd daemon. The details are different depending on the infrared receiver 
that you use, and the remote control model.

As an example, here is the howto for a modern digital TV USB receiver: 
http://mcentral.de/wiki/index.php/LircRemote

LIRC Client
-----------

If you want to use the internal LIRC client compiled into Rosegarden, you need 
to provide a configuration file. It is usually located in your home directory 
with the name ".lircrc", and here is where you define the bindings between the 
remote control buttons and the application functions. Here is an example of 
such configuration.

# ----------------------------------------------------------------------------
# lircrc.rosegarden
#
# Example .lircrc config file for rosegarden.
# Adjust the "button =" lines to your remote control in your ~/.lircrc
# ----------------------------------------------------------------------------
begin rosegarden
  # ------------------------------
  # rosegarden transport
  # ------------------------------
  begin
    prog = rosegarden
    button = FORWARD
    config = FORWARD
  end
  begin
    prog = rosegarden
    button = REWIND
    config = REWIND
  end
  begin
    prog = rosegarden
    button = PLAY
    config = PLAY
  end
  begin
    prog = rosegarden
    button = STOP
    config = STOP
  end
  begin
    prog = rosegarden
    button = RECORD
    config = RECORD
  end
  # (mis-)use volume up/down for jumping to beginning/end
  begin
    prog = rosegarden
    button = VOLUMEUP
    config = FORWARDTOEND
  end
  begin
    prog = rosegarden
    button = VOLUMEDOWN
    config = REWINDTOBEGINNING
  end
  # ------------------------------
  # track navigation
  # ------------------------------
  begin
    prog = rosegarden
    button = CHANNELUP
    config = TRACK-
  end
  begin
    prog = rosegarden
    button = CHANNELDOWN
    config = TRACK+
  end
  # track LED's
  begin
    prog = rosegarden
    button = MUTE
    config = TRACK-MUTE
  end
  begin
    prog = rosegarden
    button = MENU
    config = TRACK-RECORD
  end
end rosegarden


IRKick support
--------------

The IRKick profile was already installed in your system when you installed 
Rosegarden. You only need to start the IRKick program, and use the 
configuration dialog to bind the buttons of your remote control to the actions 
provided by Rosegarden. You may also bind a remote button to any Rosegarden 
function exported in a DCOP interface. 
-------------------------------------------------------------------------
This SF.net email is sponsored by DB2 Express
Download DB2 Express C - the FREE version of DB2 express and take
control of your XML. No limits. Just data. Click to get it now.
http://sourceforge.net/powerbar/db2/
_______________________________________________
Rosegarden-devel mailing list
[email protected] - use the link below to unsubscribe
https://lists.sourceforge.net/lists/listinfo/rosegarden-devel

Reply via email to