An MIT-licensed Bitchat-compatible messenger for Android and iOS. No accounts, phone numbers, wallet accounts, or username registration.
- Nearby: Bluetooth mesh public chat, Noise-encrypted private messages, and
invitation-based encrypted private groups. Open Private groups to create,
accept invitations and inspect members. Buttons and
/groupcommands are supported. See private groups for instructions, key rotation, offline behavior and the 255-member wire/official-client limits. - Cashu transfers: send tokens prepared in an external Cashu wallet through Nearby encrypted DMs. Received tokens remain unverified until redeemed in that wallet. Both phones need Outlink support. See instructions and limits.
- Location channels: public Bitchat geohash chat and presence over Nostr. Enter an area code manually, or choose an approximate area using optional foreground location access. Region, City, District, Neighborhood, and Block show approximate sizes and fill the code directly. An empty bridge area also receives the Neighborhood code. Custom codes can be submitted with Join. Exact coordinates are never included in events. See location selection.
- The existing theme, typography, shared controls, light/dark modes, accents, and localized Bitchat strings are retained. New location copy falls back to English until translated.
Location channels require internet access and are public. They are separate from encrypted Bluetooth private chats. Optional internet private messaging and mesh gateway/bridge features are disabled by default. There is no Tor integration, remote push delivery or file transfer. Android offers an optional ongoing-notification mode to retain a joined Bluetooth mesh and open relay connections in the background. It is off by default; iOS and internet-only sessions pause and reconnect on return. Nearby attachments support images and recorded voice notes in Public Mesh and encrypted Nearby DMs. Recipients choose whether to open each attachment. Live voice uses opt-in listening and hold-to-talk in either Nearby conversation.
See background connectivity. Messages, drafts, and channel selections survive restarts. Chat history expires after six hours and can be cleared sooner in Settings. Ephemeral Nostr events do not guarantee historical message retrieval.
Tap @Nickname beside the app icon, or open Settings → Nickname → Save.
Duplicate active nicknames display four-character discriminators such as Alice#7a2f. New
profiles use Outlink (qualified only for active duplicates); retired random defaults are migrated. See
display names for identity and privacy details.
For immediate erasure, tap the small Outlink icon at the top left of the main screen three times within 1.5 seconds. This runs the same full-data wipe as Settings, without confirmation. See quick erase.
Tap received message text to mention its sender. Press and hold for Copy message, Message user, Hug user, Slap user, or Block user; see message actions. Enable Notify when mentioned in Settings for local alerts in mesh and location channels. A live connection and notification permission are required. See mentions and notifications. Viewed conversations stay silent; unread dots identify other activity. Android can optionally notify for all Nearby messages while background connectivity is running.
Nearby DMs appear in an unread sender strip and in Contacts; tap the sender to open the private thread. Optional Notify for private messages in Settings enables generic local alerts for Nearby and Location DMs independently of public mentions. Location private threads also show unread sender shortcuts and counts.
Use Delete conversation on a Nearby contact card to remove its local messages and draft and cancel queued sends while retaining the contact. See conversation deletion.
Outlink is free and open source. If you'd like to support its continued development, you can send a voluntary Bitcoin Lightning donation:
Lightning Address: hsoc@coinos.io
Donate via Coinos
Open the link to choose an amount and pay with a compatible Lightning wallet, or paste the reusable Lightning Address into your wallet. Unlike a one-time BOLT11 invoice, the address can be reused. Donations are optional, do not unlock features, and are processed outside Outlink by the wallet/provider. The app does not collect payment details or verify donation completion.
Use Node.js 24 and npm, then:
npm ci
npm test
npx tsc --noEmit
npm run lint
npm run check:mobile
npm run export:mobileA native development build is required for Bluetooth; Expo Go cannot provide
the project-owned BLE module. Use npm run android:dev or npm run ios:dev
and npm start. Production IDs remain io.github.hsoc.outlink on both platforms;
development uses .dev.
GitHub Actions provides Android APK builds and optional signed iOS IPA builds. See release setup for signing secrets.
The Bitchat wire/session implementation is original MIT code. It uses existing cryptographic libraries and the retained mobile BLE adapter; no upstream Bitchat application source was copied. Protocol vectors and simulated radios are tested. Real-device Bluetooth interoperability, background transitions, location prompts, and signed distribution builds still require physical Android/iOS validation.
This mobile redesign does not migrate the retired Nostr account/chat database. Old on-device data is not intentionally deleted. Back up any existing keys and history with the previous app before upgrading; do not assume old conversations appear in this version.
Architecture · Geohash protocol · Internet private messaging · Channel identity rotation · Compatibility and remaining gaps · Privacy · Security
Original copyright notices and third-party license texts are preserved. MIT license · Third-party notices
Local message history, drafts, and private preferences are encrypted with a device-secured key; existing mobile history is migrated automatically. See storage protections, dependency review, and automated interoperability results.
See the unused-code review for cleanup scope and intentionally retained native compatibility paths.
The searchable Contacts menu separates live mesh peers, explicitly saved contacts, and recent conversations. Ordinary discoveries expire instead of being saved permanently.
Chat histories expire locally after six hours; conversation windows load up to 512 messages. Cashu tokens and pending delivery records are kept separately.
The 18 non-English app catalogs include Location, bridge, identity rotation, erase, and core Cashu safety warnings. Other text can fall back to English.