id       = "flameshot"
name     = "Flameshot"
homepage = "https://flameshot.org"
description = "Powerful yet simple to use screenshot software"
# The apple-touch-icon from the project's homepage.
icon     = "https://flameshot.org/apple-touch-icon.png"
executables   = ["flameshot"]

[dotfiles]

# src/utils/confighandler.cpp constructs its QSettings as
# QSettings(QSettings::IniFormat, QSettings::UserScope, organizationName(),
# applicationName()), and src/main.cpp sets both names to "flameshot".
# https://doc.qt.io/qt-6/qsettings.html gives what that resolves to for
# UserScope + IniFormat: "$HOME/.config/MySoft/Star Runner.ini" on Unix, macOS
# and iOS — "The default UserScope paths on Unix, macOS, and iOS ($HOME/.config
# or $HOME/Settings) can be overridden by the user by setting the
# XDG_CONFIG_HOME environment variable" — and
# "FOLDERID_RoamingAppData\MySoft\Star Runner.ini" on Windows. That is the XDG
# config home on every platform including macOS, so [configHome].
# (The USE_PORTABLE_CONFIG build instead keeps flameshot.ini beside the
# executable, which is not a home-directory location at all.)
paths = ["[configHome]/flameshot/flameshot.ini"]

exclude = []

# Drawing tools, colours and shortcuts. Flameshot has no credentials of its
# own; the Imgur upload it can do is anonymous unless the user authorizes it,
# and that token is not written into this file.
secret = []

# `savePath` (src/utils/confighandler.h: CONFIG_GETTER_SETTER(savePath,
# setSavePath, QString)) is the absolute directory screenshots are written to —
# /Users/<name>/Desktop, /home/<name>/Pictures, C:\Users\<name>\Pictures — so
# it is one machine's path spelled as a preference. The colour, the button
# list, the drawing thickness and the keyboard shortcuts beside it are exactly
# what a user wants carried over, and are deliberately not marked. The save
# directory is the user's own pick and is worth seeing again when this machine
# is rebuilt, so it is kept: backup.
[[dotfiles.machine_lines]]
file  = "[configHome]/flameshot/flameshot.ini"
match = { prefix = ["savePath="] }
scope = "backup"