id       = "conky"
name     = "Conky"
homepage = "https://conky.cc"
description = "A free, light-weight system monitor for X, that displays any kind of information on your desktop."
# The project's own square logomark; conky.cc links a favicon.svg it does
# not actually serve, and the SVG beside this PNG is too large to cache.
icon     = "https://raw.githubusercontent.com/brndnmtthws/conky/main/data/logo/conky-logomark-violet.png"
executables   = ["conky"]
# The README: "Runs on Linux, FreeBSD, OpenBSD, DragonFlyBSD, NetBSD, Solaris,
# Haiku, and macOS!" — never Windows.
platforms = ["linux", "macos"]

[dotfiles]

# src/conky.cc, set_current_config(): it stats to_real_path(XDG_CONFIG_FILE),
# then to_real_path(CONFIG_FILE), then SYSTEM_CONFIG_FILE, and takes the first
# that exists. cmake/ConkyBuildOptions.cmake defines the first two:
#
#   set(XDG_CONFIG_FILE "$HOME/.config/conky/conky.conf" ...)
#   set(CONFIG_FILE "$HOME/.conkyrc" ...)
#
# conky(1) says the same: "The default configuration file location is
# ~/.config/conky/conky.conf or ${sysconfdir}/conky/conky.conf."
#
# Note the literal spelling: the build joins $HOME with ".config/conky", it does
# not read $XDG_CONFIG_HOME, so [configHome] would name a directory conky never
# opens on a machine that has moved its XDG directories. The third candidate is
# /etc/conky/conky.conf, which is system-wide and not listed here.
paths = [
  "~/.config/conky/conky.conf",
  "~/.conkyrc",
]

exclude = []

# A conky config is a Lua table of display settings plus the text to render. It
# holds no credential of conky's own — the IMAP and POP3 objects take their
# login as arguments inside that text, which is why a consumer scanning content
# still has something to find, but there is no credential *file*.
secret = []

# No machine_lines. A conky config is almost entirely appearance — alignment,
# gap, font, colours, update interval — which is what a user wants carried. The
# one machine-shaped thing is the network interface named inside ${downspeed …}
# and friends, and those are arguments in the middle of the TEXT block rather
# than lines of their own, so no prefix reaches them.