Conversation

GrapheneOS has funding available for developing an open source WebUSB-based installer as an alternative to our installation guide. It's low-level programming work despite being in JavaScript. Get in touch with us (contact@grapheneos.org) if you're interested in working on it.

2

44

105

This does not involve designing and implementing a fancy user interface. It only needs the bare minimum of a functional interface for driving the installation process. There's the open source fastboot code and an existing proprietary WebUSB-based flasher to reverse engineer.

1

2

13

Need to be comfortable with straightforward, fairly modern C++ and with JavaScript. UX design and CSS are not within the scope of the project. Don't need to be concerned with making usable instructions either. Goal for the project is a working installer with a bare minimum UI.

1

4

10

github.com/webadb/webadb. has the start of a fastboot protocol implementation. It can likely already be used to issue the lock and unlock commands without much work. Project involves figuring out how to do the rest of the flashing commands and putting it together as an installer.

GitHub - webadb/webadb.js: ADB host implementation based on WebUSB

ADB host implementation based on WebUSB. Contribute to webadb/webadb.js development by creating an account on GitHub.

1

2

10

No real need for existing experience with Android development. It's quite standalone. Don't need to already have a usable phone for working on this since we can buy one as part of the funding. The result will be open source and usable with other devices and operating systems.

1

1

13

This will be turned into an easy to use graphical installer for GrapheneOS not requiring software beyond a browser and our site. CLI instructions will still be recommended for technical users on an OS with proper fastboot and signify packages. Otherwise, WebUSB makes more sense.

2

1

19

@AlwaysCurious__

Replying to

What about code-signed macOS and Windows executables? That would be more work, and I understand if the funding for that isn’t there, but it would be more secure than a web site.

1

@AlwaysCurious__

Replying to

@AlwaysCurious__

and

Another idea I had was to make an installer package for Linux distros. It would be a wrapper script that downloaded, verified, and ran the needed components on the fly.

1

Replying to

@AlwaysCurious__

and

Trusting an installer downloaded from the site without verifying it with our offline signing key for the factory images is equivalent to trusting the site, but with a lot more that can go wrong. Could just release an archive with the web installer that's signed instead of that.

2

Replying to

@AlwaysCurious__

and

So if people wanted to download the web installer, verify it with signify and use it to install they could do that. It'd only make sense if we implemented signify verification for the factory images inside it. Completely possible to do that though.

1

Replying to

@AlwaysCurious__

and

WebUSB provides access to fastboot and adb in a portable way without much code. It's available on platforms without official support from fastboot. Could flash one phone with another. Flashing with WebUSB isn't less secure than a script / executable running the fastboot command.

4:20 PM · Jan 5, 2021Twitter Web App