# Pomar Rack — macOS quick start (Apple Silicon beta)

This is an **unsigned** beta build for **Apple Silicon** Macs (M1/M2/M3/M4). Because it isn't notarized yet,
macOS Gatekeeper blocks it on first launch — that's expected, and the steps below get you past it.

> Apple Silicon only for now. Intel Macs and a signed/notarized build (so this step goes away) are planned.

## 1 · Open the app (first launch only)

1. Double-click `PomarRack-macOS.zip` to unzip it.
2. **Right-click** (or Control-click) `Pomar Rack.app` → **Open** → **Open** again in the dialog.

Plain double-clicking shows *"Apple cannot check it for malicious software"* and refuses — that's why you
use **right-click → Open** the first time. After that, it opens normally.

If it still won't open, run this once in Terminal from the unzipped folder, then try again:

```sh
xattr -dr com.apple.quarantine "Pomar Rack.app"
```

## 2 · Build your library (first run)

Pomar Rack builds its preset/plugin library **locally** — no fixed index ships, because every Mac has
different plugins. From the unzipped folder, in Terminal:

```sh
./topo-refresh
```

This scans your installed plugins and NKS content and builds the browser index (it also imports the bundled
plugin artwork sitting next to `topo-refresh`). Re-run it whenever you install new plugins.

## 3 · Audio & microphone

Open **Setup** to pick your input/output device. Live-input tracks use your audio input, so macOS will prompt
for **microphone** permission the first time you add one — allow it.

---

Found a rough edge? It's an early beta — the macOS UI is still being tuned (e.g. fullscreen). Thanks for testing.
