Per-key tooltips

[rpnfan]

Add option to allow entering a tooltip in the Agent GUI for mapped keys and as well for macros, to be displayed in Agent. See the forum post https://forum.ultimatehackingkeyboard.com/t/feature-request-allow-adding-notes-to-key-mappings-in-agent/744/6?u=rpnfan

[mondalaci]

I think this feature is too niche and isn't worth the effort and the extra UI space, but I keep it open so others can see and upvote it.

[kriker97]

I vote for this feature in the agent. It would it be nice to have something like that, I tend to forget what the purpose was being for, when I create a macro after certain time. It could work very well to keep our macros in order.

[ubuntudroid]

Oh yes, please please please add something like this!!! ❤️ I configure my keyboard only once every few months and when deciding which rarely used mapping to replace with a new one or how to re-order existing mappings such notes would help a ton!

[mondalaci]

I'm ready with the specification.

Notice the button leftward of Cancel. It's a toggle button containing the note Font Awesome icon. When toggling it on, the note field appears:

• Make the note field two rows large by default and enlarge it as the user adds more lines.
• Display a tooltip when hovering over the note button containing "Add a note to this key." vs "Remove note." according to its state.
• Make the toggled/untoggled state of the note button visible.
• Reduce the vertical space between the Modifiers and Secondary role rows so it's the same as between the Scancode and Modifiers rows.

• Place the triangle marker underneath the rendered key mapping so it won't cover the mapping.
• Rendering the triangle on non-rectangular keys will be tricky. I suggest specifying an (x,y) translation and rotation for the affected keys in the SVGs to be used by Agent.
• When hovering a key that contains a note, show its note in a tooltip.

Related firmware issue: UltimateHackingKeyboard/firmware#788

[rpnfan]

Thanks a lot. That looks great :-)

[ajh3]

I would also like tooltips on the keymap screen, mainly for macros. My suggestion was going to be tooltips with the full macro name, since right now it's truncated to what can be displayed on each key icon. If you don't think this would overcomplicate things, maybe there could be a checkbox that makes the note equal to the macro title? Just a note would be a lot better than nothing, though. Thank you!

[mondalaci]

Maybe we can add a general option that'd expand actions, such as macros in tooltips upon hover, but I'm unsure how widely it'd be used as it hasn't been requested yet. In any case, I wouldn't mix the suggested feature with this one.