# MAIM

*MAIM Ain't an Implementation of Mp3*

<img src="Docs/images/maimgui.png" alt="screenshot of full maim gui">

MAIM is an audio plugin that circuit bends MP3 and Opus encoders in real time, 
disrupting the control flow sending data down unexpected paths to create digital distortions. With heavily hacked real MP3 encoders at its core, MAIM gives you the full gamut of digital distortion, from the realistic to the fantastical.

- MAIM features two real MP3 encoders (and, as of version 1.1.0, the real Opus encoder), captured in the wild and painstakingly incorporated into a real-time plugin.
- We've woven mad-science circuit bending into MAIM's MP3 encoders, to give you fine control over a whole palette of spectral distortions and face-melting glitches.
- All knobs can be smoothly dragged and automated, without pops or gaps in the sound.
- MAIM works across DAWs, on Mac (AU/VST3), Windows (VST3), and even Linux (VST3).
- MAIM is licensed under the GPL v3.0 license, so you are free to use and even modify it, as long as any redistribution of the software is under the same license.

If you encounter any issues, or have an idea for something that would improve MAIM, please raise an issue on the GitHub page.

Maim took a long time to make. If you enjoy MAIM and want to see more plugins like it in the future, [tips](https://ko-fi.com/wildergardenaudio) are always welcome.

## Installation Instructions

Under the releases tab from the GitHub, download the installer corresponding to your operating system.

On Windows or Mac, follow the instructions in the installer to install the plugin to your plugins folder.

On Linux, you'll have to copy Maim.vst3 to your plugin folder. Often this is at ~/.vst3, 
but if you're making music on Linux you're probably already a step ahead of me.

Once the installation has finished, MAIM will show up in your DAW's plugin folder, under the manufacturer name Wildergarden.

If you have any issues, please raise an issue on the issues page of this repository and describe your situation.

If instead you wish to build the plugin yourself, see the [build instructions](Docs/BUILDING.md).

## Contributing

You are welcome and encouraged to raise issues and create pull requests!
