id       = "gimp"
name     = "GIMP"
homepage = "https://www.gimp.org"
description = "GIMP is a cross-platform image editor available for GNU/Linux, macOS, Windows and more operating systems."
icon     = "SimpleIcons:gimp"
executables   = ["gimp"]

[dotfiles]

# libgimpbase/gimpenv.c, gimp_directory(): "we use the GIMPDIR subdirectory of
# the local configuration directory: - UNIX: $XDG_CONFIG_HOME (defaults to
# $HOME/.config/) - Windows: CSIDL_APPDATA - OSX (UNIX exception): the
# Application Support Directory." That triple — XDG on Linux, Application
# Support on macOS, %APPDATA% on Windows — is [appData].
#
# The GIMPDIR part carries the release: docs.gimp.org/2.10/en/gimp-concepts-
# setup.html names $XDG_CONFIG_HOME/GIMP/2.10, ~/Library/Application
# Support/GIMP/2.10 and %APPDATA%/GIMP/2.10, and says "all of the configuration
# information is stored in this directory". GIMP 3 keeps the same shape under
# GIMP/3.0, hence the glob over the version segment.
paths = ["[appData]/GIMP/*/"]

# pluginrc is a generated index, not settings: app/plug-in/
# gimppluginmanager-restore.c writes it with gimp_directory_file("pluginrc")
# and reads it back to "read the pluginrc file for cached data" — a cache of
# every plug-in's procedures keyed by the absolute path of the plug-in binary
# on this machine, which a second machine regenerates on first launch anyway.
#
# GIMP's other heavy state is already outside this tree: since 2.10.10
# gimp_cache_directory() puts caches under g_get_user_cache_dir()/GIMP/<version>
# (libgimpbase/gimpenv.c), and the swap file follows it, so the tile swap the
# same file warns "can easily get very large" is not in what syncs.
exclude = [
  "[appData]/GIMP/*/pluginrc",
]

# Nothing GIMP writes here is a credential; the directory is preferences,
# brushes, palettes, scripts and plug-ins.
secret = []

# No machine_lines. GIMP's rc files are s-expressions rather than a
# line-oriented `key value` format, so a prefix rule would be matching source
# lines rather than settings, and the machine-local values in them — the
# gimprc paths that were edited away from their ${gimp_dir} defaults, and
# sessionrc's window geometry — are a minority of a file whose point is the
# tool options, shortcuts and colour management the user set up.