Update: 2024-09-28
UltraSynth is an ordinary synthesizer except 64-fold oversampling that is the same one used in UltrasonicRingMod. Because of the high oversampling ratio, modulation sound is okay. However CPU load is high.
full
- VST 3 (github.com) macOS
- VST 3 (github.com) 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:
/Program Files/Common Files/VST3/
for Windows.$HOME/.vst3/
for Linux./Users/$USERNAME/Library/Audio/Plug-ins/VST3/
for
macOS.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.
presets
directory placed in extracted
package.Uhhyou
directory into an OS specific preset
directory (see below).Below is a list of preset directories for each OS.
/Users/$USERNAME/Documents/VST3 Presets
$HOME/.vst3/presets
/Users/$USERNAME/Library/Audio/Presets
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.
Contents/Resources/Documentation
Contents/x86_64-linux
Contents/x86_64-win
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.
sudo spctl --master-disable
.Beware that steps above degrades security of your system. To revert the settings, follow the steps below.
sudo spctl --master-enable
.codesign
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:
/Users/USERNAME/AppData/Roaming/UhhyouPlugins/style/style.json
on Windows.$XDG_CONFIG_HOME/UhhyouPlugins/style/style.json
on
Linux.
$XDG_CONFIG_HOME
is empty, make
$HOME/.config/UhhyouPlugins/style/style.json
./Users/$USERNAME/Library/Preferences/UhhyouPlugins/style/style.json
on macOS.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.
fontFamily
: Font family name.fontBold
: Enable bold style when
true
, disable when false
.fontItalic
: Enable italic style when
true
, disable when false
.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.
foreground
: Text color.foregroundButtonOn
: Text color of active toggle
button. Recommend to use the same value of foreground
or
boxBackground
.foregroundInactive
: Text color of inactive
components. Currently, only used for TabView.background
: Background color.boxBackground
: Background color of inside of box
shaped components (Barbox, Button, Checkbox, OptionMenu, TextKnob,
VSlider).border
: Border color of box shaped components.borderCheckbox
: Border color of CheckBox.borderLabel
: Line color of parameter section
label.unfocused
: Color to fill unfocused components.
Currently, only used for knobs.highlightMain
: Color to indicate focus is on a
component. Highlight colors are also used for value of slider
components (BarBox and VSlider).highlightAccent
: Same as highlightMain
.
Used for cosmetics.highlightButton
: Color to indicate focus is on a
button.highlightWarning
: Same as highlightMain
,
but only used for parameters which requires extra caution.overlay
: Overlay color. Used to overlay texts and
indicators.overlayHighlight
: Overlay color to highlight current
focus.Right Click on the controls pops up a context menu provided by DAW.
Knob and slider provides following controls:
dB
) parameters,
floor is applied after the value is converted to amplitude.XY pad provides 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.
Output gain.
Mixing ratio of full wave rectified signal.
Mixing ratio of the signal distorted by square root.
Gain envelope parameters.
A
: Attack time.D
: Decay time.S
: Sustain amplitude.R
: Release time after note-off.UltraSynth has 2 oscillators. The parameters of each oscillator matchs to X or Y axis of X-Y pad.
Oscillator pitch.
The value is not visible on GUI, but the unit is cent, which is 1/100 of a semitone.
Oscillator wave shape.
When Saw-Pulse
is 0, the value [0, 0.5, 1] matches to
[Upward Sawtooth, Triangle, Downward Sawtooth]. When
Saw-Pulse
is 1, the value becomes the duty ratio of pulse
wave.
Mixing ratio of sawtooth and pulse wave in a oscillator.
When Saw-Pulse
is 0, oscillator outputs sawtooth wave.
When Saw-Pulse
is 1, oscillator outputs pulse wave.
Pitch of oscillator in octave.
Mixing ratio of 2 oscillators.
When Mix
is 0, you can only hear oscillator X output.
When Mix
is 1, you can only hear oscillator Y output.
Modulation gain of filter output to oscillator X.
Cross phase modulation amount.
Horizontal (X) axis constrols Y to X modulation, and vertical (Y) axis controls X to Y modulation.
Feedback phase modulation amount.
Horizontal (X) axis constrols X to X modulation, and vertical (Y) axis controls Y to Y modulation.
Lowpass filter parameters.
Cutoff frequency of lowpass filter.
Q factor of lowpass filter.
Cutoff envelope parameters.
A
: Attack time.D
: Decay time.Modulation amount from envelope to cutoff frequency.
Cutoff tuning ratio depending on the pitch of note.
When set to leftmost, cutoff frequency doesn’t change regardless of the pitch of note. When set to rightmost, cutoff frequency precisely follows the pitch of note.
Pitch in semitone or cent. 1 semitone equals to 100 cents.
Equal Temp.
is abbreviation of equal temperament (ET).
When Equal Temp.
is 12, then the tuning becomes standard
12 ET. Setting Equal Temp.
to less than 12 might increase
the range of note that doesn’t change sound, or doesn’t output sound.
This is due to the internal pitch becomes too high or too low.
A4 [Hz]
is freqeuncy of note A4.
Range of pitch bend in semitone.
Rate of LFO.
When Sync.
is turned off, Rate
becomes
the frequency of LFO. When Sync.
is turned on,
Rate
becomes the multiplier to the interval of
synchronization. For example, if Rate
is 2 and
Sync.
is turned off, LFO cycles at 2 Hz. If
Rate
is 2 and Sync.
is turned on, the
interval of synchronization becomes half (1/2).
LFO distortion amount.
The wave shape becomes close to square wave when Shape
is set to rightmost.
When checked, it resets LFO phase to 0 for each note-on.
When checked, it enables tempo synchronization.
These are the numbers on the right side of Sync.
checkbox. They indicates the interval of synchronization in beats.
Note that Sync. Upper
and Sync. Lower
are
not time signature, but beats in fractional number. For example, if
time signature is set to 3/4, and Sync. Upper
and
Sync. Lower
are both set to 1, LFO cycles 3 time in a
bar.
Following is the calculation of the interval of synchronization.
syncIntervalInBeats = (Sync. Upper) / (Sync. Lower).
LFO modulation amount for oscillator pitch.
LFO modulation amount for Oscillator -> Mix
.
LFO modulation amount for filter cutoff frequency.
LFO modulation amount for the amplitude of signal right before
passing Sat.
.
LFO modulation amount for Wave Shape
.
When checked, it resets oscillator phase at note-on, only if gain envelope is resting.
Gain envelope rests when the output value after release becomes sufficiently small. Therefore, if note-on is given when you are still perceiving release of the previous note, the oscillator phase won’t reset because gain envelope is not resting. Also note that when release time is long, it’s hard to determine if gain envelope is resting or not by using hearing.
Time to slide the pitch of latest note.
style.json
crashes
plugin.foregroundInactive
.processContext
is
nullptr
.virtual
to destructor of common components.
This may prevent some cause of crash or memory leak.UltraSynth 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.