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.12.4+image.0.2.3

dev
dev experimental

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

latest: 0.12.4+image.0.2.3-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.12.4
size
72.1 mb
sha256
44f1246e1e2be814749de8756e63f5e3ed7cbb68698f8b42dc0bfcff4c1f101b

u3 - the desktop app

desktop connector for the desk-inclined

version
0.12.4
released

every platform

macos apple silicon

darwin-aarch64 · dmg · 12.8 mb

a928a10336dce2611b4dbcaa68865b86e597f898b802556d6f8fa030e5689d68

macos intel

darwin-x86_64 · dmg · 14.3 mb

91c041b7c8795e731a79bfa2683973365a97926d00f882be8ef17ed7d53358fe

linux x86_64

linux-x86_64 · appimage · 93.8 mb

dcda21ca051aabea2c291970f8096af0472bc27ad6604098c3b9612432a93b58

linux arm64

linux-aarch64 · appimage · 91.4 mb

9b5dce63811a694695bd4c14d0f9fbf53e4c7bc0a4952e9e54944405cd66e133

windows x86_64

windows-x86_64 · exe installer · 15.3 mb

4069b6fa0c230af4925fa526e88f50904d6acfba24be56807e356529cc5baa7c

windows arm64

windows-aarch64 · exe installer · 13.2 mb

cfc267f0b48d68e17d06454c18a8e280232e393458abeb8155d8e4ada0589df2

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.