summaryrefslogtreecommitdiffstats
path: root/keyboards/keebio/iris/keymaps/nstickney/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'keyboards/keebio/iris/keymaps/nstickney/README.md')
-rw-r--r--keyboards/keebio/iris/keymaps/nstickney/README.md46
1 files changed, 46 insertions, 0 deletions
diff --git a/keyboards/keebio/iris/keymaps/nstickney/README.md b/keyboards/keebio/iris/keymaps/nstickney/README.md
new file mode 100644
index 000000000..1cafce67f
--- /dev/null
+++ b/keyboards/keebio/iris/keymaps/nstickney/README.md
@@ -0,0 +1,46 @@
+# nstickney's Iris Layout
+
+ > Familiar layout for users who regularly switch between Iris and more standard layouts.
+
+[![standard-readme compliant](https://img.shields.io/badge/readme%20style-standard-brightgreen.svg)](https://github.com/RichardLitt/standard-readme)
+
+## Install
+
+For instructions on building and installing this keymap, see the [docs](https://docs.qmk.fm/#/getting_started_make_guide). Below is the command for me; it may be different for you.
+
+```sh
+$ make keebio/iris/rev2:nstickney:avrdude
+```
+
+## Usage
+
+0. QWERTY `BASE` layer.
+ * `/`, `\\`, ` `, `[ENTER]`, `-`, and `=` on the thumb clusters.
+ * `CAPSLOCK` replaced by `ESC`; hold it down for `CTRL`. `'` can also be held for `CTRL`.
+ * [Space-Cadet Shift](/docs/docs/feature_space_cadet_shift.md) is enabled, so the `SHIFT` keys send `(` and `)` when tapped.
+ * Hold down `/` or `=` for `ALT`.
+ * Hold down `\\` or `-` to access the functions layer.
+ * Upper-center thumb keys are `GUI` and `MENU`.
+ * Tapping `GUI` 2, 3, or 4 times will toggle `NUMLOCK`, `CAPSLOCK`, or `SCROLLLOCK`, respectively.
+ * Tapping `MENU` 2, 3, or 4 times will toggle the `NUMP`, `SYMB`, and `SYSH` layers, respectively.
+0. Unicode-input symbols on `SYMB` and `SYSH` layers. Based (loosely) on US-International layout.
+0. `NUMP` layer has number pads on each hand. Number pad `7`-`8`-`9` align with QWERTY `7`-`8`-`9` on right hand.
+0. Function, arrow, media, and miscellaneous keys on `FCTN` layer.
+ * `F1` through `F10` on `1`-`10`. `F11` is on `GUI` and `F12` is on `MENU`.
+ * Brackets (`[` and `]`) available on `U` and `I`; braces (`{` and `}`) on `O` and `P`.
+ * Arrow keys on `ESDF` and `HJKL`; familiar for both Vim users and FPS gamers.
+ * `W` is `HOME`; `R` is `END`. `T` is `PAGE UP` and `G` is `PAGE DOWN`.
+ * Music controls on lower row of left hand.
+ * Volume and screen brightness on lower row of right hand.
+ * `PRINT SCREEN`, `PAUSE`, `SYSREQ`, `INSERT`, and `CLEAR` also mapped, as intelligently as possible.
+ * `A` toggles the RGB underglow (which changes color to indicate active layer).
+ * `Q` toggles the Unicode input through Linux, WinCompose, and MacOS.
+
+## Contribute
+
+If you are using this layout and think you've found a better way to do something, I'd appreciate an [issue](https://github.com/nstickney/qmk_firmware/issues), or better yet a [pull request](https://github.com/nstickney/qmk_firmware/pulls).
+
+
+## License
+
+Copyright © 2016-2019 @nstickney. Released under [GPL-2.0](/LICENSE).