.env.example

# Copy to .env (gitignored). All are optional — each has a working default.
# macOS only: the tools read and write Logic Pro's own files, the Swift helpers under
# src/logicxkit/native/ run through the `swift` toolchain, and `logic ocr` uses Apple Vision.

# X32 scene file for the tests/rig preflight golden. Absent -> those tests skip.
LOGICXKIT_SCENE="$HOME/Music/Behringer/x32/Scenes/example.scn"

# Names the goldens build their paths from: the two channel-strip library folders and the
# prefix on the .logicx templates. The files themselves are not in this repo, so a golden
# whose file is missing skips. The values below are placeholders — use your own.
LOGICXKIT_STRIP_LIB="Example Mixing"
LOGICXKIT_TRACK_LIB="Example Tracking"
LOGICXKIT_PROJECT_PREFIX="Example"

# Logic's own user folder, the base for both settings libraries.
# Absent -> ~/Music/Audio Music Apps.
LOGICXKIT_AUDIO_MUSIC_APPS=

# Root for a spec's relative strip paths, and where `logic diff --library` looks.
# Absent -> Logic's own ~/Music/Audio Music Apps/Channel Strip Settings, which is what you
# want for real use; the tests fall back to a staged snapshot under resources/ instead of the
# live library (see resources/README.md — those files are not in the repo). Leave it unset
# unless you keep your strips somewhere else.
LOGICXKIT_STRIP_ROOT=
# Read Logic's settings from a copy instead of ~/Library/Preferences. Absent -> Logic's own.
LOGICXKIT_LOGIC_PREFS=
# Logic.app itself, for the factory .pst defaults. Absent -> /Applications/Logic Pro.app.
LOGICXKIT_LOGIC_APP=

# Root of a rig config tree kept outside this repo: the tests/rig preflight golden reads
# <root>/x32/preflight.json. Absent -> ~/.config/logicxkit/rig; missing -> those tests skip.
LOGICXKIT_RIG_CONFIG="$HOME/.config/logicxkit/rig"
# Logic-written record templates, donor slots and AU tables. Written by Logic and by plugin
# vendors, so they are not in the repo — see resources/data/README.md for how to make them.
LOGICXKIT_DATA=resources/data
# --- test-only ---
# The owner's corpus the goldens read (the public one is tracked under tests/corpus). Absent ->
# resources/ beside this file; its files are not in the repo (see resources/README.md), so those
# goldens skip when it is empty.
LOGICXKIT_RESOURCES=
# Project templates within that corpus. Absent -> <resources>/templates.
LOGICXKIT_TEMPLATES=
# Set to 1 to turn a golden whose file is missing into a failure instead of a skip, or to
# `public` to fail only on keys the public corpus (tests/corpus) supplies. Every
# run prints `goldens: N of M keys found`; this is how you stop N from quietly being 0.
LOGICXKIT_REQUIRE_GOLDENS=
# Where a key both corpora have resolves: `public` (default) or `owner`.
LOGICXKIT_GOLDENS=
# --- logging (pf-core, at the CLI boundary) ---
# The console stays clean whatever these say. LOG_FILE names a JSON-lines file that records
# every run (absent -> no file); LOG_LEVEL is the threshold, DEBUG..ERROR (absent -> INFO).
LOG_FILE=
LOG_LEVEL=