]> git.donarmstrong.com Git - qmk_firmware.git/blob - keyboards/planck/keymaps/smt/readme.md
Add smt keymap for Planck
[qmk_firmware.git] / keyboards / planck / keymaps / smt / readme.md
1 # smt's Planck keymap
2
3 This keymap is primarily based on the default Planck keymap.
4
5 Notable differences from the default are:
6
7 1. **Dvorak by default**
8
9     I happen to type in Dvorak, and prefer that layer to be the default on my keyboard. This is easy enough to switch around with Qwerty, Colemak, or whatever.
10
11 2. **Right Shift**
12
13     I use both the left and right shift keys when I type. When I want to modify a key with shift, I hold shift with the hand opposite the one typing the key. In the default keymap, Enter is where shift would be on a standard keyboard layout. Oh, muscle memory.
14
15     Thankfully, QMK supports [mod-tap](https://github.com/jackhumbert/qmk_firmware/wiki#fun-with-modifier-keys) keys, and this allows me to set the Enter key to send a modifier (MOD_LSFT) when held, and KC_ENT when tapped. Awesome!
16
17 ## Dvorak (default)
18
19 ```
20 ,-----------------------------------------------------------------------------------.
21 | Tab  |   "  |   ,  |   .  |   P  |   Y  |   F  |   G  |   C  |   R  |   L  | Bksp |
22 |------+------+------+------+------+-------------+------+------+------+------+------|
23 | Esc  |   A  |   O  |   E  |   U  |   I  |   D  |   H  |   T  |   N  |   S  |  -   |
24 |------+------+------+------+------+------|------+------+------+------+------+------|
25 | Shift|   ;  |   Q  |   J  |   K  |   X  |   B  |   M  |   W  |   V  |   Z  |Enter |
26 |------+------+------+------+------+------+------+------+------+------+------+------|
27 | Brite| Ctrl | Alt  | GUI  |Lower |    Space    |Raise | Left | Down |  Up  |Right |
28 `-----------------------------------------------------------------------------------'
29 ```
30
31 ## Qwerty (same as default)
32
33 ```
34 ,-----------------------------------------------------------------------------------.
35 | Tab  |   Q  |   W  |   E  |   R  |   T  |   Y  |   U  |   I  |   O  |   P  | Bksp |
36 |------+------+------+------+------+-------------+------+------+------+------+------|
37 | Esc  |   A  |   S  |   D  |   F  |   G  |   H  |   J  |   K  |   L  |   ;  |  "   |
38 |------+------+------+------+------+------|------+------+------+------+------+------|
39 | Shift|   Z  |   X  |   C  |   V  |   B  |   N  |   M  |   ,  |   .  |   /  |Enter |
40 |------+------+------+------+------+------+------+------+------+------+------+------|
41 | Brite| Ctrl | Alt  | GUI  |Lower |    Space    |Raise | Left | Down |  Up  |Right |
42 `-----------------------------------------------------------------------------------'
43 ```
44
45 ## Lower
46
47 This is where I put the number row, a numpad cluster, function keys, and some light navigation via Home/End/PageUp/PageDn. Like the "Raise" layer, the top row is redundant to help with Planck compatibility.
48
49 ```
50 ,-----------------------------------------------------------------------------------.
51 |   `  |   1  |   2  |   3  |   4  |   5  |   6  |   7  |   8  |   9  |   0  | Del  |
52 |------+------+------+------+------+-------------+------+------+------+------+------|
53 |      |  F1  |  F2  |  F3  |  F4  |  F5  |  F6  |   4  |   5  |   6  | Home |PageUp|
54 |------+------+------+------+------+------|------+------+------+------+------+------|
55 |      |  F7  |  F8  |  F9  |  F10 |  F11 |  F12 |   1  |   2  |   3  | End  |PageDn|
56 |------+------+------+------+------+------+------+------+------+------+------+------|
57 |      |      |      |      |      |             |      | Next | Vol- | Vol+ | Play |
58 `-----------------------------------------------------------------------------------'
59 ```
60
61 ## Raise
62
63 As a developer, it makes the most sense for me to group all the commonly-used symbols that don't fit on the main layer. In particular, having the dual-column of parens-braces-brackets really helps a lot.
64
65 I haven't completely filled this layer, which leaves room for future mappings and macros.
66
67 ```
68 ,-----------------------------------------------------------------------------------.
69 |   ~  |   !  |   @  |   #  |   $  |   %  |   ^  |   &  |   *  |   (  |   )  | Del  |
70 |------+------+------+------+------+-------------+------+------+------+------+------|
71 |      |      |      |      |      |      |   _  |   ?  |   +  |   {  |   }  |  |   |
72 |------+------+------+------+------+------|------+------+------+------+------+------|
73 |      |      |      |      |      |      |   -  |   /  |   =  |   [  |   ]  |  \   |
74 |------+------+------+------+------+------+------+------+------+------+------+------|
75 |      |      |      |      |      |             |      | Next | Vol- | Vol+ | Play |
76 `-----------------------------------------------------------------------------------'
77 ```
78