qmk-firmware/keyboards/thevankeyboards/minivan/keymaps/josjoha

Minivan

A 40% keyboard made first by TheVan Keyboards https://thevankeyboards.com now taken over by TKC https://thekey.company

Table of Contents

  1  Overview
      1.1 Hardware compatibility
      1.2 Software compatibility
  2  'make' example
  3  Base layouts
      3.1  Normal layouts
            3.1.1 Qwerty
            3.1.2 Qwerty with arrows on Base
            3.1.3 Dvorak
            3.1.4 Dvorak² 
            3.1.5 Colemak
            3.1.6 Workman
      3.2 Special layouts
            3.2.1 Numbers pad
  4 The common system
      4.1 Main features 
      4.2 Layer access
      4.3 Layout in graphics
      4.4 Layout in text
      4.5 Movement layer options
      4.6 Numbers pad layer options
  5 Led colors for layers
  6 Compile options
  7 Language support
      7.1 Input methods
      7.2 Unicode symbols
  8 Speed measuring
      8.1 Speed Led color compilation assist
  9 Text size measuring
      9.1 Text size Usage
 10 Making your own base layer(s)
 11 Eviscerations
 12 Key associations
 13 Trouble shooting
    • Compiling
    • Unicode
    • Leds
    • Weird layer jumping
    • Difficult/impossible key combinations ?
 14 Why you want this layout
 15 BUGS
 16 Resources
 17 Author(s)

1 Overview

A layout for the demanding keyboard user (10 fingers / blind). Designed for intuitive key placement, more symbols than standard English keyboard, speed and text size measuring. 400% the capability in 40% the size (by key function count).

For some ‛common layers’ (numbers pad, movement), different versions can be chosen than shown just below in this by layer view:

By key view:

1.1 Hardware compatibility

This keymap functions on Minivan hardware variants with 44, 45 and 46 keys.

It may be fairly easily ported to 12x12x12x[11|12|13] keyboards.

1.2 Software compatibility

This keymap relies on Unicode, in an attempt to avoid the “dead key” system for accented characters on many non-English keyboards. You need to have Unicode input working on your computer.

On a Linux computer operating system, this keymap is designed to work with this keyboard/language setting:

    > setxkbmap -layout us
    > echo $LANG
    `en_US.UTF-8`

If that works for you, you can type the most important characters in the western European group of languages, native from the keyboard.

This keymap might not function as expected if you want to use a different keyboard language setting in your operating system.

See also chapter 6 Language support.

2 'make' example

 … Download the repository, resolve software dependencies etc..
 … To change compile options: edit user_config.h (or `minifan_config_compact.h`)
 > cd […]/qmk_firmware
 > make thevankeyboards/minivan:josjoha
 > su
 # dfu-programmer atmega32u4 erase
 # dfu-programmer atmega32u4 flash thevankeyboards_minivan_josjoha.hex
 # dfu-programmer atmega32u4 start

This “Minifan” layout is explained in several readme files, with links to the others files in this readme. The common system is explained in this readme.md file. The options for the letters and number/symbol layer pairs (two pairs in the dual layout) are explained in their separate readme file, see immediately below. Compile options are detailed in ./user_config.h.

3 Base layouts

Layouts are presented here in a sort of simplified keycaps view. If a base layer pair has its own user configuration options, they are located in ./base_NAME.h.

3.1 Normal layouts

These are layouts for commonly used configurations, such as Qwerty or Dvorak.

3.1.1 Qwerty

For the readme about the Qwerty version, see ➡ ⬅

3.1.2 Qwerty with arrows on Base

For the readme about this Qwerty variation, see ➡ ⬅

3.1.3 Dvorak

For the readme about the Dvorak version, see ➡ ⬅

3.1.4 Dvorak²

Regular Dvorak for a computer already set to Dvorak.

For the readme about the Dvorak² version, see ➡ ⬅

3.1.5 Colemak

For the readme about the Colemak version, see ➡ ⬅

3.1.6 Workman

For the readme about the Workman version, see ➡ ⬅

3.2 Special layouts

These are unusual layouts. Most people will probably only want one of these on the ‛Alternate’ layout, with a normal layout on ‛Default’. How this works is explained below.

3.2.1 Numbers pad

For the readme about the Numpad version, see ➡ ⬅

4 The common system

4.1 Main features

 • Dual layout. Several layouts to choose from (example: Qwerty
   and Dvorak dual layout). Easy to add more layouts.
 • Expanded character set with western European accented characters
   (ëøßœç…); sub- super-script numbers (¹₂…) quite a few additional
   symbols such as 《 ± • ☑  ❦ √ ┣ ≠ 》…
 • Typing speed measuring. Led changes color with your speed. You can 
   ask for a report on your current and average typing speeds.
 • Text size measuring. If you want to type some amount of words or
   characters, the middle led will go from green to red as you go,
   and prevent you going over the limit.

4.2 Layer access

This graphic shows how layers are reached from the ‛Default base’ layer.

You can switch between the default base layer (typically letters), and another base layer, the alternate base layer (also typically letters), on the _RAR layer with key ‛Other Base’. Each base layer comes with its own second layer, typically numbers-symbols. The other layers are used common between the default and alternate base layers.

The Base layers and their numbers layer are detailed in files beginning with ./base_… (links below).

               Layer overview:                    Defined in:

    • Default Letters / Base                   ┓
    • Default Numbers-symbols                  ┃
                                               ┣ ./base_….c/md files
          • Alternate Letters / Base           ┃
          • Alternate numbers-symbols layout   ┛

       • Numbers pad                           ┓
       • Accented characters                   ┃
       • Additional Unicode characters         ┃
       • More Additional Unicode characters    ┣ ./keymap.c(etc)/readme.md
       • Movement arrows/mouse                 ┃   “The common system”
       • Function keys / layer toggles         ┃
       • Power, media, Speed, Text size, etc.  ┛

There are some additional layer switching keys due to key transparency artefacts, allowing for example to go back to ‛Base’ from a toggled _MOV layer with what is the ‛Enter’ key on Base.

4.3 Layout in graphics

Layer: DEF_BASE

Layer: DEF_NSY

Layer: ALT_BASE

Layer: ALT_NSY

Layer: _PAD

^ See below for a different configuration of the numbers pad keys. See above for a Base layout for a numbers pad.

Layer: _ACC

Layer: _DRA

Layer: _BON

Layer: _FUN

Layer: _MOV

^ There is an alternative flat arrow configuration for this layer (see below), and options to compile with the 'arrow' hardware layout.

Layer: _RAR

4.4 Layout in text

     Layer _DEF_BASE (Letters layer, see ./base* files for what comes on ‛__’)
                                              | Right hand
     <pink2     <pinky<ring <middl<index<indx2| indx2>index>middl>ring> pinky>pinky2>   // Keys by finger
     -o-                                     <|>                                    ... //-o- Base access
     Esc        __    __    __    __    __    | __    __    __    __    __         Bksp
     Tab+LCtl   __    __    __    __    __    | __    __    __    __    __           __
     LSht+_PAD  __    __    __    __    __    | __    __    __    __    __    RSht+_FUN 
         +_MOV⁵                               |                                   +_RAR⁶
 ---------------------------------------------------------------------------------------
 Left+LAlt Del;_ACC _..._NSY(_DRA)  Enter+_MOV| Space  _..._NSY(_DRA) RGUI    Right;_RAR 
           hold     hold₍₁,₂٭₎      hold      |        hold₍₁,₂٭₎             hold     // switch type
           hold₍₂₎  ^-┃-----------------------+--------^ ┃                          // ₁₎ both = _DRA
           ┗━━━_BON━━━╋┅───────────┄┄┄«or»┄┄┄─+─────────┅┛                          // ₂₎ both = _BON
 <1   ±    <2       <3              <4        | 4>     3>             2>   ±  1>    // Keys by number
      ^³                                                                   ^⁴   // Optional more keys
    (LGUI)                                                               (_MOV)
 
 ₁) Dual hold for _DRA, single hold for _..._NSY. Marked by: ^--…--^
 ₂) Hold key “<2” with either٭ key “<3” or “3>” for _BON, single hold “<2” for _ACC. Marked: ┗━━…━━┛
 ³) 'South paw' hardware configuration. Configurable, default shown.
 ⁴) 'Arrow' hardware configuration  Configurable, default shown.
 ³ ⁴) There are two more optional hardware keys, to make it easier to compile for
      a 12x12x12x11 or 12x12x12x12 layouts.
 ⁵) Left Shift when pressed with another key. Medium long: to toggle _PAD. Long: toggle _MOV.
 ⁶) Right shift when pressed with another key. medium long: to toggle _FUN. Long: toggle _RAR.

Remarks: The left modifiers have a slight delay in combination with an outside pointer device (mouse, stylus). It seems this will be difficult to fix, because it is spread over two devices. To avoid the ±0.2 second delay, activate a layer where the modifiers are direct (_PAD, _MOV), using the layer toggle on left shift.

The two keys with ';' (Del;_ACC, Right;_RAR) do not auto-repeat on double tap, like QMK normal layer-tap keys.

There is an uncluttered Delete on _PAD, an uncluttered Right arrow on the _MOV layer.

There is an uncluttered Tab on both the _DRA and _ACC layers. They can be modified with Control there.

Holding both _..._NSY keys left and right of the "split space bar" (enter, space) results in layer _DRA.

Holding either one of the just above mentioned _..._NSY layer keys (<3 and 3>), with the _ACC layer key (on <2) results in layer _BON.

---

 Layer _..._NSY (Numbers and SYmbols, ./base* files for what comes on ‛__’)

 <pink2   <pinky<ring <middl<index<indx2| indx2>index>middl>ring>pin>pink2>
          -*-                          <|>                                  //(toggle) Access on _FUN
 BASE     __    __    __    __    __    | __    __    __    __   __     Bspc
 Tab+LCtl __    __    __    __    __    | __    __    __    __   __  __+RCtl
 -+LSht   __    __    __    __    __    | __    __    __    __   __  __+RSht 
 ---------------------------------------------------------------------------
             Left+LAlt ___   ___   Ent  | .   ___   RGUI  Right+RAlt
                             -*-       <|>    -*-                        //(hold) Access on _DEF_BASE
               <1   ±  <2    <3    <4   | 4>  3>    2>  ± 1>  
                    ^                                   ^
                  (LGUI)                              (_MOV)

---

 Layer _FUN (F-keys, Layer access)

 <pink2<pinky<ring <middl<index<indx2| indx2>index>middl>ring> pinky>pink2>
 toggl toggl set   toggl toggl toggl | toggl toggl                            // Type of layer switch
                                    <|>                                       
 BASE: NUMS: _PAD  _ACC  _DRA  _BON  | _MOV  _RAR  xxx   xxx   xxx   Bspc       //':' are dynamic ...
 LCtl  F1    F2    F3    F4    F5    | F6    F7    F8    F9    F10   RCtl
 LSht  F11   F12   F13   F14   F15   | F16   F17   F18   F19   F20   RSht     
 ---------------------------------------------------------------------*--       //-*-  toggle on Base
          LAlt  LCtl&  LCtl&  LSht&  | FUN< +LCtl&LSht RGUI   RAlt              //... < toggle 'stay'
                LSht   LAlt   LAlt   |      &LAlt                                    
                +xxx   +xxx   +xxx   |      +xxx
                                    <|>
          <1  ± <2     <3     <4     | 4>   3>         2>  ±  1>                
              ^                                            ^
            (LGUI)                                       (_MOV)

Remarks. FUN< toggles an immediate return to the Base layer after pressing an F-key, or staying on the _FUN layer. Right led yellow indicates F-layer stays active.

---

This is the triangle configuration for arrows, arrow are on left hand (WASD):

 Layer _MOV (MOVement, mouse movement on right hand)

 <pinky2<pinky<ring <middl<index<indx2| indx2>index>middl>ring> pinky>pink2>
                                     <|>-*-                                
 Base   PgDn  Up    PgUp  Home  Btn3  | xxx   WhDn  MsUp  WhU   WhLft Bksp
 LCtl   Left  Down  Right End   Btn1  | Btn1  MsLft MsDn  MsRht WhRht RCtl
 LSht   xxx   Acc2  Acc1  Acc0  Btn2  | Btn2  Btn3  Btn4  Btn5  xxx   RSht
 -------------------------------------------------------------------------
                 LAlt Del   Ent   ___ | PgUp  PgDn  RGUI  RAlt
                                  -*-<|>                                                 
                 <1 ± <2    <3    <4  | 4>    3>    2>  ± 1>  
                    ^                                   ^
                  (LGUI)                              (DOWN)

Remarks. For the Minivan arrow hardware layout with arrow cluster, you get this on ‛Base’:

 (…)
 LSht+_PAD ;:    qQ    jJ    kK    xX    | bB    mM    wW    vV    zZ    RSht+_FUN
 -------------------------------------------------------------------------------
 Left+LAlt Del;_ACC _..._NSY(_DRA) Enter+_MOV| Space  _..._NSY(_DRA) RGUI  _MOV  Right;_RAR 
                                                                           ^^^^     // new key (toggle)

… and this on _MOV for the triangle configuration:

 (…)
 LSht*- xxx   Acc2  Acc1  Acc0  Btn2  | Btn2  Btn3  Btn4  Btn5  _Up_  RSht
 ---------------------------------------------------------------------------
                 LAlt Del   Ent   ___ | PgUp       PgDn  _Left__Down__Right_
                                  -*-<|>                                 
                 <1 ± <2    <3    <4  | 4>         3>     2>   _±_    1>  
                    ^
                  (LGUI)

… or this on _MOV for the triangle arrow configuration with additional navigation keys:

 BASE   PgDn  Up    PgUp  Home _Btn4_ | xxx   WhDn  MsUp  WhU   WhLft Bksp
 LCtl   Left  Down  Right End   Btn1  | Btn1  MsLft MsDn  MsRht WhRht RCtl
 LSht*- xxx   Acc2  Acc1  Acc0 _Btn5_ | Btn2  Btn3 _Home__PgUp_ _Up_ _PgDn_
 ---------------------------------------------------------------------------
                 LAlt Del   Ent   ___ | PgUp      _End_  _Left__Down__Right_
                                  -*-<|>                                  
                 <1 ± <2    <3    <4  | 4>         3>     2>   _±_    1>  
                    ^
                  (LGUI)

This is the flat configuration for arrows, arrow are on right hand:

 <pinky2<pinky<ring <middl<index<indx2| indx2>index>middl>ring> pinky>pink2>
                                     <|>-*-                              
 BASE   WLft  WDn   WUp   WRht  xxx   | Btn3  PgUp  Home  End   PgDn  Bksp
 LCtl   MLft  MDn   MUp   MRht  Btn1  | Btn1  Left  Up    Down  Right RCtl
 LSht*- Btn5  Btn4  Btn3  Butn2 xxx   | Btn2  Acc0  Acc1  Acc2  xxx   RSht
 -------------------------------------------------------------------------
                 LAlt Del   Ent   ___ | PgUp  PgDn  RGUI  RAlt
                                  -*-<|>                                                
                 <1 ± <2    <3    <4  | 4>    3>    2>  ± 1>  
                    ^                                   ^
                  (LGUI)                              (DOWN)

For the Minivan arrow hardware layout with flat arrow cluster, you get this on _MOV:

 (…)
 BASE   WLft  WDn   WUp   WRht  xxx   | Btn3  PgUp  Home  End   PgDn  Bksp
 LCtl   MLft  MDn   MUp   MRht  Btn1  | Btn1  Left  Up    Down  Right RCtl
 LSht*- Btn5  Btn4  Btn3  Butn2 xxx   | Btn2  Acc0  Acc1  Acc2  xxx   RSht
 ---------------------------------------------------------------------------
                 LAlt Del   Ent   ___ | PgUp      _Left_ _UP_  _Down__Right_
                                  -*-<|>                                 
                 <1 ± <2    <3    <4  | 4>         3>     2>   _±_    1>  
                    ^   
                  (LGUI)

… or this on _MOV for the flat arrow configuration with additional navigation keys:

 BASE   WLft  WDn   WUp   WRht  xxx   |_Acc2_ PgUp  Home  End   PgDn  Bksp
 LCtl   MLft  MDn   MUp   MRht  Btn1  | Btn1  Left  Up    Down  Right RCtl
 LSht*- Btn5  Btn4  Btn3  Butn2 xxx   |_Acc1_ Acc0 _PgUp__Home__End_ _PgDn_
 ---------------------------------------------------------------------------
                 LAlt Del   Ent   ___ | PgUp      _Left_ _UP_  _Down__Right_
                                  -*-<|>                                  
                 <1 ± <2    <3    <4  | 4>         3>     2>   _±_    1>  
                    ^ 
                  (LGUI)

… or this on _MOV for the flat arrow configuration, […], and vi(1) layout:

 <pinky2<pinky<ring <middl<index<indx2| indx2>index>middl>ring> pinky>pink2>
                                     <|>-*-                                 
 BASE   WLft  WDn   WUp   WRht  xxx   |_Acc2_ PgUp  Home  End   PgDn  Bksp
 LCtl   MLft  MDn   MUp   MRht  Btn1  | Left  Down  Up    Right Btn1  RCtl         // vi as in Qwerty
 LSht*- Btn5  Btn4  Btn3  Butn2 xxx   |_Acc1_ Acc0 _PgUp__Home__End_ _PgDn_
 ---------------------------------------------------------------------------
                 LAlt Del   Ent   ___ | PgUp      _Left_ _Down__Up_  _Right_       // vi as in Qwerty
                                  -*-<|>                                  
                 <1 ± <2    <3    <4  | 4>         3>     2>   _±_    1>  
                    ^
                  (LGUI)

For the 'arrow' hardware layout (additional key on the right), keys on the first row are sacrificed and lost. The right most key on the second row is also lost. The two keys on places 3 and 4 when counting from the right on the second row, are being moved to the spots for Btn2 and Btn3 on the hand that also has the arrows (those keys are otherwise twice defined for left and right hand).

---

 _RAR (RARe keys. Power keys, Unicode mode, Alternate Base, Media, Brightness, Speed, Size, leds, …)

 <pink2<pinky <ring <middl <indexx<indx2| indx2>index>middl>ring> pinky> pink2>
                                       <|>      -*-                                //(toggle) on _FUN
 BASE  Cnt/Mx Cnull CWmin  CRprt  Speed | SRprt Play  Next  Prev  Stop RSht(•)   
 CapsL Power• Wake• Sleep• Pause• ScrLk | PrtSc xxx   Vol+  Vol-  Mute Insert     // • requires Shift
 ☑     uLNX   uBSD  uOSX   uWIN   uWNC  | xxx   xxx   Bri+  Bri-  xxx     APP     // Ü(nicode) tester
 ----------------------------------------------------------------------------
                 SLed  MLeds LGUI  xxx  | !Alter  xxx   RGUI  ___   // Mid-led, Side-leds, !Alternate
                                       <|>                    -*-                   // (Hold) on Base
                 <1  ± <2    <3    <4   | 4>      3>    2>  ± 1>  
                     ^                                      ^
                   (LGUI)                                 (_MOV)

Remarks. !Alter switches between normal and alternate Base layer.

☑ is a Unicode tester key. uLNX for Linux Unicode input encoding, uBSD for BSD Unix, uWIN for Windos, uWNC for another Windos encoding. The change is retained between on/off power cycles.

MLed switches on/off the middle led, SLeds switches on/off the side leds.

The keys marked with • require Shift to be activated, as a means of preventing accidents. Shift here is on (Base) 'Backspace' (upper/right key) which also reduces accidents (combinations which are never pressed normally). If you press these keys without 'shift' they print their own name between angled brackets. Example: pressing the 2nd key on the 3rd row prints “<POWER>”.

Bri+, Bri-: screen brightness (if your system supports it.)

Speed: toggles speed measuring on/off. SRprt: writes your speed. See topic about Speed measuring.

Cnt/Mx, Cnull CWmin, CRprt: text size measuring. See topic.

---

 Layer _PAD Numbers Pad (special symbol versions; regular '1' is not the same as this numpad '1', etc)

 <pink2   <pinky<ring <middl<index<indx2| indx2>index>middl>ring> pinky>pink2>
                -*-                    <|>                                         //(toggle) on _FUN
 BASE     xxx   xxx   .DEL  4LEFT 2DOWN | 8UP   6RGHT *     xxx   xxx   Bspc
 LCtl     1END  2DOWN 3PGDN 4LEFT 5     | 6RGHT 7HOME 8UP   9PGUP 0INS     -
 LSht     xxx   xxx   /     xxx   =     | +     3PGDN 1END  7HOME 9PGUP RSht
 -*-------------------------------------------------------------------------    //-*-  toggle on Base
              LAlt     Del   Tab   ENT  |  NUML  xxx   RGUI  RAlt
                                       <|>
              <1   ±   <2    <3    <4   | 4>     3>    2>  ± 1>  
                   ^                                       ^
                 (LGUI)                                  (_MOV)

Remarks: The keys between .DEL and *, + and RSht constitute sort of navigation clusters, to make it easier to find the number pad versions thereof.

This is the variety for _PAD layer, which resembles a numerical keypad:

 Layer _PAD (Number pad, square layout)

 <pink2   <pinky<ring <middl<index<indx2| indx2>index>middl>ring>pin>pink2>
                                       <|>
 BASE     xxx   xxx   xxx   xxx   xxx   | =     7HOME 8UP   9PGUP -   Bspc
 LCtl     xxx   xxx   xxx   xxx   xxx   | *     4LEFT 5     6RGHT +   RCtl
 LSht     xxx   xxx   xxx   xxx   xxx   | /     1END  2DOWN 3PGDN ,   RSht  
 ------------------------------------------------------------------------
               LAlt   Del    Tab   ENT  | NUML  0INS  .DEL  RAlt      
                                       <|>           
               <1   ±  <2    <3    <4   | 4>    3>  ± 2>    1>  
                    ^                               ^ 
                  (LGUI)                          (RGUI)¹

 ₁) Note anomaly, see Base Numpad for details `./base_numpad.md`.
    Different placement and different meaning, compared to the usual common layers.

---

 Layer _ACC (ACCented characters, see _RAR layer for input modes)

 <pink2    <pinky<ring <middl<index<indx2| indx2>index>middl>ring> pinky>pink2>
                   -*-              <|>                                            //(toggle) on _FUN
 BASE      áÁ    óÓ    éÉ    úÚ    íÍ    | ýÝ    ijIJ    çÇ    øØ    åÅ    Bksp
 LCTL(Tab) äÄ    öÖ    ëË    üÜ    ïÏ    | ÿŸ    œŒ    æÆ    ñÑ     ß       μ
 LSht      àÀ    òÒ    èÈ    ùÙ    ìÌ    | îÎ    ûÛ    êÊ    ôÔ    â    RSht
 ----------------------------------------------------------------------------
                   LAlt ___   ___   Ent  | Spc   ___   ___   RAlt 
                        -*-             <|>                                        //(hold) on Base
                   <1 ± <2    <3    <4   | 4>    3>    2>  ± 1>  
                      …                                    …

---

 Layer _DRA (DRAwings, whatever else (rendering width might vary in different applications))

 <pink2<pinky<ring <middl<index<indx2| indx2>index>middl>ring> pinky>pink2>
                         -*-        <|>                                            //(toggle) on _FUN
 BASE  “„    ”≤    £≥    ∅ ¢   ±ƒ    | ❦♥    🙂🙁  👍👎   ⁽₍    ⁾₎    Bspc 
 Tab   ¹₁    ²₂    ³₃    ⁴₄    ⁵₅    | ⁶₆    ⁷₇    ⁸₈     ⁹₉    ⁰₀    RCTL
 LSht 「━    」─   °〇   •§    …·    | ☐☒   ☑🗹     ¿¡    《┄    》┅   RSht     //  ☐ ☒ ☑ 🗹 or ⮘ ⮙ ⮚ ⮛
 -------------------------------------------------------------------------
               LAlt ___   ___   Ent  | Spc   ___   ___   RAlt 
                          -*-       <|>      -*-                                     //(hold) on Base
               <1 ± <2    <3    <4   | 4>    3>    2>  ± 1>  
                  ^                                    ^
                (LGUI)                               (_MOV)

Remarks. ☐ ☒ ☑ 🗹 or ⮘ ⮙ ⮚ ⮛

---

 Layer _BON (Bonus layer, a variety of more stuffs.)

 <pink2<pinky<ring <middl<index<indx2| indx2>index>middl>ring> pinky>pink2>
                               -*-  <|>                                            //(toggle) on _FUN
 BASE  ‛ 🛠  ’ ⬆   ¤ 🄯   ∑ ©   ‰ ‱   | ★ ٭   😊 ⍨  ×  ⃰   √     ⁻ ⁺    Bksp
 `~    ① ⬅   ② ⬇   ③ ➡   ④ ┏   ⑤  ┓  | ⑥ ┃   ⑦ ┇   ⑧ ╋   ⑨     ⓪ ∞    — ≈     // — is a dash (larger)
 LSht  ‹     ›     ÷     ☞ ┗   ≠  ┛  | ✗ ┣   ✓ ┫   ⚠     «     »      RSht
 -------------------------------------------------------------------------
              Left  ___   ___   Ent  | Spc   ___   ___   Right
                    -*-   -*-       <|>      -*-                                // Activation on Base
              <1  ± <2    <3    <4   | 4>    3>    2>  ± 1>  
                  ^                                    ^
                (LGUI)                               (_MOV)

---

4.5 Movement layer options

The movement layer (_MOV) has several configuration options. You can either have triangle configuration arrows on the left hand (with navigation keys around it), or a flat arrow configuration on the right hand (with navigation above it).

You can configure for the arrow hardware layout (one additional hardware key on the right). The additional key on the Base layer can toggle to the movement layer, and than becomes part of the arrow cluster. For both versions (triangle arrows left hand or flat arrows right hand) you can compile this second arrow cluster to be completed with navigation keys (Home, End, PageUp, PageDown).

^ #define ARROWS_TRIANGLE

^ Illustration of accessing the arrows/navigation with a key on the Base layer

^ #define ARROWS_TRIANGLE, MORE_KEY__ARROW, MOREKEY2_ARROW_CLUSTER, MORE_key2 _MOV_UP

^ #define ARROWS_TRIANGLE, MORE_KEY__ARROW, MOREKEY2_ARROW_CLUSTER, MOREKEY2_ADD_NAVIGATION, MORE_key2 _MOV_UP (note change on previously BTN2/3)

^ #define MORE_KEY__ARROW, MOREKEY2_ARROW_CLUSTER, MORE_key2 _MOV_UP

^ #define MORE_KEY__ARROW, MOREKEY2_ARROW_CLUSTER, MOREKEY2_ADD_NAVIGATION, MORE_key2 _MOV_UP (note change on previously BTN2/3)

^ #define [MORE_KEY__ARROW, MOREKEY2_ARROW_CLUSTER] VI_SWITCHERYDOO, #undef ARROWS_TRIANGLE

4.6 Numbers pad layer options

This concerns the numbers pad layer, the one that is part of the common layers.

^ #define NUMPAD_COMMON_SQUARE

5 Led colors for layers

  • letters                          Led: low-white/teal/off⁽¹⁾          _DEF_BASE "Default base"
    • letters (alternate)              Led: off/teal/low-white           _ALT_BASE "Alternate base"
  • numbers                          Led: blue/blue/blue                 _DEF_NSY "Default Numbers SYmbols"
    • numbers (alternate)              Led: blue/blue/low-white          _ALT_NSY "Alternate Numbers SYmbols"
  • number pad symbol versions       Led: green/low-white/blue ⁽²⁾       _PAD "numbers PAD"
  • accented characters é, ø, ß …    Led: cyan/cyan/cyan                 _ACC "ACCented"
  • Unicode symbols, ¹, ±, ° …       Led: yellow/yellow/yellow           _DRA "DRAwings"
  • Unicode symbols, ①, ‰, ÷ …       Led: off/yellow/off                 _BON "Bonus"
  • function keys,                   Led: red/red/orange ⁽³⁾             _FUN "FUNction keys"
  • and a movement layer             Led: green/green/green              _MOV "MOVement"
  • keys like Power, Play,           Led: white/purple/purple ⁽⁴⁾        _RAR "RARe keys"

  Leds:
        • ⁽¹⁾ The low-white led is bright-white when capslock is on. Optionally the middle led (cyan) can
              show the color of the last layer that was active.
        • ⁽²⁾ The colors are reversed blue/low-white/green when numlock is on. 
              Left led color memory aid: same as either numbers or movement layer for numlock on/off.
        • ⁽³⁾ The colors are reversed to orange/red/red when set to de-activate after one F-key press.
        • ⁽⁴⁾ The colors are reversed purple/purple/white, indicating which of the two base layers
              is active (see below).
        • Middle led: Breathing effect. When not breathing, keyboard is not working normally with the computer.
                    - When speed measurement is active, the middle led color indicates the speed, unless
                      text size counting set to a maximum is active.
                    - When text size counting is active and set to a maximum amount, the middle led color 
                      indicates progress to the limit from green to red, flipping white/red on the limit.
                    - When on Base layer it shows a teal color, or (compile option) the layer most recently active.
                    - When the left/right leds are off, when on Base, it shows a teal color (not last active), even
                      if so compiled.
        • Leds can be switched on/off on the _RAR layer (SLeds, MLed).

6 Compile options

     Layout

• Several layouts to choose from: Qwerty, Dvorak, Colemak, Workman, Numpad.

• You can use the keyboard with two different letters/number-symbols layouts.

     Hardware

• Hardware key configurations: default (44), arrow (45), south paw (45), arrow + south paw (46).

(On the _RAR layer, the additional south paw key is more to the right.)

• What the additional hardware keys for arrow, south paw should be.

     Navigation cluster

• An arrow cluster for arrow hardware configuration, on the _MOV layer.

• All navigation keys around arrow hardware configuration arrow cluster on _MOV layer.

• Navigation cluster in a triangle (WASD) (left hand), or flat layout with optional vi(1) layout.

     Numpad (in common layers)

• Numpad with numbers in a row.

• Numpad with layers in a block form.

     Special functions

• Set speed measuring on/off at keyboard startup.

• Set text size measuring on/off at keyboard startup.

     Changing symbols

• Switching the GUIs left/right, and some other specific key changes.

• Reduce firmware size/bloat: remove or eviscerate Unicode layer(s).

For the complete list, see ./user_config.h.

7 Language support

7.1 Input methods

There seem to generally be two ways in QMK for typing a language other than English. One is to use a language specific remapping on the computer operating side, and to use the QMK supplied symbols in the keymaps. This may include the use of a “dead key”. Presumably you can also still use the Unicode symbols.

⚠ There are currently no such Base pair layouts available. If this is the method you want, you may want to look elsewhere.

The other way is to type the additional symbols in Unicode. The computer operating must understand these special sequences. Several Unicode input modes are available, which can be changed while the keyboard is running. There is no need for a “dead key”. The language setting in the computer operating system can be set to English. This layout is designed for this method, to avoid the dead key problem.

7.2 Unicode symbols

For the remainder of this chapter the Unicode input method is assumed.

You may be able to type your language, with the help of some of the Unicode layers and one of these layouts: Qwerty, Dvorak, Coleman, Workman. The following languages might work for you this way.

 • Dutch (éëèïijí)
 • English (—“”‛’)
 • French (çœæéèàòùîûêôâëïüÿ)
 • German (äöüß)
 • Norwegian, Danish (œæøå, éêèëóêò, üáà …)
 • Spanish (¿¡ñ)
 • Swedish (äåö …)

The following quotation marks are available, which seems it would cover these languages:

 'test' "test" “test” „test” ‛test’ ,test’¹ «test» ‹test› 《test》 「test」 — test

 ¹) Left side is a basic comma.

See the _ACC accented characters layer for all characters with diacretic markings. If you miss a symbol, you could replace one you don't use and add it yourself (by reprogramming the source code).

8 Speed measuring

  ‛Speed’ starts speed measuring.
  ‛SRprt’ stands for ‛Speed Report’:
            • Tap to get your speed report.
            • Hold for a while for led color compilation (see below).
  ☞ Text size counting (see below) middle led colors take precedence,
    when a maximum is set, over layer colors or speed measurement.

With the key ‛Speed’ on the _RAR layer, the speed of your latest completed batch of 25 keypresses is computed, as well as the average of all your batches of 25 keys. The speed is displayed as the color of the middle led, which otherwise shows the layer color. A bright white middle led indicates ‛Speed’ has just been activated.

With the key ‛SRprt’ (short for ‛Speed Report’), the keyboard will write your typing speed either in keystrokes per second (k/s) or words-per-minute (wpm), depending on your compilation configuration.

“Keystrokes per second” uses the following format: <A k/s B.B k/s Cx25keys>. A is the amount of key presses per second (k/s) of your last batch, B.B is your average over the last C batches of keys. When using “Words per minute”, A is in word-per-minute, B is also in words-per-minute: <A wpm B wpm Cx25keys>, no decimal precision. Example: <150wpm;108wpm20x25keys>

Batches with 0 k/s are not counted to the average. You can take a longer break without it affecting your average.

8.1 Speed Led color compilation assist

If you hold the ‛Speed Report’ key for one second, it will increment the speed, and led color accordingly. This can be helpful when configuring your speed measuring compile settings. This works best with speed measuring set off.

9 Text size measuring

  ‛Cnt/Mx’ stands for ‛Count/Maximum’: 
            • Tap to start counting, tap again to suspend.
            • Hold > 0.5 seconds for maximum menu.
  ‛Cnull’ stands for ‛Count null’:
            • Tap to set the counts to zero.
  ‛CWmin’ stands for ‛Count Word minus’:
            • Tap to detract one word from the word count. 
            • Hold > 0.5 seconds to detract 10 words.
  ‛CRprt’ stands for ‛Count Report’:
            • Tap to get a counting report. 
  ☞ ‛Count’ and ‛Speed’ (see above) reports get added to the
    character count, but not to the word count.
  ☞ Auto-repeating keys do not get counted as characters.

You can count your text by character and word, by activating the key ‛Count’ on the _RAR layer. Pressing ‛Count’ again will suspend counting, pressing it yet again resumes where the count left off earlier. The middle led turns cyan when no maximum is set (see below), or to green when it is set.

You can set a maximum to type, with the ‛Cnt/Mx’ key. In your editor (or wherever typing these characters is harmless) you will get the following menu by pressing the ‛Cnt/MX’ key for at least half a second: <Nc|w>. In here: N stands for your numerical input, c for a maximum count in characters or w for a maximum in words.

Start typing a number, finish with either c or w to make the maximum be counted in either characters or words. If you want to leave the menu before giving c or w, enter a dot ‛.’ or ‛Escape’, which will leave the maximum value at 0 (zero). A maximum value of zero implies there is no maximum.

Setting a maximum of 1000 characters looks like so:

    Hold ‛Cnt/MX’ results in: `<Nc|w>` 
    Then type “1000” results in: `<Nc|w>1000`
    Then type “c” results in: `<Nc|w>1000->1000c`
    At this point the keyboard is out of this special input menu.

    The keyboard indicates what it accepted as your input, by 
    repeating the number, just before your last input is being printed.

With a maximum established, the middle led color goes from green to red, as you type. When the maximum is reached, the keyboard will output a Backspace character for every key you subsequently press, making it impossible to go any further, until text size counting has been disabled, or the count is reduced. The middle led changes color between red and white while at the maximum set size, for every new input character.

To get your word count report, press ‛CReport’ short for: ‛Count Report’. It comes in the form: <Ac;Bw>, where A is your character count, and B is your word count. Example: <5420c;547w>.

When a maximum is established, the report will only be given in either characters or words, and the maximum is given with it, like so: <66w>[200w]. 66 words have been written, a maximum of 200 words has been set.

If you have a maximum established and use it across different articles, you no longer have the total count. You can activate speed measuring, which in its report includes the total characters pressed.

9.1 Text size Usage

It is assumed that you will take the report in the document you are editing, and then delete it. If you do character counting, the value of the report itself is added to the character count. Therefore you should delete that without using an auto-repeating on the deletion key. That way the characters are subtracted again.

If you count in words, the report is not added to the word count. You can delete it however you want.

This works the same for a ‛Speed Report’ you might like to take. You can take it in the document, and then delete it in the same, without affecting the text size counting in characters or words. When deleting keys with Backspace or Delete, the character count goes down accordingly, the word count does not.

Words are counted by counting Space and Enter key presses. Immediately repeating blanks do not add to the word count. You can only manually subtract from the word count, using the key ‛CWmin’ short for ‛Count Word minus’. This means that if you delete sections in your document, you need to manually subtract the same words.

Example: after typing something and then typing <Enter> twice to start a new paragraph, counts for one word. When deleting three words with their three blank areas, then tapping ‛Count Word minus’ three times, should result in an accurate word count. To add words to the count, type mock ones and then delete them: “x x x x” adds three words, “y y y ” also adds three words (three separate blank spaces).

Layer changes, shift and unusual/complex keys do not get counted. Navigation, arrow and mouse keys do not get counted. Auto-repeating of keys does not affect the character count, therefore should be avoided if you want to count in characters.

10 Making your own base layer(s)

You can insert your own _DEF_BASE, _DEF_NSY and/or _ALT_BASE, _ALT_NSY Base plus number/symbols layer pairs, integrate it nicely with the rest of the code, and re-define a special characters layer to go with it if you want (etc). The idea is to make it easy to change the alphanumerical keys, while leaving the modifiers, layer switch keys etc. the same. YOUR_KEYMAP stands for a name you choose.

First we will look at a simple keymap, without its own configuration options or header file.

 ① Make a file named: `./base_YOUR_KEYMAP.c`), with at least 
   those two layers: _..._BASE and _..._NSY. It is probably best to
   copy one of the existing `./base_....c` files, and edit that.

 ② Add a #define to `./user_config.h`:
   #define BASE_YOUR_KEYMAP__DEF_BASE
   #define BASE_YOUR_KEYMAP__ALT_BASE
   Under the topic ‛Base layers’ there is a comment to help you.

 ③ Edit ./keymap.c to have your new file #included, using your just defined
   preprocessor element. Close to the other #includes is a comment there to
   help you. Look just under the line with this, in ./keymap.c:

   const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
   (…)
   // // ⬇ insert your ./base_YOUR_KEYMAP.c #include here:

   // # if defined(BASE_YOUR_KEYMAP__DEF_BASE) || defined(BASE_YOUR_KEYMAP__ALT_BASE)
   // #     include "./base_YOUR_KEYMAP.c" // Your Keymap.
   // # endif

Now you have integrated your base layers alternative. To compile it:

 ④ _Activate_ your #define BASES_YOUR_KEYMAP__DEF_BASE or 
   BASES_YOUR_KEYMAP__ALT_BASE in `./user_config.h`,
   _Remove_ any other base layers from being defined on the
   same spot _DEF_BASE or _ALT_BASE to prevent a conflict.

 ⑤ Check Pre-processing with:
   > gcc -E keymap.c | less

 ⑥ Compile and flash to your keyboard.

You can redefine any layer in your new ./base_YOUR_KEYMAP.c You can do that by setting one or more of the BASESFILE_LAYER_... defines in your own ./base_YOUR_KEYMAP.c file. See near the top of an existing ./base_....c file for clues. _ACC in particular is a layer meant to augment a keymap with special characters for a given language/layout in the base layer(s). Perhaps you want to redefine it, for example.

Example: Having done the above points ① ➡ ④ for a ./base_YOUR_KEYMAP.c file. Let's say you re-arranged keys on _ACC to suit ... French.

 ⑦ In your `./base_YOUR_KEYMAP.c`:
   #define `BASESFILE_LAYER_ACC`
   The `_ACC` in ./keymap.c will now be ignored.

You can re-define _ACC in your own file.

 ⑧ Copy an existing `_ACC` layer into `./base_YOUR_KEYMAP.c` 
   Edit it so that French characters like ‛Ç’ ‛«»’, ‛œ’, ‛æ’,
   ‛ô’, ‛é’ etc. are in positions that work best. You can look in
   `unicode_weurope.h` to find some Unicode points already defined.

 ⑨ Compile and flash to your keyboard.

Now we will look at a more complicated keymap, where you are also altering preprocessor constants defined in ./user_config.h. (Warning, perhaps this is overkill … ;-)

Example: the ./base_numpad.c has an option to entirely eviscerate the _PAD layer, for convenience. (Why is this even useful ? Good question ! One reason could be that it can set up a default, so that anyone who chooses this ./base_numpad.c Base layer, automatically is eviscerating the _PAD common layer, without having to do anything else. On the downside, it could be confusing that one option is configured in two places.)

Having done the above points ⑦ ➡ ⑧ as well, let's say for some reason you need to reverse Left GUI and Right GUI.

  ⑨ Copy your User Configuration Block at the top of your `./base_YOUR_KEYMAP.c`
    and the GPL License, and place that in a new _header_ file: 
    `./base_YOUR_KEYMAP.h` 

  ① ⓪  Write the necessary code to set and unset the constant
       `SWITCH_GUIS` in your `./base_YOUR_KEYMAP.h` file You are encouraged
       to write code which overrides any setting in `./user_config.h, for
       those constants which you choose to affect, for simplicity sake. 
       (This is not a C programming manual, so it won't get into this.)

  ① ①  Look in `./user_config.h`, and #include your header file there, in
       a similar way as was done for your C code file. It should be just
       below the user configuration block, and has a template for you.

  ① ②  Compile, flash and test.

  ① ③  It would be nice to put a remark on the general preprocessor constants
       which you might be affecting, that your keymap could be affecting them.
       You would edit the ./user_config.h comments with a short one line notice,
       such as:

       *
       * ⚠ Note: ./base_YOUR_KEYMAP.h can overrides this setting, if compiled with that ‛Base’ layer.
       */

Putting your *.h header file in ./user_config.h isn't strictly necessary, unless you alter “general preprocessor constants” defined in ./user_config (not local constants for your keymap only).

Perhaps a separate header file is overkill. On the other hand, whatever preprocessor logic is necessary after user configuration has been given, can be handled in one place, if #included as suggested. It allows you to override the settings in ./user_config.h from your header file (because it is #included immediately below those). If a user is playing with keymaps Base compile choices, it could be convenient to play with ./base_YOUR_KEYMAP.h settings, have everything that could be relevant close at hand, then forgetting about those settings once compiling with another Base layer, and be able to return to it with previous configuration already done.

You can also just #include your header file at the top of your ./base_YOUR_KEYMAP.h file, if it does not touch anything else but your local keymap.

11 Eviscerations

Cutting down the keymap reduces the firmware size, and helps reducing mental clutter from having masses of symbols you might never want to use.

You can compile as a single layout. Define only a ‛Default’ base pair, and set MINIFAN_SINGLE_LAYOUT (./user_config.h). The leds for the base layers letters and numbers&symbols, will show up as they would for the ‛Alternate’ layer in a dual layout compilation.

You can remove the layers _ACC, _DRA and/or _BON (see ./user_config.h around REMOVE_ACC).

You can remove a set of symbols from one or more of Unicode layers, such as not having box drawing characters on _BON, or no sub-script numbers on _DRA.

12 Key associations

The keymap was designed to have the same or similar keys on the same key or close to it, on different layers. Sometimes the association goes by what finger is used, and/or on what row. For example the symbol ‛(’ on the numbers-symbols layer (_NSY), becomes the symbol ‛⁽’ on another layer.

13 Trouble shooting

• Compiling

If the firmware is too large, you can try using a different version of the compiler, or you may have to reduce size by removing certain options.

• Unicode

Unicode is chaos: try going to _RAR layer, and hit the Unicode operating system buttons.

• Leds

Leds not working after flashing firmware: try going to _RAR layer, and hit the key MLeds and SLeds, which switch Leds on/off.

• Weird layer jumping

You weirdly end up on the _PAD, _FUN or some other layer while typing ? If you jump to layers which are on Shift key toggles, this is a typing mistake.

• Difficult/impossible key combinations ?

An example of a difficult key combination is: the modifier Control, Shift, or Alt, with media key “volume up” (or down, etc). It may work to press and hold “Control” (which should communicate “Control depressed”), then activate _RAR layer with the hold key (which communicates nothing to the computer attached to the keyboard), press and let go “volume up” (which should communicate just that), let go of the _RAR layer (which again communicates nothing), let go of the Control key (which should communicate “Control released”)..

14 Why you want this layout

☞ This layout seems easy to learn and predictable.

☞ The normally most used layer after letters is “numbers & symbols” (123…, !@#…, []/…, called _NSY). This layer you can access by either your left or right thumb, to spread fatigue.

☞ Right hand pinky is no longer overused, as it is on regular keyboards.

☞ 0-9 enumerations / numbers, they are on the same fingers as a standard keyboard.

☞ The symbols normally reached by shifting a number, are also still on the same fingers.

☞ Because one often uses an F-key only once, the layer can switch back to Base after an F-key is used.

☞ Modifier combination keys on _FUN layer for use with F-keys.

☞ The movement layer has a bunch of layout options, and allows for mouse use.

☞ The layer with Power buttons protects you from accidental keystrokes on the critical keys.

☞ If you need working with Control/Shift/Alt and a pointing device in right hand, you can quickly get uncluttered such keys by tapping left shift.

☞ The accented layer makes it possible to set the keyboard in a mode on the computer side without dead-keys.

☞ The second Unicode layer adds a fair amount of fun stuff to spice up your writing. Write H₂O, 2⁷·⁰=128, ±8 °C, §2.1, 2 ³/₈", a note⁴, £ 6.²⁵ etc.

☞ The third Unicode layer adds a proper dash — and French style quotations «»‹› and other stuff. ① «Ça va bien», ② 5 × 3 ≠ 14, ③ .083% ÷ 2 ≈ 4‱ ➡ 4.₁₅‱

              ┏━━━━━━┓
              ┃ test ┃
            ┅━╋━━━━━━┛
              ┇ ④

☞ Speed and text size measuring, including to set a maximum on your text input. These are features not part off regular keyboards.

☞ Easy to create your own dual layout for letters / numbers.

☞ If you do want to reprogram the code, it has a lot of comments to make it easier to follow.

15 BUGS

No real bugs known currently. Just some minor issues …

The tilde ~ on the numbers-symbols layer should logically be reached on the second row without the need for shift, however there seems to be a QMK limitation with this. No work around has been attempted as of yet. (It seems to be a minor issue; using shift for once seems OK.)

LCTL_T ( KC_TAB ) is not seen as a blank by word counting, use as Control is not ignored in character counting. (This minor issue is ignored for now. Tab is not normally used in text writing.)

The eviscerations may not have been worked out yet into the ultimate scrubbing of everything that may have become redundent, because it does complicate the code with a lot of #defines. Perhaps it should be done eventually, if there is an actual need.

16 Resources

This links to an external file, with some development resources like Gimp .xcf files, pre-compiled hex files, …

Resources

17 Author(s)

This keymap.c was edited from the Minivan default, original LED support was copied/edited from ../jetpacktuxedo/ keymap. Thanks to QMK support for their help, especially Drashna.

Personal note: This keymap came about because of a sudden need for a replacement keyboard. It took over a year to make (≈ 1.5 h/day). The goal became to make a good keymap for everyone without the time to make one, in the best keyboard format: “40%”.

Written on the Minivan: Jos Boersema. contact

Contributions to this key map: - …