install

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

flash the thingthenpair the app

u1 - flash the thing

install bridgething

stable
stablestabledefault

daily-use image with the best performance.

latest: 0.16.0+image.0.2.6

dev
devexperimental

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

latest: 0.16.0+image.0.2.6-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.16.0
size
79.5 mb
sha256
66e91045ff9eebe22533c751e920b35d075d7100e40308b56d7ca39f7e5e2cab

u3 - the desktop app

desktop connector for the desk-inclined

version
0.16.0
released

every platform

macos apple silicon

darwin-aarch64 · dmg · 14.8 mb

0e9465a8e1593edb2e87f3659fe678b8b574d3c3f5b7e87ddf4ef866a9485434

macos intel

darwin-x86_64 · dmg · 16.6 mb

ef5bc7ce257747d2cca197c652a652fccc1d77a7d4e622e806958cc093211999

linux x86_64

linux-x86_64 · appimage · 108 mb

4c2b2fcd3f97921a6bd65dde22a28bb0ff23d2305b53d822ae16d8d3297ded12

linux arm64

linux-aarch64 · appimage · 101 mb

e4269edcdcef8c7fa98fcc8eee8febeefcc4c42ed329c86c84d3614ee11c64ea

windows x86_64

windows-x86_64 · exe installer · 20.3 mb

2b751ecffb59ee2b059e57c0232fb111733d471160c0b431c31c052a8099d936

windows arm64

windows-aarch64 · exe installer · 17.2 mb

e8a0678b8cb6f464c843e51c9f92a65e6ff55e7efcc161987b80f79377d06cf8

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.