AMPR-Auto-Pak-Guide (MacOS Silicon)

An unofficial macOS Auto Guide by Shambhala222, based on Drakmor's AMPR emulator and PAK tools. This is an independent community edition, not an official Drakmor release.

The app provides the recording/existing-TOML workflow, projects, Continue and Step Back, PAK assembly, and recovery. Recover retains the selected TOML at its current path, including the working folder chosen in the guide, and keeps its latest edits. It cannot recover a TOML already deleted by an older build.

Download and run

Download AMPR-Auto-Pak-Guide-1.0.0-macos-arm64.zip from Releases. After extraction:

AMPR-Auto-Pak-Guide-1.0.0-macos-arm64/
  ampr-auto-pak-guide-macos-arm64/
    AMPR Auto Pak Guide.app
    README.md
    LICENSES/
    ...
  emus/

Open AMPR Auto Pak Guide.app inside that inner tool folder (not the outer ZIP folder that only contains emus and another folder). This build is for Apple Silicon. Python, Tcl/Tk and LZ4 are bundled. It is locally ad-hoc signed, not Apple-notarized.

First launch (macOS Gatekeeper). After a GitHub download, macOS may block the app to protect your Mac. That is Gatekeeper, not a broken or infected download. Unlock it once:

1. Open System Settings → Privacy & Security.
2. Scroll down to the Security section.
3. macOS shows that the app was blocked to protect your Mac. Click Open Anyway next to that message.
4. A second dialog appears (Move to Bin / Open Anyway / Done). Click Open Anyway.
5. Confirm with Touch ID or your password. The app then opens.

After that you can always open the app with a normal double-click. macOS will not show these warnings again.

Finish operations in an older version before switching; do not open the same project in two versions simultaneously. Keep your original backup.

Use Help → About & Credits, License, and Third-party notices for attribution and licensing. The English/German PDF guides use the previous “AMPR PAK Tools” name; the workflow remains the same. This README supersedes any older instruction saying Recovery removes the active TOML.

Build from source

This release used macOS/arm64, Python 3.12.3 with Tcl/Tk 8.6.13, PyInstaller 6.22.2 and python-lz4 4.4.5. Python 3.11+ with working Tkinter is required by the application; use the recorded versions to match the release.

python3 -m venv .venv
.venv/bin/python -m pip install -r requirements-build.txt
.venv/bin/python prepare_emulators.py
.venv/bin/python -m PyInstaller --noconfirm MacRelease.spec

Output: dist/AMPR Auto Pak Guide.app. prepare_emulators.py downloads the three official release assets and checks their pinned SHA-256 values. No game files, recordings, credentials or personal project data are required or included. To run from source: .venv/bin/python python-tools/ampr_mac_gui.py.

The corresponding source for the upstream emulator release is included at upstream/ampr_emu-0.4.2.1; see SOURCE_PROVENANCE.md for the source commit, configuration files and build limitations. The old pull-request branch is not the source reference for this release.

Editable English/German documentation sources are in guide-source. render_guides.py uses ReportLab (a documentation-only dependency installed separately) and writes PDFs to help-resources. No guides were regenerated as part of this release.

License and attribution

The modified application is GPLv3; see LICENSE. Original AMPR emulator and PAK tools: Drakmor and upstream contributors. macOS front end, Auto Guide and modifications: Shambhala222. Existing upstream copyright and separate third-party licenses are retained. See CREDITS.txt, THIRD_PARTY_NOTICES.txt and LICENSES. The independent branding does not imply endorsement.

Source ZIP and tar.gz downloads are attached to the same tagged release, including the current application source, upstream emulator release source, resources, build files and license notices. Distributing a copy of the app also requires complying with its source and license obligations.