v5-services-location.md
[location] is the single source of “where am I” for the whole shell. It resolves your coordinates and feeds Weather, Night Light, and Theme auto. Configure under Settings → Location.
[location]auto_locate = false # resolve coordinates from your IP address when trueaddress = "Toronto, ON" # geocoded when auto_locate = false and non-empty
# Manual schedule fallback (used only when neither auto_locate nor address is set):sunset = "20:30" # HH:MM - night startssunrise = "07:30" # HH:MM - day starts# latitude = 52.5200 # used instead of sunset/sunrise when set# longitude = 13.4050
Resolution priority: auto_locate (IP) → address (geocoded) → manual latitude/longitude → fixed sunset/sunrise. Whenever coordinates resolve (from IP, address, or manual lat/long), sunrise and sunset are computed astronomically for your position; the fixed sunset/sunrise times are used only when no coordinates are available. If only one of latitude/longitude is provided, the manual coordinates are ignored.
When auto_locate = true, location lookup goes through noctalia.dev to resolve approximate coordinates from your IP address. See the Noctalia privacy policy for how this service is handled.
Location resolution runs independently of Weather - auto_locate and address work even when Weather is disabled, so Night Light and Theme auto get real coordinates on their own.