DARKMAN.CONF(5)

📦 version 2.3.1, in alpine 3.24, arch rolling, nixpkgs unstable

💅 darkman.conf — the vibe check

okay bestie, so this is the manual for the darkman.conf config file (that's section 5 of the manual, iykyk) 🎀 — it's literally the glow-up instructions for darkman(1). Where does the file live tho? Head over to the FILES section of darkman(1), she'll tell you. ✨

🌸 DESCRIPTION 🌸

This page describes the configuration file format for darkman(1). Periodt.

The config file is YAML format, and every single setting is optional — not one of them is required, no pressure bestie 🫶.

Here's what you can put in it:

  • lat, lng — latitude and longitude respectively 💫. This value gets used at start-up, but it's lowkey not the final boss: it gets superseded later by whatever geoclue resolves (if geoclue is enabled). And ngl, more than one decimal point is generally not needed — the reasoning is literally documented at https://xkcd.com/2170/ 😭.
  • usegeoclue (true/false) — whether to use a local geoclue instance to figure out your current location 🗺️. Heads up: on some distributions/setups, this may require setting up a geoclue agent to function properly. And setting this to false without explicitly setting lat and lng disables automatic transitions entirely — like, fully off, no transitions, gone 💀.
  • 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 — so they actually match your whole aesthetic, iconic.
  • socketpath — filesystem path for the query and control socket 🔌. The default value is ${XDG_RUNTIME_DIR}/darkman/control.sock. Copy that exactly, bestie, no typos 💅.

👑 SEE ALSO 👑

darkman(1) — go read her too, she's the main character here fr fr.

🦋 AUTHORS 🦋

Developed by Hugo O. Barrera <hugo@whynothugo.nl>, with invaluable contributions from the community 🌸 — like, the community really showed up and ate, we love to see it 🫶.

💖 A little sign-off from me to you: this page comes from the Debian manual source (version $Mdocdate$), and it's the DARKMAN.CONF(5) page, bestie. Now go configure your darkness slayfully ✨🌙
📦 where this page comes from