Gadgetbridge/README.md

Gadgetbridge
============

Gadgetbridge is an Android (4.4+) Application which will allow you to use your
Pebble or Miband 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.

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 notificaions (above filtered out)
* Apollo playback info (artist, album, track)
* Music control: play/pause, next track, previous track, volume up, volume down
* List and remove installed apps/watchfaces
* Install .pbw files
* Install firmware from .pbz files (EXPERIMENTAL)

How to use (Pebble):

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

How to use (Miband):

* With older Miband firmware (e.g. 1.4.0.sx): Add your Miband's MAC address manually  (Settings -> Debug)
* With newer firmware that supports pairing, pair your Miband through the Android Bluetooth Settings

1. Configure other notifications as desired
2. Go back to the "Gadgetbridge" Activity
3. Tap the "MI" device to connect
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 Miband sometimes takes a little patience. Try to connect a few times, wait, 
  possibly quit Gadgetbridge before connecting again. This only happens until you have "bonded" with the 
  Miband, i.e. until it knows your MAC address. This behavior may also only occur with older firmware versions.

## Download

[![Gadgetbridge on F-Droid](/Get_it_on_F-Droid.svg.png?raw=true "Download from F-Droid")](https://f-droid.org/repository/browse/?fdid=nodomain.freeyourgadget.gadgetbridge)
Initial commit 2015-01-06 00:19:03 +01:00			`Gadgetbridge`
			`============`
First checkin of actual code 2015-01-07 14:00:18 +01:00
Improved README 2015-04-25 23:59:24 +02:00			`Gadgetbridge is an Android (4.4+) Application which will allow you to use your`
			`Pebble or Miband 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.`
First checkin of actual code 2015-01-07 14:00:18 +01:00
bump version to 0.3.0, update README.md and CHANGELOG.md 2015-04-19 11:34:26 +02:00			`Features (Pebble):`
Update README.md 2015-02-01 00:43:31 +01:00
initial support for music playback information (artist, album, track), fix encoding of empty strings in PebbleProtocol 2015-02-08 23:53:40 +01:00			`* Incoming calls notification and display (caller, phone number)`
Support for rejecting/ending calls via Pebble buttons 2015-03-07 17:44:39 +01:00			`* Outgoing call display`
fix crash when no Pebble was paired, change version to 0.1.0, build tweaks 2015-03-11 12:40:59 +01:00			`* Reject/hangup calls`
Native support for K-9 Mail, bugfixes for generic notifications 2015-01-26 18:52:19 +01:00			`* SMS notification (sender, body)`
			`* K-9 Mail notification support (sender, subject, preview)`
Update README.md 2015-02-01 00:43:31 +01:00			`* Support for generic notificaions (above filtered out)`
fix crash when no Pebble was paired, change version to 0.1.0, build tweaks 2015-03-11 12:40:59 +01:00			`* Apollo playback info (artist, album, track)`
update README.md 2015-04-13 22:31:00 +02:00			`* Music control: play/pause, next track, previous track, volume up, volume down`
show hint at the bottom of the Main Activity, update README.md, bump to 0.1.4 2015-03-27 12:33:51 +01:00			`* List and remove installed apps/watchfaces`
Pebble: Firmware upgrade support 2015-04-17 12:23:19 +02:00			`* Install .pbw files`
			`* Install firmware from .pbz files (EXPERIMENTAL)`
Update README.md 2015-02-01 00:43:31 +01:00
bump version to 0.3.0, update README.md and CHANGELOG.md 2015-04-19 11:34:26 +02:00			`How to use (Pebble):`
Update README.md 2015-02-01 00:43:31 +01:00
Improved README 2015-04-25 23:59:24 +02:00			`1. Pair your Pebble through the Android Bluetooth Settings`
display connection status in the device list 2015-03-22 23:38:51 +01:00			`2. Start Gadgetbridge, tap on the device you want to connect to`
update README 2015-02-07 13:30:12 +01:00			`3. To test, chose "Debug" from the menu and play around`
First checkin of actual code 2015-01-07 14:00:18 +01:00
bump version to 0.3.0, update README.md and CHANGELOG.md 2015-04-19 11:34:26 +02:00			`How to use (Miband):`

Improved README 2015-04-25 23:59:24 +02:00			`* With older Miband firmware (e.g. 1.4.0.sx): Add your Miband's MAC address manually (Settings -> Debug)`
			`* With newer firmware that supports pairing, pair your Miband through the Android Bluetooth Settings`

			`1. Configure other notifications as desired`
			`2. Go back to the "Gadgetbridge" Activity`
			`3. Tap the "MI" device to connect`
			`4. To test, chose "Debug" from the menu and play around`
bump version to 0.3.0, update README.md and CHANGELOG.md 2015-04-19 11:34:26 +02:00
Receive SMS the proper way, filter them out in the generic NotificationListener. 2015-01-24 12:21:15 +01:00			`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.`
add f-droid logo and link. Thanks to "ghost" for the suggestion. 2015-03-29 22:22:03 +02:00
Improved README 2015-04-25 23:59:24 +02:00			`* The initial connection to a Miband sometimes takes a little patience. Try to connect a few times, wait,`
			`possibly quit Gadgetbridge before connecting again. This only happens until you have "bonded" with the`
			`Miband, i.e. until it knows your MAC address. This behavior may also only occur with older firmware versions.`
add f-droid logo and link. Thanks to "ghost" for the suggestion. 2015-03-29 22:22:03 +02:00
			`## Download`

Improved README 2015-04-25 23:59:24 +02:00			`[![Gadgetbridge on F-Droid](/Get_it_on_F-Droid.svg.png?raw=true "Download from F-Droid")](https://f-droid.org/repository/browse/?fdid=nodomain.freeyourgadget.gadgetbridge)`