Repository navigation
Releases
SocialMesh 0.3.0: apps
Apps: polls, petitions and sign-up sheets that pass around like posts, with no server. Their code runs with no network at all, and nothing is sent without your say-so. Phones now also keep going without Bluetooth: over Wi-Fi, through a host you add, or, with neither radio, by sound.
Experimental proof of concept, not independently security-reviewed. Keys are stored unencrypted on disk, and link observers can still see who connects to whom. Don't rely on it where your safety depends on it. Read THREAT-MODEL.md.
Security fix: update from 0.2.0
In 0.2.0, a site containing an <iframe> (or another frame or embed) could make your device look up the frame's web address before the viewer blocked the frame. Whoever runs that address could then tell when someone opened the site. 0.3.0 removes frames and embeds from sites before showing them. Checked against 38 ways a page can reach out, none now touches the network.
What's new
- Apps. A site can carry code: a poll that counts votes, a petition that gathers names.
- The code can read the app's own files and what people have sent it. It can't reach the internet, other sites or your device, and it can't run code inside the page.
- When an app wants to send something, you see exactly what will be sent and choose: anonymously (signed by a key used only for that app, sent by a route that hides which device it came from), as you, or not at all.
- Try the example in
examples/poll.
- No Bluetooth needed. The Android app starts with whatever is available, and picks Bluetooth up when you turn it on.
- Sound modem. With no Bluetooth and no Wi-Fi, the phone switches to sound by itself:
- it listens all the time, and every minute or so plays one of its newest public posts as tones for phones nearby;
- it waits while it hears another phone playing;
- it warns you if the media volume is too low to be heard.
- Hosts. Add a computer or relay by its address, or paste a
mesh1:invitation.- The phone remembers which node answered and refuses a different one at that address later.
- It keeps in sync over any network, mobile data included.
- Nodes on the same Wi-Fi are listed, and you can save them for later.
Full list: CHANGELOG.md. Format: SPEC.md §11.
Try it
On a computer:
mesh site new poll
mesh site publish ./examples/poll --key poll --app poll.js --title "Bus route poll"
mesh site view <address> # vote in your browser; the terminal asks before sending
mesh site entries <address> # what people have sentOn Android: Sites, then open any site marked · app.
Downloads
| File | What it is |
|---|---|
mesh-0.3.0-windows-x64.exe |
The command-line node for Windows. On macOS and Linux, build from source: cargo build --release -p mesh-cli. |
socialmesh-0.3.0-android-arm64-test.apk |
The Android test app (Android 10+, 64-bit ARM). It installs over 0.2.0 and keeps your posts and sites. It's signed with a development key, so a later properly signed release may need an uninstall first. |
SHA256SUMS.txt |
Checksums for the files above. |
SocialMesh 0.2.0: sites
Sites: web pages that pass around like posts, with no server, no domain name and no hosting. Publish a folder of pages from a computer or a phone, and it spreads to the people you meet: over Wi-Fi, Bluetooth, or a USB stick.
Experimental proof of concept, not independently security-reviewed. Keys are stored unencrypted on disk, and link observers can still see who connects to whom. Don't rely on it where your safety depends on it. Read THREAT-MODEL.md.
What's new
- Publish a site. A site's address is its own key, separate from your identity. Only whoever holds that key can publish new versions, and an update sends only the files that changed. You can also publish anonymously, but then the site can never be updated.
- View a site safely. Sites never run scripts and never load anything from the internet, so opening one tells no website that you read it. Tracking images, redirects and connection tricks are blocked. Links to ordinary websites open only if you choose, in your own browser.
- Photos lose their hidden location and camera details when published, as with posts.
- USB sticks carry files now.
mesh exportincludes photos and sites, not just posts. - A tidier Android app:
- breadcrumbs on every screen;
- light and dark mode;
- who you're linked with, and how;
- a Sites screen with publishing.
Full list: CHANGELOG.md. Format: SPEC.md §10.
Try it
On a computer:
mesh site new pamphlet
mesh site publish ./my-site --key pamphlet --title "Local water plan"
mesh site view <address> # opens in your browser through the safe viewerOn Android: Sites → Publish a site, choose a folder or a .zip. Other phones running SocialMesh nearby will receive it.
Downloads
| File | What it is |
|---|---|
mesh-0.2.0-windows-x64.exe |
The command-line node for Windows. On macOS and Linux, build from source: cargo build --release -p mesh-cli. |
socialmesh-0.2.0-android-arm64-test.apk |
The Android test app (Android 10+, 64-bit ARM). It installs over 0.1.0 and keeps your posts. It's signed with a development key, so a later properly-signed release may need an uninstall first. |
SHA256SUMS.txt |
Checksums for the files above. |
SocialMesh 0.1.0: proof of concept
First public release of SocialMesh: a decentralised social protocol with no accounts, no servers and no DNS, where devices carry the network themselves.
Experimental proof of concept, not independently security-reviewed. Keys are stored unencrypted on disk, and link observers can still see who connects to whom. Don't rely on it where your safety depends on it. Read THREAT-MODEL.md.
What works
- Posts with no infrastructure. Identities are created locally. Posts can be signed, ownerless or anonymous within a thread; there are replies, and feeds are built on each device.
- Private by construction. Every link is encrypted with forward secrecy. Anonymous posts go public from a relay a few hops away, not from their author. Relays carry attachments without being able to read them.
- Many media at once. TCP (LAN or internet) with LAN discovery, Bluetooth LE between phones, offline bundles for USB sticks, and sound: posts played as tones and decoded by another device's microphone, or carried over a phone call or radio.
- Survives its publisher. Once posted, content keeps spreading after the original device goes offline.
All of this is described in CHANGELOG.md. The wire format is in SPEC.md.
Downloads
| File | What it is |
|---|---|
mesh-0.1.0-windows-x64.exe |
The command-line node for Windows. On macOS and Linux, build from source: cargo build --release -p mesh-cli. Start with mesh init, then mesh run. |
socialmesh-0.1.0-android-arm64-test.apk |
The Android test app (Android 10+, 64-bit ARM). It is signed with a development key, so a later release may need you to uninstall this one first. Install it on two phones, open it on both and keep them close: they find each other over Bluetooth and sync. Play newest post / Listen send a post by sound. |
SHA256SUMS.txt |
Checksums for the files above. |
Building from source and the quickstart are in the README.