C2 NEOS Alternate Fix Install

Stuck on the NEOS setup screen? You're not alone.

You get this message after "Connect to Wi-Fi":

The network "xxxx" is not connected to the internet.

comma.ai no longer has a working endpoint for the setup tool to use to determine if the device is connected to the internet. This means that the NEOS setup screen after selecting a Wi-Fi network will always show "The network 'xxxx' is not connected to the internet" even when it is.

This repository provides a simple, all-in-one tool to bypass the NEOS Setup screen and install openpilot on a comma two, EON, or a comma two clone device. This is NOT designed or needed for AGNOS devices such as the comma three.

Usage

This tool can be run on Windows, macOS, or Linux.

Prerequisites

1. Connect to Wi-Fi

   • On your comma two, connect to the same Wi-Fi network as the computer you are using to run this tool.

2. Find Your Device's IP Address

   • On the device, go to More Options.
   • Touch the triple-dot icon in the upper right corner and select Advanced.
   • Scroll down and note the IPv4 address. It will likely start with 192.168.x.x, 10.x.x.x, or 172.16.x.x.

Fork Selection

Upon running the installer, you will be prompted to select a fork of openpilot to install. You can choose from a list of preset forks or opt to install a custom fork by providing the GitHub owner and branch name. The repo is still expected to be named openpilot which some forks have setup redirects.

Windows Instructions

1. Download the Installer

   • Click here to download c2-neos-alt-fix-install.exe
   • Save the file to a convenient location, like your Downloads folder.

2. Run the Installer

   • Find the c2-neos-alt-fix-install.exe file you downloaded.
   • Double-click the file to run it.
   • The application will open a command prompt-like window and guide you through the rest of the process.
   • When the process is finished, the window will stay open until you press the Enter key.

macOS Instructions

1. Run the Installer
   • Open the Terminal application on your Mac.
   • Copy and paste the following command into the Terminal and press Enter. This will download, make executable, and run the installer in one step.

     curl -L https://github.com/ophwug/c2-neos-alt-fix-install/releases/latest/download/c2-neos-alt-fix-install-darwin -o c2-neos-alt-fix-install-darwin && chmod +x c2-neos-alt-fix-install-darwin && ./c2-neos-alt-fix-install-darwin

   • The application will then guide you through the rest of the process.

Linux Instructions

1. Run the Installer
   • Open a Terminal on your Linux distribution.
   • Copy and paste the following command into the Terminal and press Enter. This will download, make executable, and run the installer in one step.

     curl -L https://github.com/ophwug/c2-neos-alt-fix-install/releases/latest/download/c2-neos-alt-fix-install-linux -o c2-neos-alt-fix-install-linux && chmod +x c2-neos-alt-fix-install-linux && ./c2-neos-alt-fix-install-linux

   • The application will then guide you through the rest of the process.

Device Recovery

If you install software that causes your device to fail to boot, you can perform a system reset to restore it.

1. Enter Recovery Mode

   • With the device off but plugged in, press and hold the Volume Down + Power buttons simultaneously until the device boots into Recovery Mode.
   • Note: The touchscreen will not work in Recovery Mode.

2. Perform a Reset

   • In Recovery Mode, you can choose to perform a System Reset or a Factory Reset. A system reset is usually sufficient.
   • Use the Volume Up and Volume Down buttons to navigate the menu and the Power button to confirm your selection.

3. Reboot

   • After the reset is complete, unplug the device and then plug it back in to power it on.

For Developers

If you want to build the application yourself:

1. Clone this repository.
2. Make sure you have Go installed (version 1.22 or later).
3. Run make to build the Windows, macOS, and Linux executables.
4. Run make run to run the application for development.

The build process is automated via GitHub Actions. Every push to the main branch will trigger a new build and update the "Latest Build" release.

Credits

This project is a Go-based evolution of the original shell script installer created by jyoung8607. A big thank you for the original work and inspiration!

It was mostly coded with Roo Code and Gemini Pro 2.5.