pikvm/docs/video.md

# Working with video

## Video recording

!!! info
    H.264 is available on Pi 3 and Pi 4. Older boards won't handle it. Best of all this feature only works for HDMI to CSI bridge. For the USB HDMI dongle, there will be a decrease in FPS to 10-15 for 1080p. Work in progress.

1. Perform full system update to get the latest uStreamer and install ffmpeg:

    ```
    # rw
    # pacman -Syu ffmpeg
    ```

2. For USB dongle only: Add line `gpu_mem=256` to `/boot/config.txt`.

3. Perform `reboot` command.

4. Run `rw` after the reboot.

6. To record a video, you need to enable the stream (open the web interface or connect via VNC). Then run something like this in the console:

    ```
    # rw
    # ustreamer-dump --sink kvmd::ustreamer::h264 --output - | ffmpeg -use_wallclock_as_timestamps 1 -i pipe: -c:v copy test.mp4
    ```

7. Press `Ctrl+C` to stop recording. Your video will be in the file `test.mp4`.

8. After finishing work, do not forget to switch the file system to read-only mode using `ro` command.


## Take a screenshot via console on PiKVM

!!! note
    You must have a stream running

```
# curl --unix-socket /run/kvmd/ustreamer.sock http://localhost/snapshot -o /tmp/screen.jpg
```
docs.pikvm.org 2021-10-12 18:45:00 +00:00			`# Working with video`

			`## Video recording`

			`!!! info`
			`H.264 is available on Pi 3 and Pi 4. Older boards won't handle it. Best of all this feature only works for HDMI to CSI bridge. For the USB HDMI dongle, there will be a decrease in FPS to 10-15 for 1080p. Work in progress.`

			`1. Perform full system update to get the latest uStreamer and install ffmpeg:`

			```
			`# rw`
update documentation to reflect best-practices (#857) * update tailscale.md to reflect best-practices The provided -Syy is supposed to be used to redownload all package databases, while the command chain itself is a partial upgrade which is not recommended either for rolling release distributions. Replace the full database redownload with a database update and run a system upgrade while installing tailscaled. * remove unnecessary sync command from video.md * remove unnecessary sync command from bluetooth_hid.md * remove unnecessary sync command from arduino_hid.md * update faq.md to reflect best practices * update letsencrypt.md to keep system up-to-date when installing packages 2022-11-09 19:16:22 +00:00			`# pacman -Syu ffmpeg`
docs.pikvm.org 2021-10-12 18:45:00 +00:00			```

			2. For USB dongle only: Add line `gpu_mem=256` to `/boot/config.txt`.

			3. Perform `reboot` command.

			4. Run `rw` after the reboot.

			`6. To record a video, you need to enable the stream (open the web interface or connect via VNC). Then run something like this in the console:`

			```
			`# rw`
			`# ustreamer-dump --sink kvmd::ustreamer::h264 --output - \| ffmpeg -use_wallclock_as_timestamps 1 -i pipe: -c:v copy test.mp4`
			```

			7. Press `Ctrl+C` to stop recording. Your video will be in the file `test.mp4`.

			8. After finishing work, do not forget to switch the file system to read-only mode using `ro` command.


			`## Take a screenshot via console on PiKVM`

			`!!! note`
			`You must have a stream running`

			```
			`# curl --unix-socket /run/kvmd/ustreamer.sock http://localhost/snapshot -o /tmp/screen.jpg`
			```