id       = "caffeine"
name     = "Caffeine"
homepage = "https://www.intelliscapesolutions.com/apps/caffeine"
description = "A tiny program that keeps your Mac awake, so long running tasks aren't interrupted by the computer going to sleep."
# Caffeine ships no command-line tool, so what a consumer sees when the user
# runs it is the bundle identifier. Both are listed because both are Caffeine:
# the project's own README explains that "Tomas Franzén of Lighthead Software
# originally developed Caffeine in 2006" and that in 2018 he "graciously
# provided the source code under an open source license", which is where
# IntelliScape's build comes from.
executables = []
platforms = ["macos"]

[installation]
macos_bundle_ids = ["com.intelliscapesolutions.caffeine", "com.lightheadsw.caffeine"]

[dotfiles]

# The current build's preferences domain is com.intelliscapesolutions.caffeine:
# the Homebrew cask's `uninstall quit:` names that bundle identifier and its
# `zap trash:` list names ~/Library/Preferences/com.intelliscapesolutions.caffeine.plist
# (Casks/c/caffeine.rb). The Lighthead build wrote
# ~/Library/Preferences/com.lightheadsw.caffeine.plist, which is still on this
# machine from an older install and is what a long-time user's home directory
# holds; a consumer skips whichever is absent.
#
# The README says what is in there: "Options you can configure include whether
# to start Caffeine automatically every time you start up your Mac, whether
# Caffeine should activate every time it starts, and a default duration if you
# always want Caffeine to turn itself off after a set time."
paths = [
  "[preferences]/com.intelliscapesolutions.caffeine.plist",
  "[preferences]/com.lightheadsw.caffeine.plist",
]

# The cask's zap list also names ~/Library/Caches/com.intelliscapesolutions.caffeine
# and an HTTPStorages cookie jar. Neither is under a path above, so there is
# nothing to carve out of what is.
exclude = []

# Caffeine talks to no service and is free; there is no credential file.
secret = []

# No machine_lines: start-at-login, activate-on-launch and the default duration
# are exactly the preferences a user wants on their second Mac too.