Quick Facts
- Author
- Martin Kryzwinski
- Year
- 2005
- Finger Map
- Traditional
CarpalX
~`
!1
@2
#3
$4
%5
^6
&7
*8
(9
)0
_-
+=
Q
G
M
L
W
Y
F
U
B
:;
{[
}]
|\
D
S
T
N
R
I
A
E
O
H
"'
Z
X
C
V
J
K
P
<,
>.
?/
~`
!1
@2
#3
$4
%5
^6
&7
*8
(9
)0
_-
+=
Q
W
Y
R
F
M
L
U
B
P
{[
}]
|\
D
S
A
T
N
H
O
E
I
:;
"'
Z
X
C
V
J
G
K
<,
>.
?/
Quick Facts
- Author
- Martin Kryzwinski
- Year
- 2005
- Finger Map
- Traditional
~`
!1
@2
#3
$4
%5
^6
&7
*8
(9
)0
_-
+=
Q
W
K
R
F
Y
U
I
J
P
{[
}]
|\
D
S
A
T
N
H
O
E
L
:;
"'
Z
X
C
V
B
G
M
<,
>.
?/
Quick Facts
- Author
- Martin Kryzwinski
- Year
- 2005
- Finger Map
- Traditional
CarpalX is a series of layouts the first keyboard layout analyzer program to use simulated annealing.
- QGMLWY is the fully optimized version,
- QWYRFM is the best result within 10 swaps of QWERTY, and
- QWKRFY is the best result within 5 swaps of QWERTY.
CarpalX’s model of typing effort does not explain the particularities of why it penalized some kinds of motions over others, but based on metrics, QGMLWY was heavily optimized to minimize redirects. In exchange for remarkably low redirects, it has very high SFN stats.
Install
Section titled “Install”There are two downloads available for Windows:
| Method | Admin Required | Notes |
|---|---|---|
| Native | Yes | Official Microsoft method for adding custom keyboard layouts. |
| AutoHotkey | No | Requires 3rd party remapping software. Does not take effect until AutoHotkey is launched. |
-
Install Microsoft Keyboard Layout Creator (MSKLC):
-
Download the KLC file for the desired version of CarpalX:
-
Open the downloaded
.klcfile in Microsoft Keyboard Layout Creator. -
In MSKLC, go to Project → Build DLL and Setup Package.
-
Navigate to the generated folder and run
setup.exeas Administrator. -
Follow the installer instructions to complete the installation.
-
Go to Windows Settings → Time & Language → Language & Region → Language Options → Add a keyboard and select your new CarpalX layout.
-
Install AutoHotkey:
-
Download the AutoHotkey script file for the desired version of CarpalX:
-
Save the downloaded
.ahkfile to a convenient location on your computer. -
Double-click the
.ahkfile to run the script. You should see the AutoHotkey icon appear in your system tray. -
Make sure you know how to type your computer password using CarpalX.
-
Your keyboard is now remapped to CarpalX! The script will continue running until you close it or restart your computer.
-
To run automatically on startup: Copy the
.ahkfile to your Windows Startup folder:C:\Users\[YourUsername]\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\StartupYou can quickly access this folder by pressing Win + R, typing
shell:startup, and pressing Enter.
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 version of CarpalX:
-
Extract the downloaded zip file.
-
Install the
.keylayoutfile:Run one of the install scripts from the extracted folder:
- install-user.sh to install for a single user
- install-system.sh to install for all users
- carpalx_X.keylayout the layout to install
To install for a single user: Copy the
.keylayoutfile from the extracted folder to~/Library/Keyboard Layouts. Create the folder if it doesn’t exist.To install for all users: Copy the
.keylayoutfile from the extracted folder to/Library/Keyboard Layouts. -
Restart macOS.
-
Open System Settings.
-
Go to Keyboard → Text Input → Input Sources → Edit… and add your new CarpalX layout.
-
Press the “+” button at the bottom left.
-
Search for “CarpalX,” select your new layout, and press Add.
-
Install Karabiner-Elements:
-
Download the Karabiner rule file for the desired version of CarpalX:
-
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 CarpalX.
-
Scroll down to the “CarpalX” section and enable the rule you want.
“All keyboards” remaps CarpalX 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 CarpalX onto an external keyboard using custom firmware.
-
To use CarpalX on the password entry screen before logging in, follow the official instructions:
-
Download the XKB file for the desired version of CarpalX:
-
Extract the downloaded tar.gz file.
-
Run the install script from the extracted folder:
Terminal window sudo ./install-system.shThis copies the layout files to
/usr/share/X11/xkband registers the layout with the system. -
Add the layout to your desktop environment. Refer to your desktop environment's documentation for specific instructions.