From 85bdff32d7e4f57914540340c0ddf7d3fb39e05f Mon Sep 17 00:00:00 2001
From: Maxim Devaev <mdevaev@gmail.com>
Date: Mon, 27 Oct 2025 20:48:16 +0200
Subject: [PATCH] update

---
 docs/api.md   | 10 ++++++++++
 docs/video.md | 28 +++++++++++++---------------
 2 files changed, 23 insertions(+), 15 deletions(-)

diff --git a/docs/api.md b/docs/api.md
index 380a7041..fa6ec8fe 100644
--- a/docs/api.md
+++ b/docs/api.md
@@ -1950,3 +1950,13 @@ The `GET /api/export/prometheus/metrics` handle returns the Prometheus metrics.
 ```console
 $ curl -k -u admin:admin https://<pikvm-ip>/api/export/prometheus/metrics
 ```
+
+----
+## Video
+
+PiKVM has 3 different ways to receive video and audio, depending on the device.
+This is also [reflected](video.md) in the web interface.
+
+| Mode |
+
+### Get raw H.264 video stream
diff --git a/docs/video.md b/docs/video.md
index d8e0f12d..8e9a4f0e 100644
--- a/docs/video.md
+++ b/docs/video.md
@@ -123,34 +123,32 @@ this may include any RedHat or Debian variant. Here some examples:
 
 At the moment, it is not possible to record videos in a convenient way from the Web UI,
 but a small trick in the console can be used to record videos without sound.
-It's only available on same PiKVM models which support H.264 video.
+It's only available on all PiKVM models which support H.264 video.
 
-??? example "Recording video from terminal"
+Available since KVMD 4.110
 
-    1. Update OS:
+??? example "Recording video from terminal on Linux or Mac OS"
 
-        {!_update_os.md!}
+    1. Install `ffmpeg` and `websocat`.
 
-    2. Install `ffmpeg` package and reboot:
+    2. Let's assume that your PiKVM is located on `https://pikvm` and uses a self-signed certificate.
+        Request the stream from it from the first opened console on your PC (not PiKVM):
 
         ```console
-        [root@pikvm ~]# rw
-        [root@pikvm ~]# pacman -S ffmpeg
-        [root@pikvm ~]# reboot
+        [user@host ~]$ websocat -k wss://pikvm/api/ws?stream=1 -H X-KVMD-User:admin -H X-KVMD-Passwd:admin
         ```
 
-    3. After reboot, switch filesystem to RW-mode again using the `rw` command
-
-    4. To record a video, open the Web UI (i.e. stream should be running) or connect via VNC.
-        Next, run the recording process in the current directory:
+    3. Keeping the previous command running, open a new terminal and run the video recording process:
 
         ```console
-        [root@pikvm ~]# ustreamer-dump --sink kvmd::ustreamer::h264 --output - | ffmpeg -use_wallclock_as_timestamps 1 -i pipe: -c:v copy my_video.mp4
+        [user@host ~]$ websocat -b -B 10000000 -k wss://pikvm/api/media/ws?video=h264 -H X-KVMD-User:admin -H X-KVMD-Passwd:admin | ffmpeg -use_wallclock_as_timestamps 1 -i pipe: -c:v copy my_captured_video.mp4
         ```
 
-    5. Press `Ctrl+C` to stop the recording, and don't forget to switch filesystem to read-only mode using the `ro` command.
+    4. Same can be done on PiKVM itself, locally.
 
-??? example "Take a screenshot from terminal"
+    5. Press `Ctrl+C` to stop the recording.
+
+??? example "Take a screenshot from terminal on PiKVM"
 
     To take a screenshot, switch filesystem to RW-mode like in previous example and run the stream.