Back to Index

Update: 2024-11-16

Table of Contents

EnvelopedSine is an additive synthesizer that computes 64 sine waves for each note. Difference to IterativeSinCluster is that this synth has AD envelope and saturator for each oscillator. EnvelopedSine is better suited for percussive sounds.

EnvelopedSine requires AVX or later SIMD instructions on x86_64 environment.

full package contains following builds.

Linux build is built on Ubuntu 24.04. If you are using distribution other than Ubuntu 24.04, plugin will not likely to run. In this case, please take a look at build instruction.

macOS package is recommended for macOS user. I can’t purchase Apple Developer Program, therefore installation requires a workaround to bypass Gatekeeper. Details of workaround are written in Installation -> macOS Specific section.

Feel free to contact me on GitHub repository or ryukau@gmail.com.

You can fund the development through paypal.me/ryukau.

Move *.vst3 directory to:

DAW may provides additional VST3 directory. For more information, please refer to the manual of the DAW.

Notice: Some plugins don’t have presets provided by Uhhyou Plugins.

Presets are included in the plugin package linked at the top of this page. To install presets, follow the steps below.

  1. Download plugin from a link at the top of this page.
  2. Extract downloaded zip file.
  3. Open presets directory placed in extracted package.
  4. Move Uhhyou directory into an OS specific preset directory (see below).

Below is a list of preset directories for each OS.

Preset directory name must be the same as the plugin. If preset directory does not exist, create it.

If DAW doesn’t recognize the plugin, try installing C++ redistributable (vc_redist.x64.exe). Installer can be found in the link below.

On Ubuntu 24.04, those packages are required.

sudo apt install libxcb-cursor0  libxkbcommon-x11-0

If DAW doesn’t recognize the plugin, take a look at Package Requirements section of the link below and make sure all the VST3 related package is installed.

REAPER on Linux may not recognize the plugin. A workaround is to delete a file ~/.config/REAPER/reaper-vstplugins64.ini and restart REAPER.

Important: full package is not confirmed working. When using full, try removing following files.

macOS package doesn’t contain above files. Also, all packages are in “ad-hoc signing” state set by codesign command.

When trying to run plugin first time, following message may appear on macOS.

<PluginName>.vst3 is damaged and can't be opened. You should move it to the Trash.

In this case, open terminal and try running one or both of following command to unzipped .vst3 directory. Replace /path/to/PluginName.vst3 according to your install location.

xattr -rd com.apple.quarantine /path/to/PluginName.vst3
xattr -rc /path/to/PluginName.vst3

Plugin may be considered as unsigned/un-notarized application. In this case, open System Preferences, go to Security & Privacy → General, then click the Open Anyway button. The offcial Apple help page linked below has screenshots for the procedure. See “If you want to open an app that hasn’t been notarized or is from an unidentified developer” section.

If the plugin is still not working, try changing install location to /Library/Audio/Plug-ins/VST3/ or /Users/$USERNAME/Library/Audio/Plug-ins/VST3/ whichever still haven’t tried.

If all the above methods do not work, try following the steps below.

  1. Open terminal and run sudo spctl --master-disable.
  2. Go to System Preferences → Security and Privacy → General → Allow apps downloaded from, then select “Anywhere”.

Beware that steps above degrades security of your system. To revert the settings, follow the steps below.

  1. Go to System Preferences → Security and Privacy → General → Allow apps downloaded from, then select option to “App Store and identified developers”.
  2. Open terminal and run sudo spctl --master-enable.

Note This section may not relevant to macOS packages. However it’s not verified. (GitHub issue)

To use full package, following command might be used.

sudo codesign --force --deep -s - /path/to/PluginName.vst3

codesign might not be available without installing Xcode.

At first time, create color config file to:

style.json will be loaded for each time a plugin window opens.

Several color themes are available on the link below. To use, copy the text to style.json.

Below is an example of style.json.

{
  "fontFamily"        : "Tinos"    ,
  "fontBold"          : true       ,
  "fontItalic"        : true       ,
  "foreground"        : "#000000"  ,
  "foregroundButtonOn": "#000000"  ,
  "foregroundInactive": "#8a8a8a"  ,
  "background"        : "#ffffff"  ,
  "boxBackground"     : "#ffffff"  ,
  "border"            : "#000000"  ,
  "borderCheckbox"    : "#000000"  ,
  "borderLabel"       : "#000000"  ,
  "unfocused"         : "#dddddd"  ,
  "highlightMain"     : "#0ba4f1"  ,
  "highlightAccent"   : "#13c136"  ,
  "highlightButton"   : "#fcc04f"  ,
  "highlightWarning"  : "#fc8080"  ,
  "overlay"           : "#00000088",
  "overlayHighlight"  : "#00ff0033"
}

Following is a list of font options.

System font can be used as fontFamily. To use different fonts for different plugins, place *.ttf file into custom font path: *.vst3/Contents/Resources/Fonts.

Notice: If the combination of fontFamily, fontBold, fontItalic does not exist in custom font path, default font of VSTGUI is used.

If fontFamily is set to empty string "", then "Tinos" is used as fallback. If the length is greater than 1 and the font family name doesn’t exist, default font of VSTGUI is used.

Styles other than bold, italic or bold-italic are not supported by VSTGUI. For example, “Thin”, “Light”, “Medium”, and “Black” weights cannot be used.

Hex color codes are used.

First letter # is conventional. Plugins ignore the first letter of color code, thus ?102938, \n11335577 are valid.

Do not use characters outside of 0-9a-f for color value.

Following is a list of color options. If an option is missing, default color will be used.

Right Click on the controls pops up a context menu provided by DAW.

Knob and slider provides following controls:

Control with many blue vertical bars (BarBox) have some keyboard shortcuts. Shortcuts are enabled after left clicking BarBox and mouse cursor is on the inside of BarBox.

Input Control
Left Drag Change Value
Shift + Left Drag Change Value (Snapped)
Ctrl + Left Drag Reset to Default
Ctrl + Shift + Left Drag Change Value (Skip Between Frames)
Middle Drag Draw Line
Shift + Middle Drag Edit One Bar
Ctrl + Middle Drag Reset to Default
Ctrl + Shift + Middle Drag Toggle Lock
a Alternate Sign
d Reset Everything to Default
D Toggle Min/Mid/Max
e Emphasize Low
E Emphasize High
f Low-pass Filter
F High-pass Filter
i Invert Value (Preserve minimum)
I Invert Value (Minimum to 0)
l Toggle Lock under Mouse Cursor
L Toggle Lock for All
n Normalize (Preserve minimum)
N Normalize (Minimum to 0)
p Permute
r Randomize
R Sparse Randomize
s Sort Descending Order
S Sort Ascending Order
t Subtle Randomize (Random walk)
T Subtle Randomize (Converge to 0)
z Undo
Z Redo
, (Comma) Rotate Back
. (Period) Rotate Forward
1 Decrease
2-4 Decrease 2n-4n
5-9 Decimate by holding 2n-5n

Snapping is not available for all BarBox. If you’d like to have snapping for certain BarBox, feel free to open issue to GitHub repository.

Edit One Bar with Shift + Right Drag holds a bar under the cursor when mouse right button is pressed. Then only changes that one bar while holding down mouse right button.

Toggle Lock with Ctrl + Shift + Right Drag behaves as line edit. When right mouse button (RMB) is pressed, it holds the opposite state of the bar below mouse cursor, then use the state for the rest of bars. For example, if RMB is pressed on a locked bar, dragging unlocks bars while holding down RMB.

Some BarBox has scroll bar to zoom in. Scroll bar has handles on left end and right end. To control zoom, use Left Drag on one of the handle. Scroll bar also has following controls:

If the image is small, use Ctrl + Mouse Wheel or “View Image” on right click menu to scale.

Diagram only shows overview. It’s not exact implementation.

4 big controls on top right.

Attack, Decay

Gain envelope attack and decay for each oscillator.

Gain

Gain for each oscillator.

Saturation

Saturation gain for each oscillator.

Boost, Gain

Both controls output gain. Peak value of output will be Boost * Gain.

Add Aliasing

When checked, the synth enables rendering of sine waves over nyquist frequency.

Roughly speaking, nyquist frequency is the highest frequency that can be reconstructed from recorded digital signal. When generating sound, it’s possible to set value that is higher than nyquist frequency. However, the result may contain unexpected frequency due to a phenomenon called aliasing. Add Aliasing is option to add those aliasing noise.

Octave

Note octave.

Multiply, Modulo

Change sine wave frequency.

Equation is noteFrequency * (1 + fmod(Multiply * pitch, Modulo)). pitch is calculated from note pitch and overtone index. fmod(a, b) is a function that returns reminder of a / b.

Expand

Scaling factor for overtone controls.

Shift

Amount of right shift to overtone controls.

Randomize parameters. These are more effective when used with Unison.

Retrigger

When checked, reset random seed for each note-on.

Seed

Random seed. This value change random number sequence.

To Gain, To Attack, To Decay, To Sat.

Amount of randomization to overtone controls. Equation is value * random. Range of random is [0.0, 1.0).

To Pitch

Amount of randomization to pitch.

To Phase

Amount of randomization to phase.

Smooth

Time length to change some parameter value to current one. Unit is in second.

List of parameters related to Smooth. * represents wild card.

Other parameter uses the value obtained from the timing of note-on for entire duration of a note.

nVoices

Maximum polyphony. Lowering the number of this option reduces CPU load.

Unison

When checked, unison is enabled.

When unison is enabled, 1 note uses 2 voices. 1 voice is placed on left and other is placed on right. Combining Unison with Random.To Phase, Random.To Pitch, etc. can be used to make sound with stereo spread.

Attack*, Decay*

Multiplier for Attack/Decay in overtone control section.

Declick

When checked, it reduces click noise that occurs when the value of Attack and/or Decay is 0.

Gain^

Exponent to Gain in overtone control. Following is the equation of gain of an oscillator.

Gain.Boost * Gain.Gain * pow(Overtone.Gain, Modifier.Gain^)
Sat. Mix

Mixing ratio of dry/wet signal of saturation. Dry : Wet becomes 0 : 1 when turned the knob to rightmost.

nStages

Number of all-pass filter.

Mix

Mixing ratio of dry/wet signal of phaser. Dry : Wet becomes 0 : 1 when turned the knob to rightmost.

Freq

LFO frequency.

Feedback

Amount of feedback. Feedback is disabled when the knob is pointing to 12 o’clock. It becomes negative feedback when turned to left and positive feedback when turned to right.

Range

Range of all-pass filter modulation by LFO.

Min

Minimum value of all-pass filter modulation by LFO.

Offset

LFO phase offset.

Phase

LFO phase. This can be used to make sound with automation. Turning Freq to leftmost sets LFO frequency to 0.

EnvelopedSine is licensed under GPLv3. Complete licenses are linked below.

If the link above doesn’t work, please send email to ryukau@gmail.com.

VST is a trademark of Steinberg Media Technologies GmbH, registered in Europe and other countries.