Skip to content

Easy-to-use web installer for Android-based operating systems

License

Notifications You must be signed in to change notification settings

ii/android-webinstall

 
 

Repository files navigation

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:

  • yarn install
  • yarn serve
  • yarn build
  • yarn lint

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.

About

Easy-to-use web installer for Android-based operating systems

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Languages

  • Vue 81.3%
  • JavaScript 15.5%
  • HTML 2.8%
  • Other 0.4%