Quick Facts
- Author
- Colby Chai (CTGAP)
- Year
- 2022
- Finger Map
- Traditional
CTGAP
~`
!1
@2
#3
$4
%5
^6
&7
*8
(9
)0
_-
+=
Q
P
L
C
J
X
F
O
U
?/
{[
}]
|\
R
N
T
S
G
Y
H
E
I
A
:;
Z
B
M
W
V
K
D
"'
<,
>.
~`
!1
@2
#3
$4
%5
^6
&7
*8
(9
)0
_-
+=
X
C
L
M
K
J
Y
O
U
?/
{[
}]
|\
R
S
T
H
B
P
N
E
I
A
:;
Q
G
W
D
V
Z
F
"'
<,
>.
Quick Facts
- Author
- Colby Chai (CTGAP)
- Year
- 2022
- Finger Map
- Traditional
~`
!1
@2
#3
$4
%5
^6
&7
*8
(9
)0
_-
+=
V
P
L
C
F
K
U
O
Y
J
{[
}]
|\
R
N
T
S
D
"'
A
E
I
H
?/
Z
B
M
G
W
X
<,
>.
:;
Q
Quick Facts
- Author
- Colby Chai (CTGAP)
- Year
- 2021
- Finger Map
- Traditional
~`
!1
@2
#3
$4
%5
^6
&7
*8
(9
)0
_-
+=
W
C
L
D
K
J
Y
O
U
?/
{[
}]
|\
R
S
T
H
M
P
N
E
I
A
:;
Q
V
G
F
B
Z
X
"'
<,
>.
Quick Facts
- Author
- Colby Chai (CTGAP)
- Year
- 2021
- Finger Map
- Traditional
CTGAP is a series of layouts created by the author, who goes by the same name. It acknowledges several influences, including APT and BEAKL.
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 CTGAP:
-
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 CTGAP layout.
-
Install AutoHotkey:
-
Download the AutoHotkey script file for the desired version of CTGAP:
-
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 CTGAP.
-
Your keyboard is now remapped to CTGAP! 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 CTGAP:
-
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
- ctgap_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 CTGAP layout.
-
Press the “+” button at the bottom left.
-
Search for “CTGAP,” select your new layout, and press Add.
-
Install Karabiner-Elements:
-
Download the Karabiner rule file for the desired version of CTGAP:
-
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 CTGAP.
-
Scroll down to the “CTGAP” section and enable the rule you want.
“All keyboards” remaps CTGAP 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 CTGAP onto an external keyboard using custom firmware.
-
To use CTGAP on the password entry screen before logging in, follow the official instructions:
-
Download the XKB file for the desired version of CTGAP:
-
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.