BTX PQ WALLET post-quantum ← Back to wallet
First-time install

BTX PQ wallet
on macOS

Two clicks and one command. Here is exactly how to open it the first time, safely.

Short version: drag the app to Applications, then right-click it and choose Open. If macOS says it is “damaged” or “can’t be opened”, run the one Terminal command in step 3 and open it again.

Step by step

  1. Download the macOS .dmg from the wallet download page, open it, and drag BTX PQ wallet into your Applications folder.
  2. Open Applications, right-click (or Control-click) BTX PQ wallet, choose Open, then Open again in the dialog. macOS remembers your choice, so future launches are a normal double-click.
  3. If instead macOS says the app “is damaged and can’t be opened” or “cannot be opened because Apple cannot check it”, that is just the download quarantine flag on an unsigned app. Open Terminal (Spotlight, type Terminal), paste this exact line, press Return, then open the app again:
    xattr -dr com.apple.quarantine "/Applications/BTX PQ wallet.app"
    Keep the quotes, the app name has spaces. This removes only the “downloaded from the internet” marker; it changes nothing inside the app.

Why does this happen?

macOS Gatekeeper adds a quarantine attribute to anything downloaded from the internet, and refuses to open an app that is not signed with a paid Apple Developer certificate until you explicitly allow it. The wallet is an independent, open project and is not signed yet, so you approve it once by hand. The xattr command simply deletes that quarantine attribute. It does not touch the wallet’s code, your keys, or your funds.

Verify the download (optional, recommended)

Because the build is unsigned, you can confirm you got the real file. On the download page each build lists its SHA-256 (each hash links to its VirusTotal scan). In Terminal, run shasum -a 256 ~/Downloads/BTX-PQ-wallet-*.dmg and check it matches.

On Windows

There is no Terminal step. SmartScreen shows “Windows protected your PC”. Click More info, then Run anyway, and finish the installer.

← Back to the wallet page