Updated Using Tuhi (markdown)

Using-Tuhi.md

@@ -49,3 +49,46 @@ Next to the zoom slider is an icon displaying the battery state of the device. H
 <img src="https://raw.githubusercontent.com/tuhiproject/tuhi/screenshots/drop-down-menu.png" width="20%" alt="the drop-down menu" align="left">
 
 The drop-down menu shown when you click the hamburger button allows switching between portrait and landscape mode. This is a permanent setting, Tuhi remembers it across restarts. All current and future drawings default to that orientation. You can still rotate individual drawings with the buttons above the drawing itself.
+
+<br/>
+<br/>
+<br/>
+<br/>
+<br/>
+
+-----
+
+
+## Advanced usage: Live mode
+
+It is possible to use the live mode with tuhi. However, this is not shipped in the flatpak, and so people need to start this from git:
+
+```bash
+git clone https://github.com/tuhiproject/tuhi.git
+cd tuhi
+sudo ./tools/tuhi-live.py
+```
+
+There are a few pitfalls that may arise:
+#### the device has not been paired with tuhi, yet:
+
+```
+11:44:38 ERROR: tuhi.wacom: **** Exception: DeviceError.AUTHORIZATION_ERROR ****
+```
+
+In that case you need to need to start tuhi (the gui) and follow the above instructions to register your device.
+Then you can start the live mode again.
+
+#### the device has not been paired with tuhi through flatpak:
+
+```
+11:44:38 ERROR: tuhi.wacom: **** Exception: DeviceError.AUTHORIZATION_ERROR ****
+```
+
+You need to run the flatpak in the background for the authorization token to be valid.
+Note that tuhi 0.2 has issues with the live mode, so you need to upgrade to v0.3 first.
+
+#### something else happened:
+
+Keep trying. Sometimes, it doesn't work on the first attempt (yes, that's a bug, but hard to reproduce and fix).
+