.Dd $Mdocdate$
.Dt DARKMAN.CONF 5
.Os
.Sh NAME
.Nm darkman.conf
.Nd darkman configuration file
.Sh DESCRIPTION
This manual describes the configuration file format for
.Xr darkman 1 .
See the
.Sx FILES
section of
.Xr darkman 1
for configuration file locations.
.Pp
The configuration file uses YAML format.
All settings are optional.
.Pp
The following settings are available:
.Bl -tag -width Ds
.It Cm lat , lng
Latitude and longitude respectively.
This value will be used at start-up, but will later be superseded by whatever
geoclue resolves (if enabled).
More than one decimal point is generally not needed, as described in
.Lk https://xkcd.com/2170/ .
.It Cm usegeoclue Pq true/ Ns Sy false
Whether to use a local geoclue instance to determine the current location.
On some distributions/setups, this may require setting up a geoclue agent to
function properly.
Setting this to false without explicitly setting lat and lng disables automatic
transitions entirely.
.It Cm portal Pq Sy true Ns /false
Whether to expose the current mode via the XDG settings portal D-Bus API.
Many desktop applications will read the current mode via the portal and respect
what
.Xr darkman 1
is indicating.
.It Cm socketpath
Filesystem path for the query and control socket.
The default value is
.Pa ${XDG_RUNTIME_DIR}/darkman/control.sock .
.El
.Sh SEE ALSO
.Xr darkman 1
.Sh AUTHORS
Developed by
.An Hugo O. Barrera Aq Mt hugo@whynothugo.nl ,
with invaluable contributions from the community.