Skip to content

Display and control your Android device

Document --encoder option

Romain Vimont576814bcec57
diff --git a/README.md b/README.md
index 95a38409..1283aa50 100644
--- a/README.md
+++ b/README.md
@@ -203,6 +203,22 @@ scrcpy --lock-video-orientation 3 # 90° clockwise
This affects recording orientation.
+#### Encoder
+
+Some devices have more than one encoder, and some of them may cause issues or
+crash. It is possible to select a different encoder:
+
+```bash
+scrcpy --encoder OMX.qcom.video.encoder.avc
+```
+
+To list the available encoders, you could pass an invalid encoder name, the
+error will give the available encoders:
+
+```bash
+scrcpy --encoder _
+```
+
### Recording
It is possible to record the screen while mirroring:
diff --git a/app/scrcpy.1 b/app/scrcpy.1
index b16d1004..92b8e1e3 100644
--- a/app/scrcpy.1
+++ b/app/scrcpy.1
@@ -56,6 +56,10 @@ The list of possible display ids can be listed by "adb shell dumpsys display"
Default is 0.
+.TP
+.BI "\-\-encoder " name
+Use a specific MediaCodec encoder (must be a H.264 encoder).
+
.TP
.B \-\-force\-adb\-forward
Do not attempt to use "adb reverse" to connect to the device.