The card shows a place name, the local time, an optional date, and the temperature with an icon and a short description. You can add feels-like, humidity, wind and pressure under the temperature. The place name is coarse. By default it shows your state and country, not your city.
Where the location comes from
In the builder, under Where does the location come from?, choose one:
- This device (browser location): your device’s location. This is the default if you choose nothing. The Use this device’s location now button tries it. Browsers inside OBS and some other apps block it.
- A city I type: type a City or ZIP. Add a state or region for a common name, and a two-letter Country code to narrow it down.
- Fixed latitude / longitude: exact coordinates.
- RTIRL pull key (off-device / cloud OBS): for cloud OBS or BELABOX setups that cannot read your phone’s GPS. This is marked experimental. Treat the key like a password.
If you choose a city, coordinates or key and leave it blank, the builder warns you and does not make a link.
How much of your location shows
Show my location as only changes the place name on screen. Weather and time always use the exact spot. The choices are State + country (safest) (starting choice), Country only, State / region only, County, City and Hide location entirely. County and City warn you that they can put your city on stream.
Display options
- Units
- Metric, imperial or both. Both shows “°F / °C”. Wind and pressure use km/h and hPa for metric and mph and inHg otherwise.
- Clock
- 12 or 24 hour. 24 is the start.
- Date format
- A list with examples. The start is a weekday and date, like “Monday, July 14”.
- Show
- Tick Location, Local time, Local date and Weather. Date is off to start. If you switch everything off the card disappears.
- Weather details
- Feels like, Humidity, Wind and Pressure, with a rising, falling or steady arrow for pressure.
- Detail layout
- One line or Each on its own line (taller).
- Refresh (seconds)
- How often weather and place update. The minimum is 60 and the start is 300. The clock ticks every second regardless.
- Language
- English, Spanish, French, German, Portuguese, Italian or Japanese.
Style
Text alignment, Position, Base text size (px) (34), Text color, Card background, Temperature color and Corner radius (px) (14).
Messages
If the weather or location cannot be loaded, it shows Weather unavailable — allow location access, or set a location. This can take up to about half a minute, or appear straight away if location is blocked. It keeps the last good data and tries again on the next refresh. In the builder preview, once it is live, that message means either allow location or choose a city or coordinates.
Where the data comes from
Weather, time zone and city search come from Open-Meteo. Place names come from OpenStreetMap Nominatim. Neither needs a key. Weather data is by Open-Meteo (CC BY 4.0) and place names are © OpenStreetMap contributors. The RTIRL service is contacted only if you give a key.
Advanced: change it in the link
Everything the builder does is a setting in the link after the #. Only settings you change are written.
| Setting | Values | Starts as |
|---|---|---|
lat, lon | decimal degrees | none |
city, country | text, two-letter code | none |
rtirl | your pull key | none |
place | city, county, state, country, state-country, hide | state-country |
units | metric, imperial, both | both |
details | any of feelslike, humidity, wind, pressure, or all | none |
detaillayout | inline, stacked | inline |
clock | 12, 24 | 24 |
show | any of place, time, date, weather, or none | place,time,weather |
datefmt | weekday, weekday-short, date, date-short, weekday-date, full, numeric | weekday-date |
refresh | 60 to 86400 seconds | 300 |
lang | en, es, fr, de, pt, it, ja | en |
fg, bg, accent | colours | white, a dark see-through card, same as text |
size, radius, pad | pixels | 34, 14, 16 |
align | left, center, right | left |
pos | top-left, top-center, top-right, mid-left, mid-center, mid-right, bottom-left, bottom-center and bottom-right | top-left |