BangleApps/apps/ios
Gordon Williams 9e72ef1274 ios 0.18: Fix UTF8 conversion (check for `font` library, not `fonts`) 2024-03-19 10:51:54 +00:00
..
ChangeLog ios 0.18: Fix UTF8 conversion (check for `font` library, not `fonts`) 2024-03-19 10:51:54 +00:00
README.md Support for international fonts, and rendering UTF8 characters that come from iOS direct in the messages app 2024-03-15 16:15:55 +00:00
app-icon.js ability to depend on a specific app ID 2021-11-04 17:16:02 +00:00
app.js messages: split library/gui/widget into separate apps 2022-11-26 16:52:17 +01:00
app.png ability to depend on a specific app ID 2021-11-04 17:16:02 +00:00
boot.js ios 0.18: Fix UTF8 conversion (check for `font` library, not `fonts`) 2024-03-19 10:51:54 +00:00
metadata.json ios 0.18: Fix UTF8 conversion (check for `font` library, not `fonts`) 2024-03-19 10:51:54 +00:00
settings.js Support for international fonts, and rendering UTF8 characters that come from iOS direct in the messages app 2024-03-15 16:15:55 +00:00

README.md

iOS integration app

This is the iOS integration app for Bangle.js. This app allows you to receive notifications from your iPhone. The Apple Notification Center Service (ANCS) sends all the messages to your watch.

You can allow this if you connect your Bangle to your iPhone. It will be prompted for immediatly after you connect the Bangle to the iPhone.

Setting

Under Settings -> Apps -> iOS Integration there are some settings:

  • Time Sync - This will enable syncing between the watch and iOS.
  • Disable UTF8 - As of version 0.17 of this app, text strings from iOS are treated as UTF8. If you install a font library like https://banglejs.com/apps/?id=fontsall then the messages app will be able to use that to render characters from iOS. Without fonts installed, non-european (ISO8859-1) characters won't be displayed. If Disable UTF8 is true or no fonts library is installed, text from iOS is converted to ISO8859-1, and known characters with equivalents within that range are converted (so text will display without a font library).

Connecting your Bangle.js to your iPhone

The Bangle watches are Bluetooth Low Energy (BLE) devices. Sometimes they will not be seen/detected by the Bluetooth scanner in your iPhone settings menu.

To resolve this, you can download an app that can actually scan for BLE devices. There are great ones out there, free and paid.

We really like WebBLE, which we also recommend to load apps on your watch with your iOS device, as Safari does not support WebBluetooth for now. It's just a few bucks/pounds/euro's.

If you like to try a free app first, you can always use NRF Toolbox or Bluetooth BLE Device Finder to find and connect your Bangle.

Weather and Calendar

By using the Shortcuts app on your phone, you can send weather and calendar data to your watch. This works by sending a notification, which is read by the watch through ANCS. The watch then parses the notification for the data.

While you may write your own shortcuts if you prefer (for example, to get weather from a different source), two are provided:

The weather shortcut requires an OpenWeatherMap api key, which you can get for free from https://openweathermap.org/api. The shortcut will prompt you for this when you add it to your phone.

These shortcuts can also be automated to run periodically, for example every hour, using the Automation tab in the Shortcuts app.

The shortcuts will send a notification, which can be annoying. One potential workaround for this would be to create a focus mode, and have an automation:

  • activate the focus mode (hiding notifications from the shortcut)
  • run the shortcut
  • deactivate the focus mode

Requests

Please file any issues on https://github.com/espruino/BangleApps/issues/new?title=ios%20app

Creator

Gordon Williams