import { _ as _export_sfc, c as createElementBlock, I as createVNode, w as withCtx, a8 as createStaticVNode, D as resolveComponent, o as openBlock, l as createBaseVNode, a as createTextVNode } from "./chunks/framework.Cauyuiy8.js";
const __pageData = JSON.parse('{"title":"QMK Breaking Changes - 2025 May 25 Changelog","description":"","frontmatter":{},"headers":[],"relativePath":"ChangeLog/20250525.md","filePath":"ChangeLog/20250525.md","lastUpdated":null}');
const _sfc_main = { name: "ChangeLog/20250525.md" };
const _hoisted_1 = /* @__PURE__ */ createStaticVNode('QMK Breaking Changes - 2025 May 25 Changelog
Notable Features
Adds Flow Tap as a core tap-hold option to disable HRMs during fast typing, aka Global Quick Tap, Require Prior Idle.
Flow Tap modifies mod-tap MT and layer-tap LT keys such that when pressed within a short timeout of the preceding key, the tapping behavior is triggered. It basically disables the hold behavior during fast typing, creating a "flow of taps." It also helps to reduce the input lag of tap-hold keys during fast typing, since the tapped behavior is sent immediately.
See the Flow Tap documentation for more information.
Version 1.1.1 introduces support for module defined RGB matrix effects and indicator callbacks, as well as pointing and layer state callbacks.
See the Community Modules documentation for more information, including the full list of available hooks.
Changes Requiring User Action
Updated Keyboard Codebases
| Old Keyboard Name | New Keyboard Name |
|---|
| chew | chew/split |
| deemen17/de60fs | deemen17/de60/r1 |
| keyten/kt60hs_t | keyten/kt60hs_t/v1 |
| plywrks/ply8x | plywrks/ply8x/solder |
| rookiebwoy/late9/rev1 | ivndbt/late9/rev1 |
| rookiebwoy/neopad/rev1 | ivndbt/neopad/rev1 |
Deprecation Notices
In line with the notice period, deprecation notices for larger items are listed here.
Deprecation of qmk generate-compilation-database (#25237)
This command has been deprecated as it cannot take into account configurables such as converters or environment variables normally specified on the command line; please use the --compiledb flag with qmk compile instead.
Deprecation of usb.force_nkro/FORCE_NKRO (#25262)
Unpicking the assumption that only USB can do NKRO, forcing of NKRO on every boot has been deprecated. As this setting persists, it produces unnecessary user confusion when the various NKRO keycodes (for example NK_TOGG) do not behave as expected.
The new defaults can be configured in the following ways:
', 19);
const _hoisted_20 = /* @__PURE__ */ createBaseVNode("div", { class: "language-json vp-adaptive-theme" }, [
/* @__PURE__ */ createBaseVNode("button", {
title: "Copy Code",
class: "copy"
}),
/* @__PURE__ */ createBaseVNode("span", { class: "lang" }, "json"),
/* @__PURE__ */ createBaseVNode("pre", { class: "shiki shiki-themes github-light github-dark has-focused-lines vp-code" }, [
/* @__PURE__ */ createBaseVNode("code", null, [
/* @__PURE__ */ createBaseVNode("span", { class: "line" }, [
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, "{")
]),
/* @__PURE__ */ createTextVNode("\n"),
/* @__PURE__ */ createBaseVNode("span", { class: "line has-focus" }, [
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#005CC5", "--shiki-dark": "#79B8FF" } }, ' "host"'),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, ": { ")
]),
/* @__PURE__ */ createTextVNode("\n"),
/* @__PURE__ */ createBaseVNode("span", { class: "line has-focus" }, [
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#005CC5", "--shiki-dark": "#79B8FF" } }, ' "default"'),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, ": { ")
]),
/* @__PURE__ */ createTextVNode("\n"),
/* @__PURE__ */ createBaseVNode("span", { class: "line has-focus" }, [
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#005CC5", "--shiki-dark": "#79B8FF" } }, ' "nkro"'),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, ": "),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#005CC5", "--shiki-dark": "#79B8FF" } }, "true")
]),
/* @__PURE__ */ createTextVNode("\n"),
/* @__PURE__ */ createBaseVNode("span", { class: "line has-focus" }, [
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, " } ")
]),
/* @__PURE__ */ createTextVNode("\n"),
/* @__PURE__ */ createBaseVNode("span", { class: "line has-focus" }, [
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, " } ")
]),
/* @__PURE__ */ createTextVNode("\n"),
/* @__PURE__ */ createBaseVNode("span", { class: "line" }, [
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, "}")
])
])
])
], -1);
const _hoisted_21 = /* @__PURE__ */ createBaseVNode("div", { class: "language-json vp-adaptive-theme" }, [
/* @__PURE__ */ createBaseVNode("button", {
title: "Copy Code",
class: "copy"
}),
/* @__PURE__ */ createBaseVNode("span", { class: "lang" }, "json"),
/* @__PURE__ */ createBaseVNode("pre", { class: "shiki shiki-themes github-light github-dark has-focused-lines vp-code" }, [
/* @__PURE__ */ createBaseVNode("code", null, [
/* @__PURE__ */ createBaseVNode("span", { class: "line" }, [
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, "{")
]),
/* @__PURE__ */ createTextVNode("\n"),
/* @__PURE__ */ createBaseVNode("span", { class: "line" }, [
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#005CC5", "--shiki-dark": "#79B8FF" } }, ' "config"'),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, ": {")
]),
/* @__PURE__ */ createTextVNode("\n"),
/* @__PURE__ */ createBaseVNode("span", { class: "line has-focus" }, [
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#005CC5", "--shiki-dark": "#79B8FF" } }, ' "host"'),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, ": { ")
]),
/* @__PURE__ */ createTextVNode("\n"),
/* @__PURE__ */ createBaseVNode("span", { class: "line has-focus" }, [
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#005CC5", "--shiki-dark": "#79B8FF" } }, ' "default"'),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, ": { ")
]),
/* @__PURE__ */ createTextVNode("\n"),
/* @__PURE__ */ createBaseVNode("span", { class: "line has-focus" }, [
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#005CC5", "--shiki-dark": "#79B8FF" } }, ' "nkro"'),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, ": "),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#005CC5", "--shiki-dark": "#79B8FF" } }, "true")
]),
/* @__PURE__ */ createTextVNode("\n"),
/* @__PURE__ */ createBaseVNode("span", { class: "line has-focus" }, [
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, " } ")
]),
/* @__PURE__ */ createTextVNode("\n"),
/* @__PURE__ */ createBaseVNode("span", { class: "line has-focus" }, [
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, " } ")
]),
/* @__PURE__ */ createTextVNode("\n"),
/* @__PURE__ */ createBaseVNode("span", { class: "line" }, [
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, " }")
]),
/* @__PURE__ */ createTextVNode("\n"),
/* @__PURE__ */ createBaseVNode("span", { class: "line" }, [
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, "}")
])
])
])
], -1);
const _hoisted_22 = /* @__PURE__ */ createBaseVNode("div", { class: "language-c vp-adaptive-theme" }, [
/* @__PURE__ */ createBaseVNode("button", {
title: "Copy Code",
class: "copy"
}),
/* @__PURE__ */ createBaseVNode("span", { class: "lang" }, "c"),
/* @__PURE__ */ createBaseVNode("pre", { class: "shiki shiki-themes github-light github-dark has-focused-lines vp-code" }, [
/* @__PURE__ */ createBaseVNode("code", null, [
/* @__PURE__ */ createBaseVNode("span", { class: "line" }, [
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#D73A49", "--shiki-dark": "#F97583" } }, "#pragma"),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#6F42C1", "--shiki-dark": "#B392F0" } }, " once")
]),
/* @__PURE__ */ createTextVNode("\n"),
/* @__PURE__ */ createBaseVNode("span", { class: "line" }),
/* @__PURE__ */ createTextVNode("\n"),
/* @__PURE__ */ createBaseVNode("span", { class: "line has-focus" }, [
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#D73A49", "--shiki-dark": "#F97583" } }, "#define"),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#6F42C1", "--shiki-dark": "#B392F0" } }, " NKRO_DEFAULT_ON"),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#005CC5", "--shiki-dark": "#79B8FF" } }, " true")
])
])
])
], -1);
const _hoisted_23 = /* @__PURE__ */ createStaticVNode('The deprecated options will be removed in a future breaking changes cycle.
CTPC/CONVERT_TO_PROTON_C removal (#25111)
Deprecated build options CTPC and CONVERT_TO_PROTON_C have been removed. Users should of these should migrate to CONVERT_TO=proton_c.
see the Converters Feature documentation for more information.
DEFAULT_FOLDER removal (#23281)
DEFAULT_FOLDER was originally introduced to work around limitations within the build system. Parent folders containing common configuration would create invalid build targets.
With the introduction of keyboard.json as a configuration file, the build system now has a consistent method to detect build targets. The DEFAULT_FOLDER functionality is now redundant and the intent is for rules.mk to become pure configuration.
Backwards compatibility of build targets has been maintained where possible.
Converter Pin Compatible updates (#20330)
Converter support will be further limited to only function if a keyboard declares that is is compatible.
This can be configured in the following ways:
', 11);
const _hoisted_34 = /* @__PURE__ */ createBaseVNode("div", { class: "language-json vp-adaptive-theme" }, [
/* @__PURE__ */ createBaseVNode("button", {
title: "Copy Code",
class: "copy"
}),
/* @__PURE__ */ createBaseVNode("span", { class: "lang" }, "json"),
/* @__PURE__ */ createBaseVNode("pre", { class: "shiki shiki-themes github-light github-dark has-focused-lines vp-code" }, [
/* @__PURE__ */ createBaseVNode("code", null, [
/* @__PURE__ */ createBaseVNode("span", { class: "line" }, [
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, "{")
]),
/* @__PURE__ */ createTextVNode("\n"),
/* @__PURE__ */ createBaseVNode("span", { class: "line has-focus" }, [
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#005CC5", "--shiki-dark": "#79B8FF" } }, ' "development_board"'),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, ": "),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#032F62", "--shiki-dark": "#9ECBFF" } }, '"promicro"'),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, ", ")
]),
/* @__PURE__ */ createTextVNode("\n"),
/* @__PURE__ */ createBaseVNode("span", { class: "line" }, [
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, "}")
])
])
])
], -1);
const _hoisted_35 = /* @__PURE__ */ createBaseVNode("div", { class: "language-make vp-adaptive-theme" }, [
/* @__PURE__ */ createBaseVNode("button", {
title: "Copy Code",
class: "copy"
}),
/* @__PURE__ */ createBaseVNode("span", { class: "lang" }, "make"),
/* @__PURE__ */ createBaseVNode("pre", { class: "shiki shiki-themes github-light github-dark vp-code" }, [
/* @__PURE__ */ createBaseVNode("code", null, [
/* @__PURE__ */ createBaseVNode("span", { class: "line" }, [
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, "PIN_COMPATIBLE = promicro")
])
])
])
], -1);
const _hoisted_36 = /* @__PURE__ */ createStaticVNode('see the Converters Feature documentation for more information.
Deprecation of encoder_update_{kb|user}
These callbacks are now considered end-of-life and will be removed over the next breaking changes cycle, ending August 2025. PRs containing these callbacks will be asked to change to use encoder mapping.
ENCODER_MAP_ENABLE will subsequently be changed to "default-on" when encoders are enabled, and future breaking changes cycles will remove this flag entirely.
To migrate usage of encoder_update_user to encoder map you'll need to handle all of the following changes in your keymap.c:
', 5);
const _hoisted_41 = /* @__PURE__ */ createBaseVNode("p", null, "Define new keycodes:", -1);
const _hoisted_42 = /* @__PURE__ */ createBaseVNode("div", { class: "language-c vp-adaptive-theme" }, [
/* @__PURE__ */ createBaseVNode("button", {
title: "Copy Code",
class: "copy"
}),
/* @__PURE__ */ createBaseVNode("span", { class: "lang" }, "c"),
/* @__PURE__ */ createBaseVNode("pre", { class: "shiki shiki-themes github-light github-dark has-focused-lines vp-code" }, [
/* @__PURE__ */ createBaseVNode("code", null, [
/* @__PURE__ */ createBaseVNode("span", { class: "line" }, [
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#D73A49", "--shiki-dark": "#F97583" } }, "enum"),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, " {")
]),
/* @__PURE__ */ createTextVNode("\n"),
/* @__PURE__ */ createBaseVNode("span", { class: "line has-focus" }, [
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, " MY_ENCODER_LEFT "),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#D73A49", "--shiki-dark": "#F97583" } }, "="),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, " QK_USER,")
]),
/* @__PURE__ */ createTextVNode("\n"),
/* @__PURE__ */ createBaseVNode("span", { class: "line has-focus" }, [
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, " MY_ENCODER_RIGHT,")
]),
/* @__PURE__ */ createTextVNode("\n"),
/* @__PURE__ */ createBaseVNode("span", { class: "line" }, [
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, "};")
])
])
])
], -1);
const _hoisted_43 = /* @__PURE__ */ createBaseVNode("p", null, "Add the keycodes to a new encoder map (optionally with transparent layers above, if you want identical functionality of layer-independence):", -1);
const _hoisted_44 = /* @__PURE__ */ createBaseVNode("div", { class: "language-c vp-adaptive-theme" }, [
/* @__PURE__ */ createBaseVNode("button", {
title: "Copy Code",
class: "copy"
}),
/* @__PURE__ */ createBaseVNode("span", { class: "lang" }, "c"),
/* @__PURE__ */ createBaseVNode("pre", { class: "shiki shiki-themes github-light github-dark has-focused-lines vp-code" }, [
/* @__PURE__ */ createBaseVNode("code", null, [
/* @__PURE__ */ createBaseVNode("span", { class: "line" }, [
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#D73A49", "--shiki-dark": "#F97583" } }, "#if"),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#D73A49", "--shiki-dark": "#F97583" } }, " defined"),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, "("),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#6F42C1", "--shiki-dark": "#B392F0" } }, "ENCODER_MAP_ENABLE"),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, ")")
]),
/* @__PURE__ */ createTextVNode("\n"),
/* @__PURE__ */ createBaseVNode("span", { class: "line" }, [
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#D73A49", "--shiki-dark": "#F97583" } }, "const"),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#D73A49", "--shiki-dark": "#F97583" } }, " uint16_t"),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, " PROGMEM encoder_map"),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#D73A49", "--shiki-dark": "#F97583" } }, "[]"),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, "[NUM_ENCODERS][NUM_DIRECTIONS] "),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#D73A49", "--shiki-dark": "#F97583" } }, "="),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, " {")
]),
/* @__PURE__ */ createTextVNode("\n"),
/* @__PURE__ */ createBaseVNode("span", { class: "line has-focus" }, [
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, " ["),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#005CC5", "--shiki-dark": "#79B8FF" } }, "0"),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, "] "),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#D73A49", "--shiki-dark": "#F97583" } }, "="),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, " { "),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#6F42C1", "--shiki-dark": "#B392F0" } }, "ENCODER_CCW_CW"),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, "(MY_ENCODER_LEFT, MY_ENCODER_RIGHT) },")
]),
/* @__PURE__ */ createTextVNode("\n"),
/* @__PURE__ */ createBaseVNode("span", { class: "line has-focus" }, [
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, " ["),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#005CC5", "--shiki-dark": "#79B8FF" } }, "1"),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, "] "),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#D73A49", "--shiki-dark": "#F97583" } }, "="),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, " { "),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#6F42C1", "--shiki-dark": "#B392F0" } }, "ENCODER_CCW_CW"),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, "(KC_TRNS, KC_TRNS) },")
]),
/* @__PURE__ */ createTextVNode("\n"),
/* @__PURE__ */ createBaseVNode("span", { class: "line has-focus" }, [
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, " ["),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#005CC5", "--shiki-dark": "#79B8FF" } }, "2"),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, "] "),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#D73A49", "--shiki-dark": "#F97583" } }, "="),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, " { "),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#6F42C1", "--shiki-dark": "#B392F0" } }, "ENCODER_CCW_CW"),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, "(KC_TRNS, KC_TRNS) },")
]),
/* @__PURE__ */ createTextVNode("\n"),
/* @__PURE__ */ createBaseVNode("span", { class: "line has-focus" }, [
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, " ["),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#005CC5", "--shiki-dark": "#79B8FF" } }, "3"),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, "] "),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#D73A49", "--shiki-dark": "#F97583" } }, "="),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, " { "),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#6F42C1", "--shiki-dark": "#B392F0" } }, "ENCODER_CCW_CW"),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, "(KC_TRNS, KC_TRNS) },")
]),
/* @__PURE__ */ createTextVNode("\n"),
/* @__PURE__ */ createBaseVNode("span", { class: "line" }, [
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, "};")
]),
/* @__PURE__ */ createTextVNode("\n"),
/* @__PURE__ */ createBaseVNode("span", { class: "line" }, [
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#D73A49", "--shiki-dark": "#F97583" } }, "#endif")
])
])
])
], -1);
const _hoisted_45 = /* @__PURE__ */ createBaseVNode("p", null, [
/* @__PURE__ */ createTextVNode("Handle the new keycodes within "),
/* @__PURE__ */ createBaseVNode("code", null, "process_record_user"),
/* @__PURE__ */ createTextVNode(", much like any other keycode in your keymap:")
], -1);
const _hoisted_46 = /* @__PURE__ */ createBaseVNode("div", { class: "language-c vp-adaptive-theme" }, [
/* @__PURE__ */ createBaseVNode("button", {
title: "Copy Code",
class: "copy"
}),
/* @__PURE__ */ createBaseVNode("span", { class: "lang" }, "c"),
/* @__PURE__ */ createBaseVNode("pre", { class: "shiki shiki-themes github-light github-dark has-focused-lines vp-code" }, [
/* @__PURE__ */ createBaseVNode("code", null, [
/* @__PURE__ */ createBaseVNode("span", { class: "line" }, [
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#D73A49", "--shiki-dark": "#F97583" } }, "bool"),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#6F42C1", "--shiki-dark": "#B392F0" } }, " process_record_user"),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, "("),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#D73A49", "--shiki-dark": "#F97583" } }, "uint16_t"),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#E36209", "--shiki-dark": "#FFAB70" } }, " keycode"),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, ", "),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#005CC5", "--shiki-dark": "#79B8FF" } }, "keyrecord_t"),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#D73A49", "--shiki-dark": "#F97583" } }, " *"),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#E36209", "--shiki-dark": "#FFAB70" } }, "record"),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, ") {")
]),
/* @__PURE__ */ createTextVNode("\n"),
/* @__PURE__ */ createBaseVNode("span", { class: "line" }, [
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#D73A49", "--shiki-dark": "#F97583" } }, " switch"),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, " (keycode) {")
]),
/* @__PURE__ */ createTextVNode("\n"),
/* @__PURE__ */ createBaseVNode("span", { class: "line has-focus" }, [
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#D73A49", "--shiki-dark": "#F97583" } }, " case"),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, " MY_ENCODER_LEFT:")
]),
/* @__PURE__ */ createTextVNode("\n"),
/* @__PURE__ */ createBaseVNode("span", { class: "line has-focus" }, [
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#D73A49", "--shiki-dark": "#F97583" } }, " if"),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, " (record"),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#D73A49", "--shiki-dark": "#F97583" } }, "->"),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, "event.pressed) {")
]),
/* @__PURE__ */ createTextVNode("\n"),
/* @__PURE__ */ createBaseVNode("span", { class: "line has-focus" }, [
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#6A737D", "--shiki-dark": "#6A737D" } }, " // Add the same code you had in your `encoder_update_user` for the left-rotation code")
]),
/* @__PURE__ */ createTextVNode("\n"),
/* @__PURE__ */ createBaseVNode("span", { class: "line has-focus" }, [
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, " }")
]),
/* @__PURE__ */ createTextVNode("\n"),
/* @__PURE__ */ createBaseVNode("span", { class: "line has-focus" }, [
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#D73A49", "--shiki-dark": "#F97583" } }, " return"),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#005CC5", "--shiki-dark": "#79B8FF" } }, " false"),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, ";"),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#6A737D", "--shiki-dark": "#6A737D" } }, " // Skip all further processing of this keycode")
]),
/* @__PURE__ */ createTextVNode("\n"),
/* @__PURE__ */ createBaseVNode("span", { class: "line has-focus" }, [
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#D73A49", "--shiki-dark": "#F97583" } }, " case"),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, " MY_ENCODER_RIGHT:")
]),
/* @__PURE__ */ createTextVNode("\n"),
/* @__PURE__ */ createBaseVNode("span", { class: "line has-focus" }, [
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#D73A49", "--shiki-dark": "#F97583" } }, " if"),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, " (record"),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#D73A49", "--shiki-dark": "#F97583" } }, "->"),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, "event.pressed) {")
]),
/* @__PURE__ */ createTextVNode("\n"),
/* @__PURE__ */ createBaseVNode("span", { class: "line has-focus" }, [
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#6A737D", "--shiki-dark": "#6A737D" } }, " // Add the same code you had in your `encoder_update_user` for the right-rotation code")
]),
/* @__PURE__ */ createTextVNode("\n"),
/* @__PURE__ */ createBaseVNode("span", { class: "line has-focus" }, [
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, " }")
]),
/* @__PURE__ */ createTextVNode("\n"),
/* @__PURE__ */ createBaseVNode("span", { class: "line has-focus" }, [
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#D73A49", "--shiki-dark": "#F97583" } }, " return"),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#005CC5", "--shiki-dark": "#79B8FF" } }, " false"),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, ";"),
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#6A737D", "--shiki-dark": "#6A737D" } }, " // Skip all further processing of this keycode")
]),
/* @__PURE__ */ createTextVNode("\n"),
/* @__PURE__ */ createBaseVNode("span", { class: "line" }, [
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, " }")
]),
/* @__PURE__ */ createTextVNode("\n"),
/* @__PURE__ */ createBaseVNode("span", { class: "line" }, [
/* @__PURE__ */ createBaseVNode("span", { style: { "--shiki-light": "#24292E", "--shiki-dark": "#E1E4E8" } }, "}")
])
])
])
], -1);
const _hoisted_47 = /* @__PURE__ */ createBaseVNode("p", null, [
/* @__PURE__ */ createTextVNode("Remove your implementation of "),
/* @__PURE__ */ createBaseVNode("code", null, "encoder_update_user"),
/* @__PURE__ */ createTextVNode(" from your "),
/* @__PURE__ */ createBaseVNode("code", null, "keymap.c"),
/* @__PURE__ */ createTextVNode(".")
], -1);
const _hoisted_48 = /* @__PURE__ */ createStaticVNode('If your board has multiple encoders, each encoder will need its own pair of keycodes defined as per above.
Full changelist
Core:
- Non-volatile memory data repository pattern (#24356)
- High resolution scrolling (without feature report parsing) (#24423)
- Implement battery level interface (#24666)
- get_keycode_string(): function to format keycodes as strings, for more readable debug logging. (#24787)
- [Cleanup] Handling of optional
*.mk files (#24952) - Add EOL to non-keyboard files (#24990)
- use
keycode_string in unit tests (#25042) - Add additional hooks for Community modules (#25050)
- Remove
CTPC/CONVERT_TO_PROTON_C options (#25111) - Flow Tap tap-hold option to disable HRMs during fast typing (aka Global Quick Tap, Require Prior Idle). (#25125)
- Remove
bluefruit_le_read_battery_voltage function (#25129) - Avoid duplication in generated community modules
rules.mk (#25135) - [chore]: move and rename mouse/scroll min/max defines (#25141)
- Ignore the Layer Lock key in Repeat Key and Caps Word. (#25171)
- Allow for disabling EEPROM subsystem entirely. (#25173)
- Implement connection keycode logic (#25176)
- Align ChibiOS
USB_WAIT_FOR_ENUMERATION implementation (#25184) - Enable community modules to define LED matrix and RGB matrix effects. (#25187)
- Bind Bluetooth driver to
host_driver_t (#25199) - Enhance Flow Tap to work better for rolls over multiple tap-hold keys. (#25200)
- Remove force disable of NKRO when Bluetooth enabled (#25201)
- [New Feature/Core] New RGB Matrix Animation "Starlight Smooth" (#25203)
- Add battery changed callbacks (#25207)
- Generate versions to keycode headers (#25219)
- Add raw_hid support to host driver (#25255)
- Deprecate
usb.force_nkro/FORCE_NKRO (#25262) - [Chore] use {rgblight,rgb_matrix}_hsv_to_rgb overrides (#25271)
- Remove outdated
nix support due to bit-rot. (#25280)
CLI:
- Align to latest CLI dependencies (#24553)
- Exclude external userspace from lint checking (#24680)
- [Modules] Provide access to current path in
rules.mk. (#25061) - Add "license" field to Community Module JSON schema. (#25085)
- Prompt for converter when creating new keymap (#25116)
- Extend lint checks to reject duplication of defaults (#25149)
- Add lint warning for empty url (#25182)
- Deprecate
qmk generate-compilation-database. (#25237) - Use relative paths for schemas, instead of $id. Enables VScode validation. (#25251)
Submodule updates:
- STM32G0x1 support (#24301)
- Update develop branch to Pico SDK 1.5.1 (#25178)
- Add
compiler_support.h (#25274)
Keyboards:
- add 75_(ansi|iso) Community Layouts to mechlovin/olly/octagon (#22459)
- Add the plywrks ply8x hotswap variant. (#23558)
- Add Community Layout support to daskeyboard4 (#23884)
- New standard layout for Savage65 (65_ansi_blocker_tsangan_split_bs) (#24690)
- Add Icebreaker keyboard (#24723)
- Update Tractyl Manuform and add F405 (weact) variant (#24764)
- Chew folders (#24785)
- modelh: add prerequisites for via support (#24932)
- Only configure
STM32_HSECLK within board.h (#25001) - Allow LVGL onekey keymap to be able compile for other board (#25005)
- Remove Sofle
rgb_default keymap & tidy readme's (#25010) - Migrate remaining
split.soft_serial_pin to split.serial.pin (#25046) - Update keymap for keycult 1800 (#25070)
- Add kt60HS-T v2 PCB (#25080)
- Refactor Deemen17 Works DE60 (#25088)
- Rookiebwoy to ivndbt (#25142)
- Remove duplication of RGB Matrix defaults (#25146)
- ymdk/id75/rp2040 (#25157)
- Remove duplication of RGBLight defaults (#25169)
- Remove empty
url fields (#25181) - Remove more duplication of defaults (#25189)
- Remove
"console":false from keyboards (#25190) - Remove
"command":false from keyboards (#25193) - Remove redundant keyboard headers (#25208)
- Add debounce to duplicated defaults check (#25246)
- Remove duplicate of SPI default config from keyboards (#25266)
- Resolve miscellaneous keyboard lint warnings (#25268)
- Configure boards to use development_board - 0-9 (#25287)
- Configure boards to use development_board - UVWXYZ (#25288)
- Configure boards to use development_board - S (#25293)
- Configure boards to use development_board - T (#25294)
Keyboard fixes:
- Fix
boardsource/beiwagon RGB Matrix coordinates (#25018) - amptrics/0422 - Prevent OOB in
update_leds_for_layer (#25209) - salicylic_acid3/getta25 - Fix oled keymap (#25295)
Others:
- Require 'x'/'y' properties for LED/RGB Matrix layout (#24997)
- Align
new-keyboard template to current standards (#25191)
Bugs:
- Fix OS_DETECTION_KEYBOARD_RESET (#25015)
- Fix outdated GPIO control function usage (#25060)
- Cater for use of
__errno_r() in ChibiOS syscalls.c with newer picolibc revisions (#25121) - Fixup eeconfig lighting reset. (#25166)
- Fix for Flow Tap: fix handling of distinct taps and timer updates. (#25175)
- Minimise force-included files (#25194)
- Ensure
qmk_userspace_paths maintains detected order (#25204) - Resolve alias for
qmk new-keymap keyboard prompts (#25210) - gcc15 AVR compilation fixes (#25238)
- Fix typos introduced by PR #25050 (#25250)
- Fix Wear Leveling compilation (#25254)
- Remove more USB only branches from NKRO handling (#25263)
- [Fix] lib8tion: enable fixed scale8 and blend functions (#25272)
- Fix tap_hold code blocks (#25298)
', 16);
function _sfc_render(_ctx, _cache, $props, $setup, $data, $options) {
const _component_PluginTabsTab = resolveComponent("PluginTabsTab");
const _component_PluginTabs = resolveComponent("PluginTabs");
return openBlock(), createElementBlock("div", null, [
_hoisted_1,
createVNode(_component_PluginTabs, null, {
default: withCtx(() => [
createVNode(_component_PluginTabsTab, { label: "keyboard.json" }, {
default: withCtx(() => [
_hoisted_20
]),
_: 1
}),
createVNode(_component_PluginTabsTab, { label: "keymap.json" }, {
default: withCtx(() => [
_hoisted_21
]),
_: 1
}),
createVNode(_component_PluginTabsTab, { label: "config.h" }, {
default: withCtx(() => [
_hoisted_22
]),
_: 1
})
]),
_: 1
}),
_hoisted_23,
createVNode(_component_PluginTabs, null, {
default: withCtx(() => [
createVNode(_component_PluginTabsTab, { label: "keyboard.json" }, {
default: withCtx(() => [
_hoisted_34
]),
_: 1
}),
createVNode(_component_PluginTabsTab, { label: "rules.mk" }, {
default: withCtx(() => [
_hoisted_35
]),
_: 1
})
]),
_: 1
}),
_hoisted_36,
createVNode(_component_PluginTabs, null, {
default: withCtx(() => [
createVNode(_component_PluginTabsTab, { label: "1. Add keycode definitions" }, {
default: withCtx(() => [
_hoisted_41,
_hoisted_42
]),
_: 1
}),
createVNode(_component_PluginTabsTab, { label: "2. Add encoder mapping" }, {
default: withCtx(() => [
_hoisted_43,
_hoisted_44
]),
_: 1
}),
createVNode(_component_PluginTabsTab, { label: "3. Add keycode processing" }, {
default: withCtx(() => [
_hoisted_45,
_hoisted_46
]),
_: 1
}),
createVNode(_component_PluginTabsTab, { label: "4. Remove old code" }, {
default: withCtx(() => [
_hoisted_47
]),
_: 1
})
]),
_: 1
}),
_hoisted_48
]);
}
const _20250525 = /* @__PURE__ */ _export_sfc(_sfc_main, [["render", _sfc_render]]);
export {
__pageData,
_20250525 as default
};