firmware
● web serial ok
// install the remote's software over usb-c

flash_your_bleep

Everything happens in this tab: the browser talks to the remote over the cable. It takes about a minute, and nothing leaves your computer.

$ select --remote

$ select --mode

Update keeps your devices, activities, Wi-Fi and paired TVs, and shows its progress on the remote's screen when the remote's firmware can take it. Clean erases everything first, and the remote starts as new.

Connecting…
then pick “USB JTAG/serial debug unit”
details

      
  1. [01] plug in

    Use a USB-C cable that carries data, not one for charging only.

  2. [02] wake it

    Press any key so the remote is awake. Asleep, its USB connection is off.

  3. [03] install

    Press install and pick the remote in the browser's list.

  4. [04] done

    Leave the cable in until it says done. The remote restarts by itself.

$ tail -f bleep.log

What the remote reports as it runs. Useful when something isn't working and you're asked for its log.


  

$ help

The remote isn't in the list

Wake it up: press any key, then try again. A sleeping remote switches its USB connection off.

Try another cable. Many USB-C cables only charge. Then try another USB port, plugged straight into the computer rather than through a hub.

On Linux, your user needs to be allowed to use serial ports: run sudo usermod -aG dialout $USER, then log out and in again.

“Couldn't connect” or “port is busy”

Only one program can talk to the remote at a time. Disconnect the console on this page, and close other tabs or programs that might have it open (a serial monitor, Arduino, another flasher), then try again.

The remote doesn't start, or the screen stays dark after an install

Install again, choosing clean. If the remote isn't in the list any more, start it in download mode, where it always shows up:

  1. Hold the OK key down.
  2. Through the slot in the back, touch a small flat screwdriver across the two reset pads, then take it away.
  3. Let go of OK. The screen stays dark: that's expected.
  4. Press install here. When it's done, unplug the cable and plug it back in, or short the reset pads once more.
It stopped halfway

The remote may not start until it's installed again, but nothing is damaged, and an update keeps your setup. Plug it back in and press install again. If it isn't in the list, use download mode (above).

Which browsers work?

Chrome, Edge or another Chromium browser on a computer (Windows, macOS, Linux or ChromeOS). Firefox, Safari and phones can't connect to USB devices from a web page.