Minimak by Ted Lilley is licensed under a Creative Commons Attribution 3.0 Unported License.
Switch branches/tags
Nothing to show
Pull request Compare This branch is 2 commits ahead, 24 commits behind binaryphile:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

Included in this readme:

Windows Boot Mappings for Minimak {: #wbm}

To use Minimak as your system layout, registry mappings are included in the boot_mappings subdirectory.

Use the PKL layouts (below) if you're just learning and use these boot mappings if you've settled on a layout for good.

Several versions are included:

  • minimak_4_key.reg: Swaps D, T, E and K (looped)
  • minimak_6_key.reg: Swaps 4-key as well as F, R
  • minimak_8_key.reg: Swaps 4-key as well as N, J and L, O
  • minimak_8_key+backslock.reg: Adds CapsLock as Backspace
  • minimak.reg: Swaps remaining keys for Minimak (no Backslock)
  • minimak+backslock.reg: Adds CapsLock as Backspace

If you want to use user mappings (on XP) instead of boot mappings, or you want to experiment with your own layouts, I recommend Key Mapper.


You must be administrator on your machine.

Double-click the registry file you want and accept the changes. Then reboot.

Once you've rebooted, your layout is changed and you don't have to do anything further to use it.

Portable Key Layout for Minimak {: #pkl}

This is a copy of the PKL project which has been customized for Minimak. It was created by us and is not supported by the PKL folks. It's in the pkl subdirectory.

It includes the same layouts as above, as well as inverse mappings for Minimak and the 8-key layout. The inverse mappings are meant to be used once you've adopted a boot mapping, but need to go back to QWERTY temporarily. For example, if you need someone else to use the keyboard to enter a password.

None of these layouts include the Backspace to CapsLock mapping.


PKL is located in the pkl subdirectory.

This is a portable executable, so it doesn't need to be installed to use it.

If you'd like to install it like a normal program, I recommend ZipInstaller.


  • Run pkl.exe
  • To change layouts: right-click the icon in the system tray and select Change Layout.
  • To move the on-screen keyboard: float the mouse over the keyboard and it will move.
  • To get rid of the on-screen keyboard: press Win-F1.
  • To toggle the layout on and off: press both Alt keys.

Mac OSX Installation {: #osx}

  • Copy Minimak.bundle from the osx directory in the repository to /Library/Keyboard Layouts You will need to enter your password
  • Open System Preferences > Keyboard > Input Sources
  • Turn on the layouts you wish to use

For information on Backslock on the Mac, see the Colemak Mac page.

Linux Installation

These are brand new mappings and untested since I don't have a machine with X to test on. The mappings are simple enough that I'm confident most will work with the possible exception of the P and semicolon mappings, since I'm not sure whether the semicolon keysym is spelled out.

The linux directory holds xmodmap mapping files. See the Window Boot Mapping section for descriptions of each of the files.

To try the keymappings for the length of your login session, run the command:

xmodmap filename

where filename is the name of the mapping you've chosen.

To install one for your login, first copy the file to ~/.Xmodmap, then add the following to ~/.xinitrc:

if [ -f $HOME/.Xmodmap ]; then
    /usr/bin/xmodmap $HOME/.Xmodmap

There are no Backslock mappings since many Linux systems have Backslock as a possible configuraion choice in their keyboard settings.