Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Chowdhury-DSP/BYOD
Build-your-own guitar distortion!
https://github.com/Chowdhury-DSP/BYOD
Last synced: 3 months ago
JSON representation
Build-your-own guitar distortion!
- Host: GitHub
- URL: https://github.com/Chowdhury-DSP/BYOD
- Owner: Chowdhury-DSP
- License: gpl-3.0
- Created: 2021-06-20T00:02:12.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-05-18T00:15:15.000Z (6 months ago)
- Last Synced: 2024-05-19T00:31:44.701Z (6 months ago)
- Language: C++
- Size: 5.42 MB
- Stars: 409
- Watchers: 11
- Forks: 21
- Open Issues: 31
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Authors: AUTHORS
Awesome Lists containing this project
- awesome-juce - BYOD - DSP](https://github.com/Chowdhury-DSP)</sup> | Build-Your-Own Guitar Distortion| GPL-3.0|436|6Β months<sub><sup>σ σ π’</sup></sub>| (Effects)
README
# BYOD (Build-Your-Own Distortion)
[](https://github.com/Chowdhury-DSP/BYOD/releases/latest)
[](https://opensource.org/licenses/GPL-3.0)
[](https://somsubhra.github.io/github-release-stats/?username=Chowdhury-DSP&repository=BYOD&page=1&per_page=30)
BYOD is a guitar effects plugin with a customisable
signal chain that allows users to create their own guitar
distortion effects. The plugin contains a wide variety
of distortion effects from analog modelled circuits
to purely digital creations, along with some musical
tone-shaping filters, and a handful of other useful
signal processors.
## Quick Links
- [Latest Release](https://chowdsp.com/products.html#byod)
- [BYOD for iOS](https://apps.apple.com/us/app/byod/id1595313287)
- [Nightly Builds](https://chowdsp.com/nightly.html#byod)
- [User Manual](https://github.com/Chowdhury-DSP/BYOD/blob/main/manual/Manual.md)
BYOD is open to contributions! If you would like to
add new guitar effect processors, please see
[the documentation](./docs).
## Building
To build from scratch, you must have CMake installed.
```bash
# Clone the repository
$ git clone https://github.com/Chowdhury-DSP/BYOD.git
$ cd BYOD
# initialize and set up submodules
$ git submodule update --init --recursive
# build with CMake
$ cmake -Bbuild
$ cmake --build build --parallel 4
```
If you'd like to make an optimized "release" build, it
is suggested to use some slightly different build commands:
```bash
$ cmake -Bbuild -DCMAKE_BUILD_TYPE=Release
$ cmake --build build --config Release --parallel 4
```
BYOD requires CMake version 3.15 or higher, however, BYOD
CLAP builds require CMake 3.21 or higher. CLAP builds can
be disabled by adding `-DBYOD_BUILD_CLAP=OFF` to the first
CMake command.
After a successful build, the resulting plugin binaries will be located in
`build/BYOD_artefacts`.
If building for Linux, please review the Linux dependencies used by
the [BYOD CI pipeline](https://github.com/Chowdhury-DSP/BYOD/blob/main/.github/workflows/cmake.yml#L30).
### Compiling with OpenGL support
By default, OpenGL support is enabled on Windows, and is disabled on all other
platforms. If you would like to override the default behaviour, you can pass the
argument `-DCHOWDSP_ENABLE_OPENGL=` to the CMake configure step.
## Credits:
- Extra Icons - [FontAwesome](https://fontawesome.com/)
- Fuzzy Searching - [fuuzysearch](https://bitbucket.org/j_norberg/fuzzysearchdatabase)
- C++ Utilities:
- [Magic Enum](https://github.com/Neargye/magic_enum)
- [Surge Synth Team's cpputils](https://github.com/surge-synthesizer/sst-cpputils)
- [ea_variant](https://github.com/eyalamirmusic/Variant)
Credits for the individual processors are shown on
the information page for each processor. Big thanks to all who
have contributed!
## License
BYOD is open source, and is dual-licensed under the
General Public License Version 3. For more details,
please see the [licensing documentation](./docs/Licensing.md). Enjoy!