This installation guide describes the installation process of openMHA on Linux (I.), macOS(II.), and Windows (III.) operating systems.
First, add the openMHA package repository to your system:
In Ubuntu 20.04:
wget -qO- https://apt.hoertech.de/openmha-packaging.pub | sudo apt-key add -
sudo apt-add-repository 'deb [arch=amd64] http://apt.hoertech.de focal universe'
In Ubuntu 18.04:
wget -qO- https://apt.hoertech.de/openmha-packaging.pub | sudo apt-key add -
sudo apt-add-repository 'deb [arch=amd64] http://apt.hoertech.de bionic universe'
On Computers with an ARM CPU running a recent variant of Debian, Ubuntu, Raspberry Pi OS, Armbian, or similar: The following instructions work for both, 32 and 64 bit ARM systems. A requirement for 32 bit ARM systems is that the CPU needs to be at least ARMv7.
wget -qO- https://apt.hoertech.de/openmha-packaging.pub | sudo apt-key add -
echo 'deb http://apt.hoertech.de bionic universe' | sudo tee /etc/apt/sources.list.d/openmha.list
sudo apt update
Install openMHA and some openMHA usage examples:
sudo apt install openmha openmha-examples
After installation, openMHA documentation is found in
/usr/share/doc/openmha
and tools for GNU Octave/Matlab in /usr/lib/openmha/mfiles.
We provide some examples for openMHA, after installing the openmha-examples
package the examples can be found in /usr/share/openmha/examples.
The reference algorithms can be found in /usr/share/openmha/reference_algorithms.
NOTE: If you want to use the example files we recommend to make a copy in your home directory as they are located in a system-wide read-only directory. Some of the examples may require changes to work with the current audio hardware setup and need write access to store output.
Algorithm developers interested in implementing their own plugins should also install the development package libopenmha-dev.
For updating openMHA when a new release is available, execute:
sudo apt update
sudo apt install openmha
This will upgrade all installed openmha packages to their latest version.
An openMHA installer for macOS can be downloaded from our Github releases page, https://github.com/HoerTech-gGmbH/openMHA/releases.
To use the Jack audio plugin, the JackOSX distribution needs to be installed.
On some machines macOS refuses to open the installer because it is from an unverified developer. Opening the installer while holding Ctrl makes macOS offer an override option.
The installer installs openMHA example setups and some tools. We recommend to copy the examples folder to a writable location inside your user directory.
On macOS, you can find the examples folder in
/usr/local/share/openmha/examples/ and the reference algorithms can be found in
/usr/local/share/openmha/reference_algorithms. m-files for interacting with the openMHA
from Matlab or Octave are installed in /usr/local/lib/openmha/mfiles/, and
documentation can be found in /usr/local/doc/openmha/.
An openMHA installer for 64 bit Windows 10 can be downloaded from our Github releases page, https://github.com/HoerTech-gGmbH/openMHA/releases.
The installer installs openMHA example setups and some tools. We recommend to copy the examples folder to a writable location inside your user directory.
After installation, you can find the examples in folder
C:\Program Files\openMHA\examples. The reference algorithms are located in
C:\Program Files\openMHA\reference_algorithms.
The folderC:\Program Files\openMHA\mfiles contains Matlab / Octave files for
interacting with openMHA. Folder C:\Program Files\openMHA\doc contains
documentation.
Due to compatibility issues the Windows build requires Jack version 1.9.11, which can be downloaded here: https://github.com/jackaudio/jackaudio.github.com/releases/download/1.9.11/Jack_v1.9.11_64_setup.exe