GitXplorerGitXplorer
M

glove80-config

public
6 stars
4 forks
8 issues

Commits

List of commits on branch main.
Unverified
d042cbb490d709e87d04fd17f3173fe5e533ce75

[Draw] flake.lock: Update

MMattSturgeon committed 8 months ago
Unverified
c1716957ebfe05001f0b03aad6d4be049e4f0fe1

flake.lock: Update

ggithub-actions[bot] committed 8 months ago
Unverified
3da3791b131ecfac82255b00bf605cd1dde621ad

[Draw] remove: underscore combo

kkeymap-editor[bot] committed 10 months ago
Verified
6f9c77fe7b86c4a2e324fb1caa105984d3384e3a

remove: underscore combo

kkeymap-editor[bot] committed 10 months ago
Verified
2ac361121f134e02a727a25527ea9e817ad8d036

docs: Update links in README

MMattSturgeon committed 10 months ago
Verified
1ab0a80248a1e6832943160f9a56f722744e2415

ci: update commit action

MMattSturgeon committed 10 months ago

README

The README file for this repository.

My ZMK config for the MoErgo Glove80

Photo

Based on MoErgo's template and Gaétan Lepage's flake.

This repo contains the current config for my Glove80 keyboard. The keymap was initially built using MoErgo's Layout Editor, however it is now maintained using Keymap Editor with occasional manual tweaking.

The keyboard firmware can be built locally using nix, which is also used for automatic builds.

Keymap Drawer is used to render images of each layer (see below).

Layers

Base Layers

The default base layer uses Colemak DH. Some punctuation is moved around using Mod Morphs, and useful stuff is placed on the thumb keys.

Default

There is a secondary Qwerty base layer available as a fallback:

Qwerty

Gaming

A gaming layer extends Qwerty, shifting WASD to a more comfortable position.

Gaming

Symbols

Readily accessible from a thumb key, the symbols layer attempts to find comfortable positions for commonly used programming symbols.

Symbols

Numbers & Navigation

Also on the thumb keys, a nav layer has a comfortable numpad and navigation keys.

Numbers & Navigation

I may consider switching from a numpad layout to a 2x 4-finger numrow in an attempt to keep everything closer to the home row. Alternatively, moving the 0 key up may have the same effect.

MoErgo's Magic Layer

As standard on all Glove80 keyboards, a Magic layer provider access to system utilities, such as Bluetooth settings and RGB lighting config.

Magic Layer

Setup

Flashing Firmware

Before flashing, ensure udisks2 is setup and enabled so that the keyboard can mount its bootloader storage device.

Flashing automatically

The easiest way to flash the firmware is using nix run.

  • cd into the project root
  • Connect the right half (in bootloader mode)
  • Run nix run
  • Connect the left half (in bootloader mode)
  • Run nix run
  • Done!

Flashing manually

You can also manually copy the uf2 firmware file to the keyboard.

The firmware can be built locally using nix build and will be written to ./result/glove80.uf2. Alternatively, the firmware can be downloaded from GitHub Actions's artifacts.

Connect the keyboard half in bootloader mode, then copy the firmware file into the keyboard's USB storage. The keyboard will unmount when it has finished flashing.

Booting into bootloader mode

See the user guide for more info.

  • Hold the C6 R6 key (extreme bottom corner)
  • Also hold the C3 R2 key (middle-finger; Colemak F or U, Qwerty E or I)
  • Power on the keyboard

Activating bootloader

You can tell if a Glove80 half is in bootloader mode using the red LED next to the power switch:

  • Slow LED: in bootloader mode and connected via USB.
  • Fast LED: in bootloader mode but there is no USB connection.
  • Solid or no LED: not in bootloader mode.

Factory reset

See the user guide for more info.

Similar to booting into bootloader mode, but use R2 (numrow) instead of R3. Hold for ~5s powered on, before powering off again.

Activating reset

Note, the reset will not affect the saved keymap. Instead it wipes things like Bluetooth devices.

To re-pair the two halves: first power both on at the same time, then toggle RGB on/off with (Colemak) Magic+B or (Qwerty) Magic+T.

Bluetooth

See the user guide for more info.

Status

When tapping the Magic key, status indicators will appear on the Bluetooth keys.

White LED Connected (in use)
Green LED Connected (not in use)
Red LED Paired (not connected)
Purple LED Not paired

Pairing

  • First ensure the profile is unpaired (white status LED)
  • Select the profile
  • Pair using the host device's interface

Unpairing

Unpair the selected Bluetooth profile using the BT_Clear key (see magic layer above). Alternatively unpair all devices using BT_Clear_All.

Resources