Manual: Setup/Wine

From OpenMPT Wiki
Jump to: navigation, search
Wine tab of the settings dialog

This tab of the settings dialog is only visible if OpenMPT detects that it is running in a Wine environment. On Windows systems, it is hidden automatically.

Wine Native Host Support[edit]

This is an experimental feature that allows to completely bypass the emulation of Windows sound drivers as implemented in Wine, and instead talk to the native Linux and BSD audio APIs directly. Supported audio APIs are Pulse Audio (Simple API) and anything supported by PortAudio, in particular ALSA.

Automatic setup of the Wine integration

For this feature to work, the following requirements have to be met:

  • OpenMPT bitness must match the host system bitness, i.e. use OpenMPT 32-bit on i686 and OpenMPT 64-bit on x86-64.
  • On Debian or Ubuntu (and derivates), the following packages must be installed: coreutils dialog make pkg-config cpp gcc g++ binutils ccache xterm. Package names may differ on different systems.
  • The following packages need optionally be installed: libpulse-dev (for PulseAudio), libjack-jackd2-dev and portaudio19-dev (for PortAudio), libdbus-1-dev (for RealtimeKit)
  • And most importently, the Wine developments headers and tools must also be installed. These have various different but similarly looking names on various distributions. Typically the package names match the package names of the installed wine version with something like -dev or -tools appended (Note: This can be easily confused with packages for the Wine development branch, which can typically be called wine-devel or wine-development). A list of tested Distribution and Wine versions as well as the precise package names for the tested setups can be found in the forum at

After enabling the feature, restart OpenMPT to automatically setup and compile the required host system libraries.