mwb

A Linux and macOS client for Microsoft PowerToys Mouse Without Borders. Share your Windows keyboard and mouse with a Linux or macOS machine over the network.

• Go 1.25+
• A Windows machine running PowerToys Mouse Without Borders
• Linux: uinput support, Wayland display
• macOS: Accessibility permission granted to the mwb binary

Before running mwb on Linux, you need to configure uinput access:

# Load the uinput kernel module
sudo modprobe uinput

# Load uinput automatically on boot
echo 'uinput' | sudo tee /etc/modules-load.d/uinput.conf

# Allow the input group to access /dev/uinput
echo 'KERNEL=="uinput", GROUP="input", MODE="0660"' | sudo tee /etc/udev/rules.d/99-uinput.rules
sudo udevadm control --reload-rules && sudo udevadm trigger /dev/uinput

# Add your user to the input group (log out and back in after this)
sudo usermod -aG input $USER

mwb needs Accessibility permission to inject mouse and keyboard events:

1. Build or install the mwb binary
2. Run it once — macOS will prompt for Accessibility access
3. Grant permission in System Settings > Privacy & Security > Accessibility

If running from Terminal, you may need to grant the permission to Terminal.app instead.

brew tap bketelsen/tap
brew install mwb

To start mwb automatically on login:

brew services start mwb

On macOS you must grant Accessibility permissions after installing:

System Settings → Privacy & Security → Accessibility → Add mwb

Download the latest .deb or .rpm from the releases page.

make install

This builds the binary, installs it to ~/go/bin/mwb, and sets up a systemd user service.

make build
cp mwb /usr/local/bin/mwb

Create ~/.config/mwb/config.toml:

host = "192.168.1.100"   # IP of the Windows machine
key = "YourSecurityKey"   # Must match the key set in PowerToys MWB
name = "linux"            # Name shown in the MWB device layout (max 15 chars)
# port = 15100            # Base port (default: 15100, message port = base + 1)

The security key is found in PowerToys > Mouse Without Borders > Security key.

systemctl --user enable --now mwb

View logs:

journalctl --user -u mwb -f

To uninstall:

make uninstall

cp packaging/com.mwb.agent.plist ~/Library/LaunchAgents/
launchctl load ~/Library/LaunchAgents/com.mwb.agent.plist

This starts mwb at login and restarts it on failure. View logs:

tail -f /tmp/mwb.log
tail -f /tmp/mwb.err.log

To stop and unload:

launchctl unload ~/Library/LaunchAgents/com.mwb.agent.plist

mwb                          # uses default config path
mwb -config /path/to/config  # custom config path
mwb -debug                   # enable debug logging

On the Windows side, open PowerToys Mouse Without Borders and click "Refresh connections" to discover the Linux client. Then drag it into your desired position in the device layout.

mwb connects to the Windows MWB server over TCP, performs an AES-256-CBC encrypted handshake, and receives mouse/keyboard events which it injects locally via Linux uinput virtual devices or macOS CoreGraphics events.