KMBox

Name: KMBox
Author: @rebind

@rebind / kmbox-netv0.2.4Public

Let programs written for KMBox Net, Ferrum, or DHZBox send keyboard and mouse input through Rebind Link over your network.

Use programs made for a KMBox Net, Ferrum, or DHZBox with Rebind Link. The program runs on another computer and sends its commands over the network.

Needs Rebind 3.5.5 or newer and Rebind Link on Windows or macOS. KMBox Net was tested on Windows and macOS with a test program on the same computer. Ferrum and DHZBox commands were checked only by a local test with simulated output, not with Rebind Link. None of the three has been tested yet with a program on a second computer.

Set up

Open the package in Rebind and select Options. The defaults work as they are.
Start the package. The notice shows the address and port, such as 192.168.2.188 (likely), port 17006. With a VPN or a direct cable to the other computer, the address shown can be the wrong one. If it shows all addresses, or the wrong one, use this computer's address on the network your program uses.
In your program, enter that address and port. For KMBox Net programs, enter the device code 00000000.

The options, if you need them:

This computer's address: leave blank to listen on every network this computer is on. If your program expects a fixed address such as 192.168.2.188, give this computer that address, or change it in the program. Some programs only accept replies from the exact address they sent to, so if the program waits forever and this computer has several addresses, enter the one the program sends to. This case has not been tested.
Port: 0 picks a random port on the first start and keeps it. Set your own if your program needs a fixed one.
Device code: the 8 hex digits your KMBox Net program uses. Ferrum and DHZBox programs do not use a code.
Controlling computer's address: blank answers this computer and any computer with a private network address (such as 192.168.x.x or 10.x.x.x). Enter addresses, separated by commas, to answer only those.

Restart the package after changing an option.

What works

KMBox Net: mouse movement, buttons, scrolling, keyboard input, smooth and curved moves (both as a straight line over the requested time), encrypted commands, and monitor, so the program can see your physical mouse and keyboard
Ferrum km. commands: move, buttons, click, wheel, key down, up, and press, and reading buttons and keys. Ferrum documents these over USB serial; here they are accepted over the network, so the program must send them to this computer's address and port. Ferrum's own network modes use the KMBox Net and DHZBox formats, which are covered above and below.
DHZBox commands: move, buttons, wheel, keys, reading buttons, and monitor. The DHZBox format comes from other people's programs, not a published spec, so scroll direction, key names, and replies are unverified.

Blocking your physical mouse or keyboard (mask, lock) and device settings such as reboot are not supported. The program's requests are accepted but have no effect.

Safety

With the default options, any computer with a private network address that can reach the port can control this computer's keyboard and mouse. The device code is not a password, and Ferrum and DHZBox commands need no code at all. On Windows, Rebind is allowed through the firewall on all networks.

On a network you do not fully trust, enter the controlling computer's address. It is the only option that also covers Ferrum and DHZBox commands; the device code limits KMBox Net commands only. Another computer on the network can still fake an allowed address, so stop the package when you are not using it.

Stop

Stop the package from the editor toolbar, or press Left Ctrl + Left Alt + K (Left Control + Left Option + K on macOS) to stop all scripts. Held keys and buttons are released.

Version

Older release. Installs get 0.2.4.

README.md2.9 KB

# KMBox Net

Let a program written for a KMBox Net send keyboard and mouse input to this computer through Rebind Link. The program runs on another computer on your network and needs no changes: you point it at this computer's address, the package's port, and a device code.

Requires Rebind 3.5.5 or newer and a connected, authenticated Rebind Link on Windows or macOS. Software mode and Linux are not supported. Tested on macOS with Rebind Link; Windows and monitor reports from a real mouse and keyboard are not tested yet.

## Set up

1. Open the installed package's `main.luau` in Rebind and select **Options**.
2. Set **This computer's address** to this computer's address on the network the program uses, such as `192.168.2.188`. The package listens only on that address.
3. Set **Port** and **Device code** to the port and eight-hex-digit code the program is configured with.
4. Set **Controlling computer's address** to the address of the computer running the program. Packets from any other address are ignored. Separate several addresses with commas.
5. Start the package from the editor toolbar. Restart it after changing any option.

Some programs, including the vendor's Python demos, use a fixed address such as `192.168.2.188`. Give this computer that address on the shared network, or change it in the program.

## What each call does

| Program call | Result |
|---|---|
| Connect | Answered |
| Move, left, right, middle, side buttons, wheel, and full mouse state | Sent through Rebind Link |
| Automove and bezier | Moved in a straight line over the requested time, answered when finished |
| Keyboard down, up, and full keyboard state | Sent through Rebind Link |
| Encrypted versions of these calls | Decrypted and handled the same way |
| Monitor | Reports physical mouse buttons, movement, wheel, and keys to the program |
| Mask and unmask | Answered, but physical input is not blocked |
| Reboot, set address, set VID/PID, display, trace, debug, and controller calls | Answered with no effect |

Monitor movement can miss some motion when Rebind is busy. Keys that Rebind has no name for are not reported. If you tap a key or button that the program is holding, it is released briefly and pressed again.

## Access and privacy

The device code travels unencrypted in every plain packet and in every reply, including replies to encrypted calls, so it is not a password. Anyone on your network who knows the code and can send from an allowed address can control this computer's keyboard and mouse. Use it only on a network you trust.

On Windows, the Rebind installer allows Rebind through the firewall on every network profile, so the port is reachable on public networks too. Stop the package whenever you are not using it.

## Stop

Stop from the editor toolbar. **Left Ctrl + Left Alt + K** stops all scripts and releases held input. Stopping the package closes its port and releases every key and button it holds.

4 files, 14.6 KB.

KMBox

Readme

Set up

What works

Safety

Stop

Files

Versions