Installation guide

If you are installing a Libre Wave virtual instrument the installation is done in two stages; first you’ll install the software plugin and standalone application, then from within the plugin or standalone application you’ll install the samples.

If you are installing a Libre Wave effect plugin then you’ll only need to follow the instructions for installing the software as there will be no samples to install.

Installing the software

The download package you received contains three installers; one each for GNU/Linux, Windows, and Mac.

Please follow the installation instructions below for your operating system.

GNU/Linux

The GNU/Linux installer has a .sh file extension. It needs to be run from the terminal. The simplest way is to drag the installer file onto an open terminal window and press Enter. If you see a command not found error you will need to grant execute permissions to the installer, how you do this will vary depending on your OS. In Linux Mint you can right click the .sh file, select properties, click the permissions tab, and check the execute box.

The software license will be displayed. You can scroll down a whole page by pressing the Space Bar or a single line by pressing the Enter key.

Once you reach the end of the license you’ll be prompted to accept its terms. Type y if you accept the terms and want to continue the installation or n if you don’t and would like to exit. Then press the Enter key.

If you accepted the terms of the license you’ll be asked if you would like to install the VST plugin version of the software. Type¬†y if you do and press the Enter key, you’ll then be prompted to enter a location to install the plugin. You should enter the full path to an existing directory, if the directory doesn’t exist the installer will ask you to choose another location. If the directory you choose requires root permissions then you’ll need to restart the installer with root access (sudo).

If the software includes a standalone application you’ll now be asked if you would like to install it. Type y if you do and press the Enter key, you’ll then be prompted to enter a location to install the standalone application. You should enter the full path to an existing directory, if the directory doesn’t exist the installer will ask you to choose another location. If the directory you choose requires root permissions then you’ll need to restart the installer with root access (sudo).

The standalone installation will also place the license file and application icon into the install directory. You can use this icon for any desktop or menu shortcuts you create for the standalone application.

The software installation will now complete and you can move on to installing the samples.

Windows

The Windows installer has a .exe file extension, double click it to launch the setup wizard. The first screen will present the software license, if you agree with its terms select I accept the agreement and then click Next.

The next screen will ask you to select a location to install the 32bit version of the plugin. This does not need to be the same location where you will install the samples. Once you’ve chosen an install directory click Next.

Now you need to select a location for the 64bit version of the plugin. This does no need to be the same location where you will install the samples.

You’ll now be given the opportunity to customise the installation. You can choose which components you’d like to install by marking the checkboxes next to them. Once you’ve made your selections click Next.

A final confirmation screen will be shown. Here you can review the installation configuration and if it’s correct click Install to begin the installation.

Once the installation is complete click Finish. You can now move on to installing the samples.

MacOS

The MacOS installer has a .pkg file extension, double click it to start the setup process. Click Continue in the security prompt that pops up and then click the Continue button at the bottom of the window.

Read through the license document and if you accept its terms click Continue and then Agree.

Choose the location to install the plugin. This doesn’t need to be the same as the location where you will install the samples. Click Continue.

The next screen allows you to confirm that you selected the correct install location and informs you of how much disk space the plugin requires. Click Install.

You’ll be prompted to enter your password to confirm that you want the installation to proceed.

The installation process will begin and the on-screen progress bar will keep you informed of the current status.

You’ll see the following screen once the plugin installation is complete. Click¬†Close and you can now move on to installing the samples.

Installing the samples

If you’re installing a Libre Wave virtual instrument you will have received one or more .hr files. These contain the audio samples that need to be extracted by the plugin or standalone application on first use.

When you run the instrument for the first time (either the standalone application or the plugin) you will be presented with two buttons, click Install Samples. You’ll then be prompted to select the file that ends in .hr1. Once you’ve located this file and selected it you’ll be asked to select the location to extract the samples to. This doesn’t need to be the same location where you installed the plugin. For the best performance it is generally recommended to install samples on an SSD.

When you have selected the destination folder a new window will pop up that displays the progress of the sample extraction. The Overwrite existing samples drop-down menu provides control over how samples that are already in the selected destination directory will be handled by the installer. These options are important if you are reinstalling the library or you are installing a different version to one you already have. For first time use you want to leave it at the default value (Overwrite if newer). The two other options provided allow you to force existing samples to be overwritten (even if the new ones are the same version or older) or not to overwrite at all and keep your existing samples.

The Delete Sample Archive after extraction drop-down menu determines what happens to the .hr files you downloaded after the samples have been extracted. The default setting of No means that nothing will happen to the .hr files after extraction. If you set this option to Yes the .hr files will be deleted after the samples have been extracted. Most of the time you are probably going to want to select Yes because the .hr files are just a delivery container for the samples and are not needed to use the sample library. Deleting them after the samples have been extracted will free up some disk space.

Now you can click ok. You’ll then have a short wait while the samples are extracted to your chosen location.

After the process is complete you might get a prompt saying The sample directory does not exist, click the Ignore button. Now you’ll need to close and reopen the plugin (or standalone program) to complete the setup.

What to do if something goes wrong

If something went wrong with the extraction process and you want to start over; go to the folder that contains the configuration files for the sample library and delete all the files it contains. Then reopen the sample library and everything should be just as it was before you extracted the samples. To determine the location of the configuration files on your operating system see the Configuration files section at the end of this document.

Moving samples

If at some point after installation you move the samples to a different location you will need to redirect the sample library to that location. You may be prompted to do this when you run the library after moving the samples or you can do it manually by going into the settings page of the plugin and clicking the Change sample folder location button.

Configuration files

During installation a directory will be created on your system that holds some files that the software needs in order to function. These files include presets, user settings, and links to the sample file directory. The location of this folder will vary depending on your operating system.

  • GNU/Linux: /home/username/.config/LibreWave/
  • Windows: Users/username/AppData/Roaming/LibreWave/
  • MacOS: ~/Library/Application Support/LibreWave/ or ~/Music/LibreWave/

Creative Commons License

Last Updated On June 18, 2019