update

README.md

@@ -243,6 +243,7 @@ These kind people donated money to the PiKVM project and supported work on it. W
 * AdamBomb
 * adipisicing
 * Adrian Basham
+* Adrian Popescu
 * Ahmed Syed
 * Alberto Bassi
 * alejandro
@@ -408,6 +409,7 @@ These kind people donated money to the PiKVM project and supported work on it. W
 * Egan Ford
 * Elani Ferri
 * Elliot Woo
+* Entt
 * Eric Phenix
 * Ethan Shold
 * Eugene Sukhodolin

docs/edid.md

@@ -27,7 +27,7 @@ If you need to restore the default EDID you can easily do this with `kvmd-edidco
 
 ```console
 # rw
-# kvmd-edidconf --restore-default=v4plus
+# kvmd-edidconf --import-preset=v4plus
 # reboot
 ```
 Available options: `v0`, `v1`, `v2`, `v3`, `v4mini` and `v4plus`.
@@ -36,9 +36,35 @@ Also defaults edid can be found locally on your PiKVM: `/usr/share/kvmd/configs.
 or in the [kvmd repo](https://github.com/pikvm/kvmd/blob/master/configs/kvmd/edid).
 
 
-## EDID examples for V4+
+## Force 1080p by defailt on PiKVM V0+
 
-PiKVM can mimic physical monitors. You can find the appropriate EDID in [this database](https://github.com/linuxhw/EDID) and import its HEX code to PiKVM. Choose something with a maximum resolution of 1920x1080 or 1920x1200.
+PiKVM V3 (or DIY V0-V2) has a hardware limit of 50Hz for 1080p mode, and this is a less common frequency than 60Hz.
+Therefore, on V3, the default mode is 720p. Some OS (like Proxmox) may not work well with 720p,
+so you can force 1080p resolution by default:
+
+```console
+# rw
+# kvmd-edidconf --import-preset=v3.1080p-by-default  # Or, for example, v1.1080p-by-default
+# reboot
+```
+
+
+## Disable 1920x1200 on PiKVM V4
+
+PiKVM V4 supports the advanced capture mode of 1920x1200. If it bothers you
+(for example, if you use a physical monitor 1920x1080 with [video passthrough](pass.md)),
+you can easily disable it and use only 1920x1080:
+
+```console
+# rw
+# kvmd-edidconf --import-preset=v4plus.no-1920x1200  # Or v4mini.no-1920x1200
+# reboot
+```
+
+
+## Other EDID examples for PiKVM V4
+
+PiKVM V4 can mimic many physical monitors. You can find the appropriate EDID in [this database](https://github.com/linuxhw/EDID) and import its HEX code to PiKVM. Choose something with a maximum resolution of 1920x1080 or 1920x1200.
 
 ??? example "Acer B246WL, 1920x1200, with audio"
     Taken [here](https://github.com/linuxhw/EDID/blob/master/Digital/Acer/ACR0565/CCF78B30FE61), as described above.
@@ -105,7 +131,7 @@ PiKVM can mimic physical monitors. You can find the appropriate EDID in [this da
     ```
 
 
-## EDID examples for V2+
+## EDID examples for PiKVM V2+
 
 Copy the contents into a file, for example `/root/edid.hex`, then follow the same steps as above.
 

docs/pass.md

@@ -1,7 +1,7 @@
 # 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.
+It allows you to connect PiKVM to the gap between the target host and physical 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.
@@ -37,30 +37,52 @@ This is shown more clearly below:
     disable_overscan=1
     ```
 
-4. Enable the passthrough service:
+4. Add some config to `/etc/kvmd/override.yaml`:
-
+
-    ```console
+    ```yaml
-    # systemctl enable kvmd-pass
+    kvmd:
+        streamer:
+            forever: true
+            cmd_append:
+                - "--format=rgb24"
+                - "--buffers=8"
+                - "--encoder=cpu"
+                - "--v4p"
     ```
 
-5. Perform the soft reboot:
+5. Disable old alpha passthrough service and perform the soft reboot:
 
     ```console
+    # systemctl disable kvmd-pass
     # reboot
     ```
 
-After rebooting, you will see an image on the display.
+After rebooting, you will see an image on the physical 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.
+
+-----
+## My monitor does not support the 1920x1200 mode
+
+PiKVM V4 supports the advanced capture mode of 1920x1200.
+If your physical monitor is limited to 1920x1080, then part of the image from the bottom will be cropped.
+
+To avoid this, you can change the resolution of the host OS, or if the OS does not support this,
+disable the 1920x1200 mode on PiKVM itself:
 
+```console
+# rw
+# kvmd-edidconf --import-preset=v4plus.no-1920x1200  # Or v4mini.no-1920x1200
+# reboot
+```
 
 -----
 ## Current limitations
 
-Please note the feature is still new and will be improved.
+Please note the feature is pretty new and will be improved.
 
-* The video cannot be shown simultaneously on the display and in a remote access session.
+* The colors in the H.264 webstream will be slightly highlighted,
-    During a remote session, you will see the `STREAM IS ACTIVE` text on the display instead of the image.
+    [this is a bug in the Raspberry firmware](https://github.com/raspberrypi/firmware/issues/1885),
+    it will be fixed soon.
 
 * 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.