Garmin - control your Homey with your Garmin watch

Devices
,
1

Hero Image Venu2

Control your Homey with this widget on your Garmin watch

Features

  • Get some Homey details like memory and CPU usage
  • scroll through your favorite devices and flows
  • toggle switches, press buttons and start flows
  • check notifications
  • change your user state (at home/away and awake/asleep)

Showcase on Youtube

(Showing some currently not availabel functionality)

Requirements

You need a Homey smart hub to use this widget :wink:

When you first start the widget, the Garmin Connect app shows the Homey login screen. Authenticate with your Homey account, select your Homey that you want to control (if you have more than one) and confirm the permissions that this widget needs.

Limitations (Garmin devices)

The widget itself uses a minimal amount of memory. But the JSON results from the WebAPI are really extensive. For this reason, only devices with more than 64kB widget memory are supported.
For details select your device on: https://developer.garmin.com/connect-iq/reference-guides/devices-reference/

Limitations (Homey access / rights)

Athom currently only grants user permissions. System-wide access (apps) and changes (notifications) are currently not possible.

Limitations (iOS mobile phones for app version < 1.0.0)
The Garmin API is not 100% compatible to the used Athom WebAPI. Garmin only supports JSON objects, but not JSON strings. That’s why you can’t use your iOS mobile phone to connect your Homey from your watch. You will only get a “device not supported” message on the watch after trying to log in.
That’s caused by the iOS GarminConnect app that’s forwarding the communication from the widget to Homey and that’s blocking the auth response.
A bug report is opened at Garmin for a long time but it doesn’t seem Garmin will fix the bug.
Android devices allow passing the API response as plain text, so the widget can get the auth token from your Homey.
Feel free to vote up the bug report or repeat the request to fix the error in the bug report.

If you own a HomeyPro23, you can use the local API key instead.

Update:
App versions from 1.0.0 and higher are using a proxy service to convert the API response to a format that can be used in Garmin API. oAuth should work for current and future versions.

How does it look like?

The main view of the widget shown in the widget carousel, followed by the category list (use a tap or START button)
GIF animated compressed

MainView fenix5x
MainView fenix5x380×524 91.6 KB
CategoryView
CategoryView390×542 96.5 KB

Tap or press START in the device category to get into the device list. Scroll through your favorite devices with UP/DOWN or swiping up/down. If a Switch or button is displayed, you can toggle or press it with START or a tap. A progess view is displayed while communicating with Homey.
DeviceView Venu2 small
DeviceView Venu2 small402×601 62.9 KB
Device with Switch&Sensor
Device with Switch&Sensor427×557 111 KB
SwitchingView
SwitchingView393×544 96.6 KB

From flow category you can jump into the favorite flow list. Select a flow and start this flow with a tap or the START button.
Flow
Flow429×555 110 KB

On-screen hints show what interaction is possible in the view:

Screen Layout
Screen Layout800×410 61.4 KB

Now the most important thing… :grinning:
Thank you for supporting app development with a small donation via PayPal.

btn_donate_LG1

2

FAQ

3

reserved

4

Versions
Current state: Public Beta version

0.1.0 Initial Beta version with WebAPI access and oAuth authentification

5

I open Garmins ConnectIQ app on my mobile device but where can I enter my cloudId and Bearer token.

thanks in advance for the help.

6

Go to “My widgets” in the IQ → Homey and then where it says “Innstillinger” on this image:

Screenshot_20220720-115914_Connect IQ
Screenshot_20220720-115914_Connect IQ1080×2220 122 KB

Fill in where it says “xxx-xxxx…” and “Bearer xxxxx-…” in this image. Not easy to see the input fields, but just tap there and your keyboard should pop up.

Screenshot_20220720-120004_Connect IQ
Screenshot_20220720-120004_Connect IQ1080×2220 156 KB

Hope this helps :slight_smile:

7

i already found it i have to fill it in via garmin express and it worked but now i get the message set app settings.

thank you in advance for the help.

8

Hi Fred,

here is a Wiki post for GarminExpress and the mobile apps:

9

The CloudID must be copied without the quotes.
The Bearer token must be copied completely (incl Bearer xxxx). Please check if it’s displayed with linebreaks. Then copy the whole text.

10

Yes i have this CloudID without the quotes en the bearer token whit Bearer xxx.

11

When you change the settings with GarminExpress, a Sync could be needed. Using the Mobile app (or ConnectIQ app), the settings are stored directly on the device.

12

A new version (0.0.3) is online… @kjeet90
It could take some time until you can see and install the new version with the ConnectIQ app.

13

i have the new version instaled and i make the sync but still the message set app settings???

14

Can you please check the app settings with the ConnectIQ app? That’s showing “live” data from your watch. I don’t use GarminExpress for app settings because in the past I got such trouble, too.

15

i have check the app settings in the connectIQ app and i see my CloudID and my bearer token.

16

But i see the version is 0.0.2 and i install the version 0.0.3

17

The install button normally will set the app into the sync queue. You can see it in

grafik
grafik448×886 57.5 KB

After a restart of teh ConnecIQ app, the sync circle should turn green and aftert sync, the “Update” vaule should witch to “0”.

Can you send me a screenshot from the settings as PM? Perhaps I can see something…
And last question: what device are you using?

18

garmin venu 2s

19

I get in the homey app
I keep getting update and queued

20

How can i make a pm to you ?