Your application may request keyboard input.

The following events and functions can be used to retreive the key pressed by the user when your application have the focus.

event.keybard:down, event.keybard:up, event.keybard:press
keyboard.ID.char, keyboard.ID.code

If your application contains several windows and if you want to catch the key globaly, you can use:
event.keybard:global:down, event.keybard:global:up
keyboard.global.code

Reading the status of each key

It may be useful to read the status of each key if your application need to react to the keyboard input whenever the application do not have the focus, or to read special keys such as SHIFT, CTRL, MAJ, ALT.

keyboard.keyState

Media Center remote control

The Media Center remote control can be supported by reacting to keyboard events.
More info: Windows Media Center remote control.