Repository navigation
Releases
AirBridge v2.5.6
Android: includes the installable debug APK (AirBridge-android-debug.apk) for direct testing/sideloading. No signed Play bundle is included because the private Play upload key is not configured yet.
Full Changelog: v2.5.5...v2.5.6
AirBridge 2.5.5
AirBridge 2.5.5
This release fixes the Android Studio Gradle distribution timeout when building signed APKs, relocates paired-device battery telemetry into a dynamic home-screen icon, and adds full Play-safe Android-to-desktop notification mirroring with inline replies.
What's New
1. Android Studio Gradle Distribution Timeout Fix & Diagnostics
- Increased
networkTimeout=60000,retries=3, andretryBackOffMs=2000inandroid/gradle/wrapper/gradle-wrapper.propertiesso slower networks do not fail withSocketTimeoutExceptionduring distribution downloads. - Diagnosed and remediated stale Android Studio global
serviceDirectoryPathoverrides (gradle.settings.xmlpointing to an older Gradle user home) so IDE sync uses the default cached Gradle 8.14.3 wrapper home cleanly. - Extended
inspectAndroidGradleToolchain()insrc/server/diagnostics.tswithwrapperNetworkTimeoutMs,wrapperRetries,ideGlobalGradleHome,ideGlobalGradleVersion, andideGlobalGradleHomeMismatch.
2. Dynamic Home-Screen Battery Indicator
- Removed duplicate battery status banners from the Contacts, Calls, and Screen tabs inside
ContinuityCenter. - Added
DeviceBatteryBadgedirectly beside each paired device's name on the home screen:- Green at
20%and above, amber yellow below20%, and red below10%. - Shows a charging lightning bolt inside the battery icon and displays the estimated time to full charge directly below the battery symbol while plugged in.
- Green at
3. Notification Mirroring & Inline Replies (macOS, Linux, Web UI)
- Added Play-safe opt-in
NotificationMirrorService(BIND_NOTIFICATION_LISTENER_SERVICE,exported="false",Prefs.notificationMirroring = falseby default) gated behind an explicit toggle and prominent in-app disclosure dialog (SettingsScreen). - Excludes AirBridge's own notifications, ongoing/foreground/no-clear alerts, system packages, group summaries, call/progress/transport categories, and lock-screen-secret (
VISIBILITY_SECRET) notifications. - Sends notification metadata, Android app PNG icons (
data:image/png;base64,..., capped at 96 KiB), conversation thread IDs, andRemoteInputinline-reply capability over the E2EE paired session. - macOS (
AirBridge.app): Posts nativeUNUserNotificationCenterbanners with the phone app icon attachment, thread grouping, inline Reply (UNTextInputNotificationAction), Dismiss on phone, and synced removal when dismissed on Android. - Linux (
notify-send) & Web UI: Delivers rich async desktop notifications with app icons and adds a desktop Notifications center modal + non-blocking live toast cards with inline reply and dismiss controls. - Diagnostics: Added notification mirroring, filtering, inline-reply execution, and dismissal counters across
AndroidDiagnostics,EngineDiagnosticsSnapshot,scripts/mac_app.swift, and/api/diagnosticswithout logging notification text or PII. - Keeps
BIND_ACCESSIBILITY_SERVICEstrictly absent and screen sharing view-only with explicit per-session consent.
Android: includes the installable debug APK (AirBridge-android-debug.apk) for direct testing/sideloading. No signed Play bundle is included because the private Play upload key is not configured yet.
Full Changelog: v2.5.4...v2.5.5
AirBridge v2.5.4
AirBridge 2.5.4
Android Gradle settings, wrapper alignment & build diagnostics
- Aligned Android Studio IDE Gradle settings (
distributionType="DEFAULT_WRAPPED") with the Gradle8.14.3wrapper pinned for Android Gradle Plugin8.13.2, preventing legacy localgradle-8.9installations from breaking project sync (Minimum supported Gradle version is 8.13). - Regenerated the Gradle
8.14.3wrapper JAR and scripts, removed stale Gradle9.4+properties fromgradle.properties, and added a fail-fast minimum Gradle8.13version guard with wrapper guidance insettings.gradle.kts. - Exposed Gradle, AGP, SDK, and JDK build metadata in Android
BuildConfigandAndroidDiagnostics(buildreport object), and addedandroidToolchaininspection (redacted IDE home paths, mismatch detection, wrapper/AGP/SDK checks) to desktop runtime diagnostics (GET /api/diagnostics). - Ignored local
android/app/release/build exports cleanly alongsideandroid/app/debug/.
Installation notes
macOS builds are ad-hoc signed, not notarised. Windows executables are unsigned. Verify downloads using SHA256SUMS.txt and GitHub Sigstore attestations. No third-party security audit is claimed.
A signed Play App Bundle is built only when private signing credentials are configured. See the Play release checklist.
Android: includes the installable debug APK (AirBridge-android-debug.apk) for direct testing/sideloading. No signed Play bundle is included because the private Play upload key is not configured yet.
Full Changelog: v2.5.3...v2.5.4
AirBridge 2.5.3
AirBridge 2.5.3
Android 16 (API 36) & platform modernization
- Updated the Android app to compile against and target Android 16 (API 36) on Android Gradle Plugin
8.13.2and Gradle8.14.3, while keepingminSdk = 26(Android 8.0+) compatibility. - Added
Service.onTimeoutforeground-service lifecycle handlers inScreenShareServiceso OS-enforced media-projection timeouts stop active screen capture cleanly. - Replaced deprecated Android SDK 28–34 platform APIs across LAN discovery (
NsdServiceInfo.hostAddresses), call-state continuity (TelephonyCallback.CallStateListeneron Android 12+), and QR camera preview (SessionConfiguration/OutputConfigurationandContext.display), preserving fallbacks for Android 8–11. - Added fail-closed monotonic Play
versionCodechecks (> 2300179) to:app:assembleRelease,:app:bundleRelease, and the release workflow.
Desktop daemon, CLI & CI fixes
- Fixed a Node/Undici
WebSocket.CONNECTINGreconnect race inWarpClientandBackgroundClipboardPeerwhere a pair-code update arriving mid-handshake could leave the background clipboard peer stuck inconnectingstate. - Added
-v,--version, andversionsupport to theairbridgenpm CLI entrypoint to match standalone desktop binaries. - Upgraded GitHub Actions workflows (
ci.yml,release.yml,pages.yml) to Node-24-compatible action majors with least-privilegecontents: readpermissions on CI.
Installation notes
macOS builds are ad-hoc signed, not notarised. Windows executables are unsigned. Verify downloads using SHA256SUMS.txt and GitHub Sigstore attestations. No third-party security audit is claimed.
A signed Play App Bundle is built only when private signing credentials are configured. See the Play release checklist.
Android: includes the installable debug APK (AirBridge-android-debug.apk) for direct testing/sideloading. No signed Play bundle is included because the private Play upload key is not configured yet.
What's Changed
- Clarify iPhone and iPad browser support by @DigantaDey in #43
- Add Terms of Service page by @DigantaDey in #44
- Site: paid Google Play policy, verified install commands, copy buttons by @DigantaDey in #45
- Privacy: describe the copy script accurately by @DigantaDey in #46
- Homepage: drop the unsafe npx airbridge reference by @DigantaDey in #47
- Site: source-available, not open source by @DigantaDey in #48
- Android: target API 36, fix SDK 31–36 deprecations, and modernize CI by @DigantaDey in #49
Full Changelog: v2.5.2...v2.5.3
AirBridge 2.5.2
AirBridge 2.5.2
Updated branding
- New AirBridge logo throughout the app, Android launcher, macOS app, website and social previews.
- Matching favicon and installed web app colours.
Release fixes
- Android CI and local builds now use the same commit-based version code. CI checks out full history; shallow local clones fail with instructions instead of producing an incorrect code.
- Fixed broken documentation links in release notes, including the published v2.5.1 notes.
- Added regression checks for brand assets, Android packaging, release links and licence wording.
Website and documentation
- Updated download and discovery pages for 2.5.2, with simpler wording and clearer platform limits.
- Corrected the homepage licence description: AirBridge uses the Fair-Use & Non-Commercial License, not MIT or Apache. Commercial or organisational use needs prior written consent.
- Google Play Store app is coming soon. The GitHub APK remains an installable testing/sideload build; a Play listing is not available yet.
Installation notes
macOS builds are ad-hoc signed, not notarised. Windows executables are unsigned. Verify downloads using SHA256SUMS.txt and GitHub attestations. No third-party security audit is claimed.
A signed Play App Bundle is built only when private signing credentials are configured. See the Play release checklist.
Android: includes the installable debug APK (AirBridge-android-debug.apk) for direct testing/sideloading. No signed Play bundle is included because the private Play upload key is not configured yet.
What's Changed
- Release 2.5.2: brand refresh, packaging fixes and website updates by @DigantaDey in #41
- Discovery release: README, airbridge.fyi SEO pages, community files (2.5.1) by @DigantaDey in #40
Full Changelog: v2.5.0...v2.5.2
AirBridge v2.5.1
Android: includes the installable debug APK (AirBridge-android-debug.apk) for direct testing/sideloading. No signed Play bundle is included because the private Play upload key is not configured yet.
AirBridge 2.5.1 changes nothing in the running application. The server,
clients, Android app and macOS shell are unchanged from 2.5.0 — same protocol,
same permissions, same encryption, same UI. This release publishes the refreshed
project documentation, search-intent website pages and community files, and
aligns every version string so the published artefacts match the site.
If you already run 2.5.0 there is no functional reason to upgrade. Install 2.5.1
only if you want the version that matches the current release notes, or you are
following the install commands on airbridge.fyi and
prefer a fresh artefact.
What changed
Project documentation
- README now opens with what AirBridge is, who it is for, why it differs and
where to download it: a per-platform download table with checksums, real
screenshots of a live transfer, the capability list, a supported-platform
matrix, an honest security summary and a comparison that names where other
tools are the better choice. All technical sections — architecture, chunk and
ACK limits, Android background behaviour, environment variables, CLI, build
instructions and licence — are preserved below it. - CONTRIBUTING.md, CODE_OF_CONDUCT.md, a private-vulnerability section in
SECURITY.md, three issue forms and a pull-request template were added so
external reports arrive with the version, platform and redacted diagnostics
needed to act on them.
Website (airbridge.fyi)
- The landing page has a refined title/description, a real 1200 × 630 Open
Graph image built from a screenshot,WebSite/SoftwareApplication/
FAQPagestructured data, a real-screenshot section and links to the guides. - New static pages, one per genuine search intent: Android to Mac, Windows and
Linux file transfer, the Android AirDrop alternative, clipboard sync, screen
sharing, the open-source alternative, private file transfer, a download page,
a guides hub, and an honest comparison with LocalSend, KDE Connect, AirDroid,
LinkMyMac, Quick Share and AirDrop. sitemap.xmllists every page,404.htmlisnoindex, favicons and
apple-touch-icon are complete, and every page carries canonical, Open Graph and
Twitter card metadata.- The guide pages are generated from
scripts/site-pages/with
npm run website:pages; CI fails if the committed HTML is stale.
Version alignment
package.json,package-lock.json,android/app/build.gradle.kts
(versionName), the website version pills and the release-facing docs now all
read 2.5.1, and the generated pages read the version frompackage.jsonso
they cannot drift again.
Verification
Every artefact in this release is published with SHA256SUMS.txt. Sigstore
build-provenance attestations are attached to the files:
sha256sum --check SHA256SUMS.txt
gh attestation verify AirBridge-linux-x64 -R DigantaDey/AirBridgemacOS builds are ad-hoc signed (not notarised) and the Windows executable is
unsigned, because vendor certificates are paid subscriptions this project does
not buy; install.sh and install.ps1 verify the checksums before installing
anything.
Android
The release includes the installable debug APK (AirBridge-android-debug.apk)
for direct testing and sideloading. No signed Play App Bundle is attached: the
AAB is built only when the private Play upload key is configured, and it is
uploaded to Play rather than offered as a download. See
PLAY_STORE_RELEASE.md.
Unchanged
- No changes to the transfer protocol, pairing (SPAKE2), key derivation,
AES-256-GCM framing, WebSocket/WebRTC transport, relay, hotspot handoff,
clipboard, screen sharing, call audio, contacts or daemon behaviour. - No new Android permissions, no Accessibility service, no notification listener,
no analytics or advertising SDK. - No UI, layout, component or workflow changes in the Android app, the desktop
app or the macOS menu-bar shell. - The licence is unchanged: personal use is free, commercial use needs written
consent.
Full Changelog: v2.5.0...v2.5.1
AirBridge v2.5.0
Contacts: Fix horizontal and vertical alignment of Call, Save, and Remove controls in macOS contact rows.
Android: includes the installable debug APK (AirBridge-android-debug.apk) for direct testing/sideloading. No signed Play bundle is included because the private Play upload key is not configured yet.
Full Changelog: v2.4.8...v2.5.0
AirBridge v2.4.8
Android: no Play bundle is included. The private Play upload key is not configured yet, so this public release contains only the validated desktop artifacts.
What's Changed
- Harden Android release path for Google Play by @DigantaDey in #37
- Fix screen sharing stability and add live phone battery status by @DigantaDey in #38
Full Changelog: v2.4.7...v2.4.8
AirBridge v2.4.7
Android: no Play bundle is included. The private Play upload key is not configured yet, so this public release contains only the validated desktop artifacts.
Full Changelog: v2.4.6...v2.4.7
AirBridge v0.0.5
Fixes "Could not reach the transfer service" on the Mac and phone timeouts after scanning
An older AirBridge server could stay running on port 3000 after an update. The Mac app kept showing that server's UI and a stale QR code, so the phone dialled an address that wasn't on its network and timed out.
- Mac app manages the AirBridge service. It starts the installed version and restarts it if it crashes or hangs. It replaces an AirBridge server of a different version, but never touches other programs. It reloads the window on every restart and stops the service when you quit. A log is kept at
~/.airbridge/server.log. - No stale QR code. The QR code and pairing link are hidden while the window isn't connected. A Restart AirBridge button appears instead.
- Installer cleans up. It stops any old AirBridge server on the port and unloads a login item that auto-starts it. It also restarts the Mac app if it's open.
- Android finds the computer again after its address changes (for example, a hotspot turned off and on). It only does this for a computer it has already paired with, and the pair code is still required.
- The server reports its version (
/api/health,welcome). A page from an older build reloads itself.
Update
- Mac: run the installer again (same command as before). Then open AirBridge.
- Phone: install
AirBridge.apkfrom this release. - Put the Mac on the phone's hotspot (or both on the same Wi-Fi). Then scan the QR code shown now.
If it still fails, send the output of:
curl -s http://localhost:3000/api/health
ifconfig | grep "inet "
Full Changelog: v0.0.4...v0.0.5