Question around keyboards with mouse layers

Post Reply
fraserYT
Member
Member
Posts: 1
Joined: Fri Mar 21, 2025 1:36 pm

Question around keyboards with mouse layers

Post by fraserYT »

I bought a SterlingKey specifically to use with my ZSA Voyager keyboard. It doesn't currently appear on your compatibility list but I think the ZSA Voyager and ZSA Moonlander (which does appear on the list), are essentially the same under the hood and it appears to work mostly flawlessly, although I've only spent 10 minutes or so testing it (On Ubuntu, in case that's relevant).

In the compatibility list for ZSA Moonlander, under built-in mouse, it says N/A, suggesting that the keyboard doesn't have a built in mouse. However, that's not entirely true. Both Moonlander and Voyager are programmable and have the ability to map mouse controls onto specific keys, allowing you to move your cursor, scroll and click etc. without having to take your hands off the keyboard. Unfortunately, this doesn't work through SterlingKey at all.

What I'd like to understand is, is this something which can/is likely to be be fixed though a future SterlingKey firmware update, is there a workaround anyone has found or is it something which will just never work through SterlingKey?

It's potentially something of a dealbreaker for me so I'd like to set my expectations.

Thanks
Alex
Site Admin
Site Admin
Posts: 52
Joined: Sun Jan 21, 2024 1:37 am

Re: Question around keyboards with mouse layers

Post by Alex »

Hey!

I don't remember if I ever got feedback for the mouse layer, didn't know it exists. It's likely fixable, I'll just need some logs from you so I can create a hotfix release.

1. Connect SterlingKey to your computer through the type-c port of SterlingKey, and connect your keyboard to the type-A port
2. Access updater
3. Under Console, click on Start
4. A popup will appear where there will be one device, select that
5. After a few seconds, the connection will be established
6. Type "set debug 1" and click enter
7. Click Reset
8. After a few seconds the Bluetooth will automatically reconnect
9. Press a few keys that you know work (keyboard layer)
10. Press some keys of the mouse layer
11. The logs will probably indicate something like `Previous command not recognized`
12. Copy the logs and paste them here

Note: You have to use Chrome based browsers

Thank you and sorry for the inconveniece!
Alex
Site Admin
Site Admin
Posts: 52
Joined: Sun Jan 21, 2024 1:37 am

Re: Question around keyboards with mouse layers

Post by Alex »

I just remembered. I had another user 2 weeks ago on Discord report the ZSA Voyager's built-in mouse compatibility. I have fixed it, but I have not yet release that firmware. However you should be able to use the test firmware. On the same `updater` page, click on Connect below Program, and on the Choose Version dropdown choose the `zsa_voyager` firmware. Finally click Program. After around 10 seconds it will be done.

No need to do any of the previously mentioned steps. Let me know if that firmware works!
Post Reply