aboutsummaryrefslogtreecommitdiffstats
path: root/keyboards/keebio/iris/keymaps/nstickney/README.md
blob: 1cafce67f8d7596510fb788a58fc6beda489fb77 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
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).