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.