Numpad mask to control Ruida

Hi all!

A little background to this project
I have a 130x90cm 100W CO2 cutter and my computer with Lightburn on it is a few steps away. Very often, I find myself clicking ‘Frame’ and running to the laser to see the framing of the work, only to arrive too late to see the actual framing in action. Also, I’d like to be able to Start etc. from the laser itself to keep a close eye.

So, I bought a very simple keypad (LogiLink ID0184) and used an app called ‘HID Macros’ to override some buttons to generate a key sequence like ALT+R for the Frame function. It works like a charm but but most keys on the keypad aren’t used and the text on the buttons themselves don’t make sense. So, owning a laser cutter and whatnot, I decided to make a mask/overlay for the keypad and its buttons.


  • Three layers of 3mm matte black acrylic for the panel body
  • 4mm birch plywood for the buttons.
  • Two layers of double sided 1mm foam tape to stick the new wooden buttons onto the keypad buttons.
  • Elastic textile band to hold the mask onto the keypad.

Original LogiLink ID0184:

Finished product:

Bonus question for the Lightburn developers
As you can see, I’ve added buttons for rubberband frame and focus, but they don’t work yet, because Lightburn doesn’t have keyboard shortcuts for them. Is there any chance these could be added? :pray:


That’s pretty cool. I should be able to give hotkeys to the O frame and focus commands without much trouble. They’ll be Alt-Shift-R (rubber band frame) and Alt-Shift-F (focus).


Nice work! For those who aren’t interested in making this for themselves, remember there are free iOS and Android apps so you can turn your phone or tablet into a remote control. Also, Ruida sells the dedicated remote control module that plugs into the controller and then has a wireless handheld device.

1 Like

Woohoo! Awesome, thank you Oz!

That’s cool! Didn’t know both of these things :slight_smile:
Well, i had a few hours to kill and some scrap to waste. The keypad was like 6-7 euro’s so this was the cheapest option and a good exercise.

The Ruida app works if you have your laser connected to a network that is also WiFi accessible, or you have their WiFi add on thing. It’s pretty cool, but it’s probably less useful than a dedicated hardware keypad sitting there. You end up fumbling with the phone a bunch to open it, find the app, etc, etc. I like this approach, and it would work for any laser, not just Ruida.

1 Like

Would there be a way of creating a keyboard shortcut API of sorts? I’ve often thought of doing the above with a remote keypad but would potentially like to add things like moving to bottom left of drawing, centre of drawing etc. Having an API would allow people to configure up a keypad in the way they wanted to.

There may be an easy and obvious way of doing this already which I have missed.

For those interested, I’ve attached the .lbrn file with 3 shapes next to eachother.
This only works for the LogiLink ID0184, which is a cheap and widely available keypad.

  • Use two layers of 3mm (or ofc. 1 layer of 6mm) of the middle shape, put them over the keypad
  • On top of that, add a 3mm material of the left shape. Note that the holes/cutouts for the buttons have a 0.1mm outward offset to give the keys some extra space. I used matte black acrylic for these layers.
  • Keys (shape on the right) are best made from 4mm material that can be engraved, such as plywood/MDF.
  • If you are feeling creative, add a hole in each layer for the numlock-LED and fill it with opaque acrylic!
  • Font used for the buttons is Roboto Light, a free Google Font, available here:

Stick the keys on the numpad while you have the ‘mask’ in place, so you get the right position. Use 2mm foam tape (or 2x1mm like I did).

KeypadMask.lbrn (102.0 KB)

1 Like

What you’re asking for is a way of editing the shortcuts in LightBurn - it would require a UI to manage them, and some would be uneditable because certain ones only work in certain contexts. I also don’t have shortcuts for all actions, so if you wanted to be able to assign “move to lower left” for example, that action doesn’t have a shortcut, so that makes it yet again more complex. It may happen eventually, but it would be a lot of work.

Here is a pic of the OEM RUIDA remote control for reference

Nice! There’s a clear advantage we have from using a remote that controls Lightburn instead of a remote that controls the controller. For example: framing a design is possible with both the remotes but only with the Lightburn remote, it sends the selected design to the laser first, then frames it. The Ruida remote wouldn’t know what to frame…

1 Like

Will the Ruida controller work directly with Lightburn? Or only a third party custom job?

The Ruida pendant works directly with the Ruida controller itself - the software is not involved.

So how does this amazing custom controller differ in benefits in working with LightBurn.

I guess my question is why should I consider a controller that works with LightBurn directly over one that works with the Ruida console directly.

Thank you in advance for you reply.



The custom one is a keyboard with assignable keys, meaning that you could program it to issue any shortcut available in LightBurn.

The Ruida pendant controller only controls the machine itself, not the software, and will therefore only perform machine specific functions, and only work with Ruida controllers.

I would like to build this as well… any assistance would be appreciated… Ordering that keyboard today!

1 Like

Thank you for the clarification. I believe that a tool of this magnitude would help many Lightburn customers. I am willing to pay for a kit and instructions on how to build this tool.

What materials/parts to use/buy
Burn Files
Procedure and instructions


I agree, I’m willing to pay as well.

1 Like

Hey guys! Cool to see you are interested. The Lightburn file is already on this topic, I posted it a few posts back with instructions. Let me know if you need help.

1 Like

This is a great idea and I would like to make one.

Do you think a wireless numpad like this would work
Bluetooth Numpad