GLKVM macOS Companion

How to Use the App

Install the app.
Build and run the app in Xcode, or use your distributed build. Grant microphone permissions if prompted.
Open Settings and set your KVM URL.
Use the format http://10.0.100.185 or http://192.168.x.x. If your KVM requires an admin password, enter it and click Save & Reload.

Set the KVM address and reload.
Choose your video and device preferences.
In the KVM UI pane, pick video quality and device settings (speaker, microphone, keyboard, mouse). The app improves macOS-specific behavior for modifier keys and cursor control.

Configure devices and video as needed.
Use Virtual Media to mount ISOs or files.
From the KVM interface, use Virtual Media to mount an ISO, disk image, or files directly to the remote host.

Virtual Media workflow exposed directly in the app.
Audio devices (important notes).
- Microphone: The app prioritizes the selected microphone for WebRTC capture when pages request audio.
- Output: On macOS, WebKit pages output to the system default device. If you need per‑app output routing, use a virtual device tool (e.g., Rogue Amoeba Loopback or BlackHole) and set that as system output.

No audio: Check macOS input permissions and ensure the KVM page requests microphone access.
Keyboard shortcuts not working: Verify modifier keys in the KVM UI and try toggling the app’s keyboard preferences.
Mouse cursor issues: Switch between Absolute and Relative mouse modes in the KVM UI.

Place screenshots in glkvm-support/assets/images/ with filenames used above to display them here.