From 98e88acf2e7f4c30ec01d01c07569c116535ed65 Mon Sep 17 00:00:00 2001 From: connorshort <59803135+connorshort@users.noreply.github.com> Date: Sun, 11 Sep 2022 14:12:09 -0400 Subject: [PATCH 1/6] Update README.md --- README.md | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index b7ce894..22fbc12 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,12 @@ # BlackBird -### [Website](https://khrykin.github.io/BlackBird) · [Sample Sounds](https://soundcloud.com/khrykin/sets/BlackBird) Simple, yet peculiar VST3/AU Synth +BlackBird is an analog-inspired software synthesizer. It features two oscillators, each with 3 waveform choices. It has one envelope that can be used to control velocity as well as the cutoff and resonance of the built-in low-pass filter. BlackBird also has a built-in reverb effect, and mod wheel functionality. + +If you just want to use BlackBird in your own compositions, please visit the [website](https://khrykin.github.io/BlackBird). Sound examples are available [here](https://soundcloud.com/khrykin/sets/BlackBird). + ![Plugin window screenshot](https://raw.githubusercontent.com/khrykin/BlackBird/master/Promo/Screenshot.png) + +## Development +BlackBird makes use of JUCE, a development framework for audio applications. More information about JUCE can be found on their [website](https://juce.com/). Fortunately, JUCE provides a utility called “the projucer” that makes setup of projects for development easy. This can be downloaded on the JUCE website [here](https://juce.com/get-juce/download). Once you have downloaded this, extract the folder and place it in a convenient location. Run the “projucer” program, and open BlackBird.jucer to begin building a project. Use “File->Global paths…” to ensure that the module and JUCE paths are set correctly based on where you extracted your JUCE directory. Once this has been established, choose your exporter at the top of Projucer (Xcode or Visual Studio), and then click the button to the right of this selection to build your project. You can now begin development on BlackBird in your chosen IDE. From c35a37ae11efffffb2aa90ff2f021ae6d2910334 Mon Sep 17 00:00:00 2001 From: connorshort <59803135+connorshort@users.noreply.github.com> Date: Sun, 11 Sep 2022 15:01:52 -0400 Subject: [PATCH 2/6] Update README.md --- README.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/README.md b/README.md index 22fbc12..4d8d280 100644 --- a/README.md +++ b/README.md @@ -10,3 +10,7 @@ If you just want to use BlackBird in your own compositions, please visit the [we ## Development BlackBird makes use of JUCE, a development framework for audio applications. More information about JUCE can be found on their [website](https://juce.com/). Fortunately, JUCE provides a utility called “the projucer” that makes setup of projects for development easy. This can be downloaded on the JUCE website [here](https://juce.com/get-juce/download). Once you have downloaded this, extract the folder and place it in a convenient location. Run the “projucer” program, and open BlackBird.jucer to begin building a project. Use “File->Global paths…” to ensure that the module and JUCE paths are set correctly based on where you extracted your JUCE directory. Once this has been established, choose your exporter at the top of Projucer (Xcode or Visual Studio), and then click the button to the right of this selection to build your project. You can now begin development on BlackBird in your chosen IDE. + +This process should create three projects, BlackBird_SharedCode, BlackBird_StandalonePlugin, and BlackBird_VST3. BlackBird_SharedCode contains the bulk of the BlackBird source, while the other two contain information for specific builds of the synthesizer. + +To begin modifying BlackBird, look in BlackBird_SharedCode/BlackBird/Source. Here you will find PluginProcessor.cpp and PluginProcessor.h, which are crucial for JUCE applications. You will also find a folder of code related to the UI, and another folder with code related to DSP, or Digital Signal Processing. From ce2b9cf804a5bb2464a9562959317afb08ab03b9 Mon Sep 17 00:00:00 2001 From: connorshort <59803135+connorshort@users.noreply.github.com> Date: Sun, 11 Sep 2022 16:49:22 -0400 Subject: [PATCH 3/6] Update README.md --- README.md | 16 +++++++++++----- 1 file changed, 11 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 4d8d280..96c6b4e 100644 --- a/README.md +++ b/README.md @@ -2,15 +2,21 @@ Simple, yet peculiar VST3/AU Synth -BlackBird is an analog-inspired software synthesizer. It features two oscillators, each with 3 waveform choices. It has one envelope that can be used to control velocity as well as the cutoff and resonance of the built-in low-pass filter. BlackBird also has a built-in reverb effect, and mod wheel functionality. +## Summary +BlackBird is an analog-inspired software synthesizer. It features two oscillators, each with a choice of sine, saw, or pulse waveforms. It has one envelope that can be used to control velocity as well as the cutoff and resonance of the built-in low-pass filter. BlackBird also has a built-in reverb effect, and mod wheel functionality. Blackbird is available in AU and VST3 forms. +![Plugin window screenshot](https://raw.githubusercontent.com/khrykin/BlackBird/master/Promo/Screenshot.png) + +## Installation If you just want to use BlackBird in your own compositions, please visit the [website](https://khrykin.github.io/BlackBird). Sound examples are available [here](https://soundcloud.com/khrykin/sets/BlackBird). -![Plugin window screenshot](https://raw.githubusercontent.com/khrykin/BlackBird/master/Promo/Screenshot.png) +## Setup +BlackBird makes use of JUCE, a development framework for audio applications. More information about JUCE can be found on their [website](https://juce.com/). Fortunately, JUCE provides a utility called “the projucer” that makes setup of projects for development easy. This can be downloaded on the JUCE website [here](https://juce.com/get-juce/download). Once you have downloaded this, extract the folder and place it in a convenient location. Within this folder is an application called Projucer, which will allow you to open and manipulate JUCE projects. -## Development -BlackBird makes use of JUCE, a development framework for audio applications. More information about JUCE can be found on their [website](https://juce.com/). Fortunately, JUCE provides a utility called “the projucer” that makes setup of projects for development easy. This can be downloaded on the JUCE website [here](https://juce.com/get-juce/download). Once you have downloaded this, extract the folder and place it in a convenient location. Run the “projucer” program, and open BlackBird.jucer to begin building a project. Use “File->Global paths…” to ensure that the module and JUCE paths are set correctly based on where you extracted your JUCE directory. Once this has been established, choose your exporter at the top of Projucer (Xcode or Visual Studio), and then click the button to the right of this selection to build your project. You can now begin development on BlackBird in your chosen IDE. +Inside Projucer, open BlackBird.jucer to begin building a project for your IDE. Use “File->Global paths…” to ensure that the JUCE and module paths are set correctly based on where you extracted your JUCE directory. If you wish to use different versions of JUCE modules, you can set individual paths in the Modules tab on the left. Once you have your settings selected, choose your exporter at the top of Projucer (Xcode or Visual Studio), and then click the button to the right of this selection to build your project. You can now begin development on BlackBird in your chosen IDE. This process should create three projects, BlackBird_SharedCode, BlackBird_StandalonePlugin, and BlackBird_VST3. BlackBird_SharedCode contains the bulk of the BlackBird source, while the other two contain information for specific builds of the synthesizer. -To begin modifying BlackBird, look in BlackBird_SharedCode/BlackBird/Source. Here you will find PluginProcessor.cpp and PluginProcessor.h, which are crucial for JUCE applications. You will also find a folder of code related to the UI, and another folder with code related to DSP, or Digital Signal Processing. +If you wish to change any settings in the Projucer, make sure to use the File->Save Project option inside the Projucer. This is a crucial step, as several code files within JUCE projects are auto-generated based on your unique configuration, meaning that failing to save from within the Projucer could result in issues when trying to build the project. Your IDE, if open at this time, may warn you about external changes to the project you are working on. Be sure to accept these changes. + +To begin modifying BlackBird, look in BlackBird_SharedCode/BlackBird/Source. Here you will find PluginProcessor.cpp and PluginProcessor.h. You will also find a folder of code related to the UI, and another folder with code related to DSP, or Digital Signal Processing. From 02d8c3869fafa334eef2ae279c17ab728d4b8434 Mon Sep 17 00:00:00 2001 From: connorshort <59803135+connorshort@users.noreply.github.com> Date: Sun, 11 Sep 2022 16:56:57 -0400 Subject: [PATCH 4/6] Update README.md --- README.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 96c6b4e..827c90d 100644 --- a/README.md +++ b/README.md @@ -5,13 +5,15 @@ Simple, yet peculiar VST3/AU Synth ## Summary BlackBird is an analog-inspired software synthesizer. It features two oscillators, each with a choice of sine, saw, or pulse waveforms. It has one envelope that can be used to control velocity as well as the cutoff and resonance of the built-in low-pass filter. BlackBird also has a built-in reverb effect, and mod wheel functionality. Blackbird is available in AU and VST3 forms. -![Plugin window screenshot](https://raw.githubusercontent.com/khrykin/BlackBird/master/Promo/Screenshot.png) +![Plugin window screenshot](https://raw.githubusercontent.com/khrykin/BlackBird/master/Promo/Screenshot.png) + +Blackbird uses JUCE, a C++ framework that aids in the creation of audio plugins. More information about JUCE can be found on their website [here](https://juce.com/). ## Installation -If you just want to use BlackBird in your own compositions, please visit the [website](https://khrykin.github.io/BlackBird). Sound examples are available [here](https://soundcloud.com/khrykin/sets/BlackBird). +If you just want to use BlackBird in your own compositions, please visit the [website](https://khrykin.github.io/BlackBird), where you can find installers for Windows. Once you have installed your AU or VST3 plugin, navigate from within your audio software to begin using the plugin. Sound examples are available [here](https://soundcloud.com/khrykin/sets/BlackBird). ## Setup -BlackBird makes use of JUCE, a development framework for audio applications. More information about JUCE can be found on their [website](https://juce.com/). Fortunately, JUCE provides a utility called “the projucer” that makes setup of projects for development easy. This can be downloaded on the JUCE website [here](https://juce.com/get-juce/download). Once you have downloaded this, extract the folder and place it in a convenient location. Within this folder is an application called Projucer, which will allow you to open and manipulate JUCE projects. +JUCE provides a utility called “the projucer” that makes setup of projects for development easy. This can be downloaded on the JUCE website [here](https://juce.com/get-juce/download). Once you have downloaded this, extract the folder and place it in a convenient location. Within this folder is an application called Projucer, which will allow you to open and manipulate JUCE projects. Inside Projucer, open BlackBird.jucer to begin building a project for your IDE. Use “File->Global paths…” to ensure that the JUCE and module paths are set correctly based on where you extracted your JUCE directory. If you wish to use different versions of JUCE modules, you can set individual paths in the Modules tab on the left. Once you have your settings selected, choose your exporter at the top of Projucer (Xcode or Visual Studio), and then click the button to the right of this selection to build your project. You can now begin development on BlackBird in your chosen IDE. From b5c54cea7ed927a312229707b1308ab889cbf2eb Mon Sep 17 00:00:00 2001 From: connorshort <59803135+connorshort@users.noreply.github.com> Date: Sun, 11 Sep 2022 19:50:34 -0400 Subject: [PATCH 5/6] Update README.md --- README.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/README.md b/README.md index 827c90d..b86f2c9 100644 --- a/README.md +++ b/README.md @@ -22,3 +22,7 @@ This process should create three projects, BlackBird_SharedCode, BlackBird_Stand If you wish to change any settings in the Projucer, make sure to use the File->Save Project option inside the Projucer. This is a crucial step, as several code files within JUCE projects are auto-generated based on your unique configuration, meaning that failing to save from within the Projucer could result in issues when trying to build the project. Your IDE, if open at this time, may warn you about external changes to the project you are working on. Be sure to accept these changes. To begin modifying BlackBird, look in BlackBird_SharedCode/BlackBird/Source. Here you will find PluginProcessor.cpp and PluginProcessor.h. You will also find a folder of code related to the UI, and another folder with code related to DSP, or Digital Signal Processing. + +## Testing +To build your own version of BlackBird, simply press build from within your chosen IDE. If working on a macOS device, your audio plugin will automatically be copied to +~/Library/Audio/Plug-Ins/VST3, but on Windows you will have to manually copy the generate .vst3 file. You may then test the synthesizer in an audio plugin, or you can use the Audio Plugin Host built in to JUCE. To activate this, use Projucer and open the .jucer file located in extras/AudioPluginHost/, then use the same method as above to open in your IDE. From here, you can build the Audio Plugin Host which will provide a testing environment. Click Options-> Edit The List of Available Plug-ins, which will provide you with a tool to scan for new plugins. At this point you can load Blackbird into the testing environment and try it out. From d4a0dede50f630ef9981b1ae46213a4fd4aa141d Mon Sep 17 00:00:00 2001 From: connorshort <59803135+connorshort@users.noreply.github.com> Date: Sun, 11 Sep 2022 19:51:44 -0400 Subject: [PATCH 6/6] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index b86f2c9..7466597 100644 --- a/README.md +++ b/README.md @@ -25,4 +25,4 @@ To begin modifying BlackBird, look in BlackBird_SharedCode/BlackBird/Source. Her ## Testing To build your own version of BlackBird, simply press build from within your chosen IDE. If working on a macOS device, your audio plugin will automatically be copied to -~/Library/Audio/Plug-Ins/VST3, but on Windows you will have to manually copy the generate .vst3 file. You may then test the synthesizer in an audio plugin, or you can use the Audio Plugin Host built in to JUCE. To activate this, use Projucer and open the .jucer file located in extras/AudioPluginHost/, then use the same method as above to open in your IDE. From here, you can build the Audio Plugin Host which will provide a testing environment. Click Options-> Edit The List of Available Plug-ins, which will provide you with a tool to scan for new plugins. At this point you can load Blackbird into the testing environment and try it out. +~/Library/Audio/Plug-Ins/VST3, but on Windows you will have to manually copy the generated .vst3 file. You may then test the synthesizer in an audio plugin, or you can use the Audio Plugin Host built in to JUCE. To activate this, use Projucer and open the .jucer file located in extras/AudioPluginHost/, then use the same method as above to open in your IDE. From here, you can build the Audio Plugin Host which will provide a testing environment. Click Options-> Edit The List of Available Plug-ins, which will provide you with a tool to scan for new plugins. At this point you can load Blackbird into the testing environment and try it out.