Plugin for extreme time stretching and other spectral processing of audio
Go to file
Nikolai Rodionov 4257a0f8ba
build: Fix zip command
2023-08-19 18:36:44 +02:00
Source Build with JUCE 7.0.2 2023-08-18 15:32:42 +02:00
deps clap-juce-wrapper: adjusted version check for feature 2022-06-15 13:33:51 -04:00
images added output recording feature. moved settings to a separate popup panel instead of a menu 2022-06-14 19:11:57 -04:00
linux update changes, and linux uninstall 2022-06-16 13:27:25 -04:00
mobile build fixes for ios 2022-06-16 17:27:11 -04:00
release updated aax signing in script 2022-06-16 12:20:10 -04:00
.drone.yml build: Fix zip command 2023-08-19 18:36:44 +02:00
.gitattributes fixes for cmake building on windows 2022-04-19 17:45:56 -04:00
CHANGES.md Update build and changelog 2023-08-19 09:28:09 +02:00
CMakeLists.txt Revert "Update CMakeLists.txt (#26)" (#28) 2022-10-02 14:38:36 -04:00
Dockerfile Build with JUCE 7.0.2 2023-08-18 15:32:42 +02:00
LICENSE added AAX distribution exception to the license 2022-04-26 18:39:03 -04:00
README.md Build with JUCE 7.0.2 2023-08-18 15:32:42 +02:00
buildcmake.sh transitioned to cmake for desktop build 2022-04-19 16:30:36 -04:00
paulxstretch-vst3.zip Use zipped artifacts 2023-08-19 16:22:28 +02:00
setupcmake.sh transitioned to cmake for desktop build 2022-04-19 16:30:36 -04:00
setupcmakewin.sh transitioned to cmake for desktop build 2022-04-19 16:30:36 -04:00
setupcmakewin32.sh transitioned to cmake for desktop build 2022-04-19 16:30:36 -04:00
setupcmakexcode.sh transitioned to cmake for desktop build 2022-04-19 16:30:36 -04:00

README.md

PaulXStretch - Plugin for extreme time stretching and other spectral processing of audio

Dev Notes:

Install the linux version using Docker.

I've created a docker image that you can use to install the current dev version of the plugin

This application/plugin is based on the PaulStretch algorithm. (Pauls Extreme Time Stretch, originally developed by Nasca Octavian Paul), and specifically the PaulXStretch version from Xenakios. The UI has been updated and adapted for various screen sizes.

PaulXStretch is only suitable for radical transformation of sounds. It is not suitable at all for subtle time or pitch corrections and such. Ambient music and sound design are probably the most suitable use cases. It can turn any short audio into an hours long ambient soundscape without batting an eye!

Works as a standalone application on macOS, Windows, Linux, and iOS, and as an audio plugin (AU, VST3) on macOS, Windows and iOS (AUv3).

Installing

Windows and Mac

There are binary releases for macOS and Windows available at sonosaurus.com/paulxstretch or in the releases of this repository on GitHub.

Linux

For now, you can build it yourself following the build instructions below.

Building

Source code is now maintained at:

https://github.com/essej/paulxstretch

To build from source on macOS and Windows, all of the dependencies are a part of this GIT repository, including prebuilt FFTW libraries (for Mac/Win only) The build now uses CMake 3.15 or above on macOS, Windows, and Linux platforms, see details below.

On macOS

Make sure you have CMake >= 3.15 and XCode. Then run:

./setupcmake.sh
./buildcmake.sh

The resulting application and plugins will end up under build/PaulXStretch_artefacts/Release when the build completes. If you would rather have an Xcode project to look at, use ./setupcmakexcode.sh instead and use the Xcode project that gets produced at buildXcode/PaulXStretch.xcodeproj.

On Windows

You will need CMake >= 3.15, and Visual Studio 2019 installed. You'll also need Cygwin installed if you want to use the scripts below, but you can also use CMake in other ways if you prefer.

./setupcmakewin.sh
./buildcmake.sh

The resulting application and plugins will end up under build/PaulXStretch_artefacts/Release when the build completes. The MSVC project/solution can be found in build/PaulXStretch_artefacts as well after the cmake setup step.

On Linux

The first thing to do in a terminal is go to the Linux directory:

cd linux

And read the BUILDING.md file for further instructions.

Contributors

Copyright (C) 2022 Jesse Chappell

Copyright (C) 2017-2018 Xenakios

Copyright (C) 2006-2011 Nasca Octavian Paul, Tg. Mures, Romania

If you would like to contribute anything via pull requests, please do so from the develop branch of this repository.

License and 3rd Party Software

Released under GNU General Public License v.3 license with App Store license exception. The full license text is in the LICENSE file. Paul Nasca, Xenakios and Jesse Chappell all explicitly permitted the license exception clause. The AAX plugin and the version distributed on the iOS App Store by Sonosaurus is not built with FFTW, and the JUCE commercial license applies there.

It is built using JUCE 6 (slightly modified on a public fork), I'm using the very handy tool git-subrepo to include the source code for my forks of those software libraries in this repository. FFTW is required, but statically built libraries are included in deps for easier building on Mac and Windows.

Dependencies that are referenced via git-subrepo in this repository are:

  • (deps/juce) https://github.com/essej/JUCE in the sono6good branch.
  • (deps/clap-juce-extensions) https://github.com/free-audio/clap-juce-extensions in the main branch.
  • (deps/clap-juce-extensions/clap-libs/clap) https://github.com/free-audio/clap in the main branch.
  • (deps/clap-juce-extensions/clap-libs/clap-helpers) https://github.com/free-audio/clap-helpers in the main branch.