Skip to content

A custom layout for the programmable ZSA Moonlander keyboard.

Notifications You must be signed in to change notification settings

Mangiola/apollo

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

21 Commits
 
 
 
 
 
 
 
 

Repository files navigation

logo

Apollo is my custom keyboard layout for the programmable ZSA Moonlander keyboard. It uses the DVORAK layout as a base for the letters while using custom layer keys for symbols. It's designed to be comfortable to type on for coding, gaming, and media creation.

Check out the layout on ZSA's online configurator.

The Layout

main layout

  • Letter Layout
    • The letters are arranged as they appear in the original DVORAK layout.
  • Number Row
    • The number row is setup so that the most frequently appearing numbers are placed in the most comfortable positions.
    • The most common 0 and 1 use the index finger, while the less common 6 7 8 and 9 need a bit of a stretch.
    • The numbers are grouped into even and odd, almost identically to the original programmer's Dvorak layout.
  • Pinky Keys
    • Backspace, delete, and escape are all located on the left pinky. This frees up the right hand to operate the mouse, and is useful for photo/video editing where these keys are pressed repeatedly.
  • Home Row Mods
    • This layout uses home row mods. Holding down the main row letters a, o, e, u and h, t, n, s will send CTRL, ALT, SHIFT, or META.
    • Note that the shift key in this position isn't meant to be used to create capital letters; it's there for shortcuts.
  • Omega Key
    • This key types an omega symbol. Useless on its own, but it's super handy when combined with text expander software like Espanso.
    • In an example setup, you could perhaps type Ωcell and it'll paste your cellphone number automatically. The macros are customizable.

blank space

Shift Layer

The shift key, besides being used for capital letters, also grants access to some punctuation.

shifted layout

  • Punctuation
    • _, !, ?, and : are found on the shift layer. This is different from standard DVORAK, but for good reason.
    • Underscore and question mark had positions that were too far to the side to fit on the Moonlander. In addition, the <, >, and " keys that were originally on the shift layer are much better suited to the dedicated symbol layer.

blank space

Symbol Layer

The symbol layer contains all the remaining typed characters.

symbol layout

  • Programming Layout
    • The position of each symbol on this layer was fine-tuned over prolonged usage. This layout places very common symbols in comfortable positions while also making sure that commonly typed programming patterns remain easy to type. The same finger is prevented from being used twice in a row as much as possible.
    • (), [], <>, and {} are able to be typed in a rolling motion.
    • Having < and > on the symbol layer makes common programming patterns like = >, - > very easy.
    • Having " on the symbol layer is almost necessary, as it's extremely common in programming to have to type patterns like (" "), " " + " ", = " ";. If it were still on the shift layer, it would add too much layer switching during programming.
  • International Keys
    • This layout uses the Canadian Multilingual keymapping. This makes it possible to type accented letters. The relevant keys are represented by empty boxes with an accent.

blank space

Function Layer

This layer contains function keys on the right in addition to common keyboard shortcuts on the left.

function layout

  • Left-hand Shortcuts
    • The essential shortcuts like cut (ctrl+x), copy (ctrl+c), paste (ctrl+v), undo (ctrl+z), and save (ctrl+s) require two hands on DVORAK. Having a seperate layer for these shortcuts allows for one-handed usage like in QWERTY.

blank space

Navigation Layer

Has the arrow keys, window controls, mouse movement, and scroll wheel keys.

navigation layout

  • Taskbar Apps
    • The keys labelled 1 through 6 open the first six apps pinned to the taskbar.

blank space

Shortcuts and Extras

The outside keys on the Moonlander are the least ergonomic to use. This makes them better off as occasional shortcuts rather than frequently used keys. These hotkeys are mostly personal preference and are not integral to the layout.

extras layout

blank space

Reasoning

The use of four extra layers (the thumb keys) allows more keys to be positioned in the middle of the board, where it's most comfortable to reach. This is why the outside keys don't change between layers.

Here's a personal mapping of how each key feels in my case.

keyboard comfort map

Gaming

The standard layout does not perform well for gaming because of the home row mods. Two extra layers are included solely for gaming purposes, viewable on the online configurator.

About

A custom layout for the programmable ZSA Moonlander keyboard.

Resources

Stars

Watchers

Forks