KHORLO — macOS install
=======================

Khorlo is free. This is a beta: it works, and it is still being finished.


WHERE THE FILES GO
------------------

Just you — no password needed, and the usual choice:

    ~/Library/Audio/Plug-Ins/VST3/Components/          Khorlo.vst3
    ~/Library/Audio/Plug-Ins/Components/               Khorlo.component
    ~/Library/Audio/Plug-Ins/CLAP/                     Khorlo.clap

More precisely — copy each into the folder that matches its kind:

    Khorlo.vst3       ->  ~/Library/Audio/Plug-Ins/VST3/
    Khorlo.component  ->  ~/Library/Audio/Plug-Ins/Components/     (this is the AU)
    Khorlo.clap       ->  ~/Library/Audio/Plug-Ins/CLAP/

The Library folder is hidden by default. In Finder: Go menu, hold Option, and
Library appears.

For every user on the machine, use /Library/... instead of ~/Library/... —
that one asks for your password.

Then restart your DAW. Logic in particular only rescans Audio Units at launch.

Use ONE format. Installing all three makes Khorlo appear three times in your
plugin list — harmless, but confusing.


macOS WILL PROBABLY REFUSE IT THE FIRST TIME
--------------------------------------------

Khorlo is not signed by Apple — a developer certificate costs money a free
plugin does not have. macOS quarantines anything downloaded and unsigned, and
describes it as "damaged", which sounds far worse than it is. The download is
not damaged; macOS simply cannot confirm who made it.

Install it first, then paste ONE of these into Terminal.

If you installed into your own folder (~/Library, the default above):

    xattr -dr com.apple.quarantine ~/Library/Audio/Plug-Ins/VST3/Khorlo.vst3 ~/Library/Audio/Plug-Ins/Components/Khorlo.component ~/Library/Audio/Plug-Ins/CLAP/Khorlo.clap

If you installed system-wide (/Library, no ~) — this one asks for your password:

    sudo xattr -dr com.apple.quarantine /Library/Audio/Plug-Ins/VST3/Khorlo.vst3 /Library/Audio/Plug-Ins/Components/Khorlo.component /Library/Audio/Plug-Ins/CLAP/Khorlo.clap

It is fine if some of the three are missing — you will see "No such file" for
any format you did not install, and the rest still works.


WHAT THIS BUILD REQUIRES
------------------------

  * macOS 11 or later.
  * Intel or Apple Silicon. One download contains both; there is nothing to
    choose.

(Builds before 0.9.02 declared macOS 26 by mistake and would not load on
anything older. If you tried Khorlo and it never appeared in your DAW, that was
why, and this build fixes it.)


IF YOUR DAW CANNOT SEE IT
-------------------------

  1. Right folder? See above. Note that the AU goes in Components, not VST3.

  2. Did you clear the quarantine? An AU that is still quarantined fails
     validation silently in Logic.

  3. Restart the DAW.

  4. Logic only: if it validated once and failed, Logic remembers. Reset with

         killall -9 AudioComponentRegistrar

     then reopen Logic and let it rescan.


IF THE INTERFACE DOES NOT APPEAR
--------------------------------

Rare on macOS — the web view ships with the system. If it happens, the audio
engine keeps running and nothing in your project is at risk. Please send:

    ~/Library/Application Support/Khorlo/ui-debug.log


SOMETHING ELSE WRONG?
---------------------

Tell me. Nearly everything fixed in this beta was found by a user on a machine
we do not have.

  info@jas-i.com
  https://jas-i.com

What helps most: your macOS version, your DAW, which format you installed, and
the log above.
