# The &kvkbd; Handbook

## Introduction

&kvkbd; is a simple virtual keyboard for &kde;. It can be used by disabled people who have trouble using a keyboard or for devices with a touch screen but no keyboard. It is also useful to quickly test a keyboard mapping to locate some keys.

## Using &kvkbd;

### &kvkbd; interface

When first launched, &kvkbd; will appears in the bottom-right corner. You can move it by clicking on empty area and drag it anywhere on the screen. You can resize it by clicking on the stripes at the bottom-right. The button on the top right is used to hide the keyboard, if you want to show it again, just click on the tray icon. If you want to use the numeric keypad, press the green arrow on the right.

### The configuration menu

&kvkbd; configuration menu is accessible ever by clicking on the configuration button or by right-clicking on the tray icon. You can change the font used to display the keys by clicking on "Choose Font...". If you check "Auto Resize Font", the font will grow or shrink when &kvkbd; is resized. If you click on "Dock Keyboard", a small dock will appears. You can click on it to hide or show the virtual keyboard, you can also drag it anywhere on your screen. Finally, the "Lock on Screen" option will prevent the virtual keyboard from being dragged or resized.

### Using &kvkbd; with a display manager

&kvkbd; can be used on a display manager, like KDM or XDM, to do this edit one of the following file:

- /etc/kde4/kdm/Xsetup for KDM/KDE4

- /etc/kde3/kdm/Xsetup for KDM/KDE3

- /etc/X11/xdm/Xsetup for XDM

And add this at the end:

    HOME=/root kvkbd --loginhelper

If you want to quit &kvkbd; once the session is started(useful to let the user launch his own instance of &kvkbd; with his own settings) edit:

- /etc/kde4/kdm/Xstartup for KDM/KDE4

- /etc/kde3/kdm/Xstartup for KDM/KDE3

- /etc/X11/xdm/Xstartup for XDM

make a new line after the first line and add this to it:

    qdbus org.kde.kvkbd /MainApplication quit

There is no configuration button in the loginhelper mode. If you want to change the default config, you can launch &kvkbd; as root using:

    $(kde4-config --path libexec)/kdesu kvkbd

and make the changes here. You can also launches Kvkbd without the --loginhelper option, this is useful if you want to let the users of the system change the options of &kvkbd; and be able to minimize it in the systray without launching their own instance of it.

## Credits and License

&kvkbd;

Program Copyright © 2007-2014 Todor Gyumyushev yodor1@gmail.com

Program and Documentation Copyright © 2008 Guillaume Martres smarter@ubuntu.com

&underFDL; &underGPL;

## Installation

### Compilation and Installation

&install.compile.documentation;
&documentation.index;