Merge pull request #88 from flathub/addreadme

README.md -- add Wii Remote how-to

README.md

@@ -1,3 +1,36 @@
+# How to connect your Wii remotes
+
+Dolphin offers three different methods to play your games using real Wii remotes.
+
+The most straightforward one is to pair the wii remote to your computer over bluetooth and use it in the same way you would any other bluetooth controller. However, connecting it this way prevents many features from working correctly and isn't recommended.
+
+In order to make full usage of your Wii remote you'll want to use one of the other two options:
+
+## Passthrough a Bluetooth adapter
+
+When using this method, Dolphin will take direct control of a USB Bluetooth adapter and use it in the same way a real Wii would.
+
+This method gives the most accurate results, including audio support on the controller, but has two main drawbacks:
+
+- requires a custom udev rule
+- hardware compatibility is limited to a few models.
+
+There's no practical way of installing a udev rule from within a flatpak (at least not without going against flathub rules), so the user must do this manually.
+
+The project's wiki has information on how to set up the udev rule:
+
+https://wiki.dolphin-emu.org/index.php?title=Bluetooth_Passthrough#Linux
+
+Compatibility table:
+
+https://wiki.dolphin-emu.org/index.php?title=Bluetooth_Passthrough#Adapter_test_results
+
+## Emulate the Wii's Bluetooth adapter
+
+This method isn't as accurate as passthrough, but it has much better hardware compatibility and doesn't require installing any udev rules.
+
+It only requires ```bluez``` which is bundled with the flatpak, and ```allow=bluetooth``` which is enabled by default in the manifest. Coupled with the improved compatibility this means it should work outside the box for most users.
+
 # Permissions used:
 
 ## device=all