automatic-timezoned-1.0.0 is not a library.
automatic-timezoned
A Linux daemon to automatically update the system timezone based on location.
How It Works
- The list of timezones and their location is loaded from the
zone1970.tab
file - The current location is retrieved from Geoclue
- The distance between the current location and each timezone is calculated with the Haversine formula
- The shortest distance determines the current timezone set via
systemd-timedated
- Then, the daemon waits for the location updated signal from Geoclue, and repeats from step 2 when it happens
Note: The timezone choice may not be accurate if a reference city in a neighboring timezone is closer than any one in the actual timezone.
Requirements
- Geoclue
- IANA Time Zone Database a.k.a.
tzdata
a.k.a.zoneinfo
- systemd
- The user must be allowed to use the
org.freedesktop.timedate1.set-timezone
action (root
or Polkit rule)
Please see the examples/ directory for sample configurations.
Configuration
Please see:
automatic-timezoned --help
Development
Build
cargo build --release
Test
cargo test
Alternatives
This service depends on the tzdata
package which allows to update the Time Zone Database independently and does not depend on a third-party service to calculate distances,
here are some alternatives which have made different trade-offs for performance and accuracy:
- github.com/Stebalien/localtime: Depends on the unmaintained github.com/bradfitz/latlong Go library.
- Gnome Automatic Time Zone (Source Code): Depends on the
tzdata
package and Nominatim Web API for distances.
License
GNU General Public License v3.0