# PSOrvia Controller Donation - macOS Your hardware controller is not in the PS plug-ins yet? Send us its factory mapping. It takes about three minutes and nothing is sent without your click. There is nothing to install: download one file, start it. ## Download and start 1. Download `pso-controller-spende-1.0.0-mac.zip` (about 8 MB; check: `shasum -a 256 `), open it (a double-click in Finder unpacks it) and drag **PSOrvia Controller Donation** to *Applications* (or start it from Downloads). 2. The app is signed and notarized by Apple, so a double-click starts it. If macOS still asks, confirm *Open* once. The program runs natively on Apple silicon and on Intel Macs (universal), from macOS 10.15. 3. The first time the program lists MIDI devices macOS may not ask anything (it reads USB MIDI through CoreMIDI); if the device list is empty, reconnect the controller and press *Refresh list*. 4. Reset the controller to its factory state, connect it by USB and close your DAW before you start. Honest notes: *Send by e-mail* opens the default mail program (`mailto:`); with web mail use *Save file* (writes into `~/Documents`) and attach the `.json` file. For the person who builds it (rental Mac, `material/pso-mac-bau`): `material/pso-controller-spende/mac-app.sh [1.0.0]` builds a universal (arm64 + x86_64) `PSOrvia Controller Donation.app`, signs it when `DEV_ID_APP` is set in `~/pso-mac.env`, notarizes it with `NOTARY_PROFILE`, zips it to `~/pso-ausgabe/spende/pso-controller-spende-1.0.0-mac.zip` with a `.sha256`. Check on the Mac: device list shows the USB controller, the capture steps count, *Send by e-mail* opens Mail, *Save file* writes into `~/Documents`. Copy the zip and its checksum line into `dist/`. ## What the program does Station 1 *Device*: pick your controller in the list (press *Refresh list* if it is missing), check the device name, type the firmware version if you know it, read the privacy text and tick the agreement. Press *Start*. Station 2 *Capture*: follow the five steps (knobs, faders, pads, buttons, wheels and pedals). Move each control once, one after another, always in the same order. Turn each knob and move each fader briefly back and forth: it is counted as soon as its first value arrives. If nothing happens after about 3 seconds, the control is probably at its end stop (a knob already at 0 or 127 sends nothing further in that direction) - turn it the other way. Set the number the device has with `-` / `+`. *Skip this step* if the device has none, *Do this step again* if you slipped. Station 3 *Send*: read the text. Press **Send by e-mail**: your mail program opens with the text filled in; press send there. Mail address: data@psorvia.io. No mail program (or it did not open)? Press **Save file**: the program writes `pso-controller-spende--.json` and `.txt` into your Documents folder. Attach the `.json` file to a mail to data@psorvia.io. What is in the mail: device name, the firmware and mode you typed, system name (macOS), program version, date, the MIDI numbers of the controls you moved. Nothing else. The program sends nothing by itself.