Skip to content
Go to file


Failed to load latest commit information.
Latest commit message
Commit time

Keyboard Layout Editor

PyGTK program that helps create or edit XKB keyboard layouts. Created by @simos in Google Summer of Code 2008. More information



To run the application, you need the python UI binding packages. For Ubuntu 14.04, the packages below are already pre-installed.

  • Cairo
  • Pango
  • GObject
  • lxml


Clone the repository with

$ git clone

You need to process the ANTLR grammars in order to generate the necessary Python code. This is a process that you do one time only (unless you make changes in the grammar files).

All *.g files should be processed with ANTLR:

    $ cd keyboardlayouteditor/
    $ sudo apt-get install python-pip
    $ sudo pip install
    $ wget
    $ java -classpath antlr-3.1.2.jar org.antlr.Tool *.g

The first command installs the Python 2 package manager. The second command installs the Python 2 Antlr 3.1.2 runtime. The third command downloads the antlr 3.1.2 JAR file (code of Antlr) in the current directory. The antlr3 package in Ubuntu is for Antlr 3.2, but we cannot use it because it is a bit complicated to get a 3.2 python runtime. The fourth command runs the Antlr code on the .g grammar files that exist in the KeyboardLayoutEditor directory. These are four files, and produces the processed grammar. Then, you can start the KeyboardLayoutEditor program.


You finally run this program with:

$ ./KeyboardLayoutEditor
You can’t perform that action at this time.