SK7 for Mac - installing
========================

SK7 comes as two plugins and a standalone app:

  SK7.component   Audio Unit, for Logic, GarageBand, MainStage and others
  SK7.vst3        VST3, for Ableton Live, Cubase, Reaper, Bitwig and others
  SK7.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 SK7-<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, guide    /Applications/SK7

These are the system-wide plug-in folders, so SK7 is there for every
user on the Mac. If you copied an earlier SK7 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 SK7, delete it first: quit your
DAW, then delete SK7.component and SK7.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 SK7.component into that folder. Then go to:

  ~/Library/Audio/Plug-Ins/VST3

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

For the standalone app, copy SK7.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. SK7 appears as an instrument from the manufacturer
Krakli. The original SynthEdit SK7 (listed under Ian Webster) is a
separate plugin, so both can stay installed.

- Logic or GarageBand: if SK7 doesn't appear, open Logic > Settings >
  Plug-in Manager, select SK7 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 SK7 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 Sk07 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/SK7.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.


The full user guide is USER-GUIDE.pdf (the installer puts it in
/Applications/SK7).

Krakli
