diff --git a/docs/manual/SpectralPhaser/SpectralPhaser.json b/docs/manual/SpectralPhaser/SpectralPhaser.json
new file mode 100644
index 00000000..2dbfe3e4
--- /dev/null
+++ b/docs/manual/SpectralPhaser/SpectralPhaser.json
@@ -0,0 +1,14 @@
+{
+ "SpectralPhaser": {
+ "latest_version": "0.1.0",
+ "urls": {
+ "plugin_url": [
+ "https://github.com/ryukau/VSTPlugins/releases/download/UhhyouPlugins0.64.0/SpectralPhaser_0.1.0.zip"
+ ],
+ "preset_url": []
+ },
+ "changelog": {
+ "0.1.0": { "en": ["Initial release."], "ja": ["初期リリース。"] }
+ }
+ }
+}
diff --git a/docs/manual/SpectralPhaser/SpectralPhaser_en.html b/docs/manual/SpectralPhaser/SpectralPhaser_en.html
new file mode 100644
index 00000000..6484ba53
--- /dev/null
+++ b/docs/manual/SpectralPhaser/SpectralPhaser_en.html
@@ -0,0 +1,888 @@
+
+
+
+
+
+
+
+
+ SpectralPhaser_en – Uhhyou Plugins
+
+
+
+
+
+
+
+ Back to Index
+
+ Update: 2024-10-23
+
+
+ Table of Contents
+
+
+
+
+
+
+
+ SpectralPhaser is an effect that produces a phaser-like sound by
+ applying a mask in the frequency domain. In addition to FFT, fast
+ Walsh-Hadamard transform (FWHT) and Haar transform are available.
+
+ Note : Presets produce the expected sound only if
+ the sampling rate is 48000 Hz.
+ full
package contains following builds.
+
+ Windows (x86_64)
+ Linux (x86_64)
+ macOS (Universal 2)
+
+ 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.
+
+ Download plugin from a link at the top of this page.
+ Extract downloaded zip file.
+ Open presets
directory placed in extracted
+ package.
+ Move Uhhyou
directory into an OS specific preset
+ directory (see below).
+
+ Below is a list of preset directories for each OS.
+
+ Windows :
+ /Users/$USERNAME/Documents/VST3 Presets
+ Linux : $HOME/.vst3/presets
+ macOS : /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.
+
+ Open terminal and run
+ sudo spctl --master-disable
.
+ 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.
+
+ Go to System Preferences → Security and Privacy → General → Allow
+ apps downloaded from, then select option to “App Store and identified
+ developers”.
+ 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:
+
+ /Users/USERNAME/AppData/Roaming/UhhyouPlugins/style/style.json
+ on Windows.
+ $XDG_CONFIG_HOME/UhhyouPlugins/style/style.json
on
+ Linux.
+
+ If $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.
+
+ 6 digit color is RGB.
+ 8 digit color is RGBA.
+
+ 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:
+
+ Ctrl + Left Click : Reset value.
+ Shift + Left Drag : Fine adjustment.
+ Middle Click : Rotate through minimum, default and
+ maximum value.
+ Shift + Middle Click : Take floor of current
+ value.
+
+ Note : For decibel (dB
) parameters,
+ floor is applied after the value is converted to amplitude.
+
+
+
+ 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.
+
+
+ Characters inside of square brackets [] represents unit. Following
+ is a list of units used in SpectralPhaser.
+
+
+
+ Output [dB]
+
+ Output gain.
+
+ Dry/Wet
+
+ Mixing ratio of input and effect output.
+ 0 is input only, 1 is effect output only.
+
+ Side Chain
+
+ When enabled, the sidechain input is used for frequency
+ masking.
+ SpectralPhaser could be used as a vocoder when both
+ Side Chain
and Latency
are enabled. In this
+ case, set Frame Size
to around 2048. If
+ Frame Size
is small, the effect will be weaker.
+ The vocoder mode is not suitable for real-time use because latency
+ is high.
+
+ Latency
+
+ When enabled, Frame Size
will be used as latency in
+ samples.
+
+
+
+
+ Waveform
+
+ LFO waveform.
+
+ Wave Mod.
+
+ LFO waveform modifier.
+
+ Phase
+
+ Initial phase of LFO.
+
+ Stereo
+
+ Phase offset of LFOs between left and right channels.
+
+ Rate
+
+ LFO frequency multiplier.
+ This can be useful to slightly shift the tempo sync timing.
+
+ Sync.
+
+ Interval of LFO tempo synchronization.
+ 2 numbers corresponds to the numerals in time signatur.
+ (left/right
= upper/lower
).
+
+ Left number correspond to upper numeral of time signature.
+ Right number correspond to lower numeral of time signature
+
+ The plugin receives musical time as beats, where a beat has a
+ relative length depending on the time signature. Here are some
+ examples:
+
+ 1 / 1 synchronizes to 1 bar.
+ 1 / 4 synchronizes to 1 beat (a quarter note), when time signature
+ is N / 4.
+ 1 / 6 synchronizes to 1 beat, when time signature is N / 6.
+ 3 / 16 synchronizes to 3 / 4 beat (a dotted 8th note), when time
+ signature is N / 4.
+
+ When time signature is changed, there may be a momentary loss of
+ sync immediately after the change.
+
+
+
+
+ Transform
+
+ Type of time to frequency transformation.
+ FFT is the normal choice, FWHT and Haar will sound rough.
+ Attention : Changing Transform
stops
+ the sound for duration of Frame Size
. This is because the
+ buffer is reset to avoid loud bursts.
+
+ Frame Size
+
+ Length of a frame over which a transform is performed.
+ Frame Size
also represents delay time in samples.
+ When Latency
is enabled, Frame Size
will
+ be used as latency in samples.
+ When Frame Size
is large and DAW buffer size is small,
+ the sound may stutter. In this case, reduce Frame Size
to
+ reduce CPU load.
+
+ Feedback
+
+ Feedback gain of delay.
+
+
+
+ LFO modulation can be changed by the small knobs on right side of
+ parameter value.
+
+ Waveform
+
+ Waveform of frequency mask.
+
+ Mix
+
+ Mixing ratio of frequency mask.
+ 0 means no masking, 1 means full masking.
+
+ Phase
+
+ Phase of the frequency mask waveform.
+ Modulating Phase
with an LFO produces a sound similar
+ to a phaser.
+
+ Freq.
+
+ Frequency of frequency mask waveform.
+ Higher the Freq.
, more notches.
+ Setting Freq.
to 0 disables frequency masking.
+
+ Threshold
+
+ When a value in a frequency mask is less than
+ Threshold
, the corresponding frequency is set to
+ zero.
+
+ Rotation
+
+ Amount of phase rotation in the frequency domain.
+ This only applies when Transform
is FFT; when other
+ orthogonal transforms are selected, Rotation
is used as
+ an amount to swap frequency components.
+
+ Spectral Shift
+
+ Frequency shift amount for each feedback.
+
+ Octave Down
+
+ Amount of octave down effect. Octave down is applied for each
+ feedback.
+ Depending on the settings, the effect may not be noticeable. To get
+ the effect, try setting Feedback
to 1 and
+ Octave Down
to around 0.1.
+
+
+
+
+
+ N/A.
+
+ SpectralPhaser 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.
+
+
+
+
+
diff --git a/docs/manual/SpectralPhaser/SpectralPhaser_en.md b/docs/manual/SpectralPhaser/SpectralPhaser_en.md
new file mode 100644
index 00000000..47969a44
--- /dev/null
+++ b/docs/manual/SpectralPhaser/SpectralPhaser_en.md
@@ -0,0 +1,203 @@
+---
+lang: en
+...
+
+# SpectralPhaser
+![](img/SpectralPhaser.png)
+
+SpectralPhaser is an effect that produces a phaser-like sound by applying a mask in the frequency domain. In addition to FFT, fast Walsh-Hadamard transform (FWHT) and Haar transform are available.
+
+{% for target, download_url in latest_download_url["SpectralPhaser"].items() %}
+- [Download SpectralPhaser {{ latest_version["SpectralPhaser"] }} `{{ target }}` - VST 3 (github.com)]({{ download_url }})
+{%- endfor %}
+{%- if preset_download_url["SpectralPhaser"]|length != 0%}
+- [Download Presets (github.com)]({{ preset_download_url["SpectralPhaser"] }})
+{%- endif %}
+
+**Note**: Presets produce the expected sound only if the sampling rate is 48000 Hz.
+
+{{ section["package"] }}
+
+{{ section["contact_installation_guiconfig"] }}
+
+## Controls
+{{ section["gui_common"] }}
+
+{{ section["gui_knob"] }}
+
+## 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.
+
+![](img/SpectralPhaser.svg)
+
+## Parameters
+Characters inside of square brackets \[\] represents unit. Following is a list of units used in SpectralPhaser.
+
+- \[dB\] : Decibel.
+
+### Mix
+Output \[dB\]
+
+: Output gain.
+
+Dry/Wet
+
+: Mixing ratio of input and effect output.
+
+ 0 is input only, 1 is effect output only.
+
+Side Chain
+
+: When enabled, the sidechain input is used for frequency masking.
+
+ SpectralPhaser could be used as a vocoder when both `Side Chain` and `Latency` are enabled. In this case, set `Frame Size` to around 2048. If `Frame Size` is small, the effect will be weaker.
+
+ The vocoder mode is not suitable for real-time use because latency is high.
+
+Latency
+
+: When enabled, `Frame Size` will be used as latency in samples.
+
+### LFO
+Waveform
+
+: LFO waveform.
+
+Wave Mod.
+
+: LFO waveform modifier.
+
+Phase
+
+: Initial phase of LFO.
+
+Stereo
+
+: Phase offset of LFOs between left and right channels.
+
+Rate
+
+: LFO frequency multiplier.
+
+ This can be useful to slightly shift the tempo sync timing.
+
+Sync.
+
+: Interval of LFO tempo synchronization.
+
+ 2 numbers corresponds to the numerals in time signatur. (`left/right` = `upper/lower`).
+
+ - Left number correspond to upper numeral of time signature.
+ - Right number correspond to lower numeral of time signature
+
+ The plugin receives musical time as beats, where a beat has a relative length depending on the time signature. Here are some examples:
+
+ - 1 / 1 synchronizes to 1 bar.
+ - 1 / 4 synchronizes to 1 beat (a quarter note), when time signature is N / 4.
+ - 1 / 6 synchronizes to 1 beat, when time signature is N / 6.
+ - 3 / 16 synchronizes to 3 / 4 beat (a dotted 8th note), when time signature is N / 4.
+
+ When time signature is changed, there may be a momentary loss of sync immediately after the change.
+
+### Delay
+Transform
+
+: Type of time to frequency transformation.
+
+ FFT is the normal choice, FWHT and Haar will sound rough.
+
+ **Attention**: Changing `Transform` stops the sound for duration of `Frame Size`. This is because the buffer is reset to avoid loud bursts.
+
+Frame Size
+
+: Length of a frame over which a transform is performed.
+
+ `Frame Size` also represents delay time in samples.
+
+ When `Latency` is enabled, `Frame Size` will be used as latency in samples.
+
+ When `Frame Size` is large and DAW buffer size is small, the sound may stutter. In this case, reduce `Frame Size` to reduce CPU load.
+
+Feedback
+
+: Feedback gain of delay.
+
+### Mask
+LFO modulation can be changed by the small knobs on right side of parameter value.
+
+Waveform
+
+: Waveform of frequency mask.
+
+Mix
+
+: Mixing ratio of frequency mask.
+
+ 0 means no masking, 1 means full masking.
+
+Phase
+
+: Phase of the frequency mask waveform.
+
+ Modulating `Phase` with an LFO produces a sound similar to a phaser.
+
+Freq.
+
+: Frequency of frequency mask waveform.
+
+ Higher the `Freq.`, more notches.
+
+ Setting `Freq.` to 0 disables frequency masking.
+
+Threshold
+
+: When a value in a frequency mask is less than `Threshold`, the corresponding frequency is set to zero.
+
+Rotation
+
+: Amount of phase rotation in the frequency domain.
+
+ This only applies when `Transform` is FFT; when other orthogonal transforms are selected, `Rotation` is used as an amount to swap frequency components.
+
+Spectral Shift
+
+: Frequency shift amount for each feedback.
+
+Octave Down
+
+: Amount of octave down effect. Octave down is applied for each feedback.
+
+ Depending on the settings, the effect may not be noticeable. To get the effect, try setting `Feedback` to 1 and `Octave Down` to around 0.1.
+
+## Change Log
+{%- for version, logs in changelog["SpectralPhaser"].items() %}
+- {{version}}
+ {%- for log in logs["en"] %}
+ - {{ log }}
+ {%- endfor %}
+{%- endfor %}
+
+## Old Versions
+{%- if old_download_link["SpectralPhaser"]|length == 0 %}
+N/A.
+{%- else %}
+ {%- for x in old_download_link["SpectralPhaser"] %}
+- [SpectralPhaser {{ x["version"] }} - VST 3 (github.com)]({{ x["url"] }})
+ {%- endfor %}
+{%- endif %}
+
+## License
+SpectralPhaser is licensed under GPLv3. Complete licenses are linked below.
+
+- [https://github.com/ryukau/VSTPlugins/tree/master/License](https://github.com/ryukau/VSTPlugins/tree/master/License)
+
+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.
diff --git a/docs/manual/SpectralPhaser/SpectralPhaser_ja.html b/docs/manual/SpectralPhaser/SpectralPhaser_ja.html
new file mode 100644
index 00000000..6be40c4d
--- /dev/null
+++ b/docs/manual/SpectralPhaser/SpectralPhaser_ja.html
@@ -0,0 +1,883 @@
+
+
+
+
+
+
+
+
+ SpectralPhaser_ja – Uhhyou Plugins
+
+
+
+
+
+
+
+ Back to Index
+
+ Update: 2024-10-23
+
+
+ Table of Contents
+
+
+
+
+
+
+
+ SpectralPhaserスペクトラル フェイザ
+ は周波数領域でマスクをかけることでフェイザのような音が出るエフェクタです。
+ FFT に加えて、高速 Walsh-Hadamard 変換 (FWHT) 、 Haar
+ 変換といった直行変換が使えます。
+
+ 注意 : プリセットはサンプリング周波数が 48000 Hz
+ でなければ想定された音が出ません。
+ full
パッケージには次のビルドが含まれています。
+
+ Windows (x86_64)
+ Linux (x86_64)
+ macOS (Universal 2)
+
+ Linux ビルドは Ubuntu 24.04 でビルドしています。もし Ubuntu 24.04
+ 以外のディストリビューションを使っているときは、プラグインが読み込まれないなどの不具合が起こることがあります。この場合はビルド手順 に沿ってソースコードからビルドしてください。
+ macOS で使用するときは macOS
+ パッケージのダウンロードを推奨します。また Apple Developer Program
+ に加入していないので、インストール時に Gatekeeper
+ を迂回するように設定する必要があります。詳細は
+ インストール -> macOS
+ の節を参照してください。
+
+ 何かあれば GitHub
+ のリポジトリ に issue を作るか ryukau@gmail.com
+ までお気軽にどうぞ。
+ paypal.me/ryukau
+ から開発資金を投げ銭することもできます。
+
+
+ 名前が .vst3
で終わるディレクトリを OS
+ ごとに決められた位置に配置してください。
+
+ Windows では /Program Files/Common Files/VST3/
+ に配置します。
+ Linux では $HOME/.vst3/
に配置します。
+ macOS では /Library/Audio/Plug-ins/VST3/
あるいは
+ /Users/$USERNAME/Library/Audio/Plug-ins/VST3/
+ に配置します。
+
+ DAW によっては上記とは別に VST3
+ をインストールできるディレクトリを提供していることがあります。詳しくは利用している
+ DAW のマニュアルを参照してください。
+
+ 注意 : プリセットの無いプラグインもあります。
+ プリセットはページの最上部のリンクからダウンロードできるプラグインパッケージに含まれています。以下はプリセットのインストール手順です。
+
+ ページの最上部のリンクからプラグインをダウンロード。
+ ダウンロードした zip ファイルを解凍。
+ presets
ディレクトリ内の Uhhyou
+ ディレクトリを OS ごとに決められたディレクトリに配置。
+
+ 以下は OS ごとのプリセットの配置先の一覧です。
+
+ Windows :
+ /Users/$USERNAME/Documents/VST3 Presets
+ Linux : $HOME/.vst3/presets
+ macOS : /Users/$USERNAME/Library/Audio/Presets
+
+ プリセットディレクトリの名前はプラグインと同じである必要があります。配置先のディレクトリが無いときは作成してください。
+
+
+ プラグインが DAW に認識されないときは C++ redistributable
+ をインストールしてみてください。インストーラは次のリンクからダウンロードできます。ファイル名は
+ vc_redist.x64.exe
です。
+
+
+ Ubuntu 24.04 では次のパッケージのインストールが必要です。
+ sudo apt install libxcb-cursor0 libxkbcommon-x11-0
+ もし DAW がプラグインを認識しないときは、下のリンクの
+ Package Requirements
を参考にして VST3
+ に必要なパッケージがすべてインストールされているか確認してください。
+
+ REAPER の Linux 版がプラグインを認識しないときは
+ ~/.config/REAPER/reaper-vstplugins64.ini
を削除して
+ REAPER を再起動してみてください。
+
+ 重要 : full
+ パッケージは動作未確認です。以下のファイルは codesign
+ されていないので削除する必要があるかもしれません。
+
+ Contents/Resources/Documentation
+ Contents/x86_64-linux
+ Contents/x86_64-win
+
+ macOS
+ パッケージでは上記のファイルの削除は不要です。また、すべてのパッケージは
+ codesign
コマンドの ad-hoc signing
+ の状態になっています。
+
+ プラグインの初回起動時に「破損している」という趣旨のメッセージが表示されることがあります。この場合は、ターミナルを開いて、解凍した
+ .vst3
+ ディレクトリに次のコマンドのどちらか、あるいは両方を適用してみてください。
+ /path/to/PluginName.vst3
+ の部分はインストールしたプラグインのパスに置き換えてください。
+ xattr -rd com.apple.quarantine /path/to/PluginName.vst3
+xattr -rc /path/to/PluginName.vst3
+
+ プラグインは署名されていない (unsigned) 、または公証されていない
+ (un-notarized)
+ アプリケーションとして認識されることがあります。この場合は、警告メッセージが表示された後に、システム環境設定を開いて「セキュリティとプライバシー」
+ → 「一般」の「このまま開く」ボタンを押してください。以下にリンクした
+ Apple
+ 公式のヘルプページにスクリーンショット付きで同じ手順が掲載されています。「ノータリゼーションを受けていない
+ App や未確認の開発元の App を開きたい場合」を参照してください。
+
+ ここまでの手順を経てまだ動かないときはインストール先を
+ /Library/Audio/Plug-ins/VST3/
あるいは
+ /Users/$USERNAME/Library/Audio/Plug-ins/VST3/
+ のいずれか使っていなかったほうに変えてみてください。
+ 上記の方法がすべて上手くいかなかったときは以下の手順を試してみてください。
+
+ ターミナルを開いて sudo spctl --master-disable
+ を実行。
+ システム環境設定を開いて「セキュリティとプライバシー」 → 「一般」
+ →
+ 「ダウンロードしたアプリケーションの実行許可」と辿り、「全てのアプリケーションを許可」を選択。
+
+ 上記の手順を実行するとシステムのセキュリティが弱くなるので注意してください。元に戻すには以下の手順を実行してください。
+
+ システム環境設定を開いて「セキュリティとプライバシー」 → 「一般」
+ → 「ダウンロードしたアプリケーションの実行許可」と辿り、「App Store
+ と認証済みの開発元からのアプリケーションを許可」を選択。
+ ターミナルを開いて sudo spctl --master-enable
+ を実行。
+
+
+ 注意 この節の内容は macOS
+ パッケージには関連しないと考えられますが未検証です。 (GitHub の
+ issue )
+ full
+ パッケージを利用する場合は以下のコマンドを適用することで利用できるかもしれません。
+ sudo codesign --force --deep -s - /path/to/PluginName.vst3
+ codesign
の利用には Xcode
+ のインストールが必要となるかもしれません。
+
+
+
+ 初回設定時は手動で次のファイルを作成してください。
+
+ Windows では
+ /Users/ユーザ名/AppData/Roaming/UhhyouPlugins/style/style.json
+ 。
+ Linux では
+ $XDG_CONFIG_HOME/UhhyouPlugins/style/style.json
。
+
+ $XDG_CONFIG_HOME
が空のときは
+ $HOME/.config/UhhyouPlugins/style/style.json
。
+
+ macOS では
+ /Users/$USERNAME/Library/Preferences/UhhyouPlugins/style/style.json
+ 。
+
+ プラグインのウィンドウを開くたびに style.json
+ が読み込まれて更新されます。
+ 既存の色のテーマを次のリンクに掲載しています。
+ style.json
にコピペして使ってください。
+
+ 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"
+}
+
+ 以下はフォントオプションの一覧です。
+
+ fontFamily
: フォントファミリ名。
+ fontBold
: ボールドスタイル (太字) を
+ true
で有効、 false
で無効。
+ fontItalic
: イタリックスタイル (斜体) を
+ true
で有効、 false
で無効。
+
+ カスタムフォントを使用するには、プラグインディレクトリの
+ *.vst3/Contents/Resources/Fonts
に *.ttf
+ ファイルを配置します。
+ 注意 : fontFamily
、
+ fontBold
、 fontItalic
+ で設定したフォントファミリ名とスタイルの組み合わせが
+ *.vst3/Contents/Resources/Fonts
以下のいずれかの
+ *.ttf
ファイルに含まれていないときは VSTGUI
+ が指定するデフォルトフォントが使用されます。
+ fontFamily
が長さ 0 の文字列 ""
+ のときはフォールバックとして "Tinos"
+ に設定されます。長さが 1
+ 以上かつ、存在しないフォントファミリ名が指定されると VSTGUI
+ が指定するデフォルトフォントが使用されます。
+ ボールドあるいはイタリック以外のスタイルは VSTGUI
+ がサポートしていないので動作確認していません。該当する例としては Noto
+ フォントの Demi Light や、 Roboto フォントの Thin や Black
+ などがあります。
+
+ 16 進数カラーコードを使っています。
+
+ 6 桁の色は RGB 。
+ 8 桁の色は RGBA 。
+
+ プラグインはカラーコードの 1 文字目を無視します。よって
+ ?102938
や \n11335577
+ も有効なカラーコードです。
+ 2 文字目以降のカラーコードの値に 0-9a-f
+ 以外の文字を使わないでください。
+ 以下は設定できる色の一覧です。設定に抜けがあるとデフォルトの色が使われます。
+
+ foreground
: 文字の色。
+ foregroundButtonOn
:
+ オンになっているボタンの文字の色。 foreground
か
+ boxBackground
+ のいずれかと同じ値にすることを推奨します。
+ foregroundInactive
:
+ 非アクティブなタブの文字の色。
+ background
: 背景色。
+ boxBackground
: 矩形の UI 部品の内側の背景色。
+ border
: 縁ふち の色。
+ borderCheckbox
: チェックボックスの縁の色。
+ borderLabel
:
+ パラメータセクションのラベルの左右の直線の色。
+ unfocused
:
+ つまみがフォーカスされていないときの色。
+ highlightMain
:
+ フォーカスされたときの色。スライダの値の表示にも使用されます。
+ highlightAccent
:
+ フォーカスされたときの色。一部のプラグインをカラフルにするために使用されます。
+ highlightButton
:
+ ボタンがフォーカスされたときの色。
+ highlightWarning
: 変更に注意を要する UI
+ がフォーカスされたときの色。
+ overlay
: オーバーレイの色。
+ overlayHighlight
:
+ フォーカスを示すオーバーレイの色。
+
+
+ パラメータが割り当てられているコントロールの上で
+ 右クリック すると、 DAW
+ から提供されるコンテキストメニューが開きます。
+ つまみと数値スライダでは次の操作ができます。
+
+ Ctrl + 左クリック : 値のリセット。
+ Shift + 左ドラッグ : 細かい値の変更。
+ ホイールクリック :
+ 最小値、デフォルト値、最大値の切り替え。
+ Shift + ホイールクリック :
+ 現在値の小数点以下を切り捨て。
+
+ 注意 :
+ デシベル表記のパラメータは、振幅に変換された後の値について切り捨て。
+
+
+
+ 図が小さいときはブラウザのショートカット Ctrl +
+ マウスホイール
+ や、右クリックから「画像だけを表示」などで拡大できます。
+ 図で示されているのは大まかな信号の流れです。実装と厳密に対応しているわけではないので注意してください。
+
+
+ 角かっこ [] で囲まれているのは単位です。以下は単位の一覧です。
+
+ [dB] : デシベル (decibel) 。
+
+
+
+ Output [dB]
+
+ 出力ゲインです。
+
+ Dry/Wet
+
+ 入力と、エフェクトのかかった出力の比率です。
+ 0 のとき入力のみ、 1 のときエフェクト出力のみになります。
+
+ Side Chain
+
+ 有効にするとサイドチェイン入力を周波数マスクに使います。
+ Latency
+ と同時に有効にすることでボコーダーになります。このとき
+ Frame Size
は 2048 あたりに設定してください。
+ Frame Size
が小さいと効果が薄くなります。
+ ボコーダーとしての使用は大きなレイテンシが出るため、リアルタイム向けではありません。
+
+ Latency
+
+ 有効にすると Frame Size
+ で設定したサンプル数をレイテンシとして DAW に伝えます。
+
+
+
+
+ Waveform
+
+ LFO の波形です。
+
+ Wave Mod.
+
+ LFO の波形を変えるパラメータです。
+
+ Phase
+
+ LFO の初期位相です。
+
+ Stereo
+
+ LFO の位相を左右でずらす量です。
+
+ Rate
+
+ LFO の周波数の倍率です。
+ テンポシンクを少しずらしたいときなどに使えます。
+
+ Sync.
+
+ LFO の周波数の同期間隔です。
+ 左右の数は、それぞれ拍子記号の上下の数字と対応しています。
+ (左 / 右
= 上 / 下
)
+ プラグインは音楽的な経過時間を拍数として受け取ります。そして 1
+ 拍は拍子記号によって長さが相対的に変わります。以下に例をいくつか挙げます。
+
+ 1 / 1 のとき 1 小節に同期。
+ 拍子が N / 4 であれば Sync.
が 1 / 4 のとき 1 拍 (4
+ 分音符) に同期。
+ 拍子が N / 6 であれば Sync.
が 1 / 6 のとき 1
+ 拍に同期。
+ 拍子が N / 4 であれば Sync.
が 3 / 16 のとき 3 / 4 拍
+ (付点 8 分音符) に同期。
+
+ 曲中で拍子記号が変わると、変わった直後に一時的に同期がずれることがあります。
+
+
+
+
+ Transform
+
+ 直行変換の種類です。
+ 通常は FFT を選んでください。 FWHT と Haar
+ はざらざらとした音になります。
+ 注意 : Transform
を変更すると
+ Frame Size
+ の長さだけ音が止まります。爆発的に大きい音を避けるためにバッファがリセットされることが原因です。
+
+ Frame Size
+
+ 直行変換を行うフレームの長さで、単位はサンプル数です。
+ この値がそのままディレイ時間になります。
+ Latency
を有効にしたときは Frame Size
+ と同じサンプル数のレイテンシを DAW に伝えます。
+ Frame Size
が大きく、 DAW
+ のバッファサイズが小さいとき、音がぶつぶつと途切れるようになることがあるかもしれません。このときは計算が間に合っていないので
+ Frame Size
を小さくしてください。
+
+ Feedback
+
+ ディレイのフィードバックです。
+
+
+
+ パラメータの右側の小さいつまみで LFO
+ による変調量を変えられます。
+
+ Waveform
+
+ 周波数マスクの波形です。
+
+ Mix
+
+ 周波数マスクをかける割合です。
+ 0 のときマスクなし、 1 のとき完全にマスクします。
+
+ Phase
+
+ 周波数マスクの波形の位相です。
+ Phase
を LFO
+ で変調するとフェイザと似たような音が出ます。
+
+ Freq.
+
+ 周波数マスクの波形の周波数です。
+ Freq.
が高くなるほど、ノッチの数が多くなります。
+ Freq.
を 0 にすると周波数マスクが無効になります。
+
+ Threshold
+
+ 周波数マスクの値が Threshold
+ よりも小さいとき、その周波数を 0 にします。
+
+ Rotation
+
+ 周波数領域で位相を回転する量です。
+ というのは Transform
が FFT
+ のときだけで、他の直行変換が選択されているときは Rotation
+ に応じて周波数成分の入れ替えが行われます。
+
+ Spectral Shift
+
+ フィードバックごとに周波数成分をシフトする量です。
+
+ Octave Down
+
+ フィードバックごとに周波数成分を約 1
+ オクターブ下に移す割合です。
+ 設定によっては効果があまり出ません。 Feedback
を 1 、
+ Octave Down
を 0.1 あたりに設定すると効果が出ます。
+
+
+
+
+
+ 旧バージョンはありません。
+
+ SpectralPhaser のライセンスは GPLv3 です。 GPLv3
+ の詳細と、利用したライブラリのライセンスは次のリンクにまとめています。
+
+ リンクが切れているときは ryukau@gmail.com
+ にメールを送ってください。
+
+ VST is a trademark of Steinberg Media Technologies GmbH, registered
+ in Europe and other countries.
+
+
+
+
+
diff --git a/docs/manual/SpectralPhaser/SpectralPhaser_ja.md b/docs/manual/SpectralPhaser/SpectralPhaser_ja.md
new file mode 100644
index 00000000..320095a0
--- /dev/null
+++ b/docs/manual/SpectralPhaser/SpectralPhaser_ja.md
@@ -0,0 +1,200 @@
+---
+lang: ja
+...
+
+# SpectralPhaser
+![](img/SpectralPhaser.png)
+
+SpectralPhaserスペクトラル フェイザ は周波数領域でマスクをかけることでフェイザのような音が出るエフェクタです。 FFT に加えて、高速 Walsh-Hadamard 変換 (FWHT) 、 Haar 変換といった直行変換が使えます。
+
+{% for target, download_url in latest_download_url["SpectralPhaser"].items() %}
+- [SpectralPhaser {{ latest_version["SpectralPhaser"] }} `{{ target }}` - VST 3 をダウンロード (github.com)]({{ download_url }})
+{%- endfor %}
+{%- if preset_download_url["SpectralPhaser"]|length != 0%}
+- [プリセットをダウンロード (github.com)]({{ preset_download_url["SpectralPhaser"] }})
+{%- endif %}
+
+**注意**: プリセットはサンプリング周波数が 48000 Hz でなければ想定された音が出ません。
+
+{{ section["package"] }}
+
+{{ section["contact_installation_guiconfig"] }}
+
+## 操作
+{{ section["gui_common"] }}
+
+{{ section["gui_knob"] }}
+
+## ブロック線図
+図が小さいときはブラウザのショートカット Ctrl + マウスホイール や、右クリックから「画像だけを表示」などで拡大できます。
+
+図で示されているのは大まかな信号の流れです。実装と厳密に対応しているわけではないので注意してください。
+
+![](img/SpectralPhaser.svg)
+
+## パラメータ
+角かっこ \[\] で囲まれているのは単位です。以下は単位の一覧です。
+
+- \[dB\] : デシベル (decibel) 。
+
+### Mix
+Output \[dB\]
+
+: 出力ゲインです。
+
+Dry/Wet
+
+: 入力と、エフェクトのかかった出力の比率です。
+
+ 0 のとき入力のみ、 1 のときエフェクト出力のみになります。
+
+Side Chain
+
+: 有効にするとサイドチェイン入力を周波数マスクに使います。
+
+ `Latency` と同時に有効にすることでボコーダーになります。このとき `Frame Size` は 2048 あたりに設定してください。 `Frame Size` が小さいと効果が薄くなります。
+
+ ボコーダーとしての使用は大きなレイテンシが出るため、リアルタイム向けではありません。
+
+Latency
+
+: 有効にすると `Frame Size` で設定したサンプル数をレイテンシとして DAW に伝えます。
+
+### LFO
+Waveform
+
+: LFO の波形です。
+
+Wave Mod.
+
+: LFO の波形を変えるパラメータです。
+
+Phase
+
+: LFO の初期位相です。
+
+Stereo
+
+: LFO の位相を左右でずらす量です。
+
+Rate
+
+: LFO の周波数の倍率です。
+
+ テンポシンクを少しずらしたいときなどに使えます。
+
+Sync.
+
+: LFO の周波数の同期間隔です。
+
+ 左右の数は、それぞれ拍子記号の上下の数字と対応しています。 (`左 / 右` = `上 / 下`)
+
+ プラグインは音楽的な経過時間を拍数として受け取ります。そして 1 拍は拍子記号によって長さが相対的に変わります。以下に例をいくつか挙げます。
+
+ - 1 / 1 のとき 1 小節に同期。
+ - 拍子が N / 4 であれば `Sync.` が 1 / 4 のとき 1 拍 (4 分音符) に同期。
+ - 拍子が N / 6 であれば `Sync.` が 1 / 6 のとき 1 拍に同期。
+ - 拍子が N / 4 であれば `Sync.` が 3 / 16 のとき 3 / 4 拍 (付点 8 分音符) に同期。
+
+ 曲中で拍子記号が変わると、変わった直後に一時的に同期がずれることがあります。
+
+### Delay
+Transform
+
+: 直行変換の種類です。
+
+ 通常は FFT を選んでください。 FWHT と Haar はざらざらとした音になります。
+
+ **注意**: `Transform` を変更すると `Frame Size` の長さだけ音が止まります。爆発的に大きい音を避けるためにバッファがリセットされることが原因です。
+
+Frame Size
+
+: 直行変換を行うフレームの長さで、単位はサンプル数です。
+
+ この値がそのままディレイ時間になります。
+
+ `Latency` を有効にしたときは `Frame Size` と同じサンプル数のレイテンシを DAW に伝えます。
+
+ `Frame Size` が大きく、 DAW のバッファサイズが小さいとき、音がぶつぶつと途切れるようになることがあるかもしれません。このときは計算が間に合っていないので `Frame Size` を小さくしてください。
+
+Feedback
+
+: ディレイのフィードバックです。
+
+### Mask
+パラメータの右側の小さいつまみで LFO による変調量を変えられます。
+
+Waveform
+
+: 周波数マスクの波形です。
+
+Mix
+
+: 周波数マスクをかける割合です。
+
+ 0 のときマスクなし、 1 のとき完全にマスクします。
+
+Phase
+
+: 周波数マスクの波形の位相です。
+
+ `Phase` を LFO で変調するとフェイザと似たような音が出ます。
+
+Freq.
+
+: 周波数マスクの波形の周波数です。
+
+ `Freq.` が高くなるほど、ノッチの数が多くなります。
+
+ `Freq.` を 0 にすると周波数マスクが無効になります。
+
+Threshold
+
+: 周波数マスクの値が `Threshold` よりも小さいとき、その周波数を 0 にします。
+
+Rotation
+
+: 周波数領域で位相を回転する量です。
+
+ というのは `Transform` が FFT のときだけで、他の直行変換が選択されているときは `Rotation` に応じて周波数成分の入れ替えが行われます。
+
+Spectral Shift
+
+: フィードバックごとに周波数成分をシフトする量です。
+
+Octave Down
+
+: フィードバックごとに周波数成分を約 1 オクターブ下に移す割合です。
+
+ 設定によっては効果があまり出ません。 `Feedback` を 1 、 `Octave Down` を 0.1 あたりに設定すると効果が出ます。
+
+## チェンジログ
+{%- for version, logs in changelog["SpectralPhaser"].items() %}
+- {{version}}
+ {%- for log in logs["ja"] %}
+ - {{ log }}
+ {%- endfor %}
+{%- endfor %}
+
+## 旧バージョン
+{%- if old_download_link["SpectralPhaser"]|length == 0 %}
+旧バージョンはありません。
+{%- else %}
+ {%- for x in old_download_link["SpectralPhaser"] %}
+- [SpectralPhaser {{ x["version"] }} - VST 3 (github.com)]({{ x["url"] }})
+ {%- endfor %}
+{%- endif %}
+
+## ライセンス
+SpectralPhaser のライセンスは GPLv3 です。 GPLv3 の詳細と、利用したライブラリのライセンスは次のリンクにまとめています。
+
+- [https://github.com/ryukau/VSTPlugins/tree/master/License](https://github.com/ryukau/VSTPlugins/tree/master/License)
+
+リンクが切れているときは `ryukau@gmail.com` にメールを送ってください。
+
+### VST® について
+VST is a trademark of Steinberg Media Technologies GmbH, registered in Europe and other countries.
diff --git a/docs/manual/SpectralPhaser/img/SpectralPhaser.drawio b/docs/manual/SpectralPhaser/img/SpectralPhaser.drawio
new file mode 100644
index 00000000..b65171ed
--- /dev/null
+++ b/docs/manual/SpectralPhaser/img/SpectralPhaser.drawio
@@ -0,0 +1,154 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/docs/manual/SpectralPhaser/img/SpectralPhaser.png b/docs/manual/SpectralPhaser/img/SpectralPhaser.png
new file mode 100644
index 00000000..cef4eff7
Binary files /dev/null and b/docs/manual/SpectralPhaser/img/SpectralPhaser.png differ
diff --git a/docs/manual/SpectralPhaser/img/SpectralPhaser.svg b/docs/manual/SpectralPhaser/img/SpectralPhaser.svg
new file mode 100644
index 00000000..2e9b2d8a
--- /dev/null
+++ b/docs/manual/SpectralPhaser/img/SpectralPhaser.svg
@@ -0,0 +1,3 @@
+
+
+Fwd. Transform SpectralPhaser Output Input LFO Bwd. Transform Feedback Mask 1 Frame Delay
Frequency Domain
\ No newline at end of file
diff --git a/docs/manual/SpectralPhaser/img/VST_Compatible_Logo_Steinberg_negative.svg b/docs/manual/SpectralPhaser/img/VST_Compatible_Logo_Steinberg_negative.svg
new file mode 100644
index 00000000..f03d67ac
--- /dev/null
+++ b/docs/manual/SpectralPhaser/img/VST_Compatible_Logo_Steinberg_negative.svg
@@ -0,0 +1,82 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+