Update FAQ to match the latest version
Here are the common reported problems and their status.
+If you encounter any error, the first step is to upgrade to the latest version.
+
## `adb` issues
`scrcpy` execute `adb` commands to initialize the connection with the device. If
`adb` fails, then scrcpy will not work.
-In that case, it will print this error:
-
-> ERROR: "adb get-serialno" returned with value 1
-
This is typically not a bug in _scrcpy_, but a problem in your environment.
-To find out the cause, execute:
-
-```bash
-adb devices
-```
### `adb` not found
@@ -32,11 +25,9 @@ in the release, so it should work out-of-the-box.
### Device unauthorized
-
-> error: device unauthorized.
-> This adb server's $ADB_VENDOR_KEYS is not set
-> Try 'adb kill-server' if that seems wrong.
-> Otherwise check for a confirmation dialog on your device.
+> ERROR: Device is unauthorized:
+> ERROR: --> (usb) 0123456789abcdef unauthorized
+> ERROR: A popup should open on the device to request authorization.
When connecting, a popup should open on the device. You must authorize USB
debugging.
@@ -48,10 +39,16 @@ If it does not open, check [stackoverflow][device-unauthorized].
### Device not detected
-> error: no devices/emulators found
+> ERROR: Could not find any ADB device
Check that you correctly enabled [adb debugging][enable-adb].
+Your device must be detected by `adb`:
+
+```
+adb devices
+```
+
If your device is not detected, you may need some [drivers] (on Windows). There is a separate [USB driver for Google devices][google-usb-driver].
[enable-adb]: https://developer.android.com/studio/command-line/adb.html#Enabling
@@ -63,12 +60,23 @@ If your device is not detected, you may need some [drivers] (on Windows). There
If several devices are connected, you will encounter this error:
-> error: more than one device/emulator
+ERROR: Multiple (2) ADB devices:
+ERROR: --> (usb) 0123456789abcdef device Nexus_5
+ERROR: --> (tcpip) 192.168.1.5:5555 device GM1913
+ERROR: Select a device via -s (--serial), -d (--select-usb) or -e (--select-tcpip)
+
+In that case, you can either provide the identifier of the device you want to
+mirror:
+
+```bash
+scrcpy -s 0123456789abcdef
+```
-the identifier of the device you want to mirror must be provided:
+Or request the single USB (or TCP/IP) device:
```bash
-scrcpy -s 01234567890abcdef
+scrcpy -d # USB device
+scrcpy -e # TCP/IP device
```
Note that if your device is connected over TCP/IP, you might get this message:
