#############################################################################
## This file is part of the lirc-0.5.4 package ##############################
## LIRC - Linux Infrared Remote Control #####################################
#############################################################################



irxevent  - infra-red xevent sender

by Heinrich Langos <heinrich@mad.scientist.com>

Irxevent is a programm that I wrote to send Buttonclicks and
Keypresses to X applications triggered by a lirc driven remote
control. You can control your favorite CD/MP3 player or your TV tuner
program or any other X application that responds to keyboard or mouse
input. If you like to you can send emacs ^X^S from your armchair.

Irxevent is a complement to irexec and irpty and works with a the same
config file. (~/.lircrc)
For a complete sample-.lircrc look at "examples/lircrc".

Part of your .lircrc could like this.
--------------------------------
begin
        prog = irxevent
        button = VIDEO_UP    
        config = Key SHIFT-KP_Add CurrentWindow
end
begin
        prog = irxevent
        button = VIDEO_DOWN
        config = Key SHIFT-KP_Subtract CurrentWindow
end
begin
        prog = irxevent
        button = STOP
        config = Key ctrl-c CurrentWindow
end
begin
        prog = irxevent
        button = 0
        config = Key f xawtv
        config = Key f xawtv
end
begin
        prog = irxevent
        button = POWER
        config = Key q xawtv
end
begin
        prog = irxevent
        button = CH_DOWN
        config = Button 1 329 92 kscd
end
begin
        prog = irxevent
        button = UP
        config = Button 1 110 80 GQmpeg
end
begin
        prog = irxevent
        button = DOWN
        config = Button 1 130 80 GQmpeg
end
--------------------------------

Simply said "config=" lines may look like this:

config = Key [shift-][ctrl-][alt-] <windowname>|CurrentWindow
config = Button <button> <x> <y> <windowname>|CurrentWindow

some more examples:
----------------------------------
config = Key Up xawtv
config = Key Down xawtv
config = Button 1 50 110 xclickme
config = Key q xawtv
config = Key ctrl-c mpg123
config = Key shift-Page_Up rxvt
----------------------------------


In BNF this looks like:

LINE    = "config =" <KEY|BUTTON> <TARGET>
KEY     = "Key" <MOD>Keyname
MOD     = ["shift-"]["numlock-"]["ctrl-"]["alt-"]["meta-"]["numlock-"]
          ["mod3-"]["mod4-"]["scrlock-"]
BUTTON  = "Button" <1..5> <x_position> <y_position>
TARGET  = Windowname|"CurrentWindow"


Keyname is the keysymbol that is declared in X windows. 
  i.e. "Up" refers to the cursor arrow pointing up. 
  "KP_Add" is the plus sign on the key pad. Just take a look at 
  irxevent.keys if you are not sure about a symbol's name.

Windowname can be the first characters of the window name displayed by 
  the windowmanager or the name that is displayed below the icon.
  Some programms use the name displayed by the windowmanager to show a
  lot of status information but don't change the iconname. (like xawtv)
  Others append information to the window name ("GQmpeg - kill_windooz.mp3")
  If neither window name nor icon name match the given Windowname 
  information from XClassHint(3x) will be checked.

CurrentWindow refers to the active window as returned by XGetInputFocus(3x).
  Most times this is the window with your mouse pointer in it.



If you have problems finding the coordinates for a buttonclick you can try 
"xev -id <window_id>". The window_id can be found using "xwininfo".
If xev and xwininfo are not part of your distribution you can find them
at an ftpserver using the search engine at: http://ftpsearch.ntnu.no/ .
xev also reports the names of keysymbols like "Control_L" (your left control 
key) or "KP_Subtract" (the 'minus' key on your keypad)

If you have problems sending events please drop me an email.


CHANGES:

see irxevent.c


BUGS: 
      -I don't care much about buffer sizes :)
      -xterm and xemacs don't receive key presses. Ok, they receive 'em
       but they don't forward them to the correct subwindow.
      
TODO:
      -a Key_xy thingie that hopefully solves xterm/xemacs problem.
      -dunno .. you tell me