Giter VIP home page Giter VIP logo

gadgetbridge's Introduction

Gadgetbridge

Gadgetbridge is an Android (4.4+) Application which will allow you to use your Pebble or Mi Band without the vendor's closed source application and without the need to create an account and transmit any of your data to the vendor's servers.

Build

Download

Gadgetbridge on F-Droid

List of changes

Features (Pebble)

  • Incoming calls notification and display (caller, phone number)
  • Outgoing call display
  • Reject/hangup calls
  • SMS notification (sender, body)
  • K-9 Mail notification support (sender, subject, preview)
  • Support for generic notifications (above filtered out)
  • Dismiss individial notifications or open corresponding app on phone from the action menu (generic notifications)
  • Dismiss all notifications from the action menu (non-generic notifications)
  • Music playback info (artist, album, track)
  • Music control: play/pause, next track, previous track, volume up, volume down
  • List and remove installed apps/watchfaces
  • Install watchfaces and firmware files (.pbw and .pbz)
  • Install language files (.pbl) (currently on Firmware 2.x only)
  • Take and share screenshots from the Pebble's screen
  • PebbleKit support for 3rd Party Android Apps support (experimental).
  • Morpheuz sleep data syncronization (experimental)

Notes about the Pebble Time

All features are also supported on the Pebble Time, except for the following:

  • Listing installed watchfaces (it will simply display the UUIDs of previously installed watchapps, no matter if they are still installed or not)
  • Firmware installation is untested and will probably not work.

How to use (Pebble)

  1. Pair your Pebble through Gadgetbridge's Discovery Activity or the Android Bluetooth Settings
  2. Start Gadgetbridge, tap on the device you want to connect to
  3. To test, choose "Debug" from the menu and play around

Features (Mi Band)

  • Mi Band notifications (LEDs + vibration) for
    • Discovery and pairing
    • Incoming calls
    • SMS received
    • K-9 mails received
    • Generic Android notifications
  • Synchronize the time to the Mi Band
  • Display firmware version and battery state
  • Synchronize activity data
  • Display sleep data (alpha)
  • Display sports data (step count) (alpha)
  • Display live activity data (alpha)
  • Set alarms on the Mi Band

How to use (Mi Band)

  • When starting Gadgetbridge and no device is visible, it will automatically attempt to discover and pair your Mi Band. Alternatively you can invoke this manually via the menu button. It will ask you for some personal info that appears to be needed for proper steps calculation on the band. If you do not provide these, some hardcoded default "dummy" values will be used instead.

    When your Mi Band starts to vibrate and blink with all three LEDs during the pairing process, tap it quickly a few times in a row to confirm the pairing with the band.

  1. Configure other notifications as desired
  2. Go back to the "Gadgetbridge" Activity
  3. Tap the "MI" item to connect if you're not connected yet.
  4. To test, chose "Debug" from the menu and play around

Known Issues:

  • Android 4.4+ only, we can only change this by not handling generic notifications or by using AccessibiltyService. Don't know if it is worth the hassle.

  • The initial connection to a Mi Band sometimes takes a little patience. Try to connect a few times, wait, and try connecting again. This only happens until you have "bonded" with the Mi Band, i.e. until it knows your MAC address. This behavior may also only occur with older firmware versions.

Authors (in order of first code contribution)

  • Andreas Shimokawa
  • Carsten Pfeiffer
  • Daniele Gobbetti

Contribute

Contributions are welcome, be it feedback, bugreports, documentation, translation, research or code. Feel free to work on any of the open issues; just leave a comment that you're working on one to avoid duplicated work.

Translations can be contributed via https://www.transifex.com/projects/p/gadgetbridge/resource/strings/ or manually.

Having problems?

  1. Open Gadgetbridge's settings and check the option to write log files
  2. Quit Gadgetbridge and restart it
  3. Reproduce the problem you encountered
  4. Check the logfile at /sdcard/Android/data/nodomain.freeyourgadget.gadgetbridge/files/gadgetbridge.log
  5. File an issue at https://github.com/Freeyourgadget/Gadgetbridge/issues/new and possibly provide the logfile

Alternatively you may use the standard logcat functionality to access the log.

gadgetbridge's People

Contributors

aafa avatar ashimokawa avatar cpfeiffer avatar danielegobbetti avatar kevlarcade avatar roidelapluie avatar sarg avatar xphnx avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.