jurihock / stftpitchshiftplugin

Official JUCE plugin for stftPitchShift

Official JUCE plugin for stftPitchShift

The stftPitchShiftPlugin features poly pitch and timbre shifting simultaneously and in real-time. It's completely based on the stftPitchShift library, which also provides a Python interface and useful command line tools.

Features

Following features are currently included:

• poly pitch shifting with or without formant preservation,
• pitch independent timbre changing,
• low latency capability depending on the preset block size,
• optional output normalization to match the input loudness level.

The stftPitchShiftPlugin is available in VST3, AU, LV2 formats as well as a standalone app. It also provides a basic UI to adjust the effect parameters on the fly:

Please refer to the User Manual for detailed explanations.

Binaries

The ready to use binaries can be obtained in two ways:

• via continuous build artifacts or
• via a local build from the source code.

Continuous build artifacts

Use one of the following links to download the latest binaries for your specific operating system:

• macOS
• Ubuntu
• Windows

On macOS, you will also have to deal with the Gatekeeper, in order to execute the standalone app or to load the AU or VST3 plugin in your DAW.

Build from source code

Since the project is based on CMake, it can be compiled in the same way on any of the supported operating systems.

Please read the official JUCE documentation and the included script files:

• build_macos.sh
• build_ubuntu.sh
• build_windows.bat

The advantage of this method on macOS is that no additional Gatekeeper handling is required.

Last but not least

This project is currently at an early development stage, so expect more highlights to come.

Stay tuned!

Credits

• JUCE by JUCE Team
• PocketFFT by Martin Reinecke
• pluginval by Tracktion Team
• nightly.link by Oleh Prypin

License

stftPitchShiftPlugin is licensed under the terms of the GPL license. For details please refer to the accompanying LICENSE file distributed with stftPitchShiftPlugin.

stftpitchshiftplugin's Issues

TODO

• Test AU/VST at least in Logic
• #2
• Add performance measurements
• Try different FFT backend (PocketFFT, JUCE FFT, Apple)
• Maybe add a configurable gain for individual pitch shifting stages
• Think about advanced automation, maybe something with MIDI chord recognition
• Think about the QDFT integration, e.g. to extract additional features for automation
• #6
• #5

Customize the user interface

See also example provided in ImJimmi/JIVE#129.

Variable block length in `processBlock`

Observations:

• Standalone app never changes the block size in processBlock.
• Logic changes the block size once in the first processBlock callback.
• Audacity permanently changes the block size in processBlock, e.g. between 512 and 157 (max. 1156).

One way to handle variable blocks would be to delay the output by the max. block size reported in prepareToPlay and report the resulting latency back by setting setLatencySamples. Therefore, two modes of operation need to be introduced, e.g. offline and online mode.

CI/CD

• actions/upload-artifact#51 is solved by nightly.link
• actions/upload-artifact#38 can possibly be solved by double-zipping the generated binaries (e.g. zip -rm foo.zip foo)

Bypass delay

Delay the output in the bypass setting by the same amount as in the core setting.