NuPhy Air75 V2 — keyboard config & RGB control

VIA keymap and RGB control scripts for the NuPhy Air75 V2 (VID 0x19F5, PID 0x3246).

Files

• config/nuphy-air75-v2-via3.json — keyboard definition for VIA
• config/martinciu.layout.json — personal keymap (8 layers, macros)
• config/presets.json — named RGB presets
• nuphy-rgb.py — command-line RGB control script

RGB control

nuphy-rgb.py uses the VIA HID protocol directly. Requires hidapi (brew install hidapi) and Python via uv.

uv run nuphy-rgb.py effect <0-40>          # set lighting effect
uv run nuphy-rgb.py color <hue> <sat>      # hue/sat 0-255 each
uv run nuphy-rgb.py brightness <0-255>
uv run nuphy-rgb.py speed <0-255>          # effect animation speed
uv run nuphy-rgb.py rgb <r> <g> <b>        # set color by RGB values (0-255 each)
uv run nuphy-rgb.py rgb <#rrggbb>          # set color by hex
uv run nuphy-rgb.py effects                # list all effects (⌨ marks interactive ones)
uv run nuphy-rgb.py read                   # read effect, color, brightness, speed from keyboard
uv run nuphy-rgb.py save                   # persist to EEPROM

read prints the current effect index, hue/sat, brightness, and speed — useful for capturing a state set via VIA before saving it as a preset with preset-save.

Settings revert on power cycle unless you run save. Chain commands:

uv run nuphy-rgb.py effect 1 && uv run nuphy-rgb.py color 170 255 && uv run nuphy-rgb.py save

Presets

Named snapshots stored in config/presets.json:

uv run nuphy-rgb.py preset <name>       # apply preset + save to EEPROM
uv run nuphy-rgb.py preset-save <name>  # capture current keyboard state as preset
uv run nuphy-rgb.py preset-list         # list all presets

Current presets (config/presets.json):

Name	Effect	Hue	Sat	Brightness
warm-white	1 (Solid Color)	0	195	202

Examples

Solid warm white (hue=0, sat=195, brightness=202):

uv run nuphy-rgb.py preset warm-white

Typing heatmap:

uv run nuphy-rgb.py effect 27 && uv run nuphy-rgb.py save

Hue reference

Hue	Color
0	Red
43	Yellow
85	Green
128	Cyan
170	Blue
213	Magenta

Effect index reference

Behavior sourced from the QMK RGB-matrix animations in the firmware. Interactive ✓ = the effect reacts to keypresses. Custom color ✓ = it renders in your configured hue/sat (set via color/rgb); ✗ = a fixed or full-spectrum palette that ignores your color.

Index	Name	Interactive	Custom color	Description
0	All Off	✗	✗	All LEDs off.
1	Solid Color	✗	✓	Every key lit in your configured color — no animation.
2	Gradient Up/Down	✗	✓	Static vertical gradient; hue shifts away from your base color down the rows (speed sets the spread).
3	Gradient Left/Right	✗	✓	Static horizontal gradient; hue shifts away from your base color across the columns (speed sets the spread).
4	Breathing	✗	✓	Your color fades the whole board in and out.
5	Band Sat.	✗	✓	A saturation band in your hue sweeps left→right; keys outside it fade toward white.
6	Band Val.	✗	✓	A brightness band in your hue sweeps left→right; keys outside it dim to off.
7	Pinwheel Sat.	✗	✓	A saturation wedge in your hue rotates around the board's center.
8	Pinwheel Val.	✗	✓	A brightness wedge in your hue rotates around the board's center.
9	Spiral Sat.	✗	✓	A saturation spiral in your hue winds out from the center.
10	Spiral Val.	✗	✓	A brightness spiral in your hue winds out from the center.
11	Cycle All	✗	✗	Whole board cycles through the full hue spectrum in unison.
12	Cycle Left/Right	✗	✗	Rainbow scrolls horizontally across the board.
13	Cycle Up/Down	✗	✗	Rainbow scrolls vertically across the board.
14	Rainbow Moving Chevron	✗	✗	A rainbow chevron (›) pattern scrolls to the right.
15	Cycle Out/In	✗	✗	Rainbow cycles from the edges inward to the center.
16	Cycle Out/In Dual	✗	✗	Rainbow cycles inward toward two horizontal centers.
17	Cycle Pinwheel	✗	✗	Rainbow rotates around the center like a pinwheel.
18	Cycle Spiral	✗	✗	Rainbow spirals out from the center.
19	Dual Beacon	✗	✓	Two beams sweep around the center; colors fan out from your base hue.
20	Rainbow Beacon	✗	✗	Two beams sweep around the center spanning the full rainbow.
21	Rainbow Pinwheels	✗	✗	Two counter-rotating rainbow pinwheels.
22	Raindrops	✗	✓	Random keys light and fade in your hue and two neighboring hues.
23	Jellybean Raindrops	✗	✗	Random keys light and fade in fully random colors.
24	Hue Breathing	✗	✓	Whole board in your hue, gently shifting hue (~12° range) as it breathes.
25	Hue Pendulum	✗	✓	Your hue sways back and forth across the board like a pendulum (~12° range).
26	Hue Wave	✗	✓	A gentle hue wave (~24° range) travels across the board from your base color.
27	Typing Heatmap	✓	✗	Keys heat up red as you type, cool down to blue when idle — hardcoded, color setting has no effect on hue
28	Digital Rain	✗	✗	Matrix-style green droplets fall down the columns; always green — only brightness follows your value setting.
29	Reactive Simple	✓	✓	Only the pressed key flashes in your color then fades — no spread
30	Reactive	✓	✓	Like Simple but hue shifts up to 64° per keypress, so rapid typing produces a rainbow across keys
31	Reactive Wide	✓	✓	Bright shockwave expands outward from keypress, brightening nearby keys as it passes
32	Reactive Multiwide	✓	✓	Like Wide but tracks all recent keypresses simultaneously — overlapping waves
33	Reactive Cross	✓	✓	Flash spreads along the row and column of the pressed key only — cross shape
34	Reactive Multicross	✓	✓	Like Cross but tracks all recent keypresses simultaneously
35	Reactive Nexus	✓	✓	Narrow halo ring expands from keypress; hue shifts slightly by vertical position giving a gradient ring
36	Reactive MultiNexus	✓	✓	Like Nexus but tracks all recent keypresses simultaneously
37	Splash	✓	✓	Ring ripple expands from keypress with hue rotating as it travels — rainbow ring
38	MultiSplash	✓	✓	Like Splash but tracks all recent keypresses simultaneously
39	Solid Splash	✓	✓	Ring ripple in your solid color — same as Splash but no hue rotation
40	Solid MultiSplash	✓	✓	Like Solid Splash but tracks all recent keypresses simultaneously

VIA browser (keymap editing)

1. Open https://usevia.app
2. Settings → enable "Design tab"
3. Design → Load Draft Definition → config/nuphy-air75-v2-via3.json
4. Save+Load tab → load config/martinciu.layout.json

Notes

• nuphy-rgb.py needs libhidapi (brew install hidapi, or apt install libhidapi-hidraw0 on Linux). It auto-adds the Homebrew lib dir to the dynamic-loader path at startup (Apple Silicon /opt/homebrew/lib, Intel macOS /usr/local/lib, Homebrew-on-Linux /home/linuxbrew/.linuxbrew/lib).