Back to main page


Current version is 1.0
Look at ChangeLog for update information.


- What's iowlircemu ?
- Before using it
- Building
- Using as LIRC emulator
- Using for LCD output
- Credits

What's iowlircemu ?

iowlircemu is an emulator of LIRC which (currently) only supports the
Code Mercenaries GmbH's IO-Warrior24 starterkit. Nothing else. 
Neither LIRC is required, nor it depends on it.
It's distributed under the terms of GPL.

Also it provides an interface to write data to a connected LCD. An plugin for
xmms is also included in the package.

Before using it

If anything is damaged    - I'm not responsible. 
If anything is removed    - I'm not responsible. 
If anything is blowing up - I'm not responsible. 
If anything happened      - I'm not responsible. 
I'm not responsible for anything. 
Use iowlircemu at your _OWN_ risk!
You must agree before using iowlircemu.

Go to download after reading this site carefully!


You need libusb[-devel] and libpthread[-devel] to compile. 
No iowarrior kernel driver is neceassary. 

Then begin to compile iowlircemu via 'configure && make'.
Maybe you should change config.h for your needs, especially for your LCD. Then to a "make" once again.
After installation using 'make install' iowlircemu-executable should be
availiable on your system.

Using as LIRC emulator

iowlircemu creates a socket (default is: /dev/lircd) were clients like xmms read 

Running 'iowlircemu -h' gives some info's for usage.

When starting sucessfull the LED is blinking twice, on exit once (but longer).
While receiving RC5 codes is blinking again.
Well known codes are passed to the lirc clients, invalid will not, but the LED
is blinking a bit longer!
Run 'iowlircemu -l' to capture and learn unknown codes.

I'm not knowing LIRC very well, so the codes might be wrong. But it seems to work.
A .lircrc example for xmms can be found in xmms' doc diretory.

Please submit created configurations for your remote controls. Thanks.

Using for LCD output

If compiled with LCD support iowlircemu creates a socket (/dev/iowlcd) were clients
can write to output data to LCD.
(Edit config.h to setup the correct settings for your LCD!)

To send a string to IOW LCD to the following:
 open the socket, send to and close,
Because I don't want to encapsulate data (NOW), do NOT open, send until your app 
quits and close after all. 

Format strings for sending to LCD:
"Line1\\nLine2\\nLine3\\nLine4\\n..." displays
"\\n\\n\\n\\n" means clear screen.

On startup iowlircemu uses the LCD as a simple watch (just to display something).
After 10 minutes of inactivity or a few seconds auf "clear screen" the watch is
display again.

If the submitted lines are to longer than display's lines, iowlircemu will scroll
the lines (but it may flicker).

A xmms-plugin for outputting data on LCD can be found in ./xmms-plugin. 
Use "make" to build and "make install" to install. 
It installs the lib into /usr/lib/xmms/General.
Note: You might have to change pathes for xmms, gtk, gdk ...

Run xmms and configure the plugin. 
A good setting is this: %p - Vol %v%\n%t - %m\n%A\n%T\n
Try it and have fun.

Another way to display something on LCD is to run "iowecho string-to-send".
Format string as mentioned above.


Parts or ideas from the following projects (all GPLed) where used:
- lircemu (
- xmms
- iowlcd by Christian Vogelgsang (
- - examples for libusb

current version:

old files: