Skip to content

INSTALL.md

Latest commit

 

History

History
93 lines (69 loc) · 3.54 KB

INSTALL.md

File metadata and controls

93 lines (69 loc) · 3.54 KB
Raw

Installing Morass

Download the installer for your OS from the project's Releases page, then follow the steps below. The installers place Morass in the standard plugin folders your DAW already scans — there's no separate "registration" step; just rescan plugins (or restart your DAW).

Two heads-ups before you start:

  • No binaries on the Releases page yet? Until the first release is cut, build from source (bottom of this page).
  • These builds are unsigned/not notarized, so macOS Gatekeeper and Windows SmartScreen will warn on first launch. Each OS section below has the one-time step to allow it. (Code-signing is on the roadmap.)

macOS

  1. Download Morass-<version>.dmg (or .pkg).
  2. Open it and run the installer package. It installs:
    • Audio Unit → /Library/Audio/Plug-Ins/Components/Morass.component
    • VST3 → /Library/Audio/Plug-Ins/VST3/Morass.vst3
  3. Launch your DAW. Morass appears under Morass Audio (in Logic: Audio FX → Morass Audio → Morass).

Unsigned build — first launch. Because these releases aren't notarized, Gatekeeper may say the package "can't be opened" or is from an "unidentified developer". To allow it:

  1. Installer: right-click the .pkg → Open → Open again. If macOS still blocks it, go to System Settings → Privacy & Security and click Open Anyway, then reopen the package.
  2. If a plugin is still quarantined after installing, clear the flag on both bundles: 
    sudo xattr -dr com.apple.quarantine /Library/Audio/Plug-Ins/Components/Morass.component
sudo xattr -dr com.apple.quarantine /Library/Audio/Plug-Ins/VST3/Morass.vst3

Uninstall: delete Morass.component and Morass.vst3 from the folders above.

Windows

  1. Download Morass-<version>-windows-setup.exe.
  2. Run it (admin elevation installs system-wide). It installs:
    • VST3 → C:\Program Files\Common Files\VST3\Morass.vst3
    • Standalone (optional component) → C:\Program Files\Morass Audio\Morass
  3. Launch your DAW and rescan plugins. Morass appears under Morass Audio.

Unsigned build — SmartScreen. The installer isn't code-signed yet, so Windows may show "Windows protected your PC". Click More info → Run anyway to proceed. (Signed builds are on the roadmap.)

If no installer is present, a portable Morass-<version>-windows.zip is provided; copy Morass.vst3 into C:\Program Files\Common Files\VST3.

Uninstall: via Add/Remove Programs, or delete the VST3 folder above.

Linux

  1. Download Morass-<version>-linux.tar.gz and extract it.
  2. Install: 
    ./install.sh             # per-user: ~/.vst3 and ~/.local/bin (no sudo)
sudo ./install.sh --system   # system-wide: /usr/local/lib/vst3
  3. Rescan plugins in your DAW (Reaper, Bitwig, Ardour, Tracktion, …).

Uninstall: ./install.sh --uninstall (or remove ~/.vst3/Morass.vst3).

Which format does my DAW use?

DAW Format
Logic Pro, GarageBand Audio Unit (macOS only)
Ableton Live, Cubase, Studio One, Reaper, Bitwig, FL Studio, Ardour VST3

Morass installs both AU and VST3 on macOS, so any of the above will find it.

Build from source instead

Developers can build and install locally — see the README. On macOS, bash scripts/build_and_install_macos.sh builds, installs and validates the AU with auval in one step.