================================================================================
  CAMBRIDGE CHANNEL STRIP  //  INSTALL GUIDE  //  LINUX  //  v1.0.0
================================================================================

Thank you for installing Cambridge Channel Strip.

SYSTEM REQUIREMENTS
-------------------
  * 64-bit x86 (x86_64) Linux
  * glibc 2.35 or newer

  Known-good distributions:

    * Ubuntu 22.04 LTS or newer
    * Debian 12 (bookworm) or newer
    * Fedora 36 or newer
    * Current glibc-based rolling distributions (Arch, openSUSE Tumbleweed)

  NOT supported: Ubuntu 20.04 and Debian 11. Both ship glibc 2.31, and
  Cambridge Channel Strip will not load there.

  To check your version:

    ldd --version

  The first line reports your glibc version. It must be 2.35 or higher.

SUPPORTED FORMATS
-----------------
  * VST3
  * CLAP

PACKAGE CONTENTS
----------------
This Linux x64 package contains:

  * install.sh
  * uninstall.sh
  * README.txt
  * README_Install_Linux.txt
  * Plugins/VST3/CambridgeChannelStrip.vst3
  * Plugins/CLAP/CambridgeChannelStrip.clap
  * Documentation/CambridgeChannelStrip_User_Manual_v1.0.0.pdf
  * Documentation/CambridgeChannelStrip_Quick_Start_v1.0.0.pdf
  * Documentation/CambridgeChannelStrip_Release_Notes_v1.0.0.txt

RECOMMENDED INSTALL METHOD
--------------------------
Use the included installer from the extracted package folder.

1. Extract the archive.

2. Open a terminal in the extracted folder:

   cambridgechannelstrip-linux-x64-v1.0.0

3. Make the installer executable if needed:

   chmod +x install.sh

4. Run the installer:

   ./install.sh

5. Choose which format(s) to install:

   1) VST3 + CLAP
   2) CLAP only
   3) VST3 only

The installer copies:

  * Plugins/VST3/CambridgeChannelStrip.vst3  ->  ~/.vst3/CambridgeChannelStrip.vst3
  * Plugins/CLAP/CambridgeChannelStrip.clap  ->  ~/.clap/CambridgeChannelStrip.clap

MANUAL INSTALLATION
-------------------
Close your DAW before copying plugin files.

For VST3:

  mkdir -p ~/.vst3
  cp -r Plugins/VST3/CambridgeChannelStrip.vst3 ~/.vst3/

For CLAP:

  mkdir -p ~/.clap
  cp Plugins/CLAP/CambridgeChannelStrip.clap ~/.clap/

Then launch your DAW and run a plugin rescan if needed.

UNINSTALL
---------
From the extracted package folder, run:

  ./uninstall.sh

The uninstaller removes:

  * ~/.vst3/CambridgeChannelStrip.vst3
  * ~/.clap/CambridgeChannelStrip.clap

NOTES
-----
  * Until activated with a licence key the plugin runs in demo mode: every
    control is active and there is no time limit, but a 2-second silence
    interruption occurs every 60 seconds and is printed into renders.
  * The user manual and quick start are included in the Documentation folder.
  * Per-user installation is recommended for most users.
  * Installing both VST3 and CLAP is fine if your host supports both.
  * System-wide install folders such as /usr/local/lib/vst3 or
    /usr/local/lib/clap may require elevated privileges and are not used by
    the included installer.

TROUBLESHOOTING
---------------
If Cambridge Channel Strip does not appear in your DAW:

  * Check your glibc version first (see SYSTEM REQUIREMENTS above). On a system
    older than glibc 2.35 the plugin cannot load at all, and most DAWs simply
    omit it from the scan results with no visible error. Running:

      ldd ~/.vst3/CambridgeChannelStrip.vst3/Contents/x86_64-linux/CambridgeChannelStrip.so

    on an unsupported system reports a message such as:

      version `GLIBC_2.35' not found

    If you see that, your distribution is too old for this build.

  * Confirm the chosen format was copied to the correct per-user plugin folder.
  * Confirm your DAW supports that format on Linux.
  * Run a manual plugin rescan.
  * Restart the DAW.
  * If both formats are installed and your DAW shows duplicates, keep the format
    you prefer and remove the other one.

SUPPORT
-------
  Website: https://www.mouseplugins.com
  Email: support@mouseplugins.com

================================================================================
  OFFLINE-FIRST  //  CAMBRIDGE CHANNEL STRIP  //  LINUX INSTALL
================================================================================
