Installation

How to get Resonon running on your system?

What You’re Installing

A Resonon coding environment has three 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.
• LSP - The Resonon language server. It provides language intelligence, like diagnostics, completions, hover info, …
• VSCode extension — The extension can be thought of as the convenience layer for Resonon user-interaction. It 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.

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 and LSP.

VSCode Extension

Note

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

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

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

Note

Installation from source is not usually necessary!

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

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 Resonon.

If you are missing an important feature in the language, feel free to open a feature request on the code 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…