install

you need to install a companion app (mobile or desktop) and flash bridgething

flash the thing then pair the app

u1 - flash the thing

install bridgething

stable
stable stable default

daily-use image with the best performance.

latest: 0.13.1+image.0.2.5

dev
dev experimental

dev image with more logging and debugging features. slower and hard on your emmc - not recommended.

latest: 0.13.1+image.0.2.5-dev

routes

terbium, in your browser

flashes over usb from the browser.

chromium only.

flashthing, on the command line

the same flasher as a binary.

macos needs libusb. linux needs a udev rule

$ cargo install flashthing-cli

u2 - the mobile app

connect to your phone with the bridgething companion app. desktop connector below

ios
testflight

ios 18 or newer via testflight

android
apk

sideload

version
0.13.1
size
74.7 mb
sha256
9d3c11fac8189ff153a93bfb86209f91b9387ebd34c2a36b74df24726fe16f2c

u3 - the desktop app

desktop connector for the desk-inclined

version
0.13.1
released

every platform

macos apple silicon

darwin-aarch64 · dmg · 13.1 mb

f330d0a9a5198c1412dbf56804790f8453e50076acb0e201352bb23100a071ed

macos intel

darwin-x86_64 · dmg · 14.7 mb

487a2b29262275bad3d5ed0048972619890715b4553ae010e8240593ae2e9e87

linux x86_64

linux-x86_64 · appimage · 94.6 mb

478fce9301050d1c68049e3a0d8a599b8fc34030a678b26c359bbd3fa67b172a

linux arm64

linux-aarch64 · appimage · 92.3 mb

aa86a989e508c1f32c1a4b4676a2ddaf2b496b7b565fc3d5e780b3e901e813af

windows x86_64

windows-x86_64 · exe installer · 15.5 mb

931e07aa4ac1a99a56fbe948954dccd0693656dfb7e370cbf7d26046a059e247

windows arm64

windows-aarch64 · exe installer · 13.4 mb

dcfdd2b92081ed784800b60a032428dcd76bd92711bef988ed2e1f8224e19b44

u4 - already running bridgething

how to update

the companion app

installs updates automatically when connected

already on

in the browser

faster than bluetooth if you are having issues with companion ota

chromium only

j2 - if it goes wrong

the usb port is flaky
try different cables, usb ports, usb hubs, no usb hubs, computers, whatever. the thing is picky.
this thing is literally impossible to brick
burn mode lives in rom. holding buttons 1 & 4 on boot always gets you to maskrom.
updates roll back
the image lands in the slot you are not booted from. a failed update boots the old one.

more in troubleshooting, or ask in discord.