summaryrefslogtreecommitdiff
path: root/keyboards/planck/keymaps/callum/readme.md
blob: 190c2b23a552fb0ff61d7d4650c4380571643802 (plain)
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
# callum's planck layout

This is a layout for the grid planck, built with a few ideals in mind:

- Consistent and minimal response times should be maintained. Keys that react
  differently depending on whether they are tapped or held, keys that react
  differently if they are double tapped, etc. should be avoided – they
  inevitably send their keycode later than a normal key – interrupting the
  immediate feedback from the screen. Therefore we restrict ourselves to
  chording as our only means of getting more than one symbol out of a single
  physical key.

- The hands should never need to leave the home position. The usual culprit for
  this is the arrow cluster, so the arrow cluster should be as close to home as
  possible.

- There should be two of every modifier (one on each side), otherwise certain
  long key combinations become hard to make.

- It should be possible to do things you might want to do while using the mouse
  with only the left hand (e.g. change tabs, navigate back or forwards in
  browser history).

- Symbols should be arranged so that the most frequently used are easiest to
  reach. This includes numbers, and lower numbers are more commonly used than
  higher ones. (number arrangement borrowed from [dustypomeleau's minidox
  layout][].

Layout rendered with [keyboard-layout-editor.com][]:

![](https://callum-oakley.github.io/images/keymap.png)

The only behaviour not captured in this graphic is: pressing both cmd keys will
send cmd+ctrl. See [keymap.c][] for details.

[dustypomeleau's minidox layout]: https://github.com/qmk/qmk_firmware/tree/master/keyboards/minidox/keymaps/dustypomerleau
[keyboard-layout-editor.com]: http://www.keyboard-layout-editor.com
[keymap.c]: keymap.c