Show Layer-Tap/Mod-Tap information on keys by BafS · Pull Request #135 · zmkfirmware/zmk-studio

BafS · 2025-04-10T23:12:47Z

Show "Layer-Tap" information on the keys, before it was empty, we now see which layer will be enabled on hold and which key will be send on tap.

Instead of the layer logo I was hesitant to add "Hold" to show that this behavior is triggered when it's hold, but it could be done as a future improvement.

Before:

After:

netlify · 2025-04-10T23:13:03Z

✅ Deploy Preview for zmk-studio ready!

Name	Link
🔨 Latest commit	`a177a63`
🔍 Latest deploy log	https://app.netlify.com/projects/zmk-studio/deploys/69409bdaab5d5300088b0833
😎 Deploy Preview	https://deploy-preview-135.preview.zmk.studio
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

nmunnich · 2025-04-11T10:43:33Z

This looks very similar to https://discordapp.com/channels/719497620560543766/722441520741089317/1293320175482966037, which I quite like the look of. If you're able to adjust it to match more closely, that would be great.

Does this work with all hold-taps? If not, it should be extended as such.

BafS · 2025-04-11T16:35:00Z

Updated the design and made it work with mode-tap too

BafS · 2025-04-11T18:47:03Z

Added indicators and some fine tuning

BafS · 2025-05-16T18:53:08Z

src/keyboard/KeymapBindingChildren.tsx

+  behavior: string,
+  binding: KeyBinding,
+): JSX.Element | JSX.Element[] => {
+  if (behavior === "Layer-Tap") {


Those if should probably be improved, not sure if we should add the "behavior type" and/or binding-cells. Could maybe be a followup?

danielsvane · 2025-06-17T13:09:35Z

I agree that it would be nice to see the layer and mod tap info on the keys, but I think we should start out with a simpler visualisation like

This is personal preference though. I feel its simpler to review, and improve over time, when making as few changes as possible.

Also the linting changes you (or your editor) has done, makes it more difficult to review, and should be done in a seperate PR. The actual important changes are confined to 1 or 2 files.

petejohanson

Thanks for the PR! The main concern for me is the trigger/logic used to determine when to render these differently.

petejohanson · 2025-06-19T19:22:11Z

src/keyboard/KeymapBindingChildren.tsx

+    ];
+  }
+
+  if (behavior === "Mod-Tap") {


We really can't do this. We need to be inspecting the metadata information to determine what to do here. Because:

Users might have multiple mod taps with different names,

Users might translate the display names to their language in the devicetree.

General flexibility for custom behavior support in studio.

So... this is great to work on... and it must be metadata driven. For instance, we might choose this rendering style if both param1 and param2 are of parameter metadata type "HID usage".

What do you think about the latest changes? Like that we don't depend on the name. It's not perfect but it's more generic.

ping @petejohanson

awkannan · 2025-06-26T14:37:15Z

src/keyboard/KeymapBindingChildren.tsx

+  const param1IsHidUsage = isHidUsageParameter(binding.param1, behavior.metadata, layerIds);
+  const param2IsHidUsage = isHidUsageParameter(binding.param2, behavior.metadata, layerIds);
+  const param1IsLayerId = isLayerIdParameter(binding.param1, behavior.metadata, layerIds);
+  const param2IsLayerId = isLayerIdParameter(binding.param2, behavior.metadata, layerIds);


Chiming in because I think this is a cool change and I hope it hits studio main soon:

This variable here param2IsLayerId is never used, so CI is failing.

alvinometric · 2025-08-15T08:51:42Z

Any updates on this?

BafS · 2025-08-18T16:34:32Z

I wish sorry, I pinged the devs a few times on Discord, I don't know what to do to get it reviewed again/merged. I lost motivation.

nmunnich · 2025-08-18T16:38:02Z

Last I checked, Pete is planning on doing more with Studio after we bump Zephyr to 4.1.

BafS · 2025-11-17T09:19:48Z

Is there still hope to help me review/merge this MR?

nmunnich · 2025-11-17T15:11:55Z

I believe this PR as-is is seen as too specific for the current state of Studio. See https://discord.com/channels/719497620560543766/719909884769992755/1435008086329917521 for a recent discussion we had - I believe that a generic "display both params of behaviour with two params" needs to come first, then figure out how to make that look good, then do edge cases for things like layer-tap.

I do think this PR could be modified to cover the more general case, but I would understand (yet feel saddened if you feel too demotivated to do said work.

awkannan · 2025-11-17T17:12:11Z

I believe this PR as-is is seen as too specific for the current state of Studio. See https://discord.com/channels/719497620560543766/719909884769992755/1435008086329917521 for a recent discussion we had - I believe that a generic "display both params of behaviour with two params" needs to come first, then figure out how to make that look good, then do edge cases for things like layer-tap.

I do think this PR could be modified to cover the more general case, but I would understand (yet feel saddened if you feel too demotivated to do said work.

So this is basically what @danielsvane suggested above.

If this change would be green lit, I'd be happy to take a stab at it

petejohanson · 2025-11-17T17:15:22Z

I'd love to see improvements here, yes, that align with the metadata approach so we can have a sane display for any possible parameter combination, with enhanced/imporved display for specific pairs of parameter types.

Important note: The calculation of the second parameter type can depend on the given first parameter value, so the calculation for what that second type is can be non-trivial. We do that right now for the behavior parameter picker here, if you need to see that in action: https://github.com/zmkfirmware/zmk-studio/blob/main/src/behaviors/BehaviorParametersPicker.tsx

BafS · 2025-11-17T20:35:38Z

Ok, thank you guys for the quick answers, I'll try to update this PR one of those days and make it more simple.

BafS · 2025-11-17T22:31:55Z

Still a WIP but it's now closer to the behavior param picker

What would be good, I think, is to send the behavior name in the protocol.
Currently, we don't have this information, we only have the "display_name" but not the "behavior_name" (see behavior_subsystem.c in the firmware).
With this info we could have a design closer to https://nickcoutsos.github.io/keymap-editor/ for instance.

awkannan · 2025-11-17T22:43:15Z

Since we pretty much have to deal with the protocol we have now, I think using display_name would be a good solution for now.
We can consider using the shorter behavior name later.

Maybe something like this:

awkannan

I think this is a great start!

src-tauri/src/transport/commands.rs

src/AppFooter.tsx

src/keyboard/HidUsageLabel.tsx

src/keyboard/Key.tsx

src/keyboard/Keyboard.tsx

awkannan · 2025-11-17T23:03:13Z

src/keyboard/KeymapBindingChildren.tsx

+  const matchingSet = findMatchingParameterSet(binding.param1, behavior.metadata, layerIds);
+
+  // If both parameters are zero
+  if (binding.param1 === 0 && binding.param2 === 0) {


this could be a valid configuration for some behaviors - so I don't think we can return an empty div here

awkannan · 2025-11-17T23:40:37Z

src/keyboard/KeymapBindingChildren.tsx

+
+  // Both parameters present and should be displayed
+  if (param1Display && param2Display) {
+    return [


The ordering here is tricky and I think could be up for discussion, but imo is fine for now

awkannan · 2025-11-17T23:45:39Z

src/behaviors/behaviorBindingUtils.tsx

+  param1?: number,
+  param2?: number
+): boolean {
+  if (


I'd add a few comments about what each check does.

For example - I'm personally a bit lost as to why we are doing a param1 === 0 check here.

For some behaviors, like bluetooth, param1 could be 0 to indicate clear current profile

I agree with you, but I didn't touch the logic, this function was moved. I reverted it to simplify the diff.

awkannan · 2025-11-17T23:46:23Z

src/keyboard/KeymapBindingChildren.tsx

+  }
+
+  // Get displays for both parameters
+  const param1Display = binding.param1 !== 0 ?


0 is a valid value for a param, i don't think this should be gated behind that

awkannan · 2025-11-17T23:46:32Z

src/keyboard/KeymapBindingChildren.tsx

+    getParameterDisplay(binding.param1, behavior.metadata.flatMap(m => m.param1), layers) :
+    null;
+
+  const param2Display = binding.param2 !== 0 && matchingSet ?


same as above

src/keyboard/PhysicalLayout.tsx

BafS · 2025-11-17T23:49:36Z

If we go that route @awkannan I think it would be better to open a separate PR that only change the design. Right now we show this info when we have the cursor "on hover".

I would gladly take care of the implementation, but to avoid back-and-forth it would help to have a specific design/idea/goal in mind before I start.

And thanks for your review! I'll check this soon

awkannan · 2025-11-17T23:53:56Z

Agreed - I think that should be a separate PR!

peterjc · 2025-11-18T19:04:14Z

This would close #147 which would be great 😍

awkannan · 2025-11-20T14:50:50Z

Since #141 was merged, there are some merge conflicts now.
But hopefully it's not too bad to fix up!

BafS · 2025-12-03T00:44:17Z

I still need to work on it, but that's how it currently looks like with the rebase from main

BafS · 2025-12-15T23:41:41Z

I tried to revert everything that was not required for this change, to simplify the diff.

With the latest change:

Let me know what you think, there are some issues with key display in "main", especially when it's long, but I didn't want to change this in this PR, I can do a followup.

BafS · 2026-01-18T21:43:46Z

Anyone?

peterjc · 2026-01-18T21:47:47Z

As a user, this would be a welcome improvement.

@BafS

…mkfirmware#135) Cherry-picked final state of zmkfirmware#135 by @BafS. Keys now display tap key + layer/modifier info directly on the visual keymap instead of being blank for hold-tap behaviors. Co-Authored-By: Fabien Salathe <github@fabien.io> Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

BafS changed the title ~~Show Layer-Tap information on keys~~ Show Layer-Tap/Mod-Tap information on keys Apr 11, 2025

BafS commented May 16, 2025

View reviewed changes

BafS force-pushed the feat/layer-tap-key-1 branch 2 times, most recently from 86d2c86 to e214945 Compare May 16, 2025 19:02

petejohanson requested changes Jun 19, 2025

View reviewed changes

awkannan reviewed Jun 26, 2025

View reviewed changes

awkannan reviewed Nov 17, 2025

View reviewed changes

src/keyboard/PhysicalLayout.tsx Outdated Show resolved Hide resolved

BafS added 3 commits December 3, 2025 00:22

Show Layer-Tap information on keys

81f388a

Update design, make it work with mod-tap too

b6abd80

Add indicators

85604ac

BafS added 5 commits December 3, 2025 00:22

Handle "transparent" behavior

5503f7c

Change logic to not depend on behavior names

0246fba

Simplify the key visual, use logic from BehaviorBindingPicker (WIP)

7ad3b9d

Revert some unrelated changes

4624d55

Simplify logic and improve key UI

7b9bf07

BafS force-pushed the feat/layer-tap-key-1 branch from c0f3ce6 to 7b9bf07 Compare December 3, 2025 00:27

Fix spacing when multilines param

4ec09be

BafS added 2 commits December 16, 2025 00:20

Revert validateBinding move

7c8619c

Don't truncate param

8926887

BafS force-pushed the feat/layer-tap-key-1 branch from 69e4140 to 8926887 Compare December 15, 2025 23:26

Cleanup

a177a63

BafS requested a review from petejohanson February 16, 2026 22:44

Uh oh!

Conversation

BafS commented Apr 10, 2025

Uh oh!

netlify bot commented Apr 10, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Deploy Preview for zmk-studio ready!

Uh oh!

nmunnich commented Apr 11, 2025

Uh oh!

BafS commented Apr 11, 2025

Uh oh!

BafS commented Apr 11, 2025

Uh oh!

BafS May 16, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

danielsvane commented Jun 17, 2025

Uh oh!

petejohanson left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

alvinometric commented Aug 15, 2025

Uh oh!

BafS commented Aug 18, 2025

Uh oh!

nmunnich commented Aug 18, 2025

Uh oh!

BafS commented Nov 17, 2025

Uh oh!

nmunnich commented Nov 17, 2025

Uh oh!

awkannan commented Nov 17, 2025

Uh oh!

petejohanson commented Nov 17, 2025

Uh oh!

BafS commented Nov 17, 2025

Uh oh!

BafS commented Nov 17, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

awkannan commented Nov 17, 2025

Uh oh!

awkannan left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

BafS commented Nov 17, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

netlify bot commented Apr 10, 2025 •

edited

Loading

BafS May 16, 2025 •

edited

Loading

BafS commented Nov 17, 2025 •

edited

Loading

BafS commented Nov 17, 2025 •

edited

Loading

BafS commented Dec 15, 2025 •

edited

Loading