BurnSim for macOS (alpha)
=========================

This is an early, unsigned alpha build. It ships in two versions - the
folder you unzipped says which one you have:

  * ...-macos-arm64  Apple Silicon Macs (M1 or later, 2020 onward)
  * ...-macos-x64    Intel Macs

If you are on Apple Silicon, prefer the arm64 package - it runs
natively. The Intel package will also run there via Rosetta 2, but
there is no reason to choose it.

The download is a real BurnSim.app bundle - drag it to Applications
(or run it in place) and double-click like any other Mac app.

Because the app is not signed with an Apple Developer ID, macOS will
refuse to launch it as downloaded. Clearing that is a one-time step,
and there are two ways to do it - pick either.

Option A - no Terminal:
  1. Unzip the download and double-click BurnSim.app. macOS will
     refuse to open it. That first refused launch is required.
  2. Open System Settings > Privacy & Security, scroll to the
     Security section, and click "Open Anyway" next to BurnSim.
  3. Double-click BurnSim.app again and confirm. It will launch
     normally from then on.

  On macOS 15 (Sequoia) and later the old right-click > Open trick no
  longer works for unsigned apps - "Open Anyway" is the replacement.

Option B - one Terminal command:
  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:

         xattr -cr BurnSim.app

     This clears the quarantine flag your browser put on the
     download. Without it, Gatekeeper blocks the app.
  3. Double-click BurnSim.app (or move it to /Applications first,
     then launch it from there or the Dock).

If you get a bare "the application cannot be opened" with no mention
of an unidentified developer, the app's executable permission did not
survive unzipping - some third-party unzip tools drop it. Restore it
with:

    chmod +x BurnSim.app/Contents/MacOS/BurnSim

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.
