eekboard - an easy to use virtual keyboard library -*- outline -*-

eekboard is a virtual keyboard software package which ships with a
standalone virtual keyboard application ("eekboard"), and a library to
create keyboard-like UI ("libeek").

* Requirements

  * GLib2, GTK, GConf2, PangoCairo, libxklavier, libfakekey, CSPI
  * Clutter (optional)
  * Clutter-Gtk (optional)
  * Vala (optional)
  * gobject-introspection (optional)

* How to test

Build from git repo:

  $ git clone git://github.com/ueno/eekboard.git
  $ cd eekboard
  $ ./autogen.sh --prefix=/usr --enable-gtk-doc
  $ ./configure
  $ make

Dump the current system layout to an XML file:

  $ ./tests/eek-example-xml -d > keyboard.xml

Load and display a keyboard created from an XML file:

  $ ./tests/eek-example-xml -l keyboard.xml

Start D-Bus server:

  $ ./src/eekboard-server &

Access to the D-Bus server:

  $ ./src/eekboard-client --set-keyboard keyboard.xml
  $ ./src/eekboard-client --show
  $ ./src/eekboard-client --listen # press some keys on the keyboard
  KeyPressed XXXXX
  KeyReleased XXXXX

Listen and follow the system events:

NOTE: eekboard-system-client is now being heavily developed and it may
behave wrongly.  Make sure to close windows where you are doing any
important work, before running eekboard.

  $ ./src/eekboard-system-client --xklavier --accessibility --fakekey

Where --xklavier is to monitor system keyboard layout change,
--accessibility is to track focus/key events via AT-SPI, and --fakekey
generates X key events when eekboard-server signals virtual
key-press/key-release events.

* Documentation

See file:docs/reference/eek/html/index.html