Archives/pikvm
2
0
Fork 0
mirror of https://github.com/pikvm/pikvm synced 2024-11-10 13:10:37 +00:00
Code Issues Projects Releases Wiki Activity
cac641bf6a
pikvm/docs/pass.md
Maxim Devaev 7a840a1a9e update
2024-03-16 17:32:34 +02:00

2.2 KiB
Raw Blame History

HDMI Video Passthrough

This is a new exclusive feature available only on PiKVM V4 Plus. It allows you to connect PiKVM to the gap between the target host and the display. Thus, PiKVM does not interfere with the normal operation of the display and passes the video signal through itself until you need remote access via PiKVM In this case, PiKVM directs the video stream to the Web UI or VNC.

!!! info

* The passthrough feature supports a screen resolution **up to 1920x1200** pixels.
* Other PiKVM devices besides V4 Plus do not support the passthrough due to hardware limitations.

This is shown more clearly below:

Setting up the passthrough

  1. Connect the display to OUT2 port on the back side of PiKVM V4 Plus.

  2. Update OS and reboot:

    {!_update_os.md!}

  3. Switch filesystem to RW-mode:

    # rw

  4. Add these lines to /boot/config.txt:

    dtoverlay=vc4-kms-v3d
disable_overscan=1

  5. Enable the passthrough service:

    # systemctl enable kvmd-pass

  6. Perform the soft reboot:

    # reboot

After rebooting, you will see an image on the display. If you open the stream in the Web UI or VNC, the image on display will be temporarily stopped and redirected to the remote access session.

Current limitations

Please note the feature is still new and will be improved.

  • The video cannot be shown simultaneously on the display and in a remote access session. During a remote session, you will see the STREAM IS ACTIVE text on the display instead of the image.

  • Display resolution must be greater than or equal to that used by PiKVM capture. If the maximum display resolution is 720p and the signal has a 1080p resolution, you will not see the image. PiKVM does not perform any downscaling.

  • At the same time, PiKVM will try to show at least something than nothing. If the input signal has a resolution of 1920x1200, and the display supports only 1920x1080, the image will be shown but cropped from the bottom so that you at least have the opportunity to adjust the image parameters of the host.

  • Audio is not supported at the moment.