Control your target computer remotely with keyboard, video, and mouse over a single USB connection.
Openterface Mini-KVM is a compact KVM (Keyboard-Video-Mouse) switch that lets you control a target computer remotely from your host machine using a single USB connection. No network required. Ideal for:
- 💻 Managing headless servers and embedded systems
- 🎮 Controlling IoT devices and Raspberry Pi systems
- 🔧 Hardware debugging and development
- 🏢 Data center and lab management
- 📱 Controlling phones, tablets, and ARM devices
Note: This is the QT version for Linux & Windows. Currently in active development with feature parity improvements underway.
- Quick Start
- Features
- Supported OS
- Installation
- Build from Source
- Development
- Firmware Flashing (CH32 KeyMod)
- Troubleshooting
- Support & Community
- License
- Download the latest installer from Releases
- Run the installer (it installs drivers + app automatically)
- Launch Openterface Mini-KVM from your Start Menu
- Connect your Mini-KVM device via USB
Requires Ubuntu 22.04+, Debian 12+, or equivalent (glibc ≥ 2.32 + Qt6). Check your system:
ldd --version | head -1. Older distros (e.g. Ubuntu 20.04) are not supported — see System Requirements.
Fastest way (~30 seconds):
curl -fsSL https://raw.githubusercontent.com/TechxArtisanStudio/Openterface_QT/main/build-script/install-release.sh | bashThen run:
openterfaceQTFor other methods and detailed setup, see Installation section below.
- Basic KVM operations
- Mouse control absolute mode
- Mouse relative mode
- Audio playing from target
- Paste text to Target device
- AI Chat Assistant with agentic control
- OCR text from Target device
- MCP Server for external AI integration (Claude, GPT, etc.)
- Native OpenAI function calling support
- Web search integration for AI Chat
- Advanced terminal detection (cursor blink analysis)
- Other feature request? Please join the Discord channel and tell me
For a detailed list of features, please refer to the Features Documentation.
For advanced features and architecture details, see Advanced Features.
| OS | Version | Architecture | Status |
|---|---|---|---|
| Windows | 10+ | x64 | ✅ Supported |
| Windows | 11 | ARM64 | ✅ Supported |
| Ubuntu | 22.04+ | x64, ARM64 | ✅ Supported |
| Ubuntu | 20.04 | x64, ARM64 | ❌ Not supported (glibc 2.31, no Qt6) |
| Fedora | 42+ | x64, ARM64 | ✅ Supported |
| Linux Mint | 21.3+ | x64 | ✅ Supported |
| openSUSE | Tumbleweed | x64 | ✅ Supported |
| Arch Linux | Rolling | x64, ARM64 | ✅ Supported |
| 🔋 Raspberry Pi OS | 64-bit | ARM64 | ✅ Supported |
| 🔋 Raspberry Pi OS | 32-bit | ARM32 | ❌ Not supported (Qt too old) |
⚠️ glibc requirement: Pre-built binaries (.deb,.rpm, AppImage) require glibc ≥ 2.32 (shipped by Ubuntu 22.04+, Fedora 36+, Debian 12+, openSUSE Leap 15.4+). This applies to AppImages as well — they do not bundle glibc. To check your system:ldd --version | head -1. If your glibc is older, see Solutions for older glibc below.
x64 (Windows 10 / 11 on Intel/AMD):
- Download the latest installer from GitHub Releases — pick the
*_amd64_installer.exeasset - Run the installer — it will automatically install drivers and the application
- Launch Openterface Mini-KVM from your Start Menu or application folder
- Connect your Mini-KVM device via USB
A portable x64 build is also available (*_amd64_portable.exe) — run it directly or extract and launch, no system changes required.
ARM64 (Windows 11 on ARM / Snapdragon / Surface Pro X, etc.):
Windows 11 on ARM is fully supported. A pre-built ARM64 binary is produced by every successful CI run on main:
- Go to the Actions tab and open a recent run of Windows ARM64 Build.
- Download the
openterfaceQT_windows_arm64_portableoropenterfaceQT_windows_arm64_installerartifact from the run's summary. - For the installer: run it and follow the prompts. For the portable build: run the
.exedirectly. - Launch Openterface Mini-KVM and connect your device via USB.
Alternatively, build locally with MSYS2 — see Build from Source → Using MSYS2 (Windows ARM64).
Note: On Windows 11 Version 22H2, some users report driver installation issues. If keyboard/mouse don't respond, manually install the CH340 driver from the WCH website or use the repository driver with
pnputil -a CH341SER.INF(run as Administrator).
Choose the method that best suits your needs:
| Method | Speed | Effort | Best For |
|---|---|---|---|
| Pre-built Binary | ⚡ ~30 sec | Minimal | Most users — fastest & easiest |
| Build from Source | 5-30 min | Medium | Custom modifications needed |
| Manual Install | Varies | High | Advanced users & troubleshooting |
Install in ~30 seconds (no compilation):
curl -fsSL https://raw.githubusercontent.com/TechxArtisanStudio/Openterface_QT/main/build-script/install-release.sh | bashSupported distributions: Ubuntu/Debian, Fedora/RHEL, openSUSE, Arch Linux
What it does automatically:
- ✅ Downloads pre-built binary for your architecture (x86_64 or ARM64)
- ✅ Installs runtime dependencies (Qt6, FFmpeg, USB libraries)
- ✅ Configures device permissions (udev rules, user groups)
- ✅ Creates desktop menu integration
To install a specific version:
RELEASE_VERSION="v0.5.17" bash <(curl -fsSL https://raw.githubusercontent.com/TechxArtisanStudio/Openterface_QT/main/build-script/install-release.sh)Then launch:
openterfaceQTQuick automated build (5-30 minutes depending on hardware):
curl -fsSL https://raw.githubusercontent.com/TechxArtisanStudio/Openterface_QT/main/build-script/install-linux.sh | bashBy default, this builds the stable version. To build a specific version:
# Build a specific version/tag
BUILD_VERSION="v1.0.0" bash <(curl -fsSL https://raw.githubusercontent.com/TechxArtisanStudio/Openterface_QT/refs/heads/main/build-script/install-linux.sh)
# Build latest development version
BUILD_VERSION="main" bash <(curl -fsSL https://raw.githubusercontent.com/TechxArtisanStudio/Openterface_QT/refs/heads/main/build-script/install-linux.sh)For detailed build instructions and developer setup, see Build from Source and Development sections below.
For advanced users who prefer manual control:
- Download the pre-built
.debpackage from GitHub Releases - Install dependencies:
sudo apt install -y \
libqt6core6 libqt6dbus6 libqt6gui6 libqt6network6 \
libqt6multimedia6 libqt6multimediawidgets6 libqt6serialport6 \
libqt6svg6 libqt6concurrent6t64 libusb-1.0-0-dev libssl-dev \
libavutil58 libavformat60 libavdevice60 libturbojpeg0 \
libva1 libva-drm2 libva-x11-2 libgstreamer1.0-0Note for Ubuntu 24.04+ users: the package
libturbojpeg0was renamed tolibturbojpeg. If the install command above fails, replacelibturbojpeg0withlibturbojpeg.
3. Configure permissions:
```bash
# Add serial and video permissions
sudo usermod -a -G dialout,video $USER
# On Arch Linux, use 'uucp' instead of 'dialout'
sudo usermod -a -G uucp $USER
# Setup udev rules for device access
echo 'SUBSYSTEM=="usb", ATTRS{idVendor}=="534d", ATTRS{idProduct}=="2109", TAG+="uaccess"
SUBSYSTEM=="hidraw", ATTRS{idVendor}=="534d", ATTRS{idProduct}=="2109", TAG+="uaccess"
SUBSYSTEM=="ttyUSB", ATTRS{idVendor}=="1a86", ATTRS{idProduct}=="7523", TAG+="uaccess"
SUBSYSTEM=="usb", ATTRS{idVendor}=="1a86", ATTRS{idProduct}=="7523", TAG+="uaccess"' | sudo tee /etc/udev/rules.d/51-openterface.rules
sudo udevadm control --reload-rules
sudo udevadm trigger
- Install the package:
unzip openterfaceQT.deb.zip
sudo dpkg -i openterfaceQT.deb- Run the application:
openterfaceQTNote: You may need to log out and log back in for group permissions to take effect.
For Arch Linux users, a native .pkg.tar.zst package is available from GitHub Releases or built by the Arch Linux CI workflow:
# Download the package from GitHub Releases, then install:
sudo pacman -U openterfaceqt-*.pkg.tar.zstThis automatically installs all runtime dependencies (Qt6, FFmpeg, GStreamer, etc.) from the Arch repos and configures udev rules for USB device access.
For detailed instructions, see Arch Linux Installation.
For Fedora 42+ and RHEL-based distributions, an RPM package is available from GitHub Releases:
# Download the RPM package
curl -L -o openterfaceqt.rpm "https://github.com/TechxArtisanStudio/Openterface_QT/releases/latest/download/openterfaceqt-*.x86_64.rpm"
# Install with dnf
sudo dnf install ./openterfaceqt.rpm
# Add your user to required groups
sudo usermod -a -G dialout,video $USERThe RPM package includes:
- Pre-built binary optimized for Fedora
- Bundled Qt 6.6.3 libraries (or uses system Qt 6.9+ if available)
- Automatic udev rule configuration
- Desktop integration
For detailed instructions and troubleshooting, see Fedora Installation Guide.
💡 Permission issues? See the Linux Permission Access Guide on our Wiki for detailed troubleshooting of device permissions.
For detailed build instructions, see docs/BUILD.md.
Quick links:
Want to contribute? We'd love your help! Here's how to get started:
-
Clone the repository:
git clone https://github.com/TechxArtisanStudio/Openterface_QT.git cd Openterface_QT -
Install build dependencies: See Build from Source section for your OS
-
Build locally:
mkdir build && cd build cmake .. make ./openterfaceQT
- Report bugs: Open an issue
- Suggest features: Discuss in Issues
- Submit changes: Create a Pull Request
For detailed contribution guidelines, see CONTRIBUTING.md.
We welcome contributions including:
- 🐛 Bug fixes
- ✨ Feature implementations
- 📖 Documentation improvements
- 🌍 Translations
- 🧪 Test coverage
If you need to flash or update the firmware on the CH32V208 controller chip of your KeyMod, Openterface provides a built-in WCH ISP Flash Tool — no external programmer needed.
📖 Full guide: docs/ch32_firmware_flashing.md
| Step | Action | Details |
|---|---|---|
| 1️⃣ | Download firmware | Get the firmware from Openterface_KM Releases |
| 2️⃣ | Enter ISP mode | |
| 3️⃣ | Open flash tool | In the app: Menu → Advanced → WCH ISP Flash |
| 4️⃣ | Scan & Connect | Click Scan Devices, select your device, click Connect |
| 5️⃣ | Select firmware | Click Browse... and choose the firmware file |
| 6️⃣ | Flash | Click Flash, Verify & Reset and wait for completion |
| 7️⃣ | Reconnect | Unplug and re-plug the KeyMod normally (no BOOT button needed) |
⚠️ Important: You MUST hold the BOOT button on the KeyMod before plugging it into the computer to enter ISP/bootloader mode. Otherwise the flash tool will not detect the device.
| Chip | VID:PID (Normal) | VID:PID (ISP Mode) |
|---|---|---|
| CH32V208 | 1A86:FE0C |
1A86:55E0 / 4348:55E0 |
- Ensure the CH340 serial chip driver is installed. Download from WCH website
- Alternatively, install from the repository driver:
(Run as Administrator)
pnputil -a path\to\CH341SER.INF
- Download the CH340 driver from WCH website
- Extract and compile:
tar -xzf CH341SER_LINUX.tar.gz cd CH341SER make sudo make install - Load the driver:
sudo modprobe ch341
- Unplug and reconnect the device
- If still not working, check permissions using the Linux Installation - Manual section or see the Linux Permission Access Guide on our Wiki
For more troubleshooting, see docs/BUILD.md#troubleshooting.
Have questions or found a bug? We're here to help!
- 💬 Discord: Join our community for real-time discussions
- 🐛 GitHub Issues: Report bugs or request features
- 📧 Email: techxartisan@gmail.com
This project is licensed under AGPL-3.0 (Affero General Public License).
- ✅ Free to use, modify, and distribute
- ✅ Source code must be made available to recipients
- ✅ Modifications must be released under AGPL-3.0
- ❌ No warranty provided
For full license details, see LICENSE file in this repository.
This project uses excellent open-source libraries:
| Library | Version | License |
|---|---|---|
| Qt Framework | 6.4+ | LGPL v3 |
| libusb | 1.0.26+ | LGPL v2.1 |
| FFmpeg | Latest | LGPL v2.1+ / GPL v2 |
| FreeType | 2.13.2+ | GPL v2 / FreeType License |
| Fontconfig | 2.14.2+ | MIT License |
| PulseAudio | 16.1+ | LGPL v2.1+ |
| libxkbcommon | 1.7.0+ | MIT License |
For detailed license compliance information and LGPL library linking details, see LICENSE.
Questions about licensing? Email us or open an issue.