KHORLO 0.9.03
=============

Khorlo is in beta and free.

It requires 64-bit x86 Linux with glibc 2.35 or later, such as Ubuntu 22.04,
Debian 12, or newer. The interface needs WebKitGTK, which most desktop
distros ship. Wayland and X11 both work.


INSTALL
-------

Install the format your DAW supports. Copy the plugin into its matching folder:

    Khorlo.vst3  ->  ~/.vst3/
    Khorlo.clap  ->  ~/.clap/

Copy the whole Khorlo.vst3 folder, not the file inside it. Create the
destination folder if it doesn't exist, then restart your DAW.

These folders install Khorlo for your user account. To install for everyone
on the machine, use /usr/lib/vst3/ and /usr/lib/clap/ instead. This needs
sudo.

If Khorlo makes sound but the interface is blank, install WebKitGTK and
restart your DAW:

    Debian 13 / Ubuntu 24.04 and newer   sudo apt install libwebkit2gtk-4.1-0
    Debian 12 / Ubuntu 22.04             sudo apt install libwebkit2gtk-4.0-37
    Fedora                               sudo dnf install webkit2gtk4.1
    Arch / Manjaro                       sudo pacman -S webkit2gtk-4.1
    openSUSE                             sudo zypper install libwebkit2gtk-4_1-0


IF YOU ARE UPDATING FROM 0.9.02
-------------------------------

Replace the installed plugin with the new one of the same format.
Khorlo adds a Factory 0.9.03 folder to your preset library and keeps the
older bank. Your saved presets stay in place. You can remove the old factory
folder when you no longer need it.


IF KHORLO DOESN'T APPEAR
------------------------

Check the installation folder and restart your DAW. Some DAWs keep a list of
plugins that failed an earlier scan. Clear it and rescan. To see if a library
is missing:

    ldd ~/.vst3/Khorlo.vst3/Contents/x86_64-linux/Khorlo.so | grep "not found"


HELP AND MANUAL
---------------

If something goes wrong or the interface is blank, email me at:

    info@jas-i.com

Include your distribution, DAW version, plugin format, Wayland or X11, and
what happened. If this log exists, attach it:

    ~/.config/Khorlo/ui-debug.log

The manual is here:

    https://jas-i.com/khorlo/manual/

    https://jas-i.com


I HOPE YOU ENJOY KHORLO!
