Skip to content

Latest commit

 

History

History
70 lines (48 loc) · 2.52 KB

README.md

File metadata and controls

70 lines (48 loc) · 2.52 KB
Raw

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

Changes to upstream

This is not the upstream source. It's a fork to fix some bugs that are not incorporated into upstream yet. If you are searching for the non-patched upstream see http://github.com/simos/keyboardlayouteditor.

The following bugs are fixed in this fork:

Additional changes:

  • Print symbol next to special keys names (for Backspace ⌫, Caps Lock ⇩, Return ↵, Shift ⇧, Tab ↹)

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.5.2-complete.jar
    $ java -classpath antlr-3.5.2-complete.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.5.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