LONGDIVISION - VST3 & CLAP PLUGIN by BruceJames.studio
=======================================================

Thank you for downloading LongDivision!

LongDivision is a frequency-band stereo widener that works by analysing how
correlated each frequency band is between the left and right channels, then
selectively widening only the bands that fall within a target correlation window
you define. Bands outside the window are left completely untouched, keeping the
result mono-compatible and transparent.

----------------------------------------
INSTALLATION
----------------------------------------

Windows:
  Run the included installer (LongDivision_Setup_1.0.2.exe) and follow the
  prompts. The installer copies plugins to the standard system folders:

  VST3 destination: C:\Program Files\Common Files\VST3
  CLAP destination: C:\Program Files\Common Files\CLAP

  Manual install (without the installer):
    LongDivision.vst3  ->  C:\Program Files\Common Files\VST3\
    LongDivision.clap  ->  C:\Program Files\Common Files\CLAP\

Linux:
  Unpack the .tar.gz, then from the extracted folder run the included script:
    ./install.sh              Install for the current user (no sudo)
                              VST3 -> ~/.vst3   CLAP -> ~/.clap
    ./install.sh --system     Install system-wide (uses sudo)
                              VST3 -> /usr/lib/vst3   CLAP -> /usr/lib/clap
    ./install.sh --uninstall  Remove the per-user install
                              (add --system to remove a system-wide install)

  Manual install (without the script):
    LongDivision.vst3  ->  ~/.vst3/        (or /usr/lib/vst3 system-wide)
    LongDivision.clap  ->  ~/.clap/        (or /usr/lib/clap system-wide)

Restart your DAW and rescan plugins after installing.

----------------------------------------
QUICK START
----------------------------------------

1. Insert LongDivision on a stereo bus or any stereo track.
2. Set the Width knob to taste (start around 50%).
3. Use the dual-handle Capture Window slider to define which correlation range
   to process. Drag the inner handle to set how "mono" a band can be before the
   gate opens; drag the outer handle to set how stereo a band can be. Bands
   with correlation inside the window get widened; bands outside do not.
4. Adjust Attack and Release to control how quickly the gate responds.
5. Enable Lock to Window to prevent widening from pushing sounds beyond the
   outer edge of your capture window.
6. Adjust HPF and LPF to limit the effect to a specific frequency range.

The spectrum display shows each analysis band as a bar. Bars land inside the
yellow capture window when that band is being processed.

----------------------------------------
PARAMETERS
----------------------------------------

Width           0–100%. The amount of stereo widening applied to captured bands.

HPF             High-pass filter cutoff. The effect is not applied below this
                frequency.

LPF             Low-pass filter cutoff. The effect is not applied above this
                frequency.

Tilt            Spectral tilt applied to the widening signal. Positive values
                weight the widening toward high frequencies; negative toward low.

Capture Window  Dual-handle slider. The left (inner) handle sets the lower
                correlation threshold; the right (outer) handle sets the upper.
                Only bands with Pearson correlation inside this range are
                widened. Correlation 1.0 = perfectly mono; 0.0 = fully stereo.

Lock to Window  When on, the maximum widening is scaled so that widened signals
                cannot push further apart than the outer edge of the capture
                window. Keeps the result predictable.

Emphasis        Flat / Louder / Quieter. Biases which bands receive the most
                widening: Flat treats all captured bands equally; Louder
                emphasises louder bands; Quieter emphasises quieter bands.

Emph Thresh     Amplitude threshold for the emphasis curve.

Emph Curve      Shape of the emphasis curve (steepness of the bias).

Bands           4–256. Number of frequency analysis bands. Higher values give
                finer frequency resolution at the cost of CPU.

Attack          0–1000 ms. How quickly the gate opens when a band enters the
                capture window.

Release         0–1000 ms. How quickly the gate closes when a band leaves the
                capture window.

LFO Amount      0–100%. Depth of the LFO modulation applied to the width.

LFO Speed       Rate of the LFO.

Mix             0–100%. Dry/wet blend. 100% is fully processed.

Bypass          Hard bypass. Processing is halted and the input passes through
                unchanged.

Null Test       Subtracts the dry signal from the output so you hear only what
                LongDivision is adding. Useful for auditing the effect in
                isolation.

----------------------------------------
LICENSE & ACTIVATION
----------------------------------------

LongDivision runs in demo mode until a valid license key is entered. In demo
mode the plugin inserts a brief silence periodically.

Purchase a license at https://brucejames.studio

To activate: click AUTHORIZE in the plugin UI, enter your key, and press
Submit. An internet connection is required for activation only.

Your license file is stored here after activation:
  Windows: %APPDATA%\LongDivision\license.json
  macOS:   ~/Library/Application Support/LongDivision/license.json
  Linux:   ~/.config/LongDivision/license.json

----------------------------------------
TROUBLESHOOTING
----------------------------------------

- If your DAW does not detect the plugin, verify it is in the correct folder
  and perform a manual plugin rescan.
- Some DAWs require a restart after installation.
- If activation fails, check your internet connection and that the license
  key was entered exactly as received (no extra spaces).
- If the SmartScreen warning appears during install, click "More info" then
  "Run anyway" to proceed.

Need help? Contact support@brucejames.studio

----------------------------------------
(c) 2026 BruceJames.studio - All Rights Reserved.
