Back to Noctalia

Location

v5-services-location.md

latest1.5 KB
Original Source

Location

[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.