GC Convert

GC Convert is a utility written in Java that will create LIRC Conf files from a Global-cache IR Codeset file. The initial motivation for this application was to produce AndyMOTE friendly lirc.conf files, but, of course, any such files should be compatible with any front end application using LIRC as a back-end IR Transmitter.

The instructions in this article are for a Linux Desktop environment; but, as GC Convert is a Java application, most instructions will apply directly to windows.

irrecord is a command line application provided by lirc.org which creates lirc.conf files by recording the signals from your original remote control using an appropriate hardware setup. The benefits of using GC Convert over irrecord are:

  • Global-cache IR Codeset Files often contain codes that are not available on the original remote control.
  • Configurations can be easily modified/regenerated once created.
  • Access to the original remote control is not required.

GC Convert is available free on github; to download your copy, goto your home directory & clone the gcConvert repository as follows:

$ cd ~
$ git clone https://github.com/orangereaper/gcConvert

alternatively download the current master using this link and unzip using your favourite unzip package.

Move the GC Convert file into a convenient location; eg:

$ sudo mkdir -p /opt/gcconvert
$ sudo mv gcConvert/target/gcConvert-1.0-SNAPSHOT.jar /opt/gcconvert/

(Note: the executable file is gcConvert-1.0-SNAPSHOT.jar requires Oracle Java 8 Runtime Environment).

Conversion Process

Generating an LIRC Conf file from the Global-Cache IR Codeset file is a simple 4-step process described below

  1. Register a Global-cache account and obtain your IR Codeset Files.
  2. Load the codeset file into gcConvert.
  3. Select the codes you wish to include in your conf file and their key names.
  4. Save the conf file.

Register with Global Global-Cache

You can register with Global-Cache by following this link.

Once you have obtained your account, login and go to the database section to obtain your IR Codeset (eg):

  • Enter the brand name. eg. LG.
  • Select the device type: eg. TV.
  • Select a Model: eg Code Group 1.
  • Press the 'Send Code Set' Button.

Note: You may get different options depending on the selections you make.

After a short delay you should receive an email from gccache.com; the body will look something like that shown in Figure 1.

Select the entire content of the email body and copy/paste it into a new text file in your favourite text editor; then, save the file to somewhere memorable. (This file is henceforth referred to as a "GCC Raw File").


Load the IR Codeset File

Start GC Convert; this will initially show an unpopulated view.

Click on 'File' to see the program options available; here you can

  • Open a GCC Raw File.
  • Import a previously exported GC Convert configuration.

The latter option allows you to reload a previously created GC Convert configuration file and make changes. First time through though, you should select the former option, browse to your previously created GCC Raw File, then click 'Open'. This will populate the GC Convert window with values.


Select Codes and Keys

At this point you GC Convert should look something like Figure 3.

The window is split into 3 sections. The top section contains information on the waveform characteristics for the codeset you have loaded (unless you know what you are doing do not change this!). The bottom section contains the list of keys (key list) available for use in your lirc.conf file. This list can be filtered (in the middle section of the window) by Function Name and to only show keys that you have selected for inclusion in your lirc.conf file.

In the key list, use the check box at the left of a key to include it in your lirc.conf file, then use the dropdown to select an appropriate name for the key (or type your own into the text box).

Note: The textbox will disappear if you select a key name from the dropdown; to restore it select "..Select.." in the dropdown

Work down the list until you have added all the keys that you want to be included in your lirc.conf file.


Save Your Work

Once you have finished selecting and naming the keys you want to be included in your lirc.conf file, it's time to save your work.

To do this click 'File' and you will be presented with a number of options:

Export Current

This option will export the program state to the same directory as your GCC Raw File; you can restore this state at some later time by using the "import" option. (ie you can save and restore your progress and modify later)


Select this option to generate an lirc.conf file in the same directory as your GCC Raw File.

This option will be greyed out if the Protocol is UNKNOWN.


This option is the same as 'Save LIRC.CONF File" except, in this case, an LIRC Raw file is created.