qmk/modules/getreuer/palettefx
2025-03-18 22:27:19 +01:00
..
introspection.h import https://github.com/getreuer/qmk-modules.git 2025-03-18 22:27:19 +01:00
palettefx.c import https://github.com/getreuer/qmk-modules.git 2025-03-18 22:27:19 +01:00
palettefx.h import https://github.com/getreuer/qmk-modules.git 2025-03-18 22:27:19 +01:00
palettefx.inc import https://github.com/getreuer/qmk-modules.git 2025-03-18 22:27:19 +01:00
palettefx_default_config.h import https://github.com/getreuer/qmk-modules.git 2025-03-18 22:27:19 +01:00
qmk_module.json import https://github.com/getreuer/qmk-modules.git 2025-03-18 22:27:19 +01:00
README.md import https://github.com/getreuer/qmk-modules.git 2025-03-18 22:27:19 +01:00
rules.mk import https://github.com/getreuer/qmk-modules.git 2025-03-18 22:27:19 +01:00

PaletteFx

Modulegetreuer/palettefx
Version2025-03-07
MaintainerPascal Getreuer (@getreuer)
LicenseApache 2.0
Documentation https://getreuer.info/posts/keyboards/palettefx

This is a community module adaptation of PaletteFx for colorful palette-based RGB matrix effects. While most of QMK's built-in RGB matrix effects are based on a single color hue, sampling from a palette of colors allows for more personality. PaletteFx is a suite of custom effects for QMK's RGB Matrix in which the effect colors are sampled from a palette, aka color gradient or color map.

Add PaletteFx to your keymap

Add the following to your keymap.json:

{
    "modules": ["getreuer/palettefx"]
}

Then in your keymap folder, create a file rgb_matrix_user.inc with the following content, or if it already exists, add this as the first line:

#include "palettefx.inc"

Using PaletteFx

Selecting effects: PaletteFx effects are appended to the list of existing RGB Matrix effects. Use the usual RM_NEXT / RM_PREV keycodes to switch to the PaletteFx effects.

Selecting palettes: PaletteFx effects repurpose the RGB Matrix hue setting to select which palette to use. Use the hue keycodes RM_HUEU / RM_HUED to cycle through them. The ith palette corresponds to hue = RGB_MATRIX_HUE_STEP * i.

Further details

Optionally, you can define your own palettes and palette-based effects. See the PaletteFx documentation for details.