OK got matchbox-keyboard compiled and i can run the script to turn it on and off.

NOW PLEASE: How do we bring-up and hide the keyboard when a SDL app is running?
---------

You can get matchbox-keyboard and libfakekey here: http://pupnik.de/matchbox-kbd.html

(EDIT) Ok turns out you need to restart the device after installing the applet. Unfortunately this was not mentioned on the applet's homepage or anywhere else on the web.

After rebooting, you should see a new cpu/memory monitor icon to the left of your screen brightness bar. Click on this, select 'Run' and then type in the path to the script in the first post. Click 'Save as' and enter a menu name for the kbd on/off script.

If you use matchbox-keyboard instead of xkbd, you'll need to edit the script and substitute matchbox-keyboard for xkbd throught the script.

----
The keyboard toggle is only selectable if the sdl game is not fullscreen. We still need a solution that works with all programs.

Cheers