Files
zsa_qmk_firmware/keyboards/zsa/moonlander
Florian Didron 16f203e2fb
Some checks failed
Build firmware / build-firmware (default) (push) Has been cancelled
Build firmware / build-firmware (oryx) (push) Has been cancelled
Unit Tests / test (push) Has been cancelled
Feat/navigators (#415)
* chore: move zsa/oryx module to a git submodule

* feat: port navigators to qmk25

* feat: adds a transmit and receive i2c method

* fix: navigator trackpad compile issue

* feat: improved trackpad scrolling, maybe?

* experiment: slight acceleration curve, more aggressive tap debounce

* fix: a better way to debounce taps

* feat: adds aim/turbo mode

* chore: tweak turbo/aim for the trackpad

* chore: remove navigator keys

* fix: #pragma once

* fix: address the i2c transmit and receive length on u16

* fix: change the packet size from 53 to 17

* chore: add more comments

* fix: remove the navigator_cpi from the eeprom config

* fix: remove the navigator_cpi from the eeprom config (ergodox)
2025-09-01 20:21:15 +07:00
..
2025-03-27 20:59:28 -07:00
2025-09-01 20:21:15 +07:00
2025-09-01 20:21:15 +07:00

Moonlander

Moonlander

A next-gen split, ergonomic keyboard with an active left side, USB type C, integrated wrist rest, and a thumb cluster that can move.

  • Keyboard Maintainer: drashna, ZSA
  • Hardware Supported: Moonlander MK 1 (STM32F303xC)
  • Hardware Availability: ZSA Store

Make example for this keyboard (after setting up your build environment):

make zsa/moonlander:default

Flashing example for this keyboard:

make zsa/moonlander:default:flash

See the build environment setup and the make instructions for more information. Brand new to QMK? Start with our Complete Newbs Guide.

Moonlander Customization

Indicator LEDs

There are 6 functions for enabling and disabling the LEDs on the top of the boards. The functions are ML_LED_1(bool) through ML_LED_6(bool), with the first LED being the left most LED on the left hand, and the sixth LED being the right most LED on the right side.

By default, the Indicator LEDs are used to indicate the layer state for the keyboard. If you wish to change this (and indicate caps/num/scroll lock status instead), then define MOONLANDER_USER_LEDS in your config.h file.

Oryx Configuration

To enable the features from Oryx (ZSAs Configurator), either compile the default keymap, or add #define ORYX_CONFIGURATOR to your config.h file.

This enables the front Indicator LEDs, and the TOGGLE_LAYER_COLOR keycode. The TOGGLE_LAYER_COLOR keycode toggles the customized LED map configured on Oryx.

RGB Matrix Features

If youre using the Smart LED (layer indication) feature from the Oryx Configurator, you want to make sure that you enable these options by adding #define ORYX_CONFIGURATOR to your keymaps config.h.

This changes the RGB_TOG keycode so that it will toggle the lights on and off, in a way that will allow the Smart LEDs to continue to work, even with the rest of the LEDs turned off.

Additionally, a new keycode has been added to toggle the Smart LEDs. Use TOGGLE_LAYER_COLOR, if you arent already.

Detecting split / Gaming mode

To make it extra gaming friendly, you can configure what happens when you disconnect the right half. This is especially useful when using gaming unfriendly layers or layouts (e.g. home row mods, dvorak, colemak).

Example for enabling a specific layer while right side is disconnected:

void housekeeping_task_user(void) {
    if (!is_transport_connected()) {
        // set layer
    }
}