3. Standalone CLI

APU TrueGain’s standalone application exposes a small user-facing command-line interface for loading, saving, and resetting standalone preset files. This section documents the supported options only.

Supported options:

  • --help prints the supported standalone CLI options and exits.
  • --resetParams resets parameters after the standalone app loads its remembered state.
  • --loadPreset="<path>" loads a preset file before the window is shown.
  • --savePreset="<path>" writes the resulting preset file and exits without opening the user interface.

Processing order:

  • The standalone app first loads its normal remembered standalone state.
  • If --resetParams is present, a full parameter reset is applied.
  • If --loadPreset is present, that preset file is loaded next.
  • If --savePreset is present, the resulting state is written to disk and the app exits immediately.

Examples:

  • <standalone-app> --help
  • <standalone-app> --savePreset="C:\Temp\truegain-startup.preset"
  • <standalone-app> --resetParams --savePreset="C:\Temp\truegain-reset.preset"
  • <standalone-app> --loadPreset="/tmp/truegain-session.preset"
  • <standalone-app> --loadPreset="/tmp/truegain-session.preset" --savePreset="/tmp/truegain-copy.preset"

Compatibility:

  • --loadPreset and --savePreset use the same file format as the standalone app’s standard JUCE options-button commands, Save current state... and Load a saved state....
  • These file-based presets store the full standalone processor state. They are different from the in-app presets combo-box, which loads the product’s built-in preset entries and user preset-list selections.