Forager ZMK Module

November 17, 2024 ยท View on GitHub

This is the ZMK module for the Forager keyboard.

ZMK Studio is supported and enabled by default.

Featuring the awesome zmk-rgbled-widget by caksoylar.

Usage

Add these lines to config/west.yml in your zmk-config repository:

manifest:
  remotes:
    - name: zmkfirmware
      url-base: https://github.com/zmkfirmware
    - name: carrefinho                            # <---
      url-base: https://github.com/carrefinho     # <---
    - name: caksoylar                             # <---
      url-base: https://github.com/caksoylar      # <---
  projects:
    - name: zmk
      remote: zmkfirmware
      revision: main
      import: app/west.yml
    - name: forager-zmk-module                    # <---
      remote: carrefinho                          # <---
      revision: main                              # <---
    - name: zmk-rgbled-widget                     # <---
      remote: caksoylar                           # <---
      revision: main                              # <---
  self:
    path: config

Then add forager_left and forager_right shields to your build.yaml:

---
include:
  - board: seeeduino_xiao_ble
    shield: forager_left rgbled_adapter
    snippet: studio-rpc-usb-uart
  - board: seeeduino_xiao_ble
    shield: forager_right rgbled_adapter

For more information on ZMK Modules and building locally, see the ZMK docs page on modules.

To customize behavior of the RGB LED, see rgbled-widget documentation.