Tarmak
Layer activators · Keysets · Notes
Layer activators
shift_rightshift_leftKeysets
Notes
Layer activators · Keysets · Notes
Layer activators
shift_rightshift_leftKeysets
Notes
Layer activators · Keysets · Notes
Layer activators
shift_rightshift_leftKeysets
Notes
Layer activators · Keysets · Notes
Layer activators
shift_rightshift_leftKeysets
Notes
Tarmak is a sequence of intermediate layouts developed by DreymaR for learning Colemak through smaller changes from QWERTY. The four stages shown here progressively put keys into their Colemak positions, using J to fill temporary gaps. A fifth step moves L, U, and I to complete Colemak.1
History
Section titled “History”DreymaR dates his initial three-step “Tarmac” approach to 2008. The 2011 progression introduced the Tarmak 1 and 2 layouts retained here.2 In April 2014, Karl Nordstrom proposed revised later stages to avoid temporarily moving the semicolon into the middle of the keyboard. DreymaR adopted this sequence, called ETROI for the letters brought to the home row at each step. Its Tarmak 3 and 4 layouts therefore date to 2014.32
Footnotes
Section titled “Footnotes”-
DreymaR, Tarmak Steps, vanilla stages 1–5. ↩
-
DreymaR, “Learn Colemak in steps with the Tarmak layouts!”, post 3, “The History of Tarmak.” This retrospective account distinguishes the 2008, 2011, and 2014 progressions. ↩ ↩2
-
Karl Nordstrom, “Incremental Colemak for programmers”, April 5, 2014, post 1; DreymaR’s adoption of the revised progression, April 10, 2014, post 33. ↩
Install
Section titled “Install”Kanata is a keyboard remapper that works on Windows, macOS, and Linux.
Install Kanata by following “Step 1: Set Up Kanata” in Nova’s Kanata setup guide:
Download the Kanata config file for the desired layout:
Make sure you know how to type your computer password using Tarmak.
Run Kanata with the downloaded config file and make sure the layout works as you expect:
kanata --cfg path/to/config.kbdTo have Tarmak activate whenever your computer starts up, follow the instructions to “Automatically start Kanata”:
There are two downloads available for macOS:
| Method | Admin Required | Notes |
|---|---|---|
| Native | Optional | Does not require 3rd party key remapping software. Admin is required to install for all users and use on first login. |
| Karabiner-Elements | Yes | Requires 3rd party key remapping software, including the installation of a Driver Extension. Allows for remapping of only specific keyboards. |
Download the .keylayout file for the desired layout:
Install the
.keylayoutfile:Copy the downloaded
.keylayoutfile to~/Library/Keyboard Layouts. Create the folder if it does not exist.Copy the downloaded
.keylayoutfile to/Library/Keyboard Layouts.Restart macOS.
Open System Settings.
Go to Keyboard → Text Input → Input Sources → Edit… and add your new Tarmak layout.
Press the “+” button at the bottom left.
Search for “Tarmak,” select your new layout, and press Add.
Install Karabiner-Elements:
Download the Karabiner rule file for the desired layout:
In Karabiner-Elements Settings, go to “Complex Modifications,” then press “Add predefined rule”at the top.
Make sure you know how to type your computer password using Tarmak.
Find the imported section named for the layout you downloaded, followed by “via Layouts.Wiki”, and enable the rule you want.
“All keyboards” remaps Tarmak onto all keyboards while connected to this computer. Select this reason unless you want to exclude some keyboards from remapping.
“Built-in keyboard only” remaps your device's built-in keyboard, as well as any other keyboard for which “Treat as built-in keyboard” (under the “Devices” section) is enabled. Select this option if you plan to map Tarmak onto an external keyboard using custom firmware.
To use Tarmak on the password entry screen before logging in, follow the official instructions: