summaryrefslogtreecommitdiff
path: root/layouts/community/ergodox/meagerfindings/README.md
diff options
context:
space:
mode:
authorMat Greten <mgreten@gmail.com>2018-09-19 17:15:13 -0600
committerDrashna Jaelre <drashna@live.com>2018-09-19 16:15:13 -0700
commit14f691d2a749c6f4fd9bf39d219da1369747cd8d (patch)
treef12c25ee6fbbe96a267ee25f36c79a3f109d1374 /layouts/community/ergodox/meagerfindings/README.md
parentc23233f41ab9221577fc83bbae0a230452a38231 (diff)
downloadqmk_firmware-14f691d2a749c6f4fd9bf39d219da1369747cd8d.tar.gz
qmk_firmware-14f691d2a749c6f4fd9bf39d219da1369747cd8d.zip
Keymap: meagerfindings ergodox (#3920)
* initial commit * updating after review
Diffstat (limited to 'layouts/community/ergodox/meagerfindings/README.md')
-rw-r--r--layouts/community/ergodox/meagerfindings/README.md109
1 files changed, 109 insertions, 0 deletions
diff --git a/layouts/community/ergodox/meagerfindings/README.md b/layouts/community/ergodox/meagerfindings/README.md
new file mode 100644
index 0000000000..e7e4270db9
--- /dev/null
+++ b/layouts/community/ergodox/meagerfindings/README.md
@@ -0,0 +1,109 @@
+![Base](https://meagerfindings.com/assets/img/ergodox/base.png)
+
+# Meagerfinding's ErgoDox Layout
+
+<!-- TOC depthFrom:2 depthTo:6 withLinks:1 updateOnSave:1 orderedList:0 -->
+
+- [Overview](#overview)
+- [Credit where credit is due](#credit-where-credit-is-due)
+- [Features](#features)
+ - [Tap/Hold Macro Keys](#taphold-macro-keys)
+ - [TapDance Keys](#tapdance-keys)
+- [Base Layer](#base-layer)
+ - [Things to note:](#things-to-note)
+- [Old Base Layer](#old-base-layer)
+- [Symbols Layer](#symbols-layer)
+- [Mouse & Media Keys Layer](#mouse-media-keys-layer)
+- [Markdown Layer](#markdown-layer)
+- [Arrow/Movements Layer](#arrowmovements-layer)
+- [Numpad Layer](#numpad-layer)
+
+<!-- /TOC -->
+
+## Overview
+
+The overall goals of this layout are to:
+1. Use the Ergodox thumb clusters to eliminate pinky reach.
+2. Place as many useful keys under the home rows as possible.
+
+I first decided to build an ErgoDox as I wanted to use my thumbs for more with the added ergonomic benefits of a split board and ortholinear layout. I knew my hands were hurting from the weird contortions of copying and pasting constantly on my Mac, but I had no idea how strained I really was until I started moving as many modifier keys to the thumb clusters.
+
+## Credit where credit is due
+
+The initial layout used created on the [ErgoDox EZ Configurator](https://ergodox-ez.com/pages/graphical-configurator). I went through 26+ iterations within the configurator prior to beginning my journey with QMK itself. Much of the dual function/layer keys are influenced by and adapted from the EZ Configurator.
+
+Many features in this layout are either directly inspired by or are adaptations of [Algernon's incredible ErgoDox layout](https://github.com/algernon/ergodox-layout). Specifically: TapDance and its usage, and the brilliant idea of using TapDance to pair down the four keys for parens, brackets, and curly braces into just 2 keys.
+
+## Features
+
+### Tap/Hold Macro Keys
+* `Paste/Paste Special` key sends Paste on tap and Paste Special when held.
+* `Screen/Video` key sends `||scrn` when tapped and `||video` when held
+ - [Typinator](http://www.ergonis.com/products/typinator/) expands `||scrn` into `(Screenshot: <CLIPBOARD CONTENTS>)`, and `||video` into `(Video: <CLIPBOARD CONTENTS>)`, the QMK macro then moves back to before the last paren, inserts a space and removes a space to create a hyperlink for use in Zendesk.
+* When tapped, `Todoist` toggles quick add window for a new Todoist task (`CMD + Shift + A`) and switches to Todoist when held
+* The RubyMine key opens RubyMine by triggering spotlight, typing out `Rubymine`, and submitting the enter key.
+* `Zendesk` triggers spotlight and then calls Typinator expansion to open my Zendesk Agent dashboard in Chrome.
+
+
+### TapDance Keys
+* `Copy/Cut` key copies on tap, cut's on two taps.
+* One tap on `Snagit` key = sends `Ctrl + Shift + C` which is Snagit's selector and two taps on `Snagit` key = `Cmd + Shift + Opt + 4`, OS X cropping screenshot that is copied to the clipboard only.
+* Tapping the `[{(`/`)}]` keys once yields `[` or `{` when the shift key is engaged, tapping them twice yields `(`.
+
+## Base Layer
+
+![Base](https://meagerfindings.com/assets/img/ergodox/base.png)
+
+The base layer retains the alphas from the QWERTY layout without any modifications.
+
+### Things to note:
+
+- The shift key is a One Shot Modifier key, meaning shift is not submitted when the key is tapped, instead, it only submits when you either tap it again, or on the next key press.
+ - There is no CAPSLOCK key designated as it is pretty comfortable to simply hold down shift in this layout and continue typing.
+- There is only one layer that you can fully switch to on this layout, the [Old Base layer](#old-base-layer). All other layers require holding a key to reach them. For the most part, the key that toggles a layer, will be on the opposite hand that will be typing with that layer.
+ - For example: the symbols layer is reached by holding down the enter key with your right thumb, and most of the symbols are located on the left hand board.
+
+
+## Old Base Layer
+
+![Old Base](https://meagerfindings.com/assets/img/ergodox/old_base.png)
+
+I am moving into a new position (software engineering) at work from a Support position. My hope is to use my F keys more often and write fewer emails. This is my old base layer, still easily accessible, as I'm not used to having F key's on my top row quite yet.
+
+## Symbols Layer
+
+![Symbols](https://meagerfindings.com/assets/img/ergodox/symbols.png)
+
+Holding down the `enter` key with your right thumb toggles the symbol layer.
+
+I've placed my most used symbols under the homerow. Granted, right now I mainly right emails/support ticket responses, so this home row may need to change as I transition to software engineering.
+
+## Mouse & Media Keys Layer
+
+![Mouse & Media](https://meagerfindings.com/assets/img/ergodox/mouse_media.png)
+
+Holding down the `:` key on with your right pinky toggles the mouse and media layer. Your left hand controls the mouse directions just in a similar fashion to the keys used in the [movement layer](#arrowmovements-layer).
+
+The right hand has a media controls under the homerow for quick muting/pausing.
+
+* `XKCD #1319` Key that ironically partially-automates accessing the link to [XKCD #1319](https://xkcd.com/1319/).
+
+## Markdown Layer
+
+![Markdown](https://meagerfindings.com/assets/img/ergodox/markdown.png)
+
+This layer places most common markdown symbols under the right hand. You can reach this layer by holding down the `F` key on your left hand.
+
+## Arrow/Movements Layer
+
+![Movement](https://meagerfindings.com/assets/img/ergodox/movement_arrows.png)
+
+Toggled by holding down the space key with the right thumb. This isn't vim like movement, nope, it's `WASD` but over one column. So I guess it's actually `ESDF` on the left hand and `IJKL` on the right hand to better line up with the columns offset/staggered columns on the Dox.
+
+## Numpad Layer
+
+![Numpad](https://meagerfindings.com/assets/img/ergodox/numpad.png)
+
+My right hand is pretty comfortable with tenkey number input so this is easily accessible by holding down backspace with the left thumb.
+
+Also, on the left hand, there is a tap to copy and hold to cut macro under the `D` key, and a tap to paste and a hold to paste special macro on the `F` key. I guess I'm to too lazy to move my fingers when copying/pasting...