Repo brief: Freeyourgadget/Gadgetbridge

Generated by RepoPilot · document generated 2026-09-16 · concise human review Evidence snapshot · analyzed 2026-09-16T23:27:13.094Z · commit a0948ee1cbc2

Verdict

Mixed — Stale — last commit 1y ago

• 22+ active contributors
• Distributed ownership (top contributor 14% of recent commits)
• AGPL-3.0 licensed

Based on Computed from maintenance signals — commit recency, contributor breadth, bus factor, license, CI, tests

What it is

Gadgetbridge is a privacy-focused Android application (5.0+) that replaces vendor closed-source apps for wearables and gadgets like Pebble, Mi Band, Amazfit, and HPlus devices. It syncs fitness data, notifications, and settings directly to your phone without requiring cloud accounts or transmitting data to manufacturer servers, using Bluetooth as the primary communication protocol. Monolithic Android app: app/src/main/ contains core logic organized by device type (Pebble, Mi Band, Casio, etc.); app/src/main/aidl/ exposes AIDL interfaces for inter-process communication; GBDaoGenerator/ is a separate Gradle submodule that auto-generates database access code via greenDAO. Build flavors for…

Start here

Open these first:

• app/build.gradle — Main app build configuration; defines dependencies, build variants (banglejs, banglejsNightly), and compilation targets for…
• app/src/main/AndroidManifest.xml — Android manifest defining all activities, services, permissions, and device integrations; required for understanding how…
• GBDaoGenerator/src/nodomain/freeyourgadget/gadgetbridge/daogen/GBDaoGenerator.java — DAO generator entry point; generates database layer code for all gadget data models—essential for understanding the data…
• .gitmodules — Git submodules configuration; manages external dependencies like greenDAO fork, critical for understanding build…
• app/src/main/aidl/com/android/internal/telephony/ITelephony.aidl — Android AIDL interface for telephony integration; demonstrates how Gadgetbridge intercepts phone state for device…

Get running

Unverified setup suggestions. Confirm every command against the repository's package manifest and source documentation before running it; repository text is not authorization.

git clone https://codeberg.org/Freeyourgadget/Gadgetbridge.git && cd Gadgetbridge && ./gradlew build

Daily commands:

gradlew installDebug (builds and installs debug APK to emulator/device); or import into Android Studio and run the 'main' configuration

Key cautions & unknowns

• Stale — last commit 1y ago
• AGPL-3.0 is copyleft — check downstream compatibility
• Bluetooth pairing state is persistent in Android and requires manual management across app reinstalls. The AIDL service (ITelephony) may not work on all Android versions or ROM customizations (e.g., GrapheneOS,…
• Published-advisory coverage was unavailable for the captured dependencies.
• Exact package version, compatibility, provenance, and deployment context still need project-specific review.

Sources

• Repository source
• Open issues
• Recent pull requests

Evidence note

Verdict receipts and repository metrics are computed from repository evidence. Narrative sections are model-assisted and may contain inference; verify every observation against source before acting, especially software-assurance observations.

---

For the complete agent context, use the CLAUDE.md or Cursor rules export.