JetKVM - Control any computer remotely
kvm
Go to file
Alex P 49d62f8eb0 Cleanup: only set PKG_CONFIG_PATH once 2025-09-12 09:22:14 +00:00
.devcontainer [#315] Updates: add advanced audio support 2025-08-02 02:23:37 +00:00
.github Merge branch 'dev' into feat/audio-support 2025-09-05 14:40:23 +00:00
.vscode chore: add VSCode extensions for improved development environment (#509) 2025-05-23 14:38:15 +02:00
bin Release 202412292127 2024-12-29 21:27:42 +01:00
cmd feat(audio): implement audio input supervisor and opus config management 2025-08-28 22:02:22 +00:00
internal Fix: add accidentally removed test file back, devcontainer build process on clean devcontainer 2025-09-12 09:10:31 +00:00
resource [WIP] Performance Enhancements: move audion processing into a separate process 2025-08-22 12:04:30 +00:00
tools perf(build): update ARM optimization flags for better compatibility 2025-09-04 08:25:16 +00:00
ui Merge branch 'dev' into feat/audio-support 2025-09-12 01:18:46 +03:00
.gitignore feat(audio): optimize audio processing with batch processing and goroutine monitoring 2025-09-03 12:10:54 +00:00
.golangci.yml Improvements, Fixes: reduce mouse lag when audio is on 2025-08-04 23:29:47 +03:00
CODE_OF_CONDUCT.md Release 202412292127 2024-12-29 21:27:42 +01:00
DEVELOPMENT.md Docs: Updated documentation 2025-08-24 23:15:46 +00:00
LICENSE Release 202412292127 2024-12-29 21:27:42 +01:00
Makefile Cleanup: only set PKG_CONFIG_PATH once 2025-09-12 09:22:14 +00:00
README.md Docs: Updated documentation 2025-08-24 23:15:46 +00:00
audio_handlers.go [WIP] Change playback latency spikes on Audio Output Quality changes 2025-09-08 22:55:19 +00:00
audio_session_provider.go Refactoring: Move most audio business logic into the audio package 2025-09-05 17:22:14 +00:00
block_device.go chore/Deprecate browser mount (#752) 2025-08-28 23:46:55 +02:00
block_device_linux.go network enhanecment / refactor (#361) 2025-04-16 01:39:23 +02:00
block_device_notlinux.go network enhanecment / refactor (#361) 2025-04-16 01:39:23 +02:00
cloud.go feat(audio): add audio handlers and refactor session management 2025-09-05 16:30:09 +00:00
config.go Merge branch 'dev' into feat/audio-support 2025-09-12 01:18:46 +03:00
dc_metrics.go feat(metrics): adding prometheus metrics for dc power extension (#556) 2025-07-11 17:04:41 +02:00
dev_deploy.sh feat(usbgadget): add nil checks for gadget operations and cleanup tests 2025-08-25 22:24:41 +00:00
display.go Merge branch 'dev' into feat/audio-support 2025-09-05 14:40:23 +00:00
go.mod chore: serve pre-compressed static files (#793) 2025-09-11 19:17:15 +02:00
go.sum chore: serve pre-compressed static files (#793) 2025-09-11 19:17:15 +02:00
hidrpc.go [WIP] Cleanup: Remove hid optimization code, as it is out of scope 2025-09-09 23:31:58 +00:00
hw.go network enhanecment / refactor (#361) 2025-04-16 01:39:23 +02:00
jiggler.go fix/Jiggler settings not saving (#786) 2025-09-09 14:48:49 +02:00
jsonrpc.go Merge branch 'dev' into feat/audio-support 2025-09-12 01:18:46 +03:00
log.go feat: hid rpc channel (#755) 2025-09-04 22:27:56 +02:00
main.go [WIP] Cleanup: reduce PR complexity 2025-09-09 06:52:40 +00:00
mdns.go network enhanecment / refactor (#361) 2025-04-16 01:39:23 +02:00
native.go Updates: merge 'dev' intu 'feat/audio-support' 2025-09-05 15:07:54 +00:00
native_linux.go Updates: merge 'dev' intu 'feat/audio-support' 2025-09-05 15:07:54 +00:00
native_notlinux.go Updates: merge 'dev' intu 'feat/audio-support' 2025-09-05 15:07:54 +00:00
network.go chore(network): fix linting error errcheck 2025-07-11 11:30:02 +02:00
ota.go Implement HTTP proxy option (#515). (#521) 2025-07-11 17:43:22 +02:00
prometheus.go Fix: go lint errors 2025-08-22 23:23:07 +00:00
publish_source.sh fix: Shell linting (#328) 2025-04-11 00:43:45 +02:00
serial.go Improvements, Fixes: reduce mouse lag when audio is on 2025-08-04 23:29:47 +03:00
session_provider.go Separation of Concerns: Move the audio-related code into the audio internal package 2025-08-05 02:04:37 +03:00
terminal.go Improvements, Fixes: reduce mouse lag when audio is on 2025-08-04 23:29:47 +03:00
test_usbgadget feat(usbgadget): add nil checks for gadget operations and cleanup tests 2025-08-25 22:24:41 +00:00
timesync.go network enhanecment / refactor (#361) 2025-04-16 01:39:23 +02:00
usb.go [WIP] Cleanup: Remove hid optimization code, as it is out of scope 2025-09-09 23:31:58 +00:00
usb_mass_storage.go chore/Deprecate browser mount (#752) 2025-08-28 23:46:55 +02:00
version.go feat: add command to show version (#604) 2025-07-11 11:32:46 +02:00
video.go Updates: merge 'dev' intu 'feat/audio-support' 2025-09-05 15:07:54 +00:00
web.go Merge branch 'dev' into feat/audio-support 2025-09-12 01:18:46 +03:00
web_tls.go fix: ensure certStore is initialised when adding custom cert (#639) 2025-06-30 18:58:39 +02:00
webrtc.go [WIP] Fix: Audio Latency issues: move audio to a dedicated media stream 2025-09-09 00:23:15 +00:00
wol.go Add ability to track modifier state on the device (#725) 2025-08-26 17:09:35 +02:00

README.md

JetKVM is a high-performance, open-source KVM over IP (Keyboard, Video, Mouse, Audio) solution designed for efficient remote management of computers, servers, and workstations. Whether you're dealing with boot failures, installing a new operating system, adjusting BIOS settings, or simply taking control of a machine from afar, JetKVM provides the tools to get it done effectively.

Features

  • Ultra-low Latency - 1080p@60FPS video with 30-60ms latency using H.264 encoding. Smooth mouse, keyboard, and audio for responsive remote control.
  • First-Class Audio Support - JetKVM now supports bidirectional, low-latency audio streaming using a dual-subprocess architecture with ALSA and Opus integration via CGO. Features both audio output (PC→Browser) and audio input (Browser→PC) with dedicated subprocesses for optimal performance and isolation.
  • Free & Optional Remote Access - Remote management via JetKVM Cloud using WebRTC.
  • Open-source software - Written in Golang (with CGO for audio) on Linux. Easily customizable through SSH access to the JetKVM device.

Contributing

We welcome contributions from the community! Whether it's improving the firmware, adding new features, or enhancing documentation, your input is valuable. We also have some rules and taboos here, so please read this page and our Code of Conduct carefully.

I need help

The best place to search for answers is our Documentation. If you can't find the answer there, check our Discord Server.

I want to report an issue

If you've found an issue and want to report it, please check our Issues page. Make sure the description contains information about the firmware version you're using, your platform, and a clear explanation of the steps to reproduce the issue.

Development

JetKVM is written in Go & TypeScript, with some C for low-level integration. Audio support uses a sophisticated dual-subprocess architecture with CGO, ALSA, and Opus integration for bidirectional streaming with complete process isolation.

The project contains two main parts: the backend software (Go, CGO) that runs on the KVM device, and the frontend software (React/TypeScript) that is served by the KVM device and the cloud.

For comprehensive development information, including setup, testing, debugging, and contribution guidelines, see DEVELOPMENT.md.

For quick device development, use the ./dev_deploy.sh script. It will build the frontend and backend and deploy them to the local KVM device. Run ./dev_deploy.sh --help for more information.

Backend

The backend is written in Go and is responsible for KVM device management, audio/video streaming, the cloud API, and the cloud web. Audio uses dedicated subprocesses for both output and input streams, with CGO-based ALSA and Opus processing, IPC communication via Unix sockets, and comprehensive process supervision for reliability.

Frontend

The frontend is written in React and TypeScript and is served by the KVM device. It has three build targets: device, development, and production. Development is used for the cloud version on your local machine, device is used for building the frontend for the KVM device, and production is used for building the frontend for the cloud.