mirror of
https://codeberg.org/Freeyourgadget/Gadgetbridge
synced 2024-11-29 21:32:57 +01:00
5b2ca65321
Hi, i applied the changes from [Emeryths fork](https://github.com/Emeryth/Gadgetbridge) to master in order to get the [SMA Q2 smartwatch](https://hackaday.io/project/85463-color-open-source-smartwatch) support upstream. It uses [his firmware](https://github.com/Emeryth/sma-q2-oss) (pretty/most popular for this device). Greatly appreciate any feedback as this is my first attempt to add a device to GB :) I read through the [tutorial](https://codeberg.org/Freeyourgadget/Gadgetbridge/wiki/New-Device-Tutorial), are there other sources for adding new device support? thanks! Co-authored-by: x29a <0.x29a.0@gmail.com> Reviewed-on: https://codeberg.org/Freeyourgadget/Gadgetbridge/pulls/2215 Co-authored-by: x29a <x29a@noreply.codeberg.org> Co-committed-by: x29a <x29a@noreply.codeberg.org>
150 lines
8.4 KiB
Markdown
150 lines
8.4 KiB
Markdown
Gadgetbridge is now hosted on [codeberg.org](https://codeberg.org/Freeyourgadget/Gadgetbridge/).
|
|
|
|
<a href="https://codeberg.org/Freeyourgadget/Gadgetbridge/">
|
|
<img alt="Get it on Codeberg" src="https://get-it-on.codeberg.org/get-it-on-blue-on-white.png" height="60">
|
|
</a>
|
|
|
|
Gadgetbridge
|
|
============
|
|
|
|
Gadgetbridge is an Android (4.4+) application which will allow you to use your
|
|
Pebble, Mi Band, Amazfit Bip and HPlus device (and more) 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.
|
|
|
|
[Homepage](https://gadgetbridge.org) - [Blog](https://blog.freeyourgadget.org) - [Wiki](https://codeberg.org/Freeyourgadget/Gadgetbridge/wiki) - <a rel="me" href="https://social.anoxinon.de/@gadgetbridge">Mastodon</a>
|
|
|
|
[](https://liberapay.com/Gadgetbridge/donate)
|
|
|
|
|
|
[](https://travis-ci.org/Freeyourgadget/Gadgetbridge)
|
|
[](https://lgtm.com/projects/g/Freeyourgadget/Gadgetbridge/context:java)
|
|
[](https://lgtm.com/projects/g/Freeyourgadget/Gadgetbridge/alerts)
|
|
[](https://hosted.weblate.org/projects/freeyourgadget/gadgetbridge)
|
|
|
|
## Download
|
|
|
|
[<img src="https://f-droid.org/badge/get-it-on.png" alt="Get it on F-Droid" height="80">](https://f-droid.org/app/nodomain.freeyourgadget.gadgetbridge)
|
|
|
|
[List of changes](https://codeberg.org/Freeyourgadget/Gadgetbridge/src/master/CHANGELOG.md)
|
|
|
|
## Supported Devices
|
|
**(WARNING: Some of them WIP and some of them without maintainer)**
|
|
|
|
- Amazfit
|
|
- [Band 5](https://codeberg.org/Freeyourgadget/Gadgetbridge/wiki/Mi-Band-5) [**\[!\]**](#special-pairing-procedures)
|
|
- [Bip](https://codeberg.org/Freeyourgadget/Gadgetbridge/wiki/Amazfit-Bip)
|
|
- [Bip Lite](https://codeberg.org/Freeyourgadget/Gadgetbridge/wiki/Amazfit-Bip-Lite), Bip S, Bip U [**\[!\]**](#special-pairing-procedures)
|
|
- [Cor](https://codeberg.org/Freeyourgadget/Gadgetbridge/wiki/Amazfit-Cor), [Cor 2](https://codeberg.org/Freeyourgadget/Gadgetbridge/wiki/Amazfit-Cor-2)
|
|
- [GTR](https://codeberg.org/Freeyourgadget/Gadgetbridge/wiki/Amazfit-GTR), [GTR 2/2e](https://codeberg.org/Freeyourgadget/Gadgetbridge/wiki/Amazfit-GTR) [**\[!\]**](#special-pairing-procedures)
|
|
- [GTS](https://codeberg.org/Freeyourgadget/Gadgetbridge/wiki/Amazfit-GTS), [GTS 2/2e](https://codeberg.org/Freeyourgadget/Gadgetbridge/wiki/Amazfit-GTS) [**\[!\]**](#special-pairing-procedures)
|
|
- [Neo](https://codeberg.org/Freeyourgadget/Gadgetbridge/wiki/Amazfit-Neo) [**\[!\]**](#special-pairing-procedures)
|
|
- T-Rex [**\[!\]**](#special-pairing-procedures)
|
|
- Verge Lite [**\[!\]**](#special-pairing-procedures)
|
|
- [X ](https://codeberg.org/Freeyourgadget/Gadgetbridge/wiki/Mi-Band-5) [**\[!\]**](#special-pairing-procedures)
|
|
- BFH-16
|
|
- Casio
|
|
- [GB-5600B/GB-6900B/GB-X6900B](https://codeberg.org/Freeyourgadget/Gadgetbridge/wiki/Casio-GB-5600B%2FGB-6900B%2FGB-X6900B)
|
|
- [GBX-100](https://codeberg.org/Freeyourgadget/Gadgetbridge/wiki/Casio-GBX-100)
|
|
- Fossil
|
|
- [Hybrid HR](https://codeberg.org/Freeyourgadget/Gadgetbridge/wiki/Fossil-Hybrid-HR) [**\[!\]**](#special-pairing-procedures)
|
|
- Q Hybrid
|
|
- [HPlus Devices (e.g. ZeBand)](https://codeberg.org/Freeyourgadget/Gadgetbridge/wiki/HPlus)
|
|
- ID115
|
|
- [iTag](https://codeberg.org/Freeyourgadget/Gadgetbridge/wiki/iTag)
|
|
- JYou Y5
|
|
- Lefun
|
|
- Lenovo
|
|
- Watch 9
|
|
- [Watch X (Plus)](https://codeberg.org/mamutcho/Gadgetbridge/wiki)
|
|
- Liveview
|
|
- Makibes HR3
|
|
- Mi
|
|
- [Band, Band 1A, Band 1S](https://codeberg.org/Freeyourgadget/Gadgetbridge/wiki/Mi-Band), [Band 2](https://codeberg.org/Freeyourgadget/Gadgetbridge/wiki/Mi-Band-2), [Band 3](https://codeberg.org/Freeyourgadget/Gadgetbridge/wiki/Mi-Band-3)
|
|
- [Band 4](https://codeberg.org/Freeyourgadget/Gadgetbridge/wiki/Mi-Band-4), [Band 5](https://codeberg.org/Freeyourgadget/Gadgetbridge/wiki/Mi-Band-5), [Band 6](https://codeberg.org/Freeyourgadget/Gadgetbridge/wiki/Mi-Band-6) [**\[!\]**](#special-pairing-procedures)
|
|
- Scale 2 (Currently only displays a toast after stepping on the scale)
|
|
- [MyKronoz ZeTime](https://codeberg.org/Freeyourgadget/Gadgetbridge/wiki/MyKronoz-ZeTime)
|
|
- NO.1 F1
|
|
- [Nut Mini 3, Nut 2 and possibly others](https://codeberg.org/Freeyourgadget/Gadgetbridge/wiki/Nut)
|
|
- Pebble
|
|
- [Pebble, Steel, Time, Time Steel, Time Round, 2](https://codeberg.org/Freeyourgadget/Gadgetbridge/wiki/Pebble)
|
|
- PineTime (InfiniTime Firmware)
|
|
- [SMA](https://codeberg.org/Freeyourgadget/Gadgetbridge/wiki/SMA) Q2 (SMA-Q2-OSS Firmware)
|
|
- Teclast H10, H30
|
|
- TLW64
|
|
- Vibratissimo (Experimental)
|
|
- Wasp-OS devices
|
|
- XWatch (Affordable Chinese Casio-like smartwatches)
|
|
- [Zepp E](https://codeberg.org/Freeyourgadget/Gadgetbridge/wiki/Amazfit-GTR) [**\[!\]**](#special-pairing-procedures)
|
|
|
|
|
|
### Special Pairing Procedures
|
|
|
|
Some Huami / Amazfit / Mi / Zepp devices can only be paired with Gadgetbridge using a secret key that has to be obtained once using the proprietary app with an account. Detailed instructions in the wiki: [Huami Server Pairing](https://codeberg.org/Freeyourgadget/Gadgetbridge/wiki/Huami-Server-Pairing)
|
|
|
|
The Fossil Hybrid HR also requires using the proprietary app, but with a more complicated procedure. Details in the wiki: [Hybrid HR](https://codeberg.org/Freeyourgadget/Gadgetbridge/wiki/Fossil-Hybrid-HR).
|
|
|
|
## Features
|
|
|
|
Please see [FEATURES.md](https://codeberg.org/Freeyourgadget/Gadgetbridge/src/master/FEATURES.md)
|
|
|
|
## Authors
|
|
### Core Team (in order of first code contribution)
|
|
|
|
* Andreas Shimokawa
|
|
* Carsten Pfeiffer
|
|
* Daniele Gobbetti
|
|
|
|
### Additional device support
|
|
* João Paulo Barraca (HPlus)
|
|
* Vitaly Svyastyn (NO.1 F1)
|
|
* Sami Alaoui (Teclast H30)
|
|
* "ladbsoft" (XWatch)
|
|
* Sebastian Kranz (ZeTime)
|
|
* Vadim Kaushan (ID115)
|
|
* "maxirnilian" (Lenovo Watch 9)
|
|
* "ksiwczynski", "mkusnierz", "mamutcho" (Lenovo Watch X Plus)
|
|
* Andreas Böhler (Casio)
|
|
* Jean-François Greffier (Mi Scale 2)
|
|
* Johannes Schmitt (BFH-16)
|
|
* Lukas Schwichtenberg (Makibes HR3)
|
|
* Daniel Dakhno (Fossil Q Hybrid, Fossil Hybrid HR)
|
|
* Gordon Williams (Bangle.js)
|
|
* Pavel Elagin (JYou Y5)
|
|
* Taavi Eomäe (iTag)
|
|
* Erik Bloß (TLW64)
|
|
* Yukai Li (Lefun)
|
|
|
|
## Contribute
|
|
|
|
Contributions are welcome, be it feedback, bug reports, documentation, translation, research or code. Feel free to work
|
|
on any of the open [issues](https://codeberg.org/Freeyourgadget/Gadgetbridge/issues);
|
|
just leave a comment that you're working on one to avoid duplicated work.
|
|
|
|
[Developer documentation](https://codeberg.org/Freeyourgadget/Gadgetbridge/wiki/Developer-Documentation) - [Support for a new Device](https://codeberg.org/Freeyourgadget/Gadgetbridge/wiki/Support-for-a-new-Device) - [New Device Tutorial](https://codeberg.org/Freeyourgadget/Gadgetbridge/wiki/New-Device-Tutorial)
|
|
|
|
Translations can be contributed via https://hosted.weblate.org/projects/freeyourgadget/gadgetbridge/
|
|
|
|
## Community
|
|
|
|
If you would like to get in touch with other Gadgetbridge users and developers outside of Codeberg, you can do so via:
|
|
* Matrix: `#gadgetbridge:matrix.org` ([web access via Element.io](https://app.element.io/#/room/#gadgetbridge:matrix.org))
|
|
|
|
## Do you have further questions or feedback?
|
|
|
|
Feel free to open an issue on our issue tracker, but please:
|
|
- do not use the issue tracker as a forum, do not ask for ETAs and read the issue conversation before posting
|
|
- use the search functionality to ensure that your question wasn't already answered. Don't forget to check the **closed** issues as well!
|
|
- remember that this is a community project, people are contributing in their free time because they like doing so: don't take the fun away! Be kind and constructive.
|
|
- Do not ask for help regarding your own projects, unless they are Gadgetbridge related
|
|
|
|
## Having problems?
|
|
|
|
0. Phone crashing during device discovery? Disable Privacy Guard (or similarly named functionality) during discovery.
|
|
1. Open Gadgetbridge's settings and check the option to write log files
|
|
2. Reproduce the problem you encountered
|
|
3. Check the logfile at /sdcard/Android/data/nodomain.freeyourgadget.gadgetbridge/files/gadgetbridge.log
|
|
4. File an issue at https://codeberg.org/Freeyourgadget/Gadgetbridge/issues/new/choose and possibly provide the logfile
|
|
|
|
Alternatively you may use the standard logcat functionality to access the log.
|