permissionlesstech/bitchat

mirror of https://github.com/permissionlesstech/bitchat.git synced 2026-07-24 22:45:19 +00:00

T

jack 2993fc3e06 Implement favorites, notifications, and improve fragment handling

- Add favorites functionality for peers with persistent storage
  - Star icon to toggle favorites in sidebar
  - Favorites appear at top of peer list
  - Storage persists across app launches using peer ID

- Add local notifications for mentions and private messages
  - Notifications appear when app is in background
  - Separate notification types for mentions vs private messages
  - Request notification permissions on app launch

- Fix sidebar header alignment to match main toolbar (44pt)
  - Add background color to sidebar header for visual consistency

- Improve voice note fragment transmission
  - Send fragments in batches of 5 with delays to prevent congestion
  - Better logging to debug fragment transmission issues
  - Reduce delay between fragments from 50ms to batch-based timing

- Fix other UI issues
  - Ensure mic recording ripples originate from mic button
  - Update sidebar to swipe from right edge smoothly

2025-07-03 22:13:28 +02:00

Implement favorites, notifications, and improve fragment handling

2025-07-03 22:13:28 +02:00

bitchat.xcodeproj

Implement favorites, notifications, and improve fragment handling

2025-07-03 22:13:28 +02:00

.gitignore

Initial commit: Bluetooth mesh chat app with end-to-end encryption

2025-07-02 19:18:35 +02:00

Package.swift

Convert JSON protocol to efficient binary format

2025-07-02 22:09:02 +02:00

project.yml

Implement favorites, notifications, and improve fragment handling

2025-07-03 22:13:28 +02:00

README.md

Initial commit: Bluetooth mesh chat app with end-to-end encryption

2025-07-02 19:18:35 +02:00

setup.sh

Initial commit: Bluetooth mesh chat app with end-to-end encryption

2025-07-02 19:18:35 +02:00

README.md

bitchat

A secure, end-to-end encrypted Bluetooth mesh chat application with an IRC-style interface.

Features

End-to-end encryption using Curve25519 and AES-GCM
Bluetooth mesh networking with automatic peer discovery
Message relay capability (TTL-based flooding)
IRC-style terminal interface
Persistent nickname storage
Universal app (iOS and macOS)
No internet connection required

Setup

Option 1: Using XcodeGen (Recommended)

Install XcodeGen if you haven't already:
```
brew install xcodegen
```
Generate the Xcode project:
```
cd bitchat
xcodegen generate
```
Open the generated project:
```
open bitchat.xcodeproj
```

Option 2: Using Swift Package Manager

Open the project in Xcode:
```
cd bitchat
open Package.swift
```
Select your target device and run

Option 3: Manual Xcode Project

Open Xcode and create a new iOS/macOS App
Copy all Swift files from the bitchat directory into your project
Update Info.plist with Bluetooth permissions
Set deployment target to iOS 16.0 / macOS 13.0

Usage

Launch the app on multiple devices
Choose or modify your nickname
The app will automatically discover nearby peers
Start chatting! Messages are relayed through the mesh network

Security

All messages are end-to-end encrypted
Public key exchange happens automatically on connection
Messages are signed to prevent tampering
TTL prevents infinite message loops

Protocol

The bitchat protocol uses JSON-encoded packets with the following structure:

Packet versioning for future compatibility
Message types: handshake, message, ack, relay, announce, keyExchange
TTL-based flooding for mesh relay
Signature verification for authenticity

Building for Production

Set your development team in project settings
Configure code signing
Archive and distribute through App Store or TestFlight

Android Compatibility

The protocol is designed to be platform-agnostic. An Android client can be built using:

Bluetooth LE APIs
Same packet structure and encryption
Compatible service/characteristic UUIDs