Software Setup | Extension Module v2

Installation overview

The Openterface host app enables your uConsole to function as a KVM interface with HDMI capture, USB HID control, SD card switching, and USB port sharing between host and target.

Installation methods

Option 1: GitHub Releases (recommended for arm64)

1. Visit Openterface_QT Releases.
2. Download the latest .deb for arm64 (e.g. openterfaceqt_*_arm64.deb).
3. Install:

   sudo apt install ./openterfaceqt_*_arm64.deb
   

Option 2: Flatpak

Follow the Flatpak Installation Guide.

Option 3: Community repository (ClockworkPi Bookworm)

Maintained by Rex for ClockworkPi images:

1. Add repository:

   wget -q -O- https://raw.githubusercontent.com/ak-rex/ClockworkPi-apt/main/bookworm/KEY.gpg | gpg --dearmor | sudo tee /etc/apt/trusted.gpg.d/ak-rex.gpg
   sudo add-apt-repository -y "deb [arch=arm64] https://raw.githubusercontent.com/ak-rex/ClockworkPi-apt/main/bookworm stable main"
   

2. Install:

   sudo apt update
   sudo apt install openterfaceqt
   

Important reminders

Usage

Starting a KVM session

1. Launch Openterface QT on your uConsole.
2. The app detects Extension Module v2 automatically.
3. Connect the target via HDMI and USB.
4. Use the uConsole keyboard and trackball to control the target.

Control features

• Keyboard: Full emulation including multimedia keys
• Mouse: Absolute and relative positioning
• Audio: HDMI audio passthrough to uConsole speakers
• Text transfer: Paste usernames, passwords, and snippets as simulated keystrokes
• USB switching: Share USB storage between uConsole and target via the host app — see Connect to Target
• SD card switching: Mount the SD card to host or target via the host app — see SD Card Guide

Troubleshooting software install

If the app is hard to install or mouse/keyboard do not work:

• Confirm you installed the arm64 build on your uConsole CM4/module
• Join Discord for real-time help
• Report issues on GitHub — Openterface_QT

Related

• Connect to Target
• SD Card Guide
• FAQs