KMBox

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38

# KMBox

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

1. Open the package in Rebind and select **Options**. The defaults work as they are.
2. 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.
3. 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** to stop all scripts. Held keys and buttons are released.