Troubleshooting & Support

Common situations, reporting bugs, and getting help.

J1. Common situations

The location autocomplete doesn't return anything. The country / city lists are built into the app and work offline, so this is rare. Make sure you've picked a country first (the city list is filtered to the selected country). You can also long‑press the map at the right place to set your location directly (the manual callout lets you type a country / city name by hand).

The cloud cover layer didn't refresh today. Daily cloud download requires (1) Premium, (2) Live (not time-lapse), (3) the Download Daily Cloud Formations toggle on, and (4) a working internet connection. If any of those is missing, the app falls back to the previously cached image, or to the bundled demo if there's no cache. Switch to Live, confirm the toggle, and try again — and note the app deliberately re‑checks at most once every three hours, so "no change for a couple of hours" is normal.

The animation is choppy / the frame rate is low. First, check the bottom-left corner: if a small orange FPS box has appeared, Sunline has already noticed and is throttling itself to stay within what your device can do — it recovers on its own when the load drops, and you can long-press the box for a breakdown (E4). Three practical levers if you want to lighten the load: pick a slower time-lapse speed (the fastest speeds ask for the highest frame rates), turn Show Seconds off in the clock settings (this removes a per‑second redraw), and on mobile, turn off Show Political Timezones if it's on (these are drawn on the CPU and can be expensive).

A premium feature won't enable. A small Premium badge flashes next to the toggle and the setting stays off — that's deliberate, not a glitch. Go to Settings → Advanced and tap Upgrade to Premium, or Restore Purchases if you've previously bought it.

The map looks letterboxed on desktop. Your window aspect doesn't match the flat map's 2:1 aspect. Tap the map, then press the Snap window to correct map aspect icon in the top‑right controls; the window resizes to fit exactly. (Or switch to the globe view, which fills any aspect.)

Onboarding failed and I'm stuck on "Preparing your experience…". Press Retry (if shown) to try again, or Preview (low‑res) to start using the app immediately with whatever low‑resolution data is available; the missing assets will fetch in the background later.

J2. Reporting a bug

Email bugs+sunline@lotabytes.com. The most useful things to include are:

  • What you were doing when it happened (one sentence is fine).
  • What you expected to see, and what you saw instead.
  • Your device and OS (e.g. "iPhone 13, iOS 17.4", "Linux Ubuntu 24.10", "Pixel 8, Android 15").
  • The app version — shown on the About Sunline row at the bottom of Settings → Advanced (e.g. "1.0.0 (build 5, a1b2c3d4)" — the letters and digits at the end identify the exact build). Tapping the row also shows data & imagery credits and the open‑source licences.
  • A screenshot if it's a visual issue.

The app sends anonymous crash reports automatically via Sentry, so you don't need to manually report crashes — but a short description of what triggered the crash is always helpful.

J3. Asking for help

Email support+sunline@lotabytes.com for everything else — questions, feature requests, billing problems, anything you'd like a human to look at.


← Platform notes   Next: Data & Privacy →