Skip to content

Project to facilitate the installation of custom ROMs and GSIs on Android devices. Created with GTK and C.

License

Notifications You must be signed in to change notification settings

NachtsternBuild/fastboot-assistant

fastboot-assistant

Description

Program to facilitate the installation of custom ROMs and GSIs on Android devices. Based on GTK and Shell.

sweet_unix

Functions

  • Check the ADB/Fastboot connection
  • Create a working directory
  • change to the working directory
  • boot into fastboot mode
  • Reboot from fastboot mode
  • Reboot into download mode
  • boot into recovery
  • boot to an image
  • lock/unlock the bootloader
  • delete user data
  • backup your full system with root or use the Open Android Backupthanks to @mrrfv
  • Rename files (recovery.img, boot.img, vendor.img, system.img, payload.zip)
  • flashing recovery.img, boot.img, init_boot.img, vendor_boot.img, vendor.img, system.img, vbmeta.img, dtbo.img, userdata.img, metadata.img, preloader.img, preloader.bin, super.img and many others
  • flashing all images in a directory
  • get device infos
  • some instructions for the program
  • set active slot
  • resize/remove/create boot/vendor/system partition

Versions

https://github.com/NachtsternBuild/fastboot-assistant/releases

Rostiges Red Hat v.0.6.x

→ It is not recommended to use the RPM.

Sweet Unix v.0.5.x

Important Notes

  • With v.0.6.2.1 and v.0.7.x the support for RPM based Linux distributions is discontinued, because there are many missing tools, like pkexec or heimdall. Hopefully Snap and Flatpak will be a suitable replacement for the RPMs.
  • It is recommended to run the Fastboot-Assistant natively under Linux, because the WSL does not provide the same amount of tools as the real Ubuntu. This version should only be used if there is no other option.
  • The possibility of building the Fastboot Assistant as a Snap and Flatpak is experimental and has not yet been fully tested. Especially for the construction of the Flatpak. The dependencies are missing here.

Notes

  • Use at your own risk.
  • The device may be damaged.
  • Not every device supports all of the functions
  • Not all operating system variants have the same range of functions.
  • The programme is currently in the test phase. Errors may occur in the programme.

Examples Images

fastboot-assistant Flashen Vorbereitungen Neustart


Some brownies

Installation of the programme

Linux

The following tools are required to run the programme.

  • Android Debug Bridge (adb) and fastboot
  • Fastboot
  • XZ-utils
  • unzip
  • wget
  • curl
  • pkexec
  • heimdall
  • GTK4
  • coreutils
  • libc6
  • xdg-desktop-portal
  • xdg-desktop-portal-gtk
  • xdg-utils

These are installed automatically with the Debian package. Root rights are required for installation.

  • Install the Debian package in the terminal with:
sudo apt-get install /PATH/to/fastboot-assistant.deb
# oder
sudo dpkg -i /PATH/to/fastboot-assistant.deb 

or via a graphical user interface.

Windows

  1. unzip the zip file
  2. Follow the steps in the README.md from the Zip

Removing fastboot-assistant

  1. open terminal
  2. Execute the following command:
# Debian/Ubuntu
sudo dpkg -r --force-all fastboot-assistant

Further information

  • see instructions in the applications themselves
  • or the dokumentation

In case of errors

  • Don't be shy, just complain.
  • Or do it better (see build)

build

see build: https://github.com/NachtsternBuild/fastboot-assistant/tree/main/Anwendung