openandroidinstaller-dev · tsterbak · Mar 6, 2023 · Feb 22, 2023 · Feb 24, 2023 · Feb 24, 2023
diff --git a/README.md b/README.md
@@ -62,7 +62,7 @@ Linux is currently the best supported platform (tested with Ubuntu 20.04/22.04 L
 
 ## Officially supported devices
 
-Currently, **we support 52 devices** by various vendors and working on adding more soon!
+Currently, the **we support 56 devices** by various vendors and working on adding more soon!
 
 
 Support for these devices is provided as best effort, but things might still go wrong.
@@ -82,9 +82,13 @@ Samsung | Galaxy S6 Edge | [zeroltexx](https://wiki.lineageos.org/devices/zerolt
 Samsung | Galaxy S7 | [herolte](https://wiki.lineageos.org/devices/herolte/) | SM-G930F | tested
 Samsung | Galaxy S7 Edge | [hero2lte](https://wiki.lineageos.org/devices/hero2lte/) | | tested
 Samsung | Galaxy S9 | [starlte](https://wiki.lineageos.org/devices/starlte/) | | tested
+Samsung | Galaxy Note 8 | greatlte | SM-N950F | tested
 Samsung | Galaxy Note 9 | [crownlte](https://wiki.lineageos.org/devices/crownlte/) | | tested
 Samsung | Galaxy S10 | [beyond1lte](https://wiki.lineageos.org/devices/beyond1lte/) | | tested
+Samsung | Galaxy S10e | [beyond0lte](https://wiki.lineageos.org/devices/beyond0lte/) | | tested
+Samsung | Galaxy S10+ | [beyond2lte](https://wiki.lineageos.org/devices/beyond2lte/) | | tested
 Samsung | Galaxy Note 10 | [d1](https://wiki.lineageos.org/devices/d1/) | | tested
+Samsung | Galaxy Note 10+ | [d2s](https://wiki.lineageos.org/devices/d2s/) | | tested
 Samsung | Galaxy Note 3 LTE | [hltetmo](https://wiki.lineageos.org/devices/hltetmo/) | N900T/V/W8 | tested
 </details>
 

diff --git a/openandroidinstaller/assets/configs/beyond0lte.yaml b/openandroidinstaller/assets/configs/beyond0lte.yaml
@@ -0,0 +1,38 @@
+metadata:
+  maintainer: Tobias Sterbak (tsterbak)
+  devicename: Samsung Galaxy S10e
+  devicecode: beyond0lte 
+requirements:
+  android: 12
+steps:
+  unlock_bootloader:
+    - type: call_button
+      content: >
+        As a first step, you need to unlock the bootloader. A bootloader is the piece of software, that tells your phone
+        how to start and run an operating system (like Android). Your device should be turned on.
+        Press 'Confirm and run' to reboot into download mode. Then continue.
+      command: adb_reboot_download
+    - type: confirm_button
+      content: >
+        Now, click the button that the onscreen instructions correlate to “Continue” and/or “Unlock Bootloader”.
+        Your device will reboot, you may now unplug the USB cable from your device.
+        The device will demand you format userdata, please follow the onscreen instructions to do so.
+    - type: confirm_button
+      content: >
+        The bootloader is now unlocked. Go through Android Setup skipping everything you can, then connect the device to a Wi-Fi network.
+        Since the device resets completely, you will need to re-enable Developer Options and USB debugging to continue.
+  flash_recovery:
+    - type: call_button
+      content: >
+        Now plug the USB-cable to your device. As a first step, you need to boot into download mode. Your device should be turned on. 
+        Then press 'Confirm and run' to reboot into download mode. Continue once it's done.
+      command: adb_reboot_download
+    - type: call_button
+      content: In this step, you need to flash a custom recovery on your device. Press 'Confirm and run' to start the process. Confirm afterwards to continue.
+      command: heimdall_flash_recovery
+    - type: confirm_button
+      img: samsung-buttons-bixby.png
+      content: >
+        Unplug the USB cable from your device. Then manually reboot into recovery by pressing the *Volume Down* + *Bixby* for 8~10 seconds 
+        until the screen turns black & release the buttons immediately when it does, then boot to recovery with the device powered off, 
+        hold *Volume Up* + *Bixby* + *Power button*.
diff --git a/openandroidinstaller/assets/configs/beyond1lte.yaml b/openandroidinstaller/assets/configs/beyond1lte.yaml
@@ -6,18 +6,32 @@ requirements:
   android: 12
 steps:
   unlock_bootloader:
+    - type: call_button
+      content: >
+        As a first step, you need to unlock the bootloader. A bootloader is the piece of software, that tells your phone
+        how to start and run an operating system (like Android). Your device should be turned on.
+        Press 'Confirm and run' to reboot into download mode. Then continue.
+      command: adb_reboot_download
+    - type: confirm_button
+      content: >
+        Now, click the button that the onscreen instructions correlate to “Continue” and/or “Unlock Bootloader”.
+        Your device will reboot, you may now unplug the USB cable from your device.
+        The device will demand you format userdata, please follow the onscreen instructions to do so.
+    - type: confirm_button
+      content: >
+        The bootloader is now unlocked. Go through Android Setup skipping everything you can, then connect the device to a Wi-Fi network.
+        Since the device resets completely, you will need to re-enable Developer Options and USB debugging to continue.
   flash_recovery:
     - type: call_button
       content: >
-        As a first step, you need to boot into the bootloader. A bootloader is the piece of software, 
-        that tells your phone who to start and run an operating system (like Android). Your device should be turned on. 
-        Then press 'Confirm and run' to reboot into the bootloader. Continue once it's done.
+        Now plug the USB-cable to your device. As a first step, you need to boot into download mode. Your device should be turned on. 
+        Then press 'Confirm and run' to reboot into download mode. Continue once it's done.
       command: adb_reboot_download
     - type: call_button
       content: In this step, you need to flash a custom recovery on your device. Press 'Confirm and run' to start the process. Confirm afterwards to continue.
       command: heimdall_flash_recovery
     - type: confirm_button
-      img: samsung-buttons.png
+      img: samsung-buttons-bixby.png
       content: >
         Unplug the USB cable from your device. Then manually reboot into recovery by pressing the *Volume Down* + *Bixby* for 8~10 seconds 
         until the screen turns black & release the buttons immediately when it does, then boot to recovery with the device powered off, 

diff --git a/openandroidinstaller/assets/configs/beyond2lte.yaml b/openandroidinstaller/assets/configs/beyond2lte.yaml
@@ -0,0 +1,38 @@
+metadata:
+  maintainer: Tobias Sterbak (tsterbak)
+  devicename: Samsung Galaxy S10+
+  devicecode: beyond2lte 
+requirements:
+  android: 12
+steps:
+  unlock_bootloader:
+    - type: call_button
+      content: >
+        As a first step, you need to unlock the bootloader. A bootloader is the piece of software, that tells your phone
+        how to start and run an operating system (like Android). Your device should be turned on.
+        Press 'Confirm and run' to reboot into download mode. Then continue.
+      command: adb_reboot_download
+    - type: confirm_button
+      content: >
+        Now, click the button that the onscreen instructions correlate to “Continue” and/or “Unlock Bootloader”.
+        Your device will reboot, you may now unplug the USB cable from your device.
+        The device will demand you format userdata, please follow the onscreen instructions to do so.
+    - type: confirm_button
+      content: >
+        The bootloader is now unlocked. Go through Android Setup skipping everything you can, then connect the device to a Wi-Fi network.
+        Since the device resets completely, you will need to re-enable Developer Options and USB debugging to continue.
+  flash_recovery:
+    - type: call_button
+      content: >
+        Now plug the USB-cable to your device. As a first step, you need to boot into download mode. Your device should be turned on. 
+        Then press 'Confirm and run' to reboot into download mode. Continue once it's done.
+      command: adb_reboot_download
+    - type: call_button
+      content: In this step, you need to flash a custom recovery on your device. Press 'Confirm and run' to start the process. Confirm afterwards to continue.
+      command: heimdall_flash_recovery
+    - type: confirm_button
+      img: samsung-buttons-bixby.png
+      content: >
+        Unplug the USB cable from your device. Then manually reboot into recovery by pressing the *Volume Down* + *Bixby* for 8~10 seconds 
+        until the screen turns black & release the buttons immediately when it does, then boot to recovery with the device powered off, 
+        hold *Volume Up* + *Bixby* + *Power button*.
diff --git a/openandroidinstaller/assets/configs/crownlte.yaml b/openandroidinstaller/assets/configs/crownlte.yaml
@@ -17,7 +17,7 @@ steps:
       content: In this step, you need to flash a custom recovery on your device. Press 'Confirm and run' to start the process. Confirm afterwards to continue.
       command: heimdall_flash_recovery
     - type: confirm_button
-      img: samsung-buttons.png
+      img: samsung-buttons-bixby.png
       content: >
         Unplug the USB cable from your device. Then manually reboot into recovery by pressing the *Volume Down* + *Bixby* for 8~10 seconds 
         until the screen turns black & release the buttons immediately when it does, then boot to recovery with the device powered off, 

diff --git a/openandroidinstaller/assets/configs/d1.yaml b/openandroidinstaller/assets/configs/d1.yaml
@@ -6,18 +6,32 @@ requirements:
   android: 12
 steps:
   unlock_bootloader:
+    - type: call_button
+      content: >
+        As a first step, you need to unlock the bootloader. A bootloader is the piece of software, that tells your phone
+        how to start and run an operating system (like Android). Your device should be turned on.
+        Press 'Confirm and run' to reboot into download mode. Then continue.
+      command: adb_reboot_download
+    - type: confirm_button
+      content: >
+        Now, click the button that the onscreen instructions correlate to “Continue” and/or “Unlock Bootloader”.
+        Your device will reboot, you may now unplug the USB cable from your device.
+        The device will demand you format userdata, please follow the onscreen instructions to do so.
+    - type: confirm_button
+      content: >
+        The bootloader is now unlocked. Go through Android Setup skipping everything you can, then connect the device to a Wi-Fi network.
+        Since the device resets completely, you will need to re-enable Developer Options and USB debugging to continue.
   flash_recovery:
     - type: call_button
       content: >
-        As a first step, you need to boot into the bootloader. A bootloader is the piece of software, 
-        that tells your phone who to start and run an operating system (like Android). Your device should be turned on. 
-        Then press 'Confirm and run' to reboot into the bootloader. Continue once it's done.
+        Now plug the USB-cable to your device. As a first step, you need to boot into download mode. Your device should be turned on. 
+        Then press 'Confirm and run' to reboot into download mode. Continue once it's done.
       command: adb_reboot_download
     - type: call_button
       content: In this step, you need to flash a custom recovery on your device. Press 'Confirm and run' to start the process. Confirm afterwards to continue.
       command: heimdall_flash_recovery
     - type: confirm_button
-      img: samsung-buttons.png
+      img: samsung-buttons-bixby.png
       content: >
         Unplug the USB cable from your device. Then manually reboot into recovery by pressing the *Volume Down* + *Bixby* for 8~10 seconds 
         until the screen turns black & release the buttons immediately when it does, then boot to recovery with the device powered off, 

diff --git a/openandroidinstaller/assets/configs/d2s.yaml b/openandroidinstaller/assets/configs/d2s.yaml
@@ -0,0 +1,38 @@
+metadata:
+  maintainer: Tobias Sterbak (tsterbak)
+  devicename: Samsung Galaxy Note 10+
+  devicecode: d2s 
+requirements:
+  android: 12
+steps:
+  unlock_bootloader:
+    - type: call_button
+      content: >
+        As a first step, you need to unlock the bootloader. A bootloader is the piece of software, that tells your phone
+        how to start and run an operating system (like Android). Your device should be turned on.
+        Press 'Confirm and run' to reboot into download mode. Then continue.
+      command: adb_reboot_download
+    - type: confirm_button
+      content: >
+        Now, click the button that the onscreen instructions correlate to “Continue” and/or “Unlock Bootloader”.
+        Your device will reboot, you may now unplug the USB cable from your device.
+        The device will demand you format userdata, please follow the onscreen instructions to do so.
+    - type: confirm_button
+      content: >
+        The bootloader is now unlocked. Go through Android Setup skipping everything you can, then connect the device to a Wi-Fi network.
+        Since the device resets completely, you will need to re-enable Developer Options and USB debugging to continue.
+  flash_recovery:
+    - type: call_button
+      content: >
+        Now plug the USB-cable to your device. As a first step, you need to boot into download mode. Your device should be turned on. 
+        Then press 'Confirm and run' to reboot into download mode. Continue once it's done.
+      command: adb_reboot_download
+    - type: call_button
+      content: In this step, you need to flash a custom recovery on your device. Press 'Confirm and run' to start the process. Confirm afterwards to continue.
+      command: heimdall_flash_recovery
+    - type: confirm_button
+      img: samsung-buttons-bixby.png
+      content: >
+        Unplug the USB cable from your device. Then manually reboot into recovery by pressing the *Volume Down* + *Bixby* for 8~10 seconds 
+        until the screen turns black & release the buttons immediately when it does, then boot to recovery with the device powered off, 
+        hold *Volume Up* + *Bixby* + *Power button*.
diff --git a/openandroidinstaller/assets/configs/greatlte.yaml b/openandroidinstaller/assets/configs/greatlte.yaml
@@ -0,0 +1,21 @@
+metadata:
+  maintainer: Michel Memeteau (freechelmi)
+  devicename: Samsung Galaxy note 8
+  devicecode: greatlte 
+steps:
+  unlock_bootloader:
+  flash_recovery:
+    - type: call_button
+      content: >
+        As a first step, you need to boot into the bootloader. A bootloader is the piece of software, 
+        that tells your phone who to start and run an operating system (like Android). Your device should be turned on. 
+        Then press 'Confirm and run' to reboot into the bootloader. Continue once it's done.
+      command: adb_reboot_download
+    - type: call_button
+      content: In this step, you need to flash a custom recovery on your device. Press 'Confirm and run' to start the process. Confirm afterwards to continue.
+      command: heimdall_flash_recovery
+    - type: confirm_button
+      img: samsung-buttons-bixby.png
+      content: >
+        Unplug the USB cable from your device. Then manually reboot into recovery by pressing the *Volume Down* + *Power buttons* for 8~10 seconds 
+        until the screen turns black to reboot  & release the buttons immediately when it does, then immediately hold *Volume Up* + *Bixby* + *Power button* until you are in recovery mode.
diff --git a/openandroidinstaller/assets/configs/taimen.yaml b/openandroidinstaller/assets/configs/taimen.yaml
@@ -3,7 +3,7 @@ metadata:
   devicename: Google Pixel 2 XL
   devicecode: taimen 
 requirements:
-  android: 12
+  android: 11
 steps:
   unlock_bootloader:
     - type: call_button

diff --git a/openandroidinstaller/assets/configs/walleye.yaml b/openandroidinstaller/assets/configs/walleye.yaml
@@ -3,7 +3,7 @@ metadata:
   devicename: Google Pixel 2
   devicecode: walleye 
 requirements:
-  android: 12
+  android: 11
 steps:
   unlock_bootloader:
     - type: call_button

diff --git a/openandroidinstaller/assets/imgs/samsung-buttons-bixby.png b/openandroidinstaller/assets/imgs/samsung-buttons-bixby.png
diff --git a/openandroidinstaller/openandroidinstaller.py b/openandroidinstaller/openandroidinstaller.py
@@ -57,7 +57,7 @@
 logger.add("openandroidinstaller.log")
 
 # VERSION number
-VERSION = "0.4.0-beta"
+VERSION = "0.4.1-beta"
 
 # detect platform
 PLATFORM = sys.platform
@@ -210,7 +210,10 @@ def log_version_infos(bin_path):
     hdversion = [
         line for line in run_command("heimdall info", bin_path, enable_logging=False)
     ]
-    logger.info(f"Heimdall version: {hdversion[1].strip()}")
+    try:
+        logger.info(f"Heimdall version: {hdversion[1].strip()}")
+    except:
+        logger.info(f"Issue with heimdall: {hdversion}")
 
 
 def main(page: Page, test: bool = False, test_config: str = "sargo"):
@@ -233,6 +236,17 @@ def main(page: Page, test: bool = False, test_config: str = "sargo"):
         center_title=False,
         bgcolor="#00d886",
         actions=[
+            Container(
+                content=ElevatedButton(
+                    icon=icons.QUESTION_MARK_ROUNDED,
+                    text="FAQ",
+                    on_click=lambda _: webbrowser.open(
+                        "https://openandroidinstaller.org/faq.html"
+                    ),
+                ),
+                padding=15,
+                tooltip="Frequently asked questions and encountered issues.",
+            ),
             Container(
                 content=ElevatedButton(
                     icon=icons.BUG_REPORT_OUTLINED,
@@ -243,7 +257,7 @@ def main(page: Page, test: bool = False, test_config: str = "sargo"):
                 ),
                 padding=15,
                 tooltip="Report an issue on github",
-            )
+            ),
         ],
     )