BurnSim for macOS (alpha, Apple Silicon)
=========================================

This is an early, unsigned alpha build for Apple Silicon Macs (M1 or
later, i.e. Macs from 2020 onward). Intel Macs are not supported by
this package.

Because the app is not signed with an Apple Developer ID, macOS will
refuse to launch it as downloaded. Three one-time Terminal steps fix
that:

1. Unzip the download, then open Terminal in the unzipped folder
   (in Finder: right-click the folder > Services > New Terminal at
   Folder, or just `cd` to it).

2. Run:

       chmod +x BurnSim && xattr -cr .

   - `chmod +x` restores the executable permission (the zip is built
     on Windows, which cannot store Unix permissions).
   - `xattr -cr .` clears the quarantine flag your browser put on the
     download. Without this, Gatekeeper blocks the app ("cannot be
     opened because the developer cannot be verified"). On macOS 15
     (Sequoia) and later, the old right-click > Open trick no longer
     works for unsigned apps - if you prefer not to use `xattr`, the
     alternative is to attempt a launch, then go to System Settings >
     Privacy & Security and click "Open Anyway".

3. Launch it from Terminal:

       ./BurnSim

   There is no .app bundle yet, so no double-click launch or Dock
   icon - run it from Terminal for now.

Where your files live
---------------------
Settings, activity logs, the propellant database, and license data are
stored under:

    ~/Library/Application Support/BurnSim/

Reporting problems
------------------
Activity logging is on by default (Settings > Log Activity for Bug
Reports). If something goes wrong, please send the newest file from

    ~/Library/Application Support/BurnSim/logs/

along with what you were doing, to burnsim@burnsim.com.
