Howto | Install Kiosktool

First let’s take a look at where KDE squirrels away all these settings. KDE is complex, but it’s well-organised, and there is always a method to whatever KDE madness you find yourself in.

You can see for yourself where your particular KDE installation is going to look for configuration files:

$ kde-config --path config

KDE reads these in reverse order, so if it encounters any conflicts, the last value read is the one used. User’s individual configurations take precedence, so they are read last. There is a way to make an exception to the precedence rule: using $i, or the “immutable” key. You’ll see how this is used in the examples below. Anything marked immutable has precedence, no matter what order it’s in.

Installing Kiosktool

This is now unnecessary, as this has been fixed on Debian, you should now be able to simply do an aptitude install.

Kiosktool is simply an easy way of administering the above files. Kiosk Admin Tool is available in Debian Testing/Unstable and should be as simple to install as:

$ sudo apt-get install kiosktool

Unfortunately the current version of Kiosktool is broken for Debian, as Debian have changed the filename for the menu configuration from to, and unfortunately Kiosktool is now unmaintained, so to install requires a few more steps than normal:

Install the build dependencies

$ sudo apt-get build-dep kiosktool

Before installing the dependencies, please copy them into the clipboard.

Download the source

Note that you do not need to be root to do this, and it helps later if you’re not! Change your repository if necessary, or remove it entirely to install from your default repository. Note however that at the time of writing Kiosktool is only available in testing, unstable and backports (the same versions in each).

$ apt-get -t etch-backports source kiosktool

Edit the source

This will download three files: a .orig.tar.gz, a .dsc and a .diff.gz. In the case of packages made specifically for Debian, the last of these is not downloaded and the first usually won’t have “orig” in the name. The .dsc file is used by dpkg-source for unpacking the source package into the directory packagename-version. Within each downloaded source package there is a debian/ directory that contains the files needed for creating the .deb package.

Navigate to this directory and open the following file in a text editor:


Replace all instances of with

Build the deb

From within the directory that was created for the package after downloading.

$ apt-get -b source kiosktool

To install the package built by the commands above one must use the package manager directly, like this:

# dpkg -i kiosktool-<version>.deb

Remove the build dependencies

It seems that some of the build dependencies may be incompatible with the LTSP enlightened sound daemon (esd), if you copied them (as recommended in Install the build dependencies section), then please purge them now. Otherwise you will need to review /var/log/dpkg.log for the relevant files.

$ sudo apt-get --purge remove package1 package2 etc

Using Kiosktool

After installation you should have a menu entry for it in System -> KIOSK Admin Tool, or use the kiosktool command to start it from the command prompt.

You may find that a copying dialog crops up at regular intervals and that often it will stall, please read:


This document was cobbled from the following sources:

Other references:

The advice in the Edit the source section was copied from a mailing list post, which I now cannot find. The post also mentioned that patches were available for this issue, although I could not find any such patches, and anyway the method above is probably just as easy.

comments powered by Disqus