feschber/lan-mouse
Lan Mouse
lan-mouse is a software KVM switch and networked peripheral controller that allows a user to share a single keyboard and mouse across multiple computers over a local area network. It functions as a cross-platform input sharer, capturing local peripheral events and relaying them to remote hosts for simulation at the operating system level.
The system secures remote input control using a TLS-encrypted transport layer to prevent the interception of keystrokes and pointer data. Access is managed through fingerprint-based device authorization, which validates remote connections by matching unique device identifiers against a trusted list.
The project includes a headless daemon for background operation and a state-synchronized event queue to maintain fluid cursor movement and consistent modifier key behavior. It also features device liveness tracking to monitor connection status and manages persistent configurations for automatic reconnection.
Installation and configuration can be integrated into declarative system management setups via Home Manager.
Features
- Software Peripheral Sharing - Allows a single set of physical mouse and keyboard peripherals to be shared across multiple networked computers.
- Software KVM Switches - Functions as a software KVM switch, sharing a single keyboard and mouse across multiple computers over a local network.
- Remote Input Controllers - Manages and routes remote keyboard and mouse inputs to a host with strict TLS and fingerprint-based permissions.
- Networked Input Controllers - Provides a network service that synchronizes input states and authorizes remote devices to manage local computer interfaces.
- Remote Device Connectivity - Establishes secure network connections between devices and synchronizes layout information for consistent input behavior.
- Remote Input Relays - Implements a system to transmit local user input events to a remote host for OS-level simulation.
- Input Event Sharers - Transmits live keyboard and mouse events across different operating systems to control multiple remote machines.
- Input Event State Synchronizers - Tracks modifier key states and input sequences to ensure fluid cursor movement and consistent keyboard behavior across network boundaries.
- Authorized Device Whitelisting - Validates remote connections by matching unique device identifiers against a trusted whitelist of authorized hardware.
- TLS Traffic Encryption - Secures communication channels between networked input devices using TLS encryption to protect sensitive keystroke data.
- Transport Layer Security - Secures all network traffic using transport layer security to prevent unauthorized interception of keystrokes and pointer data.
- Cross-Device Input Sharing - Enables a single set of input peripherals to control multiple networked computers running different operating systems.
- Headless Network Daemons - Operates as a headless background service to maintain network connectivity and process input without a user interface.
- TCP Stream Handlers - Utilizes TCP stream handlers to transmit real-time mouse and keyboard input packets over a local area network.
- Network Traffic Encryptions - Encrypts all network traffic between devices to prevent the interception of keystrokes and pointer data.
- Device Connectivity Tracking - Monitors the connection status of peer devices and automatically releases captured input when a connection is lost.
- Utilities - Software KVM switch for sharing mouse and keyboard.
