From 965e1ac9a3d8c8741b6f7a46bf4e4da91dd86aa1 Mon Sep 17 00:00:00 2001
From: SomberNight <somber.night@protonmail.com>
Date: Fri, 24 Mar 2023 13:48:42 +0000
Subject: [PATCH] android: update readme, list required apt packages for qml on
 desktop

---
 contrib/android/Readme.md | 25 ++++++++++++++++++++-----
 1 file changed, 20 insertions(+), 5 deletions(-)

diff --git a/contrib/android/Readme.md b/contrib/android/Readme.md
index ad77a9fdf..059370fb3 100644
--- a/contrib/android/Readme.md
+++ b/contrib/android/Readme.md
@@ -1,8 +1,10 @@
-# Kivy GUI
+# Qml GUI
 
-The Kivy GUI is used with Electrum on Android devices.
+The Qml GUI is used with Electrum on Android devices, since Electrum 4.4.
 To generate an APK file, follow these instructions.
 
+(note: older versions of Electrum for Android used the "kivy" GUI)
+
 ## Android binary with Docker
 
 ✓ _These binaries should be reproducible, meaning you should be able to generate
@@ -21,11 +23,11 @@ similar system.
     ```
     $ ./build.sh
     ```
-    For development, consider e.g. `$ ./build.sh kivy arm64-v8a debug`
+    For development, consider e.g. `$ ./build.sh qml arm64-v8a debug`
 
     If you want reproducibility, try instead e.g.:
     ```
-    $ ELECBUILD_COMMIT=HEAD ELECBUILD_NOCACHE=1 ./build.sh kivy all release-unsigned
+    $ ELECBUILD_COMMIT=HEAD ELECBUILD_NOCACHE=1 ./build.sh qml all release-unsigned
     ```
 
 3. The generated binary is in `./dist`.
@@ -90,7 +92,20 @@ adb logcat | grep -F "`adb shell ps | grep org.electrum.electrum | cut -c14-19`"
 ```
 
 
-### Kivy can be run directly on Linux Desktop. How?
+### The Qml GUI can be run directly on Linux Desktop. How?
+Install requirements (debian-based distros):
+```
+sudo apt-get install python3-pyqt5 python3-pyqt5.qtquick python3-pyqt5.qtmultimedia
+sudo apt-get install python3-pil
+sudo apt-get install qml-module-qtquick-controls2 qml-module-qtquick-layouts \
+    qml-module-qtquick-window2 qml-module-qtmultimedia \
+    libqt5multimedia5-plugins qml-module-qt-labs-folderlistmodel
+sudo apt-get install qtvirtualkeyboard-plugin
+```
+
+Run electrum with the `-g` switch: `electrum -g qml`
+
+### The Kivy GUI can be run directly on Linux Desktop. How?
 Install Kivy.
 
 Build atlas: `(cd contrib/android/; make theming)`