Awesome

Keyboard Layout Editor

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

Screenshot

Requirements

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

Installation

Clone the repository with

$ git clone https://github.com/simos/keyboardlayouteditor.git

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 http://www.antlr3.org/download/Python/antlr_python_runtime-3.1.2.tar.gz
    $ wget http://www.antlr3.org/download/antlr-3.1.2.jar
    $ 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.

Running

You finally run this program with:

$ ./KeyboardLayoutEditor