Skip to main content

Use cases

🙋‍♂️ Help & FAQ – KairosEye

Your go-to page for setup help, troubleshooting, and general questions about KairosEye.

🔎 Quick Index​

💸 Is it free?​

Yes! The basic version is free, but with some limitations:

  • 📍 IP-based localization only
  • 🌦️ Weather updated every 6 hours
  • 📅 Only 1 calendar
  • 🔁 Calendar updated every 6 hours

👉 See our Support page to unlock premium features.

📊 Free vs Supporter comparison​

FeatureFree 🆓Supporter 💎
Weather resolution3h1h
Calendar update frequencyEvery 6hEvery 2h
Number of calendars1Up to 3
Localization optionsIP onlyAll modes
Sunrise / Moon phase✅✅
Full event overview✅✅
Customization✅✅
Priority support❌✅

📍 How does localization work?​

You can choose among 4 modes:

  • 🌐 IP-based – lowest battery impact but less accurate
  • ⌚ Watch GPS – last known GPS position from your watch
  • ✍️ Manual – you provide the coordinates
  • 📱 Mobile-based – from the phone (Garmin Connect)

⚠️ Free users are limited to IP-based mode.

Why is IP-based location sometimes wrong?​

IP geolocation estimates your position from your public internet address. It is not 100% reliable:

  • ISPs frequently reassign IP ranges or modify their infrastructure
  • Mobile networks often route traffic through centralized gateways far from your actual position
  • VPNs or carrier-grade NAT can completely shift the detected location
  • Errors of several kilometers are common — and in rare cases even the wrong country may be detected

For precise weather and astronomical calculations, manual or GPS-based location is always preferable.

🧭 Set your exact location​

For the best accuracy, you have two options:

Option 1 — Manual coordinates​

Use our tool to get your exact coordinates: 🌍 Get your coordinates

Then enter the latitude/longitude in your KairosEye settings (decimal format, . as separator).

Option 2 — Phone GPS (recommended if you travel)​

You can use your phone's live GPS location via Garmin Connect:

Garmin Connect → More → Settings → User Settings → Weather Location

Then select:

  • "Use Phone Location" — dynamic, follows your GPS position
  • "Use Fixed Location" — static manual position

⚠️ Phone location requires GPS to be enabled on your smartphone.

📅 How to change the first day of the week?​

In the Garmin Connect app:

Settings → User Preferences → Display Preferences

You can choose:

  • Saturday
  • Sunday
  • Monday

📲 Do I need a companion app?​

No additional mobile app is required.
KairosEye runs directly on your Garmin watch and uses Garmin Connect to sync data and settings.

🔋 Battery consumption​

KairosEye is designed to be efficient:

  • 🧠 Minimal memory usage
  • 🔋 Optimized battery consumption
  • ⚙️ Smart update intervals

Premium users can fine-tune refresh rates for better performance.

🌐 Custom webservice integration​

:::note KairosEye v1 only This feature was available in KairosEye v1 and has been removed in v2. The information below is kept for reference only. :::

You can connect KairosEye to your own server to display messages or alerts.

How to use it?​

Enter a valid URL (10+ characters) in the settings.
KairosEye will send a POST request regularly and display the result.

Example response (JSON):​

{
  "ttl": 900,
  "txt": ["💧 Drink", "glass of water"]
}

🆘 Troubleshooting​

🛑 No calendar events appear?​

  • Make sure your Google Calendar is connected in your KairosEye account.
  • Check that the calendar is selected in the Configuration tab.
  • Garmin Connect must be synced after changing settings.

🌦️ Weather doesn’t update?​

  • Make sure your location is correctly set.
  • Avoid using GPS mode indoors or without recent activity.
  • Premium version allows more frequent updates.

⏰ Wrong time or timezone?​

  • Verify your location coordinates.
  • Your watch timezone is usually managed by Garmin Connect.

🔁 My settings are ignored?​

  • Wait up to 10 minutes after saving settings.
  • Restart your watch.
  • Make sure your version is up to date.

Need more help? Contact us via the Support & Contribution page.