id       = "copyq"
name     = "CopyQ"
homepage = "https://hluk.github.io/CopyQ/"
description = "Clipboard manager with advanced features."
# The app's own icon, from its repository.
icon     = "https://raw.githubusercontent.com/hluk/CopyQ/master/src/images/icon.svg"
executables   = ["copyq"]

[dotfiles]

# https://copyq.readthedocs.io/en/latest/faq.html, "Where is the configuration
# stored?": "Linux directory ~/.config/copyq" and "Windows folder %APPDATA%\copyq
# for installed version of CopyQ".
# Those are QSettings' own locations. src/app/app.cpp, setSessionName(): both
# the organization name and the application name are "copyq" (a named session
# becomes "copyq-<name>"). src/platform/win/winplatform.cpp forces
# QSettings::setDefaultFormat(QSettings::IniFormat) with the comment "Don't use
# Windows registry", which is why the Windows copy is a folder under %APPDATA%
# instead of registry keys. The Linux directory is the XDG one and follows
# $XDG_CONFIG_HOME, hence [configHome]; %APPDATA% needs a line of its own
# because the XDG roots keep their dotted spelling on Windows.
# No such call runs on macOS, so QSettings stays on the platform's native format
# there and writes ~/Library/Preferences/com.copyq.copyq.plist — the same file
# the Homebrew cask `copyq` removes when it zaps the app.
paths = [
  "[configHome]/copyq/",
  "%APPDATA%/copyq/",
  "[preferences]/com.copyq.copyq.plist",
]

# The clipboard itself never comes along, and it does not have to be carved out:
# the same FAQ page says that from 17.0.0 on "Tab data files and item data are
# in the data directory, and UI state files and logs are in the state
# directory", and src/app/app.cpp puts those under
# QStandardPaths::AppLocalDataLocation and $XDG_STATE_HOME — both outside the
# configuration directory listed above.

# Commands, shortcuts and appearance. Nothing here is a credential.
secret = []