A PHP webpage that uses string replacements to generate a binary on the fly that you can enter at setup in NEOS.
Previously to install a custom fork from scratch, you would enter https://openpilot.comma.ai in the Custom Software prompt on your device, then ssh in later and clone the actual fork you want. Now you can enter a URL during set up to install any openpilot fork available on GitHub without first cloning stock.
The syntax is pretty simple, with up to 3 arguments you can pass the generator site: https://smiskol.com/fork/[username]/{branch}/{loading_msg}
Where username is the required username of the fork, branch is the branch to clone, and loading_msg is the text it displays when cloning the repo (Installing {loading_msg}). branch and loading_msg are optional.
- If
branchis left blank (https://smiskol.com/fork/commaai), git will clone the default branch on GitHub. - If
loading_msgis left blank, then the installer will displayInstalling {username}unless the fork has a custom loading message (check the index.php for aliases). - While
usernameis required if you visit the website on your desktop, if youwgetthe site or enter just/forkduring set up, it will install the release2 branch of stock openpilot.
Example: https://smiskol.com/fork/sshane installs the Stock Additions fork.
The main index.php file looks at your user-agent to decide which installer to serve. If NEOSSetup is present in your user-agent, then the Android-based installer is served. If AGNOSSetup is present, then it serves the Ubuntu-based installer for the comma three.
Defined in the index.php file, aliases allow for more quickly installing a fork with a long username.
- To install dragonpilot, you can simply use the following URL which uses the
devel-i18nbranch by default: https://smiskol.com/fork/dp - To install Stock Additions, my fork, enter the URL: https://smiskol.com/fork/shane
- To install stock openpilot, enter the URL: https://smiskol.com/fork/commaai or just https://smiskol.com/fork
If you are a fork developer, have a repository that is not named openpilot, and want to allow users to install with this tool, you can take advantage of GitHub's internal compatibility aliasing and just temporaily rename your fork to openpilot and rename it back. You can see an example of this in action with "https://github.com/dragonpilot-community/openpilot" redirecting to "https://github.com/dragonpilot-community/dragonpilot".
If you want to specify a custom loading message but use the default branch (not passing in a branch), you can pass an underscore for the branch. For example: https://smiskol.com/fork/shane/_/some%20additions%20or%20something
Idea by nelsonjchen on the comma.ai community Discord!