id       = "sway"
name     = "sway"
homepage = "https://swaywm.org"
description = "sway is an i3-compatible Wayland compositor."
icon     = "SimpleIcons:sway"
executables   = ["sway", "swaymsg"]
platforms = ["linux"]

[dotfiles]

# sway(1), CONFIGURATION: "sway searches for a config file in the following
# locations, in this order:
#
#   1. ~/.sway/config
#   2. $XDG_CONFIG_HOME/sway/config (suggested location)
#   3. ~/.i3/config
#   4. $XDG_CONFIG_HOME/i3/config
#   5. /etc/sway/config
#   6. /etc/i3/config"
#
# with "$XDG_CONFIG_HOME defaults to ~/.config if unset". Entries 3 and 4 are
# i3's own files — sway reads them as a fallback, but they belong to the user's
# i3 installation and are already listed in apps/i3.toml, so repeating them
# here would claim the same file for two tools. Entries 5 and 6 are the system
# copies. That leaves sway's own two user locations.
#
# The XDG one is [configHome] because the man page names the variable;
# ~/.sway/config is a literal path sway hard-codes under the home directory.
paths = ["~/.sway/config", "[configHome]/sway/config"]

# sway(5) has an `include` directive for further files, but the user names
# those paths, so there is no fixed second location to carve out or list.
exclude = []

# A sway config is bindings, output and input configuration, bar blocks and
# the programs launched at startup. Nothing in it is a credential.
secret = []

# No machine_lines. `output <name> …` does pin a resolution to a monitor
# attached to this machine, but `output` is also the first word of
# `output * bg …`, a wallpaper setting the user wants everywhere, and a prefix
# cannot tell the two apart. Bindings, fonts, colours and gaps are exactly what
# should follow the user.