Installation

Rhapsodist is distributed as a HISE asset, installed through HISE’s asset manager (File > Open HISE Asset Manager). The asset manager keeps a list of packages you can install into a project, tracks which version of each one is installed, and lets you update or remove them later.

A future HISE Store will let you browse and install assets like Rhapsodist directly from within HISE. Until then, you point the asset manager at a local folder containing the asset, as set up below.

Set Up The Asset Source

Clone the Rhapsodist repository to a folder on your system where you keep local HISE assets:

git clone https://github.com/LibreWaveAudio/Rhapsodist.git

Then register that folder with the asset manager:

1. Open the asset manager (File > Open HISE Asset Manager).
2. Click Add local folders to this list to create assets at the bottom of the package list.
3. Select the package_install.json file at the root of the cloned repository.

The asset manager reads Rhapsodist’s metadata from that file and adds it to the package list, ready to install. See the asset manager guidelines for more detail on the asset manager itself.

Install Into A Project

Open the asset manager in your project and click Install next to Rhapsodist. This copies the Rhapsodist framework into your project.

Each project gets its own copy of Rhapsodist’s files, tracked in that project’s own git repository, at whatever version was installed at the time.

Rather than installing Rhapsodist into a blank HISE project, it’s easier to start from one of the Templates, then install Rhapsodist into that instead.

Updating

When a new version of Rhapsodist is available, pull the latest changes into your local clone. The asset manager marks Rhapsodist with a blue dot in your project, and the button next to it changes to Update to [version]; click it to update.

If an update doesn’t apply cleanly, click Uninstall [version] next to Rhapsodist in the asset manager, then install it again.