Back to Index

Update: 2022-09-09

Table of Contents

WaveCymbal

WaveCymbal is an attempt to make a cymbal synthesizer with banded wave-guide model. The result is more like dragging bunch of empty cans or thin metal plate on asphalt rather than cymbal.

The package includes following builds:

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

Contact

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

You can fund the development through paypal.me/ryukau. Current goal is to purchase M1 mac for better macOS support. 💸💻

Installation

Plugin

Place *.vst3 directory to:

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

Presets

Extract preset zip, then place preset directory to the OS specific path:

Preset directory name must be the same as the plugin. Make Uhhyou directory if it does not exist.

Windows Specific

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

Linux Specific

On Ubuntu 18.0.4, 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.

macOS Specific

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 following command to unzipped .vst3 directory.

xattr -rc /path/to/PluginName.vst3

Plugin may be considered as unsigned/un-notarized application. In this case, 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.

Reference

GUI Style Configuration

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.

Below is a 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"
}

Font Options

Following is a list of font options.

To use custom font, place *.ttf file into custom font path: *.vst3/Contents/Resources/Fonts.

Notice: If the combination of fontFamily, fontBold, fontItalic is not exists 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 exists, 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.

Color Options

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.

Controls

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

Knob and slider can do:

Caution

Parameters that turns red when pointing can drastically change output gain. Changing those parameters with Shift + Left Drag is recommended. To prevent sudden clipping, always insert limiter after WaveCymbal.

Block Diagram

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.

Parameters

Gain

Output gain.

Excitation

Short delays that turns impulse to tone.

Feedback

Feedback of excitor delays.

Time

Delay time of excitor delays. Beware that when the value of this parameter is high, output will be loud.

Objects

nCymbal

Number of cymbal-ish objects.

nString

Number of Karplus-Strong string per cymbal object.

Wave

Damping

Damping of 1D wave simulation. Beware that when the value of this parameter is high, output will be loud.

PulsePosition

Position where oscillator input causes wave.

PulseWidth

Width of wave caused by oscillator input.

Collision

When turns on, it sounds like a rubbing on surface of thin light metal plate. When nCymbal is 1, this doesn’t change output sound.

Distance

Distance between cymbals. Collision will more likely to occur when turning this knob to left.

Random

Seed

Random seed. Output will be the same for each note while checking Retrigger.

Amount

Amount of random number effects to delay time and band-pass cutoff. Beware that when the value of this parameter is low, output may be loud.

String

MinHz

Lower bound of Karplus-Strong string frequency.

MaxHz

Upper bound of Karplus-Strong string frequency.

Decay

Decay of Karplus-Strong string. Decay time will be longer when turning this knob to left.

Q

Band-pass filter Q.

Oscillator

Retrigger

When checking, each note on resets random seed.

OscType

Oscillator type.

Bandpass Cutoff Distribution

Smoothness

Transition time from previous value to current value in seconds. Gain, Excitation.Time, Random.Amount, Bandpass.MinCutoff, Bandpass.MaxCutoff will be affected. Slide effect of OscType.Sustain can be tuned by Smoothness.

Change Log

Old Versions

License

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

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

About VST

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