docs/ChangeLog/20250525.md
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.
1.1.1 (#25050, #25187)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.
| 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 |
In line with the notice period, deprecation notices for larger items are listed here.
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.
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:
:::::tabs
==== keyboard.json
{
"host": { // [!code focus]
"default": { // [!code focus]
"nkro": true // [!code focus]
} // [!code focus]
} // [!code focus]
}
==== keymap.json
{
"config": {
"host": { // [!code focus]
"default": { // [!code focus]
"nkro": true // [!code focus]
} // [!code focus]
} // [!code focus]
}
}
==== config.h
#pragma once
#define NKRO_DEFAULT_ON true // [!code focus]
:::::
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.
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:
:::::tabs
==== keyboard.json
{
"development_board": "promicro", // [!code focus]
}
==== rules.mk
PIN_COMPATIBLE = promicro
:::::
see the Converters Feature documentation for more information.
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:
:::::tabs
=== 1. Add keycode definitions
Define new keycodes:
enum {
MY_ENCODER_LEFT = QK_USER, // [!code focus]
MY_ENCODER_RIGHT, // [!code focus]
};
=== 2. Add encoder mapping
Add the keycodes to a new encoder map (optionally with transparent layers above, if you want identical functionality of layer-independence):
#if defined(ENCODER_MAP_ENABLE)
const uint16_t PROGMEM encoder_map[][NUM_ENCODERS][NUM_DIRECTIONS] = {
[0] = { ENCODER_CCW_CW(MY_ENCODER_LEFT, MY_ENCODER_RIGHT) }, // [!code focus]
[1] = { ENCODER_CCW_CW(KC_TRNS, KC_TRNS) }, // [!code focus]
[2] = { ENCODER_CCW_CW(KC_TRNS, KC_TRNS) }, // [!code focus]
[3] = { ENCODER_CCW_CW(KC_TRNS, KC_TRNS) }, // [!code focus]
};
#endif
=== 3. Add keycode processing
Handle the new keycodes within process_record_user, much like any other keycode in your keymap:
bool process_record_user(uint16_t keycode, keyrecord_t *record) {
switch (keycode) {
case MY_ENCODER_LEFT: // [!code focus]
if (record->event.pressed) { // [!code focus]
// Add the same code you had in your `encoder_update_user` for the left-rotation code // [!code focus]
} // [!code focus]
return false; // Skip all further processing of this keycode // [!code focus]
case MY_ENCODER_RIGHT: // [!code focus]
if (record->event.pressed) { // [!code focus]
// Add the same code you had in your `encoder_update_user` for the right-rotation code // [!code focus]
} // [!code focus]
return false; // Skip all further processing of this keycode // [!code focus]
}
}
=== 4. Remove old code
Remove your implementation of encoder_update_user from your keymap.c.
::::::
If your board has multiple encoders, each encoder will need its own pair of keycodes defined as per above.
Core:
*.mk files (#24952)keycode_string in unit tests (#25042)CTPC/CONVERT_TO_PROTON_C options (#25111)bluefruit_le_read_battery_voltage function (#25129)rules.mk (#25135)USB_WAIT_FOR_ENUMERATION implementation (#25184)host_driver_t (#25199)usb.force_nkro/FORCE_NKRO (#25262)nix support due to bit-rot. (#25280)CLI:
rules.mk. (#25061)qmk generate-compilation-database. (#25237)Submodule updates:
compiler_support.h (#25274)Keyboards:
STM32_HSECLK within board.h (#25001)rgb_default keymap & tidy readme's (#25010)split.soft_serial_pin to split.serial.pin (#25046)url fields (#25181)"console":false from keyboards (#25190)"command":false from keyboards (#25193)Keyboard fixes:
boardsource/beiwagon RGB Matrix coordinates (#25018)update_leds_for_layer (#25209)Others:
new-keyboard template to current standards (#25191)Bugs:
__errno_r() in ChibiOS syscalls.c with newer picolibc revisions (#25121)qmk_userspace_paths maintains detected order (#25204)qmk new-keymap keyboard prompts (#25210)