Installation

How to get Resonon running on your system?

What You’re Installing

A Resonon coding environment has two main components:

• Resonon — The core of the system. Think of it as the language itself - it includes the interpreter, audio and MIDI engine, and the server for live-coding.
• IDE Compatibility Layer (VSCode Extension) — This can be thought of as the convenience layer for Resonon user-interaction. Currently the standard integration comes in the form of an extension for Visual Studio Code, that connects to the Resonon server and lets you evaluate selected code with Cmd+Enter. It provides controls for sessions and transport, gives quick access to helpful TUI windows, and more. Internally, the extension uses the language server protocol (LSP).

In the future the will hopefully be integrations for other editors (think VIM, Emacs). LSP support for Resonon lives in its own binary, that can also be installed through the regular installer. For now, the VSCode extension is the standard IDE-integration.

System Requirements

• macOS (Any recent version should do..)

Installation

Resonon + LSP

Download the latest installer (.pkg). The program will guide you through the automatic installation of the Resonon language.

Note

You can optionally install the LSP support binary here, but that generally not needed when interfacing with Resonon using the VSCode integration, as the extension has its own bundled copy.

VSCode Extension

Download the latest extension (.vsix). Then, from within VSCode use “Install extension from file” in the command-pallette and select the downloaded file.

Note

The VSCode extension will be available soon on the VSCode marketplace. Stay tuned!

Verify Installation

resonon --version

If the current Resonon version is printed in the terminal, the Resonon language is correctly installed.

In VSCode the extension should show up in the “Extensions” panel. To quickly verify, just open any .non file and see the LSP and RESONON buttons in the footer appear. (The LSP should show a checkmark to the left side.)

If all this checks, you’re all set to start with your first Resonon project!

---

Installation from Source

If you want to make changes to the core source code of Resonon or have other reasons for not using the official installers, you can always build from source…

Caution

Installation from source is generally not necessary!

Think deeply whether you really want to go this route.. Changes made to the Resonon source itself easily break compatibility with all existing projects.

Resonon has support for custom Rust libraries, audio plugins, and many things can even be built completely within the language.

If you are missing an important feature, feel free to open a request on the GitHub repository, or reach out via e-mail (contact[at]resonon.org).

We are always grateful for user feedback and ideas for improvement, but cannot guarantee any feature requests will be honored. In its curent state, Resonon is highly curated and thus not open for code contributions.

Clone the repository, then build and install the language and LSP using make:

git clone https://github.com/WARNS-AUDIO/RESONON/
cd RESONON
make install

To build and install the VSCode extension:

make install-ext

If you found yourself here, you probably know your way around this sort of thing. Just check the repo for how everything is setup and what packages and tools are required…