ales-tsurko / kotoist

A VST plugin for live coding and algorithmic composition

Kotoist

VST plugin for live coding using Koto programming language.

Build

Use ./build.sh win on Windows or ./build.sh mac on macOS.

If you wish to build manually, you should build GUI first:

cd gui
yarn
yarn build

Then you can build the plugin:

cd ..
cargo build

On OS X VST plugins are packaged inside of loadable bundles. To package your VST as a loadable bundle you may use the osx_vst_bundler.sh script this library provides.

Example:

./osx_vst_bundler.sh Plugin target/release/plugin.dylib
Creates a Plugin.vst bundle

ref

REAPER Specific

To make the plugin work as expected, you should right-click on the plugin in the FX Rack and choose "Send all keyboard input to plugin".

FL Studio Specific

The debug build initialize a log file on your desktop. At least on macOS this crashes FL Studio on start. To prevent it, comment out the log initialization.

Deployment

Just tag a new version and push it to remote.

git tag {version}
git push origin {version}

Docs

You need doctave and gh-pages node package.

To install gh-pages (it's important to use 3.0.0 version):

npm install -g [email protected]

Building and deploying the docs:

doctave build --release
gh-pages -d site

kotoist's Issues

Windows 10 64x build crashes Reaper

Hi, I followed the instructions to build kotoist, first the gui then the VST, I then copied the generated kotoist.dll file into my VST folder. After adding kotoist to a track Reaper crashed giving a C++ runtime error.

Do you maybe know what could be the problem? Is there a log I could paste here, with details of the build?

freezing upon loading in Ableton Live 10

Hi,

Trying this out in Ableton Live 10 and it freezes when loading. Attached a screenshot of what I see in Ableton - it just shows "Loading..." and i am never able to input code

Linux compilation fails

I'm trying to compile this plugin on Ubuntu 22.04. The gui appears to compile fine:

yarn build
yarn run v1.22.19
$ node scripts/build.js
Creating an optimized production build...
Browserslist: caniuse-lite is outdated. Please run:
  npx browserslist@latest --update-db
  Why you should do it regularly: https://github.com/browserslist/browserslist#browsers-data-updating
Compiled successfully.

File sizes after gzip:

  863.81 KB  build/static/css/main.24531017.chunk.css
  49.69 KB   build/static/js/2.63866348.chunk.js
  2.82 KB    build/static/js/main.4b3838b4.chunk.js
  1.62 KB    build/static/js/3.b7113776.chunk.js
  1.16 KB    build/static/js/runtime-main.7505a2aa.js

The project was built assuming it is hosted at /.
You can control this with the homepage field in your package.json.

The build folder is ready to be deployed.
You may serve it with a static server:

  yarn global add serve
  serve -s build

Find out more about deployment here:

  https://cra.link/deployment

Done in 8.97s.

But when I try and build the plugin it fails at the point of compiling the vst-gui

   Compiling chrono v0.4.22
   Compiling vst-gui v0.2.0 (https://github.com/ales-tsurko/rust-vst-gui.git#0105f6d3)
error[E0308]: mismatched types
  --> /home/hellocatfood/.cargo/git/checkouts/rust-vst-gui-6c216ce8a2ccc232/0105f6d/src/lib.rs:77:97
   |
76 | pub fn new_plugin_gui(
   |        -------------- implicitly returns `()` as its body has no tail or `return` expression
77 |     html_document: String, js_callback: JavascriptCallback, window_size: Option<(i32, i32)>) -> PluginGui
   |                                                                                                 ^^^^^^^^^ expected struct `PluginGui`, found `()`

For more information about this error, try `rustc --explain E0308`.
error: could not compile `vst-gui` due to previous error
warning: build failed, waiting for other jobs to finish...
error: build failed