Repository navigation
20.07 v0.7.25-dev
20.07 v0.7.25-dev
An offline, phone-to-phone BLE mesh for coordinating a group when the internet can't be trusted or
isn't there — a radar to find your people, an SOS that hops phone to phone, and encrypted evidence
photos that survive losing any one phone. No servers, no accounts, no cellular or Wi-Fi involved.
This is a big catch-up release: the last published release was v0.6.3-dev. Everything below has
shipped since then, tested and committed the whole way, just not published until now.
Highlights since v0.6.3-dev
- Couriers — a phone can now carry content across a physical gap the mesh can't currently reach
(e.g. across a blocked street), and hand off part of its delivery load when it meets another phone. - Faster, fairer evidence sharing — photos send a thumbnail first and pull full resolution only
on request, use fountain coding so any combination of nearby helpful phones speeds up a transfer
instead of slowing it down, and get an optional faster BLE transport on phones that support it. - More private by default — each device now has a distinct identity per group instead of one
reused everywhere (closes a way to correlate someone across groups), message bodies are sealed
under a key that rotates every 24 hours instead of one static key for the group's whole life, and
every frame is padded so its size alone can't hint at what kind of message it is. - A first real step toward talking to bitchat's
mesh too (opt-in, off by default) — early testing against a real bitchat install got a
real, partial "yes, it accepts our packet"; the actual two-way bridge isn't built yet. - A full round of hardening from live, real-hardware testing: a full-codebase review found and
fixed 20 issues ahead of a device round; that round then found (and this release fixes) a real
regression from one of those fixes, a message-delivery gap on long-lived connections, a hop-count
bug that could read farther than the mesh's real size, and a "stuck" hop-count display that could
freeze on an old value — all confirmed against real multi-phone sessions, not just simulated.
Full version-by-version detail: CHANGELOG.md.
Full feature tour, security model, and architecture notes: README.md.
Known limitations, honestly
This is still a pre-1.0, sideloaded debug build, hardware-tested only at small scale (2-3 phones).
The release build isn't signed. Two things are called out specifically in this release: the new
hop-count-freeze fix above hasn't had its own dedicated hardware round yet, and the bitchat bridge
is a proof-of-concept probe, not a working bridge. See README's Known limitations section for
the complete, unvarnished list — it's kept current on purpose, including everything that's not
fixed yet.
Get it
Download the APK below and sideload it (you'll need to allow installs from this source once). Or
build from source — see the README's Get the app section.