From e1c99b167740d8d0015b78f08a3830a3c2fe2dfd Mon Sep 17 00:00:00 2001 From: Rob Pilling Date: Mon, 8 May 2023 22:18:05 +0100 Subject: [PATCH] widhid: add README --- apps/widhid/README.md | 21 +++++++++++++++++++++ apps/widhid/metadata.json | 1 + 2 files changed, 22 insertions(+) create mode 100644 apps/widhid/README.md diff --git a/apps/widhid/README.md b/apps/widhid/README.md new file mode 100644 index 000000000..7651d74eb --- /dev/null +++ b/apps/widhid/README.md @@ -0,0 +1,21 @@ +# Description + +A music control widget based on [Swipe Bluetooth Music Controls] (based on [Bluetooth Music Controls]). +By operating as a widget, you can control music without leaving your current app (e.g. on a run, bike ride or just watching the clock). + + +[Swipe Bluetooth Music Controls]: https://github.com/espruino/BangleApps/tree/master/apps/hidmsicswipe +[Bluetooth Music Controls]: https://github.com/espruino/BangleApps/tree/master/apps/hidmsic + +# Usage + +Swipe down to enable - note the icon changes from blue to orange, indicating it's listening for your instruction. Then drag up/down for volume, left/right for previous and next and tap for play/pause. + +All other watch interaction is disabled for 3 seconds, to prevent clashing taps/drags - this period is extended as you continue to alter the volume, play/pause and jump between tracks. + + +# Setup / Technical details + +Note that HID must be enabled in settings. Then provided you're paired with your phone/computer, the widget icon will appear and you can control music from your clock face! + +The app disables all other drag and tap handlers while this widget is "active" (in a similar manner to [`backswipe`](https://github.com/espruino/BangleApps/pull/2524#issuecomment-1406230564) and [`lightswitch`](https://github.com/espruino/Espruino/issues/2151#issuecomment-1042423211)). diff --git a/apps/widhid/metadata.json b/apps/widhid/metadata.json index 5acafb2e4..4ad6e17d1 100644 --- a/apps/widhid/metadata.json +++ b/apps/widhid/metadata.json @@ -5,6 +5,7 @@ "version": "0.01", "description": "Based on Swipe Bluetooth Music Controls (based on Bluetooth Music Controls). Swipe down to enable, then swipe up/down for volume, left/right for previous and next and tap for play/pause. Enable HID in settings, pair with your phone/computer, then use this widget to control music from your watch!", "icon": "icon.png", + "readme": "README.md", "tags": "widget,bluetooth", "supports": ["BANGLEJS2"], "storage": [