Merge pull request #320 from Townk/townkmap

Townkmap

8 files changed, 1624 insertions, 0 deletions

diff --git a/keyboard/ergodox_ez/keymaps/townk_osx/config.h b/keyboard/ergodox_ez/keymaps/townk_osx/config.h
new file mode 100644
index 0000000000..78aa3ee8b9
--- /dev/null
+++ b/keyboard/ergodox_ez/keymaps/townk_osx/config.h
@@ -0,0 +1,92 @@
+/*
+Copyright 2012 Jun Wako <wakojun@gmail.com>
+Copyright 2013 Oleg Kostyuk <cub.uanic@gmail.com>
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 2 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program.  If not, see <http://www.gnu.org/licenses/>.
+*/
+
+#ifndef CONFIG_H
+#define CONFIG_H
+
+#include "config_common.h"
+
+/* USB Device descriptor parameter */
+#define VENDOR_ID       0xFEED
+#define PRODUCT_ID      0x1307
+#define DEVICE_VER      0x0001
+#define MANUFACTURER    ErgoDox EZ
+#define PRODUCT         ErgoDox EZ
+#define DESCRIPTION     t.m.k. keyboard firmware for Ergodox
+
+/* key matrix size */
+#define MATRIX_ROWS 14
+#define MATRIX_COLS 6
+
+#define MOUSEKEY_DELAY          100
+#define MOUSEKEY_INTERVAL       20
+#define MOUSEKEY_MAX_SPEED      3
+#define MOUSEKEY_TIME_TO_MAX    10
+
+#define TAPPING_TOGGLE  1
+
+#define COLS (int []){ F1, F0, B0, C7, F4, F5, F6, F7, D4, D6, B4, D7 }
+#define ROWS (int []){ D0, D5, B5, B6 }
+
+/* COL2ROW or ROW2COL */
+#define DIODE_DIRECTION COL2ROW
+
+/* define if matrix has ghost */
+//#define MATRIX_HAS_GHOST
+
+/* number of backlight levels */
+#define BACKLIGHT_LEVELS 3
+
+/* Set 0 if debouncing isn't needed */
+#define DEBOUNCE    2
+#define TAPPING_TERM    200
+#define IGNORE_MOD_TAP_INTERRUPT // this makes it possible to do rolling combos (zx) with keys that convert to other keys on hold (z becomes ctrl when you hold it, and when this option isn't enabled, z rapidly followed by x actually sends Ctrl-x. That's bad.)
+
+/* Mechanical locking support. Use KC_LCAP, KC_LNUM or KC_LSCR instead in keymap */
+#define LOCKING_SUPPORT_ENABLE
+/* Locking resynchronize hack */
+#define LOCKING_RESYNC_ENABLE
+
+/* key combination for command */
+#define IS_COMMAND() ( \
+    keyboard_report->mods == (MOD_BIT(KC_LCTL) | MOD_BIT(KC_RCTL)) || \
+    keyboard_report->mods == (MOD_BIT(KC_LSFT) | MOD_BIT(KC_RSFT)) \
+)
+
+/*
+ * Feature disable options
+ *  These options are also useful to firmware size reduction.
+ */
+
+/* disable debug print */
+#define NO_DEBUG
+
+/* disable print */
+// #define NO_PRINT
+
+/* disable action features */
+//#define NO_ACTION_LAYER
+//#define NO_ACTION_TAPPING
+//#define NO_ACTION_ONESHOT
+//#define NO_ACTION_MACRO
+//#define NO_ACTION_FUNCTION
+//#define DEBUG_MATRIX_SCAN_RATE
+#define ONESHOT_TAP_TOGGLE 2
+#define ONESHOT_TIMEOUT 3000
+
+#endif
diff --git a/keyboard/ergodox_ez/keymaps/townk_osx/keymap.c b/keyboard/ergodox_ez/keymaps/townk_osx/keymap.c
new file mode 100644
index 0000000000..b63698ec6a
--- /dev/null
+++ b/keyboard/ergodox_ez/keymaps/townk_osx/keymap.c
@@ -0,0 +1,285 @@
+#include "ergodox_ez.h"
+#include "debug.h"
+#include "action_layer.h"
+#include "action_util.h"
+#include "led.h"
+#include "keymap_common.h"
+#include "timer.h"
+
+/*
+
+# Why this Layout
+
+This layout was based on Kinesis layout and other ErgoDox user layouts
+available. It's target to be used on a MacOS but I'm pretty sure it can be
+addapted to Windows and/or Linux easily.
+
+## Function Key
+
+The `fn` key work almost like it would in any other keyboard with the exception
+it has a semi-sticky behavior. What does that mean?
+
+Well, if you press the `fn` and release it, the keyboard will be put on the
+_function layout_ and the next key stroke will be processed as if the `fn` key
+was pressed. Aftwards, the leyout get back to _normal_. If you hold `fn` and
+press any other key, when you release them, the keyboard leyout is back to
+_normal_.
+
+While pressing the `fn` with the left hand and strikeing the other keys on the
+right hand is farly easy, the same cannot being said for the other keys on the
+left side. So, instead of trying to do contorcionism with my left hand, I
+decided to do a semi-sticky version of `fn`. This way, I can press the  `fn`
+key with my pinky, release it and press the `1` key to issue an `F1` to the
+operating system.
+
+## Key-Pad Key
+
+The `key pad` key is a layout switch key. If pressed, it will put the keyboard
+on the _key pad layout_ and stay there until key is pressed again.
+
+This is used to make the keyboard behave mostly like a **num pad keyboard**.
+
+## Notes
+- Regardless in which layout you are, keys from other layouts are not
+  accessible. This means that if you are on the _key pad layout_, the left hand
+  will be pretty much unusable.
+  Of course that like anything else, there are exceptions to this rule.
+  Modifiers should remain accessible throughout the layers.
+- The _shift key_ is, like the _function key_, also configured to have a sticky
+  behavior.
+- All sticky keys have a timeout of 3 seconds.
+
+*/
+#define BASE   0
+#define KEYPAD 1
+#define FN     2
+
+#define MACRO_TMUX_ESC        10
+#define MACRO_TMUX_PASTE      11
+#define MACRO_OSX_COPY        12
+#define MACRO_OSX_PASTE       13
+
+#define M_TESC   M(MACRO_TMUX_ESC)
+#define M_TPASTE M(MACRO_TMUX_PASTE)
+#define M_OSXCPY M(MACRO_OSX_COPY)
+#define M_OSXPST M(MACRO_OSX_PASTE)
+
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+/* Keymap 0: Base Layer
+ *
+ * ,-----------------------------------------------------.           ,-----------------------------------------------------.
+ * |        `~ |   1  |   2  |   3  |   4  |   5  | ESC  |           | Pwr  |   6  |   7  |   8  |   9  |   0  | - _       |
+ * |-----------+------+------+------+------+-------------|           |------+------+------+------+------+------+-----------|
+ * | Tab       |   Q  |   W  |   E  |   R  |   T  | F16  |           | F17  |   Y  |   U  |   I  |   O  |   P  | = +       |
+ * |-----------+------+------+------+------+------| Meh  |           | Meh  |------+------+------+------+------+-----------|
+ * | \ (Ctrl)  |   A  |   S  |   D  |   F  |   G  |------|           |------|   H  |   J  |   K  |   L  |   ;  | ' " (Ctrl)|
+ * |-----------+------+------+------+------+------| F18  |           | F19  |------+------+------+------+------+-----------|
+ * |  LShift   |   Z  |   X  |   C  |   V  |   B  | Hyper|           | Hyper|   N  |   M  |   ,  |   .  |   /  |   RShift  |
+ * `-----------+------+------+------+------+-------------'           `-------------+------+------+------+------+-----------'
+ *     | FN    | KPAD |LCtrl | LAlt | LGui |                                       | RGui | RAlt | RCtrl| KPAD |    FN |
+ *     `-----------------------------------'                                       `-----------------------------------'
+ *                                         ,-------------.           ,-------------.
+ *                                         | M(0) | M(1) |           | M(2) | M(3) |
+ *                                  ,------|------|------|           |------+------+------.
+ *                                  |      |      | Home |           | PgUp |      |      |
+ *                                  |Backsp| Del  |------|           |------| Enter| Space|
+ *                                  |      |      | End  |           | PgDn |      |      |
+ *                                  `--------------------'           `--------------------'
+ *
+ * M(0) = Ctrk+A Esc
+ *        (this is used to issue the Esc key to the Tmux application)
+ * M(1) = Ctrk+A P
+ *        (this is used to issue the Paste key to the Tmux application)
+ * M(2) = Cmd+C
+ * M(3) = Cmd+V
+ */
+[BASE]=KEYMAP(//left half
+              KC_GRV,         KC_1,       KC_2,     KC_3,           KC_4,       KC_5,     KC_ESC,
+              KC_TAB,         KC_Q,       KC_W,     KC_E,           KC_R,       KC_T,     MEH_T(KC_F16),
+              CTL_T(KC_BSLS), KC_A,       KC_S,     KC_D,           KC_F,       KC_G,
+              KC_FN2,         KC_Z,       KC_X,     KC_C,           KC_V,       KC_B,     ALL_T(KC_F18),
+              KC_FN1,         TG(KEYPAD), KC_LCTRL, KC_LALT,        KC_LGUI,
+                                                                                M_TESC,   M_TPASTE,
+                                                                                          KC_HOME,
+                                                                    KC_BSPC,    KC_DELT,  KC_END,
+              //right half
+              KC_POWER,       KC_6,       KC_7,     KC_8,           KC_9,       KC_0,     KC_MINS,
+              MEH_T(KC_F17),  KC_Y,       KC_U,     KC_I,           KC_O,       KC_P,     KC_EQL,
+                              KC_H,       KC_J,     KC_K,           KC_L,       KC_SCLN,  CTL_T(KC_QUOT),
+              ALL_T(KC_F19),  KC_N,       KC_M,     KC_COMM,        KC_DOT,     KC_SLSH,  KC_FN2,
+                              KC_RGUI,    KC_RALT,  CTL_T(KC_LBRC), KC_FN3,     KC_FN1,
+              M_OSXCPY,       M_OSXPST,
+              KC_PGUP,
+              KC_PGDN,        KC_ENT,     KC_SPC),
+
+/* Keymap 1: KeyPad Layer
+ *
+ * ,-----------------------------------------------------.           ,-----------------------------------------------------.
+ * |           |      | LClk | RClk | MClk |      |      |           | BTab | Clear|   /  |   *  |   ^  |   (  |           |
+ * |-----------+------+------+------+------+-------------|           |------+------+------+------+------+------+-----------|
+ * | M.Accel 2 |      |ScrlUp|  U   |ScrlDn|      |      |           | Tab  |   7  |   8  |   9  |   +  |   )  |           |
+ * |-----------+------+------+------+------+------|      |           |      |------+------+------+------+------+-----------|
+ * | M.Accel 1 |      |   L  |  D   |  R   |      |------|           |------|   4  |   5  |   6  |   -  |      |           |
+ * |-----------+------+------+------+------+------|      |           |Return|------+------+------+------+------+-----------|
+ * | M.Accel 0 |      |ScrlL |      |ScrlR |      |      |           |      |   1  |   2  |   3  |   =  |      |           |
+ * `-----------+------+------+------+------+-------------'           `-------------+------+------+------+------+-----------'
+ *     |       | XXXX |      |      |      |                                       |   0  |   .  |   ,  | XXXX |       |
+ *     `-----------------------------------'                                       `-----------------------------------'
+ *                                         ,-------------.           ,-------------.
+ *                                         |      |      |           |      |      |
+ *                                  ,------|------|------|           |------+------+------.
+ *                                  |      |      |      |           |      | XXXX |      |
+ *                                  |      |      |------|           |------| XXXX |      |
+ *                                  |      |      |      |           |      | XXXX |      |
+ *                                  `--------------------'           `--------------------'
+ */
+[KEYPAD]=KEYMAP(//left half
+                KC_NO,        KC_NO,    KC_MS_BTN1,    KC_MS_BTN2,     KC_MS_BTN3,     KC_NO,   KC_NO,
+                KC_MS_ACCEL2, KC_NO,    KC_MS_WH_UP,   KC_MS_U,        KC_MS_WH_DOWN,  KC_NO,   KC_NO,
+                KC_MS_ACCEL1, KC_NO,    KC_MS_L,       KC_MS_D,        KC_MS_R,        KC_NO,
+                KC_MS_ACCEL0, KC_NO,    KC_MS_WH_LEFT, KC_NO,          KC_MS_WH_RIGHT, KC_NO,   KC_NO,
+                KC_NO,        KC_TRNS,  KC_NO,         KC_NO,          KC_NO,
+                                                                                       KC_NO,   KC_NO,
+                                                                                                KC_NO,
+                                                                       KC_NO,          KC_NO,   KC_NO,
+                //right half
+                LSFT(KC_TAB), KC_CLEAR, KC_KP_SLASH,   KC_KP_ASTERISK, KC_CIRCUMFLEX,  KC_LPRN, KC_NO,
+                KC_TAB,       KC_KP_7,  KC_KP_8,       KC_KP_9,        KC_KP_PLUS,     KC_RPRN, KC_NO,
+                              KC_KP_4,  KC_KP_5,       KC_KP_6,        KC_KP_MINUS,    KC_NO,   KC_NO,
+                KC_KP_ENTER,  KC_KP_1,  KC_KP_2,       KC_KP_3,        KC_KP_EQUAL,    KC_NO,   KC_NO,
+                                        KC_KP_0,       KC_KP_DOT,      KC_KP_COMMA,    KC_TRNS, KC_NO,
+                KC_NO,        KC_NO,
+                KC_NO,
+                KC_NO,        KC_TRNS,  KC_NO),
+
+/* Keymap 2: Functions Layer
+ *
+ * ,-----------------------------------------------------.           ,-----------------------------------------------------.
+ * |           |  F1  |  F2  |  F3  |  F4  |  F5  |  F6  |           |  F7  |  F8  |  F9  |  F10 |  F11 |  F12 |  Vol. Up  |
+ * |-----------+------+------+------+------+-------------|           |------+------+------+------+------+------+-----------|
+ * |           | Stop |  Rw  |  Rec |  FF  |      | XXXX |           | XXXX |      |      |      |      |      | Vol. Down |
+ * |-----------+------+------+------+------+------| XXXX |           | XXXX |------+------+------+------+------+-----------|
+ * |  CapsLock | Eject| Prev | Play | Next |      |------|           |------| Left | Down |  Up  | Right|      |   Mute    |
+ * |-----------+------+------+------+------+------| XXXX |           | XXXX |------+------+------+------+------+-----------|
+ * |  L Shift  |      |      |      |      |      | XXXX |           | XXXX |      |      |      |      |      |  R Shift  |
+ * `-----------+------+------+------+------+-------------'           `-------------+------+------+------+------+-----------'
+ *     | XXXXX |      | XXXX | XXXX | XXXX |                                       | XXXX | XXXX | XXXX |      | XXXXX |
+ *     `-----------------------------------'                                       `-----------------------------------'
+ *                                         ,-------------.           ,-------------.
+ *                                         |      |      |           |      |      |
+ *                                  ,------|------|------|           |------+------+------.
+ *                                  |      |      |      |           |      |      |      |
+ *                                  |      |      |------|           |------|      |      |
+ *                                  |      |      |      |           |      |      |      |
+ *                                  `--------------------'           `--------------------'
+ *
+ * XXX = These keys are transparent keys that, when pressed, they issue the key from the previous layer.
+ */
+[FN]=KEYMAP(//left half
+            KC_NO,   KC_F1,          KC_F2,               KC_F3,               KC_F4,                 KC_F5,  KC_F6,
+            KC_NO,   KC_MEDIA_STOP,  KC_MEDIA_REWIND,     KC_MEDIA_SELECT,     KC_MEDIA_FAST_FORWARD, KC_NO,  KC_TRNS,
+            KC_CAPS, KC_MEDIA_EJECT, KC_MEDIA_PREV_TRACK, KC_MEDIA_PLAY_PAUSE, KC_MEDIA_NEXT_TRACK,   KC_NO,
+            KC_LSFT, KC_NO,          KC_NO,               KC_NO,               KC_NO,                 KC_NO,  KC_TRNS,
+            KC_TRNS, KC_NO,          KC_TRNS,             KC_TRNS,             KC_TRNS,
+                                                                                                      KC_NO,  KC_NO,
+                                                                                                              KC_NO,
+                                                                               KC_NO,                 KC_NO,  KC_NO,
+            //right half
+            KC_F7,   KC_F8,          KC_F9,               KC_F10,              KC_F11,                KC_F12, KC_VOLU,
+            KC_TRNS, KC_NO,          KC_NO,               KC_NO,               KC_NO,                 KC_NO,  KC_VOLD,
+                     KC_LEFT,        KC_DOWN,             KC_UP,               KC_RIGHT,              KC_NO,  KC_MUTE,
+            KC_TRNS, KC_NO,          KC_NO,               KC_NO,               KC_NO,                 KC_NO,  KC_RSFT,
+                                     KC_TRNS,             KC_TRNS,             KC_TRNS,               KC_NO,  KC_TRNS,
+            KC_NO,   KC_NO,
+            KC_NO,
+            KC_NO,   KC_NO,          KC_NO)};
+
+const uint16_t PROGMEM fn_actions[] = {
+  [1] = ACTION_LAYER_ONESHOT(FN),
+  [2] = ACTION_MODS_ONESHOT(MOD_LSFT),  // Sticky shift light. Tap for the next keypress to be shifted. Hold for regular shift.
+  [3] = ACTION_LAYER_TAP_KEY(KEYPAD, KC_RBRC),
+};
+
+const macro_t *action_get_macro(keyrecord_t *record, uint8_t id, uint8_t opt) {
+  // MACRODOWN only works in this function
+  switch(id) {
+    case MACRO_TMUX_ESC:
+      if (record->event.pressed) {
+        return MACRO(D(LCTRL), T(A), U(LCTRL), D(ESC), END);
+      }
+      return MACRO(U(ESC), END);
+    case MACRO_TMUX_PASTE:
+      if (record->event.pressed) {
+        return MACRO(D(LCTRL), T(A), U(LCTRL), D(P), END);
+      }
+      return MACRO(U(P), END);
+    case MACRO_OSX_COPY:
+      if (record->event.pressed) {
+        return MACRO(D(LGUI), D(C), END);
+      }
+      return MACRO(U(C), U(LGUI), END);
+    case MACRO_OSX_PASTE:
+      if (record->event.pressed) {
+        return MACRO(D(LGUI), D(V), END);
+      }
+      return MACRO(U(V), U(LGUI), END);
+  }
+  return MACRO_NONE;
+};
+
+// Runs just one time when the keyboard initializes.
+void matrix_init_user(void) {
+};
+
+uint8_t current_layer = BASE;
+
+// Runs constantly in the background, in a loop.
+void matrix_scan_user(void) {
+  uint8_t layer = biton32(layer_state);
+
+  ergodox_led_all_off();
+  ergodox_led_all_set(LED_BRIGHTNESS_LO);
+
+  switch (layer) {
+  case BASE:
+    current_layer = BASE;
+    break;
+  case KEYPAD:
+    current_layer = KEYPAD;
+    break;
+  default:
+    // none
+    break;
+  }
+
+  // layer leds
+  if (current_layer == KEYPAD) {
+    ergodox_right_led_3_on();
+  }
+
+  // capslock
+  if (host_keyboard_leds() & (3<<USB_LED_CAPS_LOCK)) {
+    ergodox_right_led_1_on();
+  }
+
+  // Temporary leds
+
+  // The function layer takes over other layers and we need to reflect that on the leds.
+  // If the current layer is the BASE, we simply turn on the FN led, but if the current
+  // layer is the KEYPAD, than we must turn it off before turning on the FN led.
+  if (layer == FN && !has_oneshot_layer_timed_out()) {
+    ergodox_right_led_3_off();
+    ergodox_right_led_2_on();
+  }
+
+  // if the shifted is pressed I show the case led in a brighter color. This is nice to
+  // differenciate the shift from the capslock.
+  // Notice that I make sure that we're not using the shift on a chord shortcut (pressing
+  // shift togather with other modifiers).
+  if((keyboard_report->mods & (MOD_BIT(KC_LSFT) | MOD_BIT(KC_RSFT)) &&                                 // is shift pressed and there is no other
+      !(keyboard_report->mods & (~MOD_BIT(KC_LSFT) & ~MOD_BIT(KC_RSFT)))) ||                           //    modifier being pressed as well
+     (get_oneshot_mods() & (MOD_BIT(KC_LSFT) | MOD_BIT(KC_RSFT)) && !has_oneshot_mods_timed_out())) {  // or the one shot shift didn't timed out
+    ergodox_right_led_1_set(LED_BRIGHTNESS_HI);
+    ergodox_right_led_1_on();
+  }
+};
diff --git a/keyboard/ergodox_ez/keymaps/townk_osx/makefile.mk b/keyboard/ergodox_ez/keymaps/townk_osx/makefile.mk
new file mode 100644
index 0000000000..e757557bda
--- /dev/null
+++ b/keyboard/ergodox_ez/keymaps/townk_osx/makefile.mk
@@ -0,0 +1,4 @@
+# I don't want my keyboard blinking lights when is suppose to be asleep.
+SLEEP_LED_ENABLE = no
+
+CONFIG_H = keymaps/$(KEYMAP)/config.h
diff --git a/keyboard/ergodox_ez/keymaps/townk_osx/readme.md b/keyboard/ergodox_ez/keymaps/townk_osx/readme.md
new file mode 100644
index 0000000000..c2853ca173
--- /dev/null
+++ b/keyboard/ergodox_ez/keymaps/townk_osx/readme.md
@@ -0,0 +1,77 @@
+# Townk's Keymap
+
+Trying to take care of an enjury on my arm I borrow an ergonomic keyboard from
+a frient ([Kinesis Advantage](http://www.kinesis-ergo.com/shop/advantage-pro-for-pc-mac/)).
+
+I really enjoyed my time with it but there were some anoyancies:
+
+* The curvature on the keys bothered me since I'm a Vim user and using the
+  motion keys on my editor was awkard.
+* I had to spend too much time remapping the keyboard to make some symbol keys
+  more accessible to me.
+* The fact that my hands had to stay close to each other was a bit stressfull
+  to my sholders.
+
+After a long research I find out that Ergodox EZ would be perfect for my needs
+and purchase one. Before the keyboard even got in my hands I started to think
+on the layout I would use on it and soon enough I planed couple adjustments
+from the Kinesis I was using so far.
+
+## The layout
+
+Here are the layout mapping in images so you can have a glimpse on it:
+
+![Base Layout](townk_osx_base.png)
+![fn Layout](townk_osx_fn.png)
+![Keypad & Mouse Layout](townk_osx_keypad.png)
+
+Notice that, differently from the default behavior, my layer keys are not transparent
+by default, which means that if you press any non-labeled white key, nothing will be
+handled to the OS.
+
+### One shot keys
+
+It all started with the access to the function keys (F1, F2, F3...), since
+those keys are located on a different layer I needed a way to press them with
+minimal effort without disrupting my flow.
+
+For me, togglihg a layer to press a button and than toggle it back is a waste
+of time (although I admit it's a single tap from what I have), so I decided to
+do it as a one shot key. I could press it and the next pressed key would be
+handled by the target layer which just after it delivers the key to the OS it
+would get back to the previous layer.
+
+After setting up my layout to do just that I realized that occasionally I
+would stop myseld on the middle of the process and the one shot layer would be
+still triggered until I press any other key. So to prevent me from tapping
+keys I don't want I added a timeout of 3 seconds for the one shot actions.
+
+Ultimately I tested the shift key as a one shot one and really like it, so
+here you have it, all the one shot keys on my layout.
+
+## Glossary
+
+If you're not familiar with the Mac symbols used on some keys, here is a
+reference to them:
+
+| Symbol | Description         |
+| :----: | ------------------- |
+|   ⌘    | Command             |
+|   ⇪    | Caps Lock           |
+|   ⇧    | Shift               |
+|   ⌥    | Option (alt)        |
+|   ⎋    | Esc                 |
+|   ⇥    | Tab forward         |
+|   ⇤    | Tab backward        |
+|   ⌃    | Control             |
+|   ␣    | Space               |
+|   ⌫    | Backspace           |
+|   ⌦    | Delete              |
+|   ⏎    | Enter               |
+|   ⌤    | Return              |
+|   ⌽    | Power on/off button |
+|   ↖    | Home                |
+|   ↘    | End                 |
+|   ⇞    | Page up             |
+|   ⇟    | Page down           |
+|   ⌧    | Clear               |
diff --git a/keyboard/ergodox_ez/keymaps/townk_osx/townk_osx.hex b/keyboard/ergodox_ez/keymaps/townk_osx/townk_osx.hex
new file mode 100644
index 0000000000..868d86e82d
--- /dev/null
+++ b/keyboard/ergodox_ez/keymaps/townk_osx/townk_osx.hex
@@ -0,0 +1,1166 @@
+:100000000C9474020C94B8020C94B8020C94B802CC

+:100010000C94B8020C94B8020C94B8020C94B80278

+:100020000C94B8020C94B8020C94ED0C0C94BF0D17

+:100030000C94141C0C94B8020C94B8020C94B802E2

+:100040000C94B8020C94B8020C94B8020C94B80248

+:100050000C94B8020C947C1C0C94B8020C94B8025A

+:100060000C94B8020C94B8020C94B8020C94B80228

+:100070000C94B8020C94B8020C94B8020C94B80218

+:100080000C94B8020C94B8020C94B8020C94B80208

+:100090000C94B8020C94B8020C94B8020C94B802F8

+:1000A0000C94B8020C94B8020C94B8022C0E4E0EAC

+:1000B0003C0F4E0E3C0F930EB60E3C0F0B0F1E0F57

+:1000C00029122912551255129D12BB1237143714DA

+:1000D000C61237147B137B132814371437143114CA

+:1000E0008813881388138813881388138813881338

+:1000F0008813881388138813881388138813881328

+:100100009913A713AE13B513BF13021902E300012D

+:10011000E3011900020602E30001E30106000213F5

+:100120000001E00104020402E001130002290001C1

+:10013000E00104020402E00129000000F4A2002210

+:1001400030A135002B003171C200C10000001E003B

+:10015000140004001D0001544D001F001A00160079

+:100160001B00E0004C002000080007000600E20031

+:100170002A002100150009001900E3004A002200AE

+:1001800017000A00050000000A3029006B77000004

+:100190006D7F00000B3066006C7700006E7F000002

+:1001A0000C3023001C000B00110000000D30240057

+:1001B00018000D001000E7004B0025000C000E0099

+:1001C0003600E6002C00260012000F0037002F71C9

+:1001D00028002700130033003800C3004E002D0014

+:1001E0002E003471C200C10000000000FF00FE00BC

+:1001F000FD00000000000000000000000000010001

+:100200000000F400F900F200FB0000000000F5001F

+:10021000F000F100000000000000F600FA00F3001A

+:10022000FC000000000000000000000000000000D2

+:1002300000000000000000000000000000002B0291

+:100240002B0000005800000000009C005F005C00D4

+:10025000590000000000540060005D005A00620078

+:100260000000550061005E005B0063000000230297

+:100270005700560067008500010026022702000093

+:10028000000001000000000000000000000000006D

+:100290000000000000003900E100010000003A0009

+:1002A000AD00B0000000000000003B00BC00AC004E

+:1002B0000000010000003C00AF00AE0000000100A3

+:1002C00000003D00BB00AB000000010000003E004C

+:1002D000000000000000000000003F0001000000DE

+:1002E00001000000000040000100000001000000CB

+:1002F000000041000000500000000000000042002B

+:100300000000510000000100000043000000520006

+:10031000000001000000440000004F000000010048

+:100320000000450000000000000000000000A900DF

+:10033000AA00A800E50001000000160345007200B5

+:1003400067006F0044006F007800200045005A00ED

+:10035000000016034500720067006F0044006F0044

+:100360007800200045005A00000004030904090237

+:100370006D00040100A0FA0904000001030101005E

+:10038000092111010001223F000705810308000A2D

+:1003900009040100010301020009211101000122E9

+:1003A0004D000705820308000A090402000103004A

+:1003B000000009211101000122360007058303080E

+:1003C000000A0904030001030000000921110100D3

+:1003D00001223900070584031000011201100100F9

+:1003E000000008EDFE0713010001020001050109EC

+:1003F00006A101050719E029E715002501950875F3

+:1004000001810205081901290595057501910295DB

+:10041000017503910105071900297715002501953C

+:100420007875018102C005010980A10185021601CC

+:100430000026B7001A01002AB70075109501810047

+:10044000C0050C0901A1018503160100269C021AB2

+:1004500001002A9C02751095018100C00501090266

+:10046000A1010901A10005091901290515002501AE

+:10047000950575018102950175038101050109301A

+:1004800009311581257F9502750881060938158186

+:10049000257F950175088106050C0A38021581250E

+:1004A0007F950175088106C0C005010906A10105F7

+:1004B0000719E029E71500250195087501810295C6

+:1004C0000175088101050819012905950575019136

+:1004D000029501750391010507190029FF150025F3

+:1004E000FF950675088100C011241FBECFEFDAE02A

+:1004F000DEBFCDBF04B603FE24C08091F30190910E

+:10050000F401A091F501B091F6018730904BA7401E

+:10051000B04BB9F41092F3011092F4011092F5016E

+:100520001092F60114BE84B7877F84BF88E10FB6AE

+:10053000F89480936000109260000FBEE0E0FFE34B

+:10054000099511E0A0E0B1E0E0E9F8E402C005900F

+:100550000D92A433B107D9F711E0A4E3B1E001C0D3

+:100560001D92A33FB107E1F70E94330A0C94462481

+:100570000C940000FC016B3079F018F46A3031F013

+:100580001DC06C3079F06D3099F018C082818111F6

+:1005900018C08CE291E008958281811115C08EE12E

+:1005A00091E008958281811112C084E191E0089563

+:1005B000828181110FC08AE091E0089580E090E08F

+:1005C00008958FE291E0089581E291E0089589E134

+:1005D00091E008958FE091E008950895CF936091A0

+:1005E000B2017091B3018091B4019091B5010E9464

+:1005F0007F1BC82F56985E9825982D9826982E9880

+:1006000027982F988FE090E090938900809388003E

+:1006100090938B0080938A0090938D0080938C0040

+:10062000CC2329F0C13029F4C093340102C01092C8

+:10063000340180913401813011F4279A2F9A0E945D

+:10064000750F867011F0259A2D9AC23041F40E94E0

+:10065000081A811104C027982F98269A2E9AE091A3

+:100660000E01F0910F018081982F927259F08D7DCB

+:1006700049F48FEF90E09093890080938800259A49

+:100680002D9A08C00E94351B827221F00E94DB194E

+:10069000882379F3CF9108950C94EE0256985E98D2

+:1006A00025982D9826982E9827982F988FEF90E0D0

+:1006B000909389008093880090938B0080938A00A8

+:1006C00090938D0080938C00259A2D9A2FEF80E7D0

+:1006D00092E0215080409040E1F700C00000269A4F

+:1006E0002E9A2FEF80E792E0215080409040E1F772

+:1006F00000C00000279A2F9A2FEF80E792E0215048

+:1007000080409040E1F700C0000025982D982FEF21

+:1007100080E792E0215080409040E1F700C0000067

+:1007200026982E982FEF80E792E02150804090404D

+:10073000E1F700C0000027982F9856985E982598FA

+:100740002D9826982E9827982F98089589EA8093B7

+:10075000800089E08093810024982C983F988AB18A

+:100760008F748AB96E98479A8BB1806B8BB9769AE1

+:100770000E944E030C94ED0280E280930001809170

+:10078000350181110EC00E940B0481E08093350178

+:100790002FEF83ED90E3215080409040E1F700C0BF

+:1007A000000080E40E9411048093000181112EC09A

+:1007B0000E943B0480930001811128C00E943B04E9

+:1007C00080930001811122C08FE30E943B0480933B

+:1007D000000181111BC00E94330480E40E941104B7

+:1007E00080930001811112C08CE00E943B04809331

+:1007F000000181110BC00E943B0480930001811114

+:1008000005C08FE30E943B04809300010E943304E3

+:100810008091000108951092B9008AE08093B80099

+:10082000089594EA9093BC009091BC0097FFFCCF90

+:100830009091B900987F983021F0903111F081E0CB

+:1008400008958093BB0084E88093BC008091BC0035

+:1008500087FFFCCF8091B900887F883111F0803408

+:1008600071F780E0089584E98093BC008091BC001A

+:1008700084FDFCCF08958093BB0084E88093BC0086

+:100880008091BC0087FFFCCF9091B900987F81E0F8

+:10089000983209F480E0089584E88093BC00809148

+:1008A000BC0087FFFCCF8091BB00089580910001C0

+:1008B000811115C080E40E94110480930001811110

+:1008C0000CC082E10E943B0480930001811105C0AD

+:1008D0008FEF0E943B04809300010E94330484B197

+:1008E000807F84B985B1807F85B98AB1837F8AB9D9

+:1008F0008BB1837F8BB93E98469808950E94BC03C4

+:10090000809300010E94560480B38C7080BB81B339

+:10091000836F81BBA7E3B1E0E5E4F1E08EE08E0FE9

+:1009200011921D928E13FCCF0C94A603BF92CF920E

+:10093000DF92EF92FF920F931F93CF93DF938091FB

+:100940000001882379F0809136018F5F8093360112

+:10095000811108C00E94BC0380930001811102C074

+:100960000E944E0307E311E0C0E0D0E0DD24D39401

+:1009700082E0C82EEE24E394F12CC730D10500F5B7

+:1009800080910001811164C080E40E941104809371

+:100990000001811112C082E10E943B04809300019A

+:1009A00081110BC0C7010C2E01C0880F0A94EAF711

+:1009B00080950E943B04809300010E94330448C04C

+:1009C000CA30A1F028F4C83059F0C93061F005C030

+:1009D000CC3089F070F0CD3089F0209A289810C082

+:1009E000219A29980DC0229A2A980AC0239A2B98F6

+:1009F00007C0529A01C0539A5B9802C03E9A46982B

+:100A000090EA9A95F1F79FB1799902C082E001C00E

+:100A100080E091709D25982B7C9902C084E001C0F4

+:100A200080E0892B7D9902C038E001C030E0832B43

+:100A30007E9902C020E101C020E0822B9FB19095F9

+:100A4000991F9927991F9295990F907E892B0FC016

+:100A500080910001811149C080E40E9411048093BB

+:100A60000001882379F1B12C0E9433048B2DF80109

+:100A70009081981719F08083C09201010E9456045A

+:100A800021960F5F1F4FCE30D10509F076CF8091B0

+:100A90000101882361F1815080930101882339F09D

+:100AA0008FE99FE00197F1F700C0000020C0A5E4A6

+:100AB000B1E0E7E3F1E0CF01825F91919D938E1366

+:100AC000FCCF15C083E10E943B048093000181119B

+:100AD000CACF81E40E941104809300018111C3CF29

+:100AE0000E944C04B82EB094BFCF80E0C0CF0E94CB

+:100AF0004C0381E0DF91CF911F910F91FF90EF9018

+:100B0000DF90CF90BF900895E82FF0E0EB5BFE4FB1

+:100B1000808108950895089596E0799FF001112449

+:100B200094E5899FE00DF11D1124E60FF11DEE0FF4

+:100B3000FF1FEE5BFE4F859194910895880F991FDA

+:100B4000FC01E654F040859194910895880F991F17

+:100B5000FC01E65CFE4F8591949108950F931F93DD

+:100B6000CF93DF93EC018115904350F5C11580E2DE

+:100B7000D80708F0B3C0CB3BD10590F4C83AD105F3

+:100B800008F05AC0C53AD10508F04BC0C430D105B1

+:100B900008F0CCC1219709F0C6C101E010E006C2FF

+:100BA000CF3FD10511F008F0C1C1C03FD10508F019

+:100BB00092C0CE01805E9109089708F4B7C1B3C115

+:100BC000C11591E5D907A8F4C23020E5D20708F095

+:100BD0009EC0C11580E5D80709F485C008F091C012

+:100BE000C11520E4D20708F09EC1DD278E01106CEC

+:100BF000DDC1C11580E8D80758F4C11590E7D907C1

+:100C000008F08DC1C11520E6D20708F422C18BC1BE

+:100C1000C11580E9D80708F086C1DF708E01106A1F

+:100C2000C5C1C53AD10509F483C1C63AD10509F059

+:100C300082C102E810E4BAC1C83AD10509F47EC104

+:100C4000C93AD10509F47DC1CA3AD10509F47CC17C

+:100C5000CB3AD10509F47BC1CC3AD10509F47AC16C

+:100C6000CD3AD10509F479C1C03BD10509F478C169

+:100C7000CE3AD10509F477C1CF3AD10509F476C14E

+:100C8000C13BD10509F475C1C23BD10509F474C15A

+:100C9000C33BD10509F473C1C43BD10509F472C14A

+:100CA000C53BD10509F471C1C63BD10509F470C13A

+:100CB000C73BD10509F46FC1C83BD10509F46EC12A

+:100CC000C93BD10509F46DC1CA3BD10509F46CC11A

+:100CD00000E014E46BC18E01106568C1CE019F7005

+:100CE0000E94A60564C10E948B149FEF24E38CE050

+:100CF000915020408040E1F700C000000E94A11CFC

+:100D000055C18091D40181608093D4014FC10E946C

+:100D10004A1E811102C00E94301E0E94671E90E090

+:100D20009093F3018093F201C23090E5D90721F44A

+:100D30008091F201816086C0C43020E5D20721F4A1

+:100D40008091F20182607EC0C63080E5D80721F430

+:100D50008091F201846076C0C83090E5D90719F41B

+:100D60008091F20127C0CA3020E5D20721F480919A

+:100D7000F201806167C0CC3080E5D80721F4809112

+:100D8000F20180625FC0CE3090E5D90721F48091F6

+:100D9000F201806457C0C03120E5D20721F4809170

+:100DA000F20180684FC0C23180E5D80729F48091F4

+:100DB000F2018460886046C0C33090E5D90721F411

+:100DC0008091F2018E7F3EC0C53020E5D20721F42C

+:100DD0008091F2018D7F36C0C73080E5D80721F4BD

+:100DE0008091F2018B7F2EC0C93090E5D90719F4AC

+:100DF0008091F20126C0CB3020E5D20721F480910A

+:100E0000F2018F7E1FC0CD3080E5D80721F480919C

+:100E1000F2018F7D17C0CF3090E5D90721F4809182

+:100E2000F2018F7B0FC0C13120E5D20721F4809100

+:100E3000F2018F7707C0C331D04531F48091F201C0

+:100E40008B7F877F8093F2018091F2010E946B1E5D

+:100E5000ADC08D2F99278F70992781309105D9F4D6

+:100E60009E012370332702C0880F991F2A95E2F74D

+:100E70009C688E0144E0000F111F4A95E1F700279E

+:100E80001370802B912B53E0CC0FDD1F5A95E1F7A7

+:100E9000C076DD272FC08230910531F4DC2FCC27BE

+:100EA0008E01016F106A82C08330910569F4CE0112

+:100EB0008370992701E010E002C0000F111F8A958E

+:100EC000E2F7C8019C680FC084309105B9F4CE01E7

+:100ED0008370992701E010E002C0000F111F8A956E

+:100EE000E2F7C8019A6823E0CC0FDD1F2A95E1F7ED

+:100EF000C07ED7708C010C2B1D2B58C085309105FE

+:100F000031F4DC2FCC278E01046F106A4FC0069796

+:100F100009F04CC0CF71DD27DC2FCC2701C0DF707A

+:100F20008E01106243C000E010E040C08E013EC060

+:100F300001E810E43BC003E810E438C002EE14E41A

+:100F400035C009EE14E432C00AEE14E42FC005EBFC

+:100F500014E42CC006EB14E429C007EB14E426C00B

+:100F60000CEC14E423C00DEC14E420C003E815E4F9

+:100F70001DC00AE815E41AC002E915E417C004E927

+:100F800015E414C001E216E411C003E216E40EC039

+:100F900004E216E40BC005E216E408C006E216E41B

+:100FA00005C007E216E402C00AE216E4C801DF91B8

+:100FB000CF911F910F91089596E0799FF001112430

+:100FC00094E5899FE00DF11D1124E60FF11DEE0F50

+:100FD000FF1FEE5BFE4F85919491803E9105E0F4FA

+:100FE000803C910558F58133910509F46FC048F4B0

+:100FF0008932910509F463C08A32910509F46DC004

+:1010000072C089339105E9F082389105D1F08533BA

+:10101000910509F44DC067C0833E910581F138F414

+:10102000803E9105B9F0823E9105D9F05CC0863EC4

+:10103000910561F1873E9105A1F155C00E949E0581

+:1010400008952091F20120FD02C021FF4CC080EEE6

+:1010500090E049C08091F20180FFF9CF89E390E0F0

+:1010600042C08091F20182FF0EC08091F20184FFA4

+:1010700003C080E090E037C083EE90E034C0809100

+:10108000F20182FFF2CF82EE90E02DC08091F2015A

+:1010900083FF0BC08091F20184FDEBCF87EE90E0DF

+:1010A00022C08091F20183FFF5CF86EE90E01BC055

+:1010B0008091F20185FF07C089E290E014C0809121

+:1010C000F20185FFF9CF85E390E00DC08091F20138

+:1010D00086FF07C08AE290E006C08091F20186FF99

+:1010E000F9CF81E390E00E94AE05089508950C9435

+:1010F0007608809163010895CF93DF9300D01F920B

+:10110000CDB7DEB79C018091E901843019F593E0F9

+:1011100099833B832A839093E9008FEF9091E800B5

+:10112000815095FD06C095ED9A95F1F7000081116B

+:10113000F5CF8091E80085FF0DC040E050E063E00E

+:1011400070E0CE0101960E94DD0A8091E8008E7762

+:101150008093E8000F900F900F90DF91CF9108954A

+:10116000CF93DF9300D01F92CDB7DEB72091E90176

+:10117000243021F522E029839B838A8383E08093B6

+:10118000E9008FEF9091E800815095FD06C095ED44

+:101190009A95F1F700008111F5CF8091E80085FF65

+:1011A0000DC040E050E063E070E0CE0101960E9487

+:1011B000DD0A8091E8008E778093E8000F900F9011

+:1011C0000F90DF91CF9108952091E9012430F1F43F

+:1011D00022E02093E9002FEF3091E800215035FD07

+:1011E00006C035ED3A95F1F700002111F5CF2091B9

+:1011F000E80025FF0BC040E050E065E070E00E9491

+:10120000DD0A8091E8008E778093E8000895CF93FF

+:10121000DF93EC019091E901943009F046C0809190

+:101220000C018823D9F080910D018823B9F09093A7

+:10123000E9008FEF9091E800815095FD06C095E19F

+:101240009A95F1F700008111F5CF8091E80085FFB4

+:101250002CC040E050E060E170E017C081E0809376

+:10126000E9008FEF9091E800815095FD06C095ED63

+:101270009A95F1F700008111F5CF8091E80085FF84

+:1012800014C040E050E068E070E0CE010E94DD0A4A

+:101290008091E8008E778093E80080E1FE01A3E56D

+:1012A000B1E001900D928A95E1F7DF91CF91089519

+:1012B0008091E801811109C00E94720C0E94CF0C3C

+:1012C0008091E20084608093E20008951092E8012A

+:1012D0000895089508950C940E1C42E061EC81E09D

+:1012E0000E94EC0B42E061EC82E00E94EC0B42E0D9

+:1012F00061EC83E00E94EC0B42E161EC84E00C9431

+:10130000EC0B8091EB01833009F455C030F481304F

+:1013100071F0823009F48EC008958A3009F47AC0E1

+:101320008B3009F460C0893009F09CC020C08091E6

+:10133000EA01813A09F096C08091E800877F8093A6

+:10134000E8008091EE019091EF01892B21F460E19A

+:1013500083E591E003C060E080E090E070E00E94EF

+:10136000280B8091E8008B778093E80008958091A6

+:10137000EA01813209F076C08091EE019091EF018F

+:10138000009719F0039709F06DC08091E800877FFE

+:101390008093E8008091E80082FD05C08091E9011A

+:1013A0008111F8CF5FC08091F1008093630180913B

+:1013B000E8008B7753C08091EA01813A09F052C06E

+:1013C0008091EE019091EF0189