DARKMAN.CONF(5)               File Formats Manual              DARKMAN.CONF(5)

NAME
     darkman.conf - darkman configuration file

DESCRIPTION
     This manual describes the configuration file format for darkman(1).  See
     the FILES section of darkman(1) for configuration file locations.

     The configuration file uses YAML format.  All settings are optional.

     The following settings are available:

     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 https://xkcd.com/2170/.

     usegeoclue (true/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.

     portal (true/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 darkman(1) is indicating.

     socketpath
             Filesystem path for the query and control socket.  The default
             value is ${XDG_RUNTIME_DIR}/darkman/control.sock.

SEE ALSO
     darkman(1)

AUTHORS
     Developed by Hugo O. Barrera <hugo@whynothugo.nl>, with invaluable
     contributions from the community.

Linux 6.18.13-arch1-1            March 5, 2026           Linux 6.18.13-arch1-1