Skip to content

Smartwatch Support ​

Integration with smartwatches via Gadget Bridge.

Overview ​

OSS Weather integrates with Gadget Bridge, an open-source companion app that supports various smartwatches and fitness bands.

What is Gadget Bridge? ​

Gadget Bridge is a free and open-source Android application that allows you to use smartwatches and fitness trackers without proprietary apps or cloud services.

Supported Devices Include:

  • Amazfit (Bip, GTS, GTR, etc.)
  • Xiaomi Mi Band series
  • Huami devices
  • Fossil Hybrid HR
  • Pinetime
  • Bangle.js
  • And many more...

See the full list of supported devices.

Features ​

OSS Weather can send weather data to your smartwatch via Gadget Bridge:

Current Weather ​

  • Temperature
  • Weather condition
  • Weather icon
  • Location

Forecast Data ​

  • Hourly forecast
  • Daily forecast
  • Temperature trends
  • Conditions

Updates ​

  • Automatic sync
  • Configurable interval
  • On-demand updates

Setting Up ​

Prerequisites ​

  1. Install Gadget Bridge from:

  2. Pair your smartwatch with Gadget Bridge

  3. Configure OSS Weather to work with Gadget Bridge

Configuration ​

  1. Open OSS Weather

  2. Go to Settings → Smartwatch

  3. Enable "Gadget Bridge Integration"

  4. Configure sync settings:

    • Sync interval
    • Data to sync
    • Location to use
  5. Open Gadget Bridge

  6. Configure weather sync in device settings

  7. Set OSS Weather as weather provider

Syncing Weather Data ​

Automatic Sync ​

When enabled, OSS Weather will:

  • Sync at configured intervals
  • Update when weather changes significantly
  • Sync on manual refresh in app

Manual Sync ​

Force sync by:

  1. Pull to refresh in OSS Weather
  2. Tap sync in Gadget Bridge
  3. Use watch to request update (device-dependent)

Sync Interval ​

Balance freshness vs battery:

  • 30 minutes: Frequent updates, more battery
  • 1 hour: Balanced (recommended)
  • 3 hours: Conservative battery usage
  • Manual only: Sync only when needed

Data Sent to Watch ​

Depending on your watch and Gadget Bridge settings:

Current:

  • Temperature
  • Weather condition
  • Weather icon
  • Feels-like temperature
  • Humidity
  • Wind speed

Hourly:

  • Next 12-24 hours
  • Temperature
  • Condition
  • Precipitation

Daily:

  • Next 5-7 days
  • High/Low temperature
  • Condition
  • Precipitation probability

Smartwatch Display ​

Watch Faces ​

Many Gadget Bridge-compatible watch faces can display:

  • Current temperature
  • Weather icon
  • Condition text
  • Forecast data

Weather App ​

Some watches have dedicated weather apps showing:

  • Detailed current conditions
  • Hourly forecast
  • Daily forecast
  • Multiple metrics

Battery Considerations ​

Smartwatch weather sync impacts battery on:

Phone:

  • Minimal impact
  • Periodic sync uses little power
  • Background communication

Watch:

  • Depends on sync frequency
  • Watch display usage
  • Device efficiency

Tips:

  • Use reasonable sync intervals (1 hour+)
  • Disable if not using weather on watch
  • Balance freshness with battery life

Troubleshooting ​

Weather Not Syncing ​

  1. Check Gadget Bridge connection:

    • Ensure watch connected
    • Check Bluetooth
    • Verify connection in Gadget Bridge
  2. Verify OSS Weather settings:

    • Integration enabled
    • Sync interval set
    • Location selected
  3. Check Gadget Bridge settings:

    • Weather integration enabled
    • OSS Weather selected as provider
    • Permissions granted

Outdated Weather on Watch ​

  1. Force sync in OSS Weather (pull to refresh)
  2. Check last sync time in Gadget Bridge
  3. Verify sync interval
  4. Check if background sync working

Wrong Location ​

  1. Verify location in OSS Weather settings
  2. Check which location is set for sync
  3. Ensure location permissions granted

Icons Not Showing ​

  • Some watch faces don't support icons
  • Check watch face settings
  • Try different watch face
  • Update Gadget Bridge

Privacy ​

OSS Weather + Gadget Bridge:

  • No cloud services
  • No data collection
  • Local sync only
  • Open source

Your weather data never leaves your devices.

Compatibility ​

Android Only ​

Gadget Bridge is Android-only, so smartwatch integration requires:

  • Android phone
  • OSS Weather for Android
  • Compatible smartwatch

iOS Alternative ​

For iOS users:

  • Some smartwatches have native iOS apps
  • Check if your watch has iOS support
  • May not have open-source options

Limitations ​

  • Sync requires Gadget Bridge installed
  • Limited by watch capabilities
  • Some watches show limited data
  • Display varies by watch model

Benefits ​

Why use Gadget Bridge + OSS Weather:

✅ Open source ✅ Privacy-focused ✅ No proprietary apps needed ✅ No cloud services ✅ Free ✅ Customizable ✅ Works offline (with cached data)

Supported Devices ​

While OSS Weather can work with any Gadget Bridge-compatible device, weather display depends on the device's capabilities.

Popular Devices:

  • Amazfit Bip/Bip S: Full weather support
  • Mi Band 5/6: Basic weather
  • Bangle.js: Customizable weather displays
  • Pinetime: Growing weather support

Check Gadget Bridge documentation for your specific device.

Next Steps ​

More Information ​

Released under the MIT License.