GNOME.ORG

GNOME Infrared Remote Control Properties Manual

1. Introduction

Use GNOME Infrared Remote Control Properties to configure your LIRC powered infrared remote. GNOME Infrared Remote Control Properties provides the following features:

  • Auto-detection of infrared receivers.
  • Selection and customization of remote configurations.
  • Learning of remote control key-codes.
  • Sharing of customized remote configurations.

Please help the community by:

  • Sharing your newly created and corrected remote configuration files.
  • Reporting receivers supported by LIRC but ignored by this control panel.
  • Reporting other issues.
  • Translating the program and its manual to your native language.

2. Getting Started

2.1. Starting GNOME Infrared Remote Control Properties

You can start GNOME Infrared Remote Control Properties in the following ways:

System menu

Choose Administration ▸ Infrared Remote Control.

Command line

To start GNOME Infrared Remote Control Properties from a command line, type the following command, then press Return:

gnome-lirc-properties

2.2. When You Start GNOME Infrared Remote Control Properties

When you start GNOME Infrared Remote Control Properties, the following window is displayed.

Figure 1GNOME Infrared Remote Control Properties Start Up Window

The GNOME Infrared Remote Control Properties window contains the following elements:

Receiver Selection.

The drop-down lists in this area allow you to select the brand and model of your infrared receiver.

For a few devices you'll have to select which physical device to use. In that case the Device entry is sensitive.

Remote Selection.

The widgets in this area allow you to select the brand and model of your infrared remote control. In many cases it is sufficient to just use remote control supplied with your receiver.

Test Area.

This area shows you the results of your configuration attempts. Press the buttons of your remote to check if they are recognized correctly.

3. Usage

You can use the GNOME Infrared Remote Control Properties application to perform the following tasks:

3.1. Detect Infrared Receivers

TODO: Write this section

Figure 2Dialog for choosing between detected receivers

3.2. Customize Remote Configuration Files

TODO: Write this section

3.3. Configure a new Remote Control

TODO: Write this section

3.4. Learn your Remote Control's Key Codes

TODO: Write this section

3.5. Upload Remote Configuration Files

TODO: Write this section

3.6. Download Remote Configuration Files

TODO: Write this section

4. Preferences

To customize your remote control's configuration, activate Use different remote control and press the Custom Configuration button. The Custom Configuration dialog contains the following tabbed sections:

4.1. Remote Model

This section is used to describe your remote control.

Figure 3Remote Model section
Manufacturer

Put the official name of your remote control's manufacturer here.

Model

Put the official model name of your remote control here.

Contributor

Put your own name here. Your work deserves acknowledgement.

4.2. Basic Configuration

This section shows the basic configuration properties of your IR remote. Your remote cannot be used unless these parameters are recognized. Press the Detect button to start guided detection of those properties.

Figure 4Basic Configuration section

4.3. Key Codes

This section allows assignment of key-codes to well-known names. Double-click a key-code row to start the learning mode. Use names from the default namespace whenever possible, for maximum interoperability.

Figure 5Key Codes section
Add

Add another key to the configuration. Learning mode starts directly after pressing this button.

Remote

Deletes the currently selected key.

Add

Deletes all key definitions.

5. About GNOME Infrared Remote Control Properties

GNOME Infrared Remote Control Properties was written by Mathias Hasselmann () and Murray Cumming (. To find more information about GNOME Infrared Remote Control Properties, please visit the project page.

To report a bug or make a suggestion regarding this application or this manual, follow the directions in the Feedback section of the GNOME User Guide.

This program is distributed under the terms of the GNU General Public license as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. A copy of this license is included with this documentation; another can be found in the file COPYING included with the source code of this program.