Software Setup | Openterface KVM Extension for uConsole

Installation Overview

The Openterface App enables your uConsole to function as a KVM interface, allowing you to control target devices through the built-in screen, keyboard, and trackball.

Requirements

uConsole: Requires Openterface App installed
Target: No app needed - supports Windows, macOS, Linux, Android, iOS
Video: Use standard HDMI cable. Use a standard HDMI cable. With a powered HDMI converter, it also supports other formats such as VGA, DP, and more. Tip: Ensure the converter is properly powered; otherwise, you may experience a black screen.

Installation Methods

Option 1: Flatpak Installation

Follow our Flatpak Installation Guide for detailed setup steps.

Option 2: Community Repository (Recommended)

If you prefer the community build maintained by Rex:

Add Repository:

Bash

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"

Install Package:

Bash

sudo apt update
sudo apt install openterfaceqt

Repository Notes

These commands require sudo. The repository targets arm64 Bookworm packages; verify compatibility with your device before installing.

Usage Instructions

Starting the KVM Session

Launch the Openterface App on your uConsole
The app will automatically detect the KVM Extension board
Connect your target device via HDMI
Use uConsole's built-in keyboard and trackball to control the target device

Control Features

Keyboard: Full keyboard emulation including multimedia keys
Mouse: Absolute and relative mouse positioning
Audio: HDMI audio passthrough to uConsole speakers

Advanced Features

Text Transfer: Quickly transmit text by simulating keystrokes—ideal for usernames, passwords, and code snippets
Switchable USB: Easily switch USB access between the uConsole and the target device using the host app