Canary

Angle Mod

~`

!1

@2

#3

$4

%5

^6

&7

*8

(9

)0

_-

+=

W

L

Y

P

K

Z

X

O

U

:;

{[

}]

|\

C

R

S

T

B

F

N

E

I

A

"'

J

V

D

G

Q

M

H

?/

<,

>.

Finger	1	2	3	4	7	8	9	10
Usage	3.74% (P7)	7.94% (P33)	8.06% (P7)	16.18% (P92)	13.26% (P69)	15.96% (P87)	9.16% (P51)	8.48% (P91)

	Same Finger	Full Scissor	Half Scissor	Lat. Stretch
Bigram	0.67% (P37)	0.04% (P13)	0.72% (P3)	0.55% (P40)
Skipgram	5.62% (P82)	0.15% (P22)	1.87% (P18)	0.76% (P16)

	No Thumbs	Left Space	Right Space
Weak-ish Redirs.	0.67% (P54)	0.58% (P36)	0.70% (P42)
Weak Redirects	0.09% (P9)	0.04% (P11)	0.04% (P11)
Other Same Finger	19.83% (P54)	13.39% (P65)	13.39% (P65)
Rolls : Alts	2.03 (P77)	2.82 (P89)	1.52 (P50)
2-Roll In : Out	0.85 (P21)	0.82 (P20)	1.05 (P34)
3-Roll In : Out	0.90 (P36)	1.49 (P50)	0.77 (P36)

Author

Apsu

Year

2022

Finger Map

Angle Mod

GitHub Repository

Ortho

~`

!1

@2

#3

$4

%5

^6

&7

*8

(9

)0

_-

+=

W

L

Y

P

B

Z

F

O

U

:;

{[

}]

|\

C

R

S

T

G

M

N

E

I

A

"'

Q

J

V

D

K

X

H

?/

<,

>.

Finger	1	2	3	4	7	8	9	10
Usage	3.80% (P8)	7.94% (P33)	8.06% (P7)	16.11% (P88)	13.26% (P69)	15.96% (P87)	9.16% (P51)	8.48% (P91)

	Same Finger	Full Scissor	Half Scissor	Lat. Stretch
Bigram	0.67% (P37)	0.04% (P18)	0.77% (P6)	1.17% (P80)
Skipgram	5.61% (P81)	0.15% (P25)	2.30% (P42)	0.77% (P16)

	No Thumbs	Left Space	Right Space
Weak-ish Redirs.	0.67% (P54)	0.58% (P37)	0.70% (P42)
Weak Redirects	0.09% (P9)	0.04% (P11)	0.04% (P11)
Other Same Finger	19.83% (P54)	13.38% (P64)	13.38% (P64)
Rolls : Alts	2.03 (P76)	2.82 (P88)	1.52 (P49)
2-Roll In : Out	0.85 (P21)	0.82 (P19)	1.05 (P34)
3-Roll In : Out	0.90 (P37)	1.49 (P50)	0.77 (P36)

Author

Apsu

Year

2022

Finger Map

Traditional

GitHub Repository

Install

Kanata

Kanata is a keyboard remapper that works on Windows, macOS, and Linux.

1. Install Kanata by following “Step 1: Set Up Kanata” in Nova’s Kanata setup guide:

   Step 1: Set Up Kanata (Kanata Guide for Alt Layouts)

2. Download the Kanata config file for the desired version of Canary:

   Canary (Angle Mod)

   Canary (Ortho)

3. Make sure you know how to type your computer password using Canary.

   Caution

   Skipping this step will lock you out of your computer. If you forget how to type your password using Canary, look up Canary on another device, such as a phone, when unlocking the computer.

4. Run Kanata with the downloaded config file and make sure the layout works as you expect:

   kanata --cfg path/to/config.kbd

5. To have Canary activate whenever your computer starts up, follow the instructions to “Automatically start Kanata”:

   Automatically start Kanata (Kanata Guide for Alt Layouts)

macOS

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.

Native

1. Download the .keylayout file for the desired version of Canary:

   Canary (Angle Mod)

   Canary (Ortho)

2. Install the .keylayout file:

   Single User

   Copy the downloaded .keylayout file to ~/Library/Keyboard Layouts. Create the folder if it does not exist.

   All Users

   Copy the downloaded .keylayout file to /Library/Keyboard Layouts.

   Note

   By default, macOS hides the “Library” folder. To navigate to it in Finder, open the Go to Folder dialog (Go → Go to Folder… in the menubar, or Command-Shift-G) and type in the path shown above.

3. Restart macOS.

4. Open System Settings.

5. Go to Keyboard → Text Input → Input Sources → Edit… and add your new Canary layout.

6. Press the “+” button at the bottom left.

7. Search for “Canary,” select your new layout, and press Add.

Note

If you forget how to type your password on Canary and get stuck on the Lock Screen, you can switch to your old layout using the Input menu at the top of the screen.

Karabiner-Elements

1. Install Karabiner-Elements:

   Karabiner-Elements

2. Download the Karabiner rule file for the desired version of Canary:

   Canary (Angle Mod)

   Canary (Ortho)

3. In Karabiner-Elements Settings, go to “Complex Modifications,” then press “Add predefined rule” at the top.

4. Make sure you know how to type your computer password using Canary.

   Caution

   Skipping this step will lock you out of your computer. If you forget how to type your password using Canary, look up Canary on another device, such as a phone, when unlocking the computer.

5. Scroll down to the “Canary” section and enable the rule you want.

   “All keyboards” remaps Canary 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 Canary onto an external keyboard using custom firmware.

6. To use Canary on the password entry screen before logging in, follow the official instructions:

   How to enable before login