BetaShape 3.0 for macOS
=======================

Requirements: a Mac with Apple silicon (M1 or later) running macOS 15 or later.

This folder contains:
  betashape            command-line program
  bin/                 programs called by betashape
  resources/           data files used by the programs
  BetaShapeGUI.app     graphical interface
Keep everything together: BetaShapeGUI.app finds betashape in its own folder.


1. Installation
---------------

Optional: to check that the download is complete and unmodified, put the
.sha256 file published with the archive in the same folder as the archive,
open the Terminal application, go to that folder (for example: cd ~/Downloads)
and run:

    shasum -a 256 -c BetaShape-3.0-macOS-arm64.zip.sha256

The answer must be: BetaShape-3.0-macOS-arm64.zip: OK

Put the BetaShape-3.0 folder in your home folder (for example
/Users/<your name>/BetaShape-3.0). Avoid Desktop, Documents, Downloads and
iCloud Drive: macOS asks for extra permissions there, and iCloud may remove
local copies of files.

These programs are not signed with an Apple Developer ID certificate. macOS
blocks unsigned programs that were downloaded from the Internet, so one more
step is needed, depending on how you downloaded the archive:

a) Downloaded with a web browser (Safari, Chrome, Firefox...) or received by
   e-mail: after unzipping, open the Terminal application and run once:

       xattr -dr com.apple.quarantine ~/BetaShape-3.0

   This removes the "downloaded from the Internet" mark from this folder only.
   No administrator password is needed. Do it again after installing a new
   version.

b) Downloaded from the Terminal, there is nothing more to do:

       cd ~
       curl -L -o BetaShape-3.0-macOS-arm64.zip "<link to the zip file>"
       ditto -x -k BetaShape-3.0-macOS-arm64.zip ~

If you skip this step, macOS says that the application "cannot be opened",
"is damaged" or that Apple "cannot check it for malicious software". Allowing
it in System Settings > Privacy & Security > "Open Anyway" also works, but it
requires an administrator password and has to be repeated for each program:
the command in a) is much simpler.


2. Graphical interface
----------------------

Double-click BetaShapeGUI.app. Menu Help > About BetaShape shows the version;
menu Calculation > Locate BetaShape shows which engine is used.

Do not move BetaShapeGUI.app out of the BetaShape folder. To add it to the
Dock, drag it there. For a shortcut on the Desktop, right-click
BetaShapeGUI.app > Make Alias, then drag the alias (not the application
itself) to the Desktop.


3. Command line
---------------

Add these two lines to the file ~/.zprofile (create it if needed), then open a
new Terminal window:

    export BSINSTALL="$HOME/BetaShape-3.0"
    export PATH="$BSINSTALL:$PATH"

Or use the script update_bsinstall_macos.zsh

Then run, in the folder that contains your input file:

    betashape myfile.ens

See the BetaShape README for the options.
