KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#typescript #ai-agents #developer-tools #cli #codex #claude-code #dsh-plugin #mcp #react #agent #dsh #deepseek-harness

DezKVM-Go

★ 109 Open GitHub ↗

A mini KVM over USB device for sysadmins to use their laptop to control headless computers or servers

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

![](https://raw.githubusercontent.com/tobychui/DezKVM-Go/main/img/title.png)

# DezKVM-Go

A mini KVM over USB device for onsite engineers to use their laptop to control headless computers or servers.

If you are looking for an IP-KVM solution, take a look at the [DezKVM](https://github.com/tobychui/DezKVM) Project!

[DezKVM-Go Project Homepage](https://kvm.aroz.org/)

## Features

- Small form factor , just 84 x 53 x 18mm
- Cheap & Easy to build, costing just under $20 USD per unit
- Fully featured software that do not require installing any apps
  - Live video and audio feeds
  - Paste box (host to remote computer through automatic virtual keyboard HID events)
  - Copy via OCR (remote to host computer through OCR image to text conversion) 
  - On-screen keyboard
  - Commonly used Hot-key and macros
  - Take Screenshots
  - Screen Recorder (with support of partial screen record)
  - Key Stacking (similar to Pi-KVM Magic-Key)
- Advanced Settings
  - Invert mouse scroll wheel direction (for Windows / MacOS cross control)
  - Absolute / Relative mode for mouse
  - Mouse Jiggler
  - WebGL based Image Sharpening feature (for Terminal / text based sessions)
  - Extra gain (when remote volume is too loud / quiet)
  - Support both 9600 & 115200 configuration of CH9329
  
## Usage

1. Insert the DezKVM-Go host side USB port into your laptop using a USB type-C cable (located on the white / black side, depends on your device casing color)
2. Insert the DezKVM-Go remote side USB port and HDMI port into the remote server or computer you want to control (located on the orange side)
3. Visit the [DezKVM-Go control panel](https://tobychui.github.io/DezKVM-Go/) or if you are working online, start the usbkvm application and visit `https://localhost:8443/` using Chrome, Edge or any Chromium browsers that support Web-Serial API.

## Quick Start

![](https://raw.githubusercontent.com/tobychui/DezKVM-Go/main/img/quickstart.png)

## Building the Hardware

To build the hardware, you will need the following items

- A DezKVM-Go PCB (See the `PCB` folder and the `how-to-place-order` folder on how to order them )
  ![image-20251221203251642](https://raw.githubusercontent.com/tobychui/DezKVM-Go/main/img/README/image-20251221203251642.png)
- A MS2109 HDMI capture card (usually around $7 - 9 USD a pcs)
- A 3D printer (for the case, see `3D Models` folder)
- M3x10 screws x 2
- USB type-C cable x 2 and HDMI cable x 1

For details, see the PCB folder.

## Building the Software

There is no need to build anything since all of the control code of this system is written in vanilla js in the web front-end. However, this project do come with a Golang written https server in which if you have difficulties deploying a website with https , you can use that https server to deploy a locally hosted version of the DezKVM viewer.

To build the local version of DezKVM viewer, follow the instruction below.

```bash
cd ./src
go mod tidy
go build
```

*Note: you will also need to configure the CH9329 chip to use the 115200 baudrate for the front-end to work. Please follow the instructions in CH9329 datasheet to perform the baudrate change procedures before use.*

## Screenshots

![](https://raw.githubusercontent.com/tobychui/DezKVM-Go/main/img/0.jpg)

![](https://raw.githubusercontent.com/tobychui/DezKVM-Go/main/img/1.jpg)

![](https://raw.githubusercontent.com/tobychui/DezKVM-Go/main/img/5.jpg)

![image-20260218134153419](https://raw.githubusercontent.com/tobychui/DezKVM-Go/main/img/README/image-20260218134153419.png)

[See more screenshots](https://github.com/tobychui/DezKVM-Go/wiki/Screenshots)

## DezKVM-Go Device

Here are a few photos on the device itself if you are interested.

![DSC00491](https://raw.githubusercontent.com/tobychui/DezKVM-Go/main/img/README/DSC00491.jpg)

![DSC00499](https://raw.githubusercontent.com/tobychui/DezKVM-Go/main/img/README/DSC00499.jpg)

![DSC00501](https://raw.githubusercontent.com/tobychui/DezKVM-Go/main/img/README/DSC00501.jpg)

![DSC00515](https://raw.githubusercontent.com/tobychui/DezKVM-Go/main/img/README/DSC00515.jpg)

![photo_2025-12-31_22-12-53](https://raw.githubusercontent.com/tobychui/DezKVM-Go/main/img/README/photo_2025-12-31_22-12-53.jpg)

![photo_2025-12-29_20-14-56](https://raw.githubusercontent.com/tobychui/DezKVM-Go/main/img/README/photo_2025-12-29_20-14-56.jpg)

### Generation 2 (MS2109S)

Due to shortage of MS2109, the HDMI capture card market are slowly shifting towards a new design of such capture card that uses MS2109S  (looks identical to the old MS2109 one, so it is hard to tell by just looking at the case of it),

In case you bought a HDMI capture card and realize it didn't fit because it is a MS2109S device, you can unscrew the metal case and use the bare PCB directly. Installation methods are as follows (notes: an additional 3D printed part and 3 x M2 x 5 screws are needed)

![gen2-diff](https://raw.githubusercontent.com/tobychui/DezKVM-Go/main/img/README/gen2-diff.jpg)

### Generation 3 (MS2109S + PCBv2)

The generation 3 uses a newly designed PCB (rev2) with the MS2109S HDMI capture card main board, which makes it more compact and easier to mass-produce using more commonly available ICs and component packages from other PCBA service providers. This new generation also exposes the downstream USB port for hackers to add more features to this board.

![pcb_update](https://raw.githubusercontent.com/tobychui/DezKVM-Go/main/img/README/pcb_update.jpg)

### Buy a Ready-to-use Device

If you’d rather skip the build, I’ve put together some DezKVM Go devices that are ready to go.

You can find them on my Tindie store (limited availability):

https://www.tindie.com/products/tobychui/dezkvm-go-kvm-over-usb-device/

## License

Software: GPLv3

Hardware: CC BY-NC-ND

DezKVM-Go

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README