Skip to content

Weather app support

Gadgetbridge weather support works as follows:

  • External weather apps send an intent with the weather data, which gets forwarded to the connected device.
  • Gadgetbridge caches that weather data, for devices that request it themselves (eg. Zepp OS).

There are 5 receivers for weather data:

  • WeatherNotificationReceiver (for the Weather Notification app)
  • TinyWeatherForecastGermanyReceiver (for the Tiny Weather Forecast Germany app)
  • CMWeatherReceiver (for CyanogenMod)
  • LineageOsWeatherReceiver (for LineageOS)
  • GenericWeatherReceiver (originally for QuickWeather, but can be used by any app)

While apps can use any of the receivers, as long as they conform to the format they expect, new apps integrating with Gadgetbridge should use the GenericWeatherReceiver, which was added in pull request #2830. This receiver expects an intent with JSON objects matching the WeatherSpec class fields.

  • Action: nodomain.freeyourgadget.gadgetbridge.ACTION_GENERIC_WEATHER
  • Extras:
    • WeatherJson - WeatherSpec for the primary location
    • WeatherSecondaryJson - array of WeatherSpecs for secondary locations (added in pull request #3349).

For example:

adb shell am broadcast -a "nodomain.freeyourgadget.gadgetbridge.ACTION_GENERIC_WEATHER" --es WeatherJson "{'timestamp':1664117628,'location':'Atlanta','currentTemp':291,'todayMinTemp':291,'todayMaxTemp':301,'currentCondition':'broken clouds, Rain in 25 mins','currentConditionCode':803,'currentHumidity':79,'windSpeed':5.75,'windDirection':290,'forecasts':[{'conditionCode':501,'humidity':68,'maxTemp':301,'minTemp':291},{'conditionCode':800,'humidity':25,'maxTemp':300,'minTemp':290},{'conditionCode':800,'humidity':15,'maxTemp':298,'minTemp':288},{'conditionCode':804,'humidity':21,'maxTemp':295,'minTemp':287},{'conditionCode':804,'humidity':36,'maxTemp':292,'minTemp':287},{'conditionCode':502,'humidity':93,'maxTemp':286,'minTemp':284},{'conditionCode':501,'humidity':96,'maxTemp':288,'minTemp':285},{'conditionCode':803,'humidity':54,'maxTemp':297,'minTemp':286}]}" nodomain.freeyourgadget.gadgetbridge

The QuickWeather implementation for this can be found here.

It's possible to validate / debug the weather data that Gadgetbridge received, by clicking the "Show Cached Weather" button in the debug menu (added in pull request #3077). This button only works for receivers that are present in the manifest, such as the GenericWeatherReceiver. Other receivers are only started if a device that supports weather is connected, and will not work otherwise.