Manual: Setup/Wine

From OpenMPT Wiki
Jump to navigation Jump to 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.

WARNING: This is an experimental feature.[edit]

Please discuss problems in the forum thread.

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 or RtAudio, 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. You must also use a Wine prefix with the correct architecture (for example, a 64-bit OpenMPT will not run in a 32-bit Wine prefix).
  • On Debian or Ubuntu (and derivatives), 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), librtaudio-dev (for RtAudio), libdbus-1-dev (for RealtimeKit)
  • And most importantly, 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).

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

Distribution specific information[edit]

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

Separate Wine prefix[edit]

The default wine prefix is located at ~/.wine. It is possible to place the OpenMPT folder in a separate Wine Prefix. Once OpenMPT is in the prefix, you can open it with a command similar to this one: WINEPREFIX=~/.YOUR-WINE-PREFIX wine $HOME'/.YOUR-WINE-PREFIX/drive_c/Program Files/OpenMPT/OpenMPT.exe'

Application association[edit]

You may have to change your OpenMPT.desktop file's Exec line to something like Exec=wine OpenMPT /shared "`winepath --windows '%f'`" for it to work properly.