## LETSDIST

![Screenshot](./assets/letsdist.png)

Aggressive Distortion plugin for Guitar (GNU GPLv3)<br>
Inspired by the legendary circuit. it combines raw hard-clipping characteristics with modern parallel processing to deliver a biting, gritty tone without sacrificing the low-end punch.<br>

Tested Environment: Arch Linux, Debian stable, Windows 11 / Reaper, Ardour.<br>

### Features
- **Asymmetric hard-clipping logic:** Creates odd and even harmonics, emulating the raw of vintage distortion.
- **Slew Rate Limiter:** Simulates the limited slew rate of the classic LM308.
- **Reverse Filter:** Low-pass filter with a reverse-taper control—turn it up to darken the tone, just like the original hardware.
- **2x Oversampling:** Reduces aliasing artifacts for a clearer high-frequency response and smoother distortion at high gain settings.

### Parameters
- **Distortion:** High values push the signal into heavy hard-clipping.
- **Filter:** Reverse Low-Pass Filter. Increasing the value lowers the cutoff frequency (darker tone).
- **Slew Rate:** Limits the signal change rate. Higher values provide a smoother, vintage feel.
- **Dry Level:** Level of clean input signal.
- **Wet Level:** Level of the distored signal.

## Build & Installation Guide
As LETSDIST is an open-source, non-binary-release project, you must compile it from the source. The build process is optimized for your local machine architecture.

#### Prerequisites
You need the **Rust toolchain (rustup)** and <br>

Arch Linux
```
sudo pacman -S base-devel pkgconf alsa-lib fontconfig freetype2 libxcb libx11 libxcursor libxrandr libxi libxkbcommon-x11 glib2
```
Debian / Ubuntu
```
sudo apt install build-essential pkg-config libasound2-dev libfontconfig1-dev libfreetype-dev libxcb1-dev libxcb-render0-dev libxcb-shape0-dev libxcb-xfixes0-dev libx11-dev libxcursor-dev libxrandr-dev libxi-dev libxkbcommon-x11-dev libglib2.0-dev
```
#### Build
```
git clone https://codeberg.org/yimrakhee/letsdist.git
cd letsdist
cargo xtask bundle letsdist --release

cp target/bundled/letsdist.clap ~/.clap/
cp -r target/bundled/letsdist.vst3 ~/.vst3/
```
### License
This project is licensed under the GNU GPLv3 License. See the LICENSE file for details.

### Credits
- Developed by [yimrakhee](https://yimrakhee.codeberg.page)
- Built with [nih-plug](https://github.com/robbert-vdh/nih-plug) and [egui](https://github.com/emilk/egui)

