# *BETA* BM-TPG Installation Instructions for macOS Thank you for downloading BM-TPG. This guide will help you install, activate, and configure the application on your Mac. ## 1. Only the Correct Version BM-TPG has been built to work on either Apple Silicon or Intel based Apple Computers. ## 2. Extract and Move - Locate the downloaded zip file in your `Downloads` folder. - Double-click the zip file to extract it. You will see the application icon named  bm-tpg.app` - Drag and drop the application into your **Applications** folder, or any other folder of your choice (e.g., `Documents/ColourSpace-Tools`). ## 3. First Launch & Security Warnings This app is not digitally signed by Apple, so the macOS Gatekeeper will prevent it from opening until you grant the execution permission. **Do not double-click the app to open it the first time.** Instead, follow these steps: 1. **Right-click** (or Control-click) on the **`bm-tpg.app`** icon. 2. Select **Open** from the context menu. 3. A dialog box will appear warning that the developer cannot be verified. Click the **Open** button in this dialog. - If you don't see an "Open" button, click "Cancel" - Then go to **System Settings > Privacy & Security**, - Scroll down to the Security section, and click **Open Anyway** next to the notification about cs_remote. 4. You only need to do this once. Future launches can be done by simply double-clicking the app. ### App is damaged - Error > **"App is damaged" Error:** If macOS says the app is "damaged and can't be opened," this is a common issue with unsigned apps downloaded from the internet. To fix it, open the **Terminal** app and type the following command (replace `/path/to/` with the actual location): `xattr -cr /Applications/bm-tpg.app` ## 4. License Activation You can access your licence key on the customer portal here: [https://polar.sh/aulwa/portal](https://polar.sh/aulwa/portal/request) - On the first launch, you will see a **License Entry** screen. - Ensure your Mac is connected to the internet. - Paste your License Key into the field and click **Activate License**. ![[BM-TPG-Licence.png|300]] - Once validated, the main application window will open and the licence status is displyed. ![[BM-TPG-Licence-status.png|200]] ## 5. The `bm-tpg.json`Configuration File - After activation, a configuration file named bm-tpg.json` will be created: - If you activated the app in the Applications folder the file will be here: `'~/Library/Application Support/aulwa'` - If you activated the app in another folder the file will be in the same folder as the app - **Purpose:** This file stores your license activation and application settings. - **Important:** If you move the application to a new folder, you must move this bm-tpg.json` file along with it, or you will be asked to activate your license again. - **Do Not Edit:** Please do not open or modify this file manually. It is digitally signed, and any changes will break the signature and you will need to log on to Polar.sh and re-enable the licence. ## Other Messages you may get when first run, on macOS You will need to grant permission for BM-TPG to find ColourSpace on the local network. ![[BM-TPG-Find-on-LAN.png|300]] You will need to grant permission for the incoming Network connection from ColourSpace. ![[BM-TPG-incomming-net-permission.png|300]] Also see the [[BM-TPG Install macOS]] and [[BM-TPG User Guide]]