KXtra for Mac - installing
==========================

KXtra comes as two plugins and a standalone app:

  KXtra.component   Audio Unit, for Logic, GarageBand, MainStage and others
  KXtra.vst3        VST3, for Ableton Live, Cubase, Reaper, Bitwig and others
  KXtra.app         Standalone app, no DAW needed (optional)

They run on Apple Silicon and Intel Macs with macOS 12 or later. They are
signed by the developer and notarized by Apple, so macOS opens them like
any other plugin: nothing needs unblocking.

There are two ways to install: the installer (easiest), or copying the
files by hand from the zip.


The installer
-------------

1. Quit your DAW.
2. Double-click KXtra-<version>-mac.pkg and follow the steps. Click
   Customize to leave out the AU, the VST3 or the standalone app.
3. Open your DAW and rescan plug-ins (see "Rescan in your DAW" below).

It installs:

  Audio Unit    /Library/Audio/Plug-Ins/Components
  VST3          /Library/Audio/Plug-Ins/VST3
  App           /Applications/KXtra

These are the system-wide plug-in folders, so KXtra is there for every
user on the Mac. If you copied an earlier KXtra into your own
~/Library/Audio/Plug-Ins folders, the installer moves it to the Trash,
so your DAW finds the new one.


Copying by hand (from the zip)
------------------------------

If you installed an earlier, unsigned KXtra, delete it first: quit your
DAW, then delete KXtra.component and KXtra.vst3 from the folders below,
and from the system-wide ones (the same paths without the ~).

Quit your DAW. In Finder, choose Go > Go to Folder (Shift-Cmd-G) and
paste:

  ~/Library/Audio/Plug-Ins/Components

Copy KXtra.component into that folder. Then go to:

  ~/Library/Audio/Plug-Ins/VST3

and copy KXtra.vst3 into it. You only need the format your DAW uses.

For the standalone app, copy KXtra.app into your Applications folder.
Choose your audio and MIDI devices in its Options menu.

Use either the installer or a hand-copied set, not both: with two copies,
your DAW may load the older one.


Rescan in your DAW
------------------

Open your DAW. KXtra appears as an instrument from the manufacturer
Krakli.

- Logic or GarageBand: if KXtra doesn't appear, open Logic > Settings >
  Plug-in Manager, select KXtra and click Reset & Rescan Selection.
- Reaper: Settings > Plug-ins > VST, then choose "Clear cache and
  re-scan" from the Re-scan button.
- Ableton Live: Settings > Plug-Ins, then hold Option and click Rescan.
- Other DAWs: rescan plug-ins in the DAW's plug-in settings, clearing its
  plug-in cache if it has that option.


If it won't load
----------------

- The DAW lists KXtra as failed, or skips it: an earlier, unsigned copy
  may have failed its scan, and Reaper and Ableton Live remember that.
  Clear the DAW's plug-in cache and rescan, as above.

- Logic still doesn't list it: clear the Audio Unit cache in Terminal
  (Applications > Utilities > Terminal), then open Logic again:

    killall -9 AudioComponentRegistrar

  To check the Audio Unit yourself, run:

    auval -v aumu KXtr Krkl

  It should end with "AU VALIDATION SUCCEEDED".

- To check that a plugin is the genuine, undamaged file, run this with
  its path (installer: /Library/..., by hand: ~/Library/...):

    spctl --assess --type install -vv /Library/Audio/Plug-Ins/VST3/KXtra.vst3

  "accepted" and "source=Notarized Developer ID" mean it's fine. If it
  says "rejected", install it again from the original download: a USB
  stick formatted for Windows (FAT or exFAT) can damage it.


Krakli
