From 14b15ceb0637d1c48a7387b0fb14e98632746e9c Mon Sep 17 00:00:00 2001
From: Romain Vimont <rvimont@genymobile.com>
Date: Sun, 11 Mar 2018 10:34:11 +0100
Subject: [PATCH] Add a FAQ for common issues

---
 FAQ.md    | 84 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 README.md |  5 ++++
 2 files changed, 89 insertions(+)
 create mode 100644 FAQ.md

diff --git a/FAQ.md b/FAQ.md
new file mode 100644
index 00000000..af3a41a3
--- /dev/null
+++ b/FAQ.md
@@ -0,0 +1,84 @@
+# Frequently Asked Questions
+
+## Common issues
+
+The application is very young, it is not unlikely that you encounter problems
+with it.
+
+Here are the common reported problems and their status.
+
+### On Windows, I have no output in the console
+
+When run in `cmd.exe`, the application does not print anything. Even `scrcpy
+--help` have no output. We don't know why yet.
+
+However, if you run the very same `scrcpy.exe` from
+[MSYS2](https://www.msys2.org/) (`mingw64`), then it correctly prints output.
+
+
+### On Windows, when I start the application, nothing happens
+
+The previous problem does not help to get a clue about the cause.
+
+The most common is your device not being detected by `adb`, or is unauthorized.
+Check everything is ok by calling:
+
+    adb devices
+
+Windows may need some [drivers] to detect your device.
+
+[drivers]: https://developer.android.com/studio/run/oem-usb.html
+
+If you still encounter problems, please see [issue 9].
+
+[issue 9]: https://github.com/Genymobile/scrcpy/issues/9
+
+
+### The application does not work over `adb connect`
+
+If the device is connected using `adb connect`, then you'll get this error:
+
+    error: more than one device/emulator
+    ERROR: "adb reverse" returned with value 1
+
+We plan to support it in future versions. See [issue 5].
+
+[issue 5]: https://github.com/Genymobile/scrcpy/issues/5
+
+
+### Mouse clicks do not work
+
+On many LG devices, [mouse clicks do not work][issue 18]. We're [working][pr27]
+on it.
+
+[issue 18]: https://github.com/Genymobile/scrcpy/issues/18
+[pr27]: https://github.com/Genymobile/scrcpy/pull/27
+
+
+### I get a black screen for some applications like Silence
+
+This is expected, they requested to protect the screen.
+
+In [Silence], you can disable it in settings → Privacy → Screen security.
+
+[silence]: https://f-droid.org/en/packages/org.smssecure.smssecure/
+
+See [issue 36].
+
+[issue 36]: https://github.com/Genymobile/scrcpy/issues/36
+
+
+### Mouse clicks at wrong location
+
+On MacOS, with HiDPI support and multiple screens, input location are wrongly
+scaled. See [issue 15].
+
+[issue 15]: https://github.com/Genymobile/scrcpy/issues/15
+
+A workaround is to build with HiDPI support disabled:
+
+```bash
+meson x --buildtype release -Dhidpi_support=false
+```
+
+However, the video will be displayed at lower resolution.
diff --git a/README.md b/README.md
index 5c2601fb..e6079ff4 100644
--- a/README.md
+++ b/README.md
@@ -242,6 +242,11 @@ A colleague challenged me to find a name as unpronounceable as [gnirehtet].
 [`strcpy`]: http://man7.org/linux/man-pages/man3/strcpy.3.html
 
 
+## Common issues
+
+See the [FAQ](FAQ.md).
+
+
 ## Developers
 
 Read the [developers page].