id       = "openemu"
name     = "OpenEmu"
homepage = "https://openemu.org"
description = "Console and Arcade video game emulator for macOS."
# OpenEmu's own sentence, the meta description on https://openemu.org.

# The app icon, from the largest apple-touch-icon openemu.org publishes.
icon     = "https://openemu.org/img/favicons/favicon-152.png"

# OpenEmu has no command line, so `detect` carries the bundle identifier.
# Verified on a Mac with OpenEmu installed:
#   osascript -e 'id of app "OpenEmu"'  →  org.openemu.OpenEmu
# The Homebrew cask zaps the same identifier's preferences file
# (https://formulae.brew.sh/api/cask/openemu.json).
executables = []
platforms = ["macos"]

[installation]
macos_bundle_ids = ["org.openemu.OpenEmu"]

[dotfiles]

# OpenEmu is a direct download rather than a Mac App Store title, so it is not
# sandboxed and its defaults land in the ordinary preferences domain. The
# cask's zap stanza names both locations under the user's home:
# ~/Library/Preferences/org.openemu.OpenEmu.plist (alongside one file per core
# plugin) and ~/Library/Application Support/OpenEmu.
#
# Read back on this machine, the preferences domain holds the settings a user
# sets: the per-system video shader (videoShader.openemu.system.gba), the
# volume, the library column layout and the OEIntegralScale entries that fix
# each console's window scale. ~/Library/Application Support/OpenEmu/Bindings
# holds Default.oebindings, the controller and keyboard maps for every system —
# the other half of an OpenEmu setup, and the half that takes longest to
# redo.
#
# [preferences] is ~/Library/Preferences and [appData] is
# ~/Library/Application Support; the entry is macOS-only, so there is no other
# platform for either root to stand for.
paths = [
  "[preferences]/org.openemu.OpenEmu.plist",
  "[appData]/OpenEmu/Bindings/",
]

# The rest of ~/Library/Application Support/OpenEmu is deliberately outside
# `paths` rather than carved out of it: "Game Library" is the Core Data
# database of the user's ROMs plus their artwork, "roms" and "Save States" are
# the games and their saves, "Cores" holds the downloaded emulator plugins, and
# openvgdb.sqlite is a 40 MB metadata database OpenEmu fetches for itself.

secret = []

# No machine_lines. Both files are property lists — Default.oebindings is a
# binary plist — and `format` here covers toml, yaml and json only, so the
# window frames and the last-opened-collection keys that genuinely belong to
# one Mac cannot be carved out.