]> git.donarmstrong.com Git - qmk_firmware.git/blob - keyboards/ergodox/keymaps/osx_whiskey_tango_foxtrot_capslock/readme.md
618db6ff438a471d4b514f6ed1dc6303d300efd1
[qmk_firmware.git] / keyboards / ergodox / keymaps / osx_whiskey_tango_foxtrot_capslock / readme.md
1 # The extra special ergodox build for MacOS Sierra caps lock users
2
3 ###Do you
4 - Hate the OSX / MacOS caps lock delay?
5 - Have an ergodox?
6
7 ###Then this might just be for you!
8
9 [This](http://apple.stackexchange.com/questions/81234/how-to-remove-caps-lock-delay-on-apple-macbook-pro-aluminum-keyboard)
10 and [this](http://sleepycow.org/2014/07/removing-the-caps-lock-delay-on-a-macbook/)
11 are good workarounds for the caps lock delay, however none of these
12 work on Sierra.  This abomination of a keymap simulates capslock to the best
13 of its abilities.
14 This means that it keeps track of caps lock state internally rather than
15 sending a caps lock keypress to the OS.  It is smart enough to check for
16 modifiers, such as Control being held down, and stop it with the hanky panky
17 and just send on the key event unmolested even if FakeCaps is enabled.  And
18 since the macro isn't even registered on the non-alphas, it will not affect
19 them regardless.  Only in the event that FakeCaps is enabled and an alpha key
20 is pressed will it sneak in a shift keydown before the alpha keydown and
21 immediately afterward sneaks in a shift keyup.  Generally this works well,
22 however there is one known issue:
23
24 - Holding down a key will only have the first character in caps.  For instance,
25   with caps lock on, if you hold down the 'a' key, you get:
26
27   ```
28   Aaaaaaaaaaaaaaaaaa
29   ```
30
31 I have only tested this on an original Ergodox with a Teensy 2.0.
32
33 ####Some other small tweaks
34  - Layer 0 board light is off
35  - Layer 1 board light is on solid
36  - Layer 2 board light blinks at speed controlled by BLINK_BASE
37
38 ![osx whiskey tango foxtrot](osx_whiskey_tango_foxtrot_capslock.png)