Customize Auxiliary Screen

2025-10-10
Update history
Date Version Author Update content
2025-10-10 v0.1 zepan
  • initial docs

Introduction

The NanoKVM-Pro Desk is equipped with a 1.47-inch 320x172 mini display. In addition to serving as a basic configuration interface, it can also display user-customized content in various ways, functioning as a secondary screen.

HDMI Secondary Screen

When NanoKVM-Pro is operating, it virtually emulates a monitor, allowing it to capture HDMI images and display them on its own screen, enabling HDMI secondary screen functionality.

In the UI, select the HDMI output video source to display the captured video image on the small screen.

When used as a desktop accessory, this feature can serve as a desktop mini secondary screen for performance monitoring, video thumbnail player, and other functions.

USB Secondary Screen

Currently, the USB secondary screen feature only supports Windows systems.

  1. Download and extract the USB secondary screen driver: https://github.com/sipeed/NanoKVM-Pro/releases/download/v1.0.5/nanokvmpro_usb_graphic_win.zip

  2. On the Desk: From the screen, tap Settings → USB to enter the USB configuration page, then enable Panel.

  3. On the controlled machine:

    • Open Device Manager → Other devices
    • Find NanoKVMPro → Right-click Properties → Driver → Update Driver
    • Select Browse my computer for drivers → Let me pick from a list of available drivers on my computer
    • Double-click Show all devices
    • Find USB Composite Device under Standard USB Host Controller / 标准 USB 主机控制器 / Standard system devices / 标准系统设备 → Double-click to install

    Note: Driver locations may vary across different Windows versions. Please search patiently.

  4. After completion, a new loop input to output device will appear under Other devices in Device Manager.

  5. Right-click the device → Update Driver → Browse my computer for drivers → Browse → Select the USB secondary screen driver folder → Next → Follow the prompts to complete installation.

  6. After driver installation is complete, a new NanoKVM graphics device will appear in the Display adapters section.

  7. On the Desk, navigate to the secondary screen page from the screen and select USB to use the Desk as a USB secondary screen.

  8. To disable, refer to step 2 and turn off Panel.

  9. When re-enabling, some systems may require reinstalling the USB driver.

Custom Display

The NanoKVM-Pro's small screen uses standard framebuffer drivers. Users can utilize /dev/fb0 to implement custom screen display operations.

hello.py
conway.py
coin.py