Pascal Getreuer's QMK keymap

(This is not an officially supported Google product.)

This is my Quantum Mechanical Keyboard (QMK) keymap for the Dactyl Ergodox and ZSA Voyager. Who knew a keyboard could do so much?

Topics

Feature libraries

• Achordion – customize the tap-hold decision

• Autocorrection – run rudimentary autocorrection on your keyboard

• Caps Word – modern alternative to Caps Lock

• Custom shift keys – they're surprisingly tricky to get right; here is my approach

• Layer Lock key – macro to stay in the current layer

• Mouse Turbo Click – macro that clicks the mouse rapidly

• Orbital Mouse – a polar approach to mouse key control

• Repeat Key – an extensible "repeat last key" implementation

• Sentence Case – automatically capitalize the first letter of sentences

• Word selection – macro for convenient word or line selection

QMK

• Macro buttons – an assortment of practical QMK macros

• Triggers: reacting to interesting events – layer changes, tap vs. long press, etc.

• Typing non-English letters – several approaches to type symbols like ä, ç, λ

• QMK song player – play QMK song code in your browser

General

• Alt keyboard layouts – switching from QWERTY to an alternative keyboard layout

• Designing a symbol layer – ergonomic and character frequency considerations

• Questioning the ergonomics of 40% keyboards – smaller is not necessarily better

• PSA: Thumbs can get overuse injuries – anecdotes, common injuries, countermeasures

• Keyboard FAQS – thoughts on topics that come up regularly

• Links about keyboards – interesting links about keyboards and related topics

My keymap

Here is a visualization of my keymap. See the Dactyl keymap.c or Voyager keymap.c and getreuer.c for full details.

Base layer (Magic Sturdy with home row mods)

Symbol layer

Mouse layer

Navigation layer

Numpad layer

Window management layer

License

This repo uses the Apache License 2.0 except where otherwise indicated. See the LICENSE file for details.

Installation

This repo works as an External QMK Userspace. Instructions on how to use it in QMK:

1. Set up QMK.

2. Clone this repo locally

   git clone https://github.com/getreuer/qmk-keymap
   

3. Run the following shell command, replacing "path/to/qmk-keymap" with the relative path to your clone of qmk-keymap from the previous step:

   qmk config user.overlay_dir="$(realpath path/to/qmk-keymap)"
   

My keymap may then be compiled and flashed with

# Dactyl Ergodox
qmk flash -kb handwired/dactyl_promicro -km getreuer
# ZSA Voyager
qmk flash -kb zsa/voyager -km getreuer