Documentation
From JSON API to home screen.
Everything you need to create trackers for any JSON API, write result formats, and pin live widgets to your home screen.
On this page
Widget
The widget on your home screen
The widget is the part of Zync you actually look at: a tracker's latest result, drawn on your home screen and refreshed on the interval you chose for that tracker.
Pinning & sizing
from the app or the launcher
Open a tracker and tap Add to Home Screen, or long-press an empty spot on the launcher, open Widgets, find Zync and drop it where you want it.
A widget starts at a two-by-two cell and shrinks to about one cell in either direction. Resizing only redraws the result that is already cached — it does not spend a request — and how many rows fit depends on the height you give it.
Refresh & cache
your interval, the last good result
Each tracker carries its own refresh interval, and the widget wakes on exactly that schedule. When the screen is off or the device is offline, Zync skips the request rather than letting it fail, so the widget keeps showing the last result it fetched instead of going blank.
Tapping
refresh, or pick another tracker
Tap the body of the widget to fetch again immediately; repeated taps are throttled so a nervous finger cannot hammer the source. Tap the widget's title to reopen the tracker picker and point that slot at a different tracker.
Errors
a marker, never a silent stale value
When a fetch fails, the widget shows a small error marker and keeps the last text it had. Open the tracker and press TEST to see the raw response and check the result format against it — most failures are a changed response or a source that stopped answering.