---
name: "darkman.conf"
section: "5"
platform: "linux"
package: "darkman"
version: "2.3.1-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/darkman.conf"
---

# darkman.conf(5)

darkman configuration file

## NAME

**darkman.conf** – darkman configuration file

## DESCRIPTION

This manual describes the configuration file format for [darkman(1)](/darkman/1.md). See the FILES section of [darkman(1)](/darkman/1.md) 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)](/darkman/1.md) 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)](/darkman/1.md)

## AUTHORS

Developed by Hugo O. Barrera ⟨*hugo@whynothugo.nl*⟩, with invaluable contributions from the community.