Repository navigation
BitChat v0.3.4 β Phase 3: Native Rust BLE Transport, Noise XX Interop & UI Stability
LatestBitChat v0.3.4 β Phase 3 Production Release: Native Rust BLE Transport, Noise XX Interoperability, Live Bluetooth Diagnostics & UI Stability
BitChat v0.3.4 delivers the Phase 3 engineering milestone across Windows, Linux, and macOS: a modular native Rust BLE transport stack (rust/bitchat-core/src/ble/) targeting Windows WinRT (windows 0.58), Linux BlueZ D-Bus (zbus 5), and macOS CoreBluetooth capability probing; decoupled Windows GATT server & companion manufacturer advertisement handling; reference bitchat-tui (107a13c) binary DM payload interoperability in Rust; live asynchronous Bluetooth Settings diagnostics with canonical BitChat UUIDs; and mouse-click navigation jitter elimination across the Textual TUI.
What's Changed in v0.3.4
Native Rust BLE Transport Architecture
- Modular Rust BLE Transport (
rust/bitchat-core/src/ble/): Replaced the single-file BLE helper stub (ble.rs) with modular Rust ownership (types.rs,advertisement.rs,connection.rs,manager.rs,windows_winrt.rs,linux_bluez.rs,macos_corebt.rs) executing platform OS BLE operations off Python's GIL (py.allow_threads) with bounded event/write queues, early-notification buffering, ATT MTU chunking, and secret-redacted diagnostic traces. - Native Windows WinRT Backend (
windows_winrt.rs): Implements real Rust WinRTBluetoothAdapter/Radioprobing,BluetoothLEAdvertisementWatchercentral scanning,BluetoothLEDevice/GattSessionGATT client operations, andGattServiceProvider+ decoupled optionalBluetoothLEAdvertisementPublisherperipheral hosting. - Native Linux BlueZ D-Bus Backend (
linux_bluez.rs): Implements pure-Rust BlueZ D-Bus (zbus 5) adapter/capability probing, central discovery/GATT client, and exportedObjectManager/GattService1/GattCharacteristic1/LEAdvertisement1peripheral hosting with manufacturer-data fallback. - Truthful macOS Backend (
macos_corebt.rs): Reports live macOS Bluetooth controller status while honestly declaring CoreBluetooth Peripheral mode as unimplemented.
BLE Reliability & Reference bitchat-tui Noise XX Interoperability
- Decoupled Windows GATT Provider & Companion Advertisement (
src/bitchat/ble/server.py,windows_winrt.rs): Fixed the critical coupling bug where a companion manufacturerBluetoothLEAdvertisementPublisherfailure tore down an already-workingGattServiceProviderandGattLocalCharacteristic; GATT and discovery advertisement statuses are now tracked and reported independently. bitchat-tui(107a13c) Binary DM Payload Decoding (rust/bitchat-core/src/engine.rs,src/bitchat/app/session_coordinator.py): Added native Rustdecode_chat_payload_rawandencode_bitchat_message_payload_rawsupporting plain UTF-8,[0x04] || UTF-8,[0x04] || binary BitchatMessage, bare binaryBitchatMessage, and nestedBitchatPacket(Message)payloads while preserving strict fail-closed Noise XX authentication and nonce-0 replay rejection.- Strict Scanner Peer-ID & GATT Property Validation (
src/bitchat/ble/scanner.py,gatt.py,advertisement.rs): Enforced full 8-byte (16-hex-char) non-zero, non-broadcast peer IDs for BLE service data (eliminating truncated 12/14-char IDs) and strictnotify+write/write-without-responseGATT characteristic validation with hyphen/case-insensitive UUID normalization.
Bluetooth Diagnostics & TUI Mouse Navigation Stability
- Live Bluetooth Settings Diagnostics (
src/bitchat/tui/screens/settings.py,src/bitchat/transport/bluetooth.py): Replaced the incorrect hardcoded0000fee0-0000-1000-8000-00805f9b34fbUUID and falsely hardcoded"Active / Scanning"Central status with live asynchronous hardware & transport telemetry, canonical BitChat Service (F47B5E2D-4A9E-4C5A-9B3F-8E1D2C3A4B5C) and Characteristic (A1B2C3D4-E5F6-4A5B-8C9D-0E1F2A3B4C5D) UUIDs, zero blank diagnostic boxes, and an explicit Refresh Bluetooth Information button with safe worker cancellation. - Eliminated Mouse Navigation Jitter & Screen Fluctuation (
status_bar.py,app.py,screens/*.py): FixedStatusBar.on_button_pressedtriple-firing every action click (ActionTriggered+ directapp.action_*call + bubbledButton.Pressed), addedevent.stop()across all screen button handlers, wrapped multi-layer screen pops inbatch_update(), and deduplicatedPeersScreen.refresh_peer_list()table rows to eliminate periodic DataTable rebuild flicker. - Homepage Preservation: Both the application Home Screen (
src/bitchat/tui/screens/home.py) and the official website homepage (website/index.html) were preserved with zero changes.
Downloadable Release Assets & SHA-256 Checksums
| Asset | Platform / Format | Size | SHA-256 |
|---|---|---|---|
BitChat-0.3.4-windows-x64.exe |
Windows x64 Inno Setup Installer | 17.85 MB | 87E534E94D5BA73C08352D34B29D594B82174BE77AEA3EF9584B3E881FDE8C92 |
bitchat_0.3.4_amd64.deb |
Debian / Ubuntu (amd64) |
19.03 MB | 134BDD43EBAA09E4E484D8A47CF367F156ABB84E2B188E91EAECAE3D2BB729D9 |
BitChat-0.3.4-x86_64.AppImage |
Linux Universal AppImage (x86_64) |
21.72 MB | C0A8BC6011D7D83ADA7C555DFE177B3AC58A7EC375A00ACBAAF0060033015E5B |
bitchat-0.3.4-cp312-abi3-win_amd64.whl |
Python 3.12+ ABI3 Wheel (Windows x64) | 1.10 MB | CDDEFBBB753297EEB7AE22F94D64AD4EC10470267B94CE73D40F329738853172 |
bitchat-0.3.4-cp312-abi3-linux_x86_64.whl |
Python 3.12+ ABI3 Wheel (Linux x86_64) | 1.99 MB | 00914AE4C94C71E41ED01B00B7C6336DB8DEAE53F30BE2A33583AAB3385E9A7C |
bitchat-0.3.4-cp312-abi3-macosx_11_0_arm64.whl |
Python 3.12+ ABI3 Wheel (macOS Apple Silicon arm64) | 1018.44 KB | 13EB946701A1249419CAD88C9F5E9C991201028746A8E3633922FF2DF6BDA621 |
bitchat-0.3.4.tar.gz |
Universal Source Distribution (Python + Rust) | 358.15 KB | 4405983582827382FC20DB0FB84391A8DC2E500ACD2243B673FED703D8584D7E |
Java-Mx.BitChat.yaml |
Windows Package Manager (WinGet) Singleton Manifest | 1.63 KB | EE77C62BA13E61B8B953B234EF08909D6D3963EF28808BD75EABA3561B3389F1 |
Install or Upgrade
- Windows (WinGet):
winget upgrade --id Java-Mx.BitChat --exact(or fresh install:winget install bitchat-rustpy) β preserves~/.bitchat/identity and settings across upgrades. - Ubuntu / Debian:
sudo apt install ./bitchat_0.3.4_amd64.deb - Fedora / Universal Linux:
chmod +x BitChat-0.3.4-x86_64.AppImage && ./BitChat-0.3.4-x86_64.AppImage - macOS (Apple Silicon arm64):
pip install bitchat-0.3.4-cp312-abi3-macosx_11_0_arm64.whl(LAN & Offline supported; BLE Peripheral not yet implemented on macOS)
Full Verification & Hardware Audit
See PHASE-3-IMPLEMENTATION-AND-VERIFICATION-REPORT.md and CHANGELOG.md.