automatic-timezoned-1.0.8 is not a library.
Automatic Timezone Daemon
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) - The user must have a running GeoClue agent or the GeoClue configuration must allow the absence of agent with an empty agent
whitelist
(see also Stebalien/localtime - Configuring GeoClue, geoclue/geoclue#74)
Please see the examples/ directory for sample configurations.
Sample Nix modules can be found here (may be submitted to NixOS/nixpkgs if there is interest):
- maxbrunet/naxos//modules/pkgs/automatic-timezoned.nix
- maxbrunet/naxos//modules/services/automatic-timezoned.nix
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