From de3db4299793450b6d28648852c70ba18ff7887c Mon Sep 17 00:00:00 2001
From: Romain Vimont <rom@rom1v.com>
Date: Sun, 5 Apr 2026 12:10:24 +0200
Subject: [PATCH] Document video codec alignment

PR #6746 <https://github.com/Genymobile/scrcpy/pull/6746>
---
 doc/video.md | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/doc/video.md b/doc/video.md
index 4de6814a..8cea0373 100644
--- a/doc/video.md
+++ b/doc/video.md
@@ -30,6 +30,17 @@ If encoding fails, scrcpy automatically tries again with a lower definition
 For camera mirroring, the `--max-size` value is used to select the camera source
 size instead (among the available resolutions).
 
+The size is rounded to a multiple of the _alignment_ required by the encoder, a
+power-of-2 value (1, 2, 4, 8 or 16) that the video width and height must be
+multiples of.
+
+The alignment can be forced to a minimum value. For instance, to force the width
+and height to be multiples of 8:
+
+```bash
+scrcpy --min-size-alignment=8
+```
+
 
 ## Bit rate