Skip to content

Add MonsGeek M3 - #2575

Closed
LLuuDev wants to merge 2 commits into
the-via:masterfrom
LLuuDev:master
Closed

LLuuDev wants to merge 2 commits into
the-via:masterfrom
LLuuDev:master

Conversation

@LLuuDev

@LLuuDev LLuuDev commented Aug 28, 2026 •

Copy link
Copy Markdown

Description

Adds the V3 definition for the MonsGeek M3 (TKL ANSI, RGB Matrix).

  • VID/PID 0xFFFE / 0x0009, matrix 6x17, matching keyboards/monsgeek/m3/keyboard.json in QMK master
  • Uses qmk_rgb_matrix_keycodes (firmware uses RM_* keycodes)
  • Custom lighting menu lists only the RGB Matrix animations enabled in the firmware, in QMK's effect order
  • Formatted with the repository's Prettier config; npm run build passes locally against current master

QMK Pull Request

qmk/qmk_firmware#20542 (merged)

VIA Keymap Pull Request

The VIA keymap was merged into QMK with the keyboard itself (qmk/qmk_firmware#20542, before 0.26.0), so there is no separate userspace PR. It was carried over into VIA userspace main and is already there:

Checklist

  • The VIA support for this keyboard is MERGED in QMK master already (MANDATORY)
  • VIA keymap is MERGED in VIA userspace master already (MANDATORY)
  • The VIA definition follows the guide here: https://caniusevia.com/docs/layouts
  • I have a V3 JSON version for this keyboard definition.(MANDATORY)
  • I have used explicit QMK lighting keycode modules instead of the legacy qmk_lighting module.
  • I have formatted the JSON file to have consistent formatting with the rest of the repository.
  • I have tested this keyboard definition using VIA's "Design" tab.
  • I have tested this keyboard definition with firmware on a device.
  • I have assigned alpha keys and modifier keys with the correct colors.
  • The Vendor ID is not 0xFEED

LLuuDev

This comment was marked as low quality.

@LLuuDev

LLuuDev commented Sep 15, 2026

Copy link
Copy Markdown
Author

@Cipulot
Hi i want to know why this pr not merged
via keymap is already commited
so i cant find via keymap pr
https://github.com/the-via/qmk_userspace_via/tree/main/keyboards/monsgeek/m3/keymaps/via

- Replace legacy qmk_lighting with qmk_rgb_matrix_keycodes
- Set name to "MonsGeek M3"
- Brightness range 0-255 (firmware scales to RGB_MATRIX_MAXIMUM_BRIGHTNESS)
- Effect labels match the animations enabled in QMK (Solid Reactive Cross,
  Cycle Spiral typo)
- Drop RESET custom keycode, not implemented in firmware
- Spacebar uses alpha color
- Format with Prettier

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@LLuuDev LLuuDev closed this Sep 27, 2026
@LLuuDev LLuuDev mentioned this pull request Sep 27, 2026
10 tasks done
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant