kdrag0n / android-webinstall

Easy-to-use web installer for Android-based operating systems
https://protonaosp.kdrag0n.dev/
MIT License
261 stars 57 forks source link
android fastboot installer javascript vue webusb

Android web installer

This is an easy-to-use web installer for Android-based operating systems that runs entirely in the browser. It uses WebUSB, which is supported by Chromium and its derivatives, and my fastboot.js library for flashing. This allows it to work on computers and Android devices software with no additional software or command-line tools.

If you have a device officially supported by ProtonAOSP, you can try flashing it with the official instance of this web installer at ProtonAOSP web installer.

Screenshot of an install in progress on a desktop computer

Install process

The following screenshots show the entire installation process, from start to finish:

Desktop

Step: Prepare your device Step: Choose an install type Step: Connect your device Step: Unlock your bootloader Step: Download a build Step: Install ProtonAOSP Step: Installation complete

Adapting for other ROMs

By default, this installer is configured for the ProtonAOSP production environment, but it was built with reusability in mind. It can be adapted to other ROM projects with only configuration changes.

You can start with the following Yarn commands:

All configuration is in src/config.js and .env, and the release index at public/releases/index.json is fetched from the root of the domain hosting the installer. You may also want to change the favicon at public/favicon.png.

Contributing

Contributions are welcome! If you adapt this installer or make other improvements to it, please contribute the improvements back to the official repository instead of forking it and keeping the changes to yourself. There are many rough edges that need to be improved upon.