id       = "kdenlive"
name     = "Kdenlive"
homepage = "https://kdenlive.org"
description = "Kdenlive is the acronym for KDE Non-Linear Video Editor. It works on Linux, Windows, macOS, and BSD."
icon     = "SimpleIcons:kdenlive"
# On Linux and Windows the executable is the name a user types — the docs' own
# install instructions say to "navigate to the bin folder and double-click
# kdenlive.exe"
# (https://docs.kdenlive.org/en/getting_started/installation.html). On macOS it
# is a bundle with no command line tool, so the bundle identifier is what a
# consumer sees there: org.kde.Kdenlive, from the Homebrew cask's zap list
# (~/Library/Preferences/org.kde.Kdenlive.plist,
# https://formulae.brew.sh/api/cask/kdenlive.json).
executables = ["kdenlive"]

[installation]
macos_bundle_ids = ["org.kde.Kdenlive"]

[dotfiles]

# kdenliverc is the settings file, and it lands in a different place on each
# platform because it is a KConfig file:
#
#   Linux   ~/.config/kdenliverc — the docs say so while explaining how to
#           reset a broken install: "delete Kdenlive's config file
#           ($HOME/.config/kdenliverc) and restart Kdenlive"
#           (https://docs.kdenlive.org/en/troubleshooting/installation_troubleshooting.html)
#   Windows %LOCALAPPDATA%\kdenliverc — listed among the folders a domain user
#           needs write access to, in "Kdenlive in a Windows Domain"
#           (https://docs.kdenlive.org/en/getting_started/installation.html)
#   macOS   ~/Library/Preferences/kdenliverc — the Homebrew cask's zap list
#
# Three genuinely different locations rather than one under three names: the
# Linux one is spelled out as $HOME/.config in the documentation, and Windows
# uses the *local* app data directory, not %APPDATA%. So each is written out
# and a consumer skips the two that do not exist.
paths = [
  "~/.config/kdenliverc",
  "[preferences]/kdenliverc",
  "%LOCALAPPDATA%/kdenliverc",
]

# Not listed, from the same two sources: kdenlive-layoutsrc is the saved window
# layouts, which are display geometry rather than settings; kxmlgui5/
# kdenlivekdenliveui.rc is the toolbar state Qt writes; and the kdenlive data
# directory (~/Library/Application Support/kdenlive, %AppData%\kdenlive) holds
# downloaded render profiles, title templates and the .backup folder. None of
# them is under a path above, so there is nothing to carve out of what syncs.
exclude = []

# A video editor with no account: kdenliverc is render presets, proxy settings,
# interface options and the paths below.
secret = []

# No machine_lines. kdenliverc does carry absolute paths — the MLT and FFmpeg
# binaries Kdenlive found at first start, and the default project folder — but
# their key names and group headings are not documented anywhere the catalog
# can cite, and a rule guessed from memory would silently match nothing. A
# consumer that syncs this file should expect the first launch on a new machine
# to re-detect its own MLT.