Resources ========= If you have any problems, the Wine FAQ is often very useful: https://wiki.winehq.org/FAQ Detailed documentation about Wine and its internals are available in the various User Guides and manpages: https://www.winehq.org/documentation For resources related to Debian Wine packaging, please visit: https://salsa.debian.org/groups/wine-team To participate in development and/or discussion about the Debian packages, please subscribe to the Debian Wine mailing list: https://lists.debian.org/debian-wine/ The Debian package repository can also be checked out with git: $ git clone https://salsa.debian.org/wine-team/wine.git Or viewed online at: https://salsa.debian.org/wine-team/wine Debugging ========= Debugging information is limited to only error messages by default. If you want other types of debugging output as well, you can set the WINEDEBUG environment variable. Example: $ WINEDEBUG=fixme+all wine If you want this to be more permanent, you can add "export WINEDEBUG=fixme+all" to your ~/.bashrc file. For more detail about WINEDEBUG options, please see the wine manpage. Old Versions ============ If you want to install a previous version of Wine, you should be able to fetch prior Debian versions from: http://snapshot.debian.org/package/wine/ http://snapshot.debian.org/package/wine-development/ You can also use debsnap from the devscripts package, for example: $ debsnap -v -d . wine 1.6.1-1 $ debsnap -v -d . wine-development 1.7.24-3 debsnap fetches source packages by default, which you will then need to build (see dpkg-buildpackage). debsnap also lets you fetch the binary packages with the "-a " option and then specifying each of the binary packages. Alternative current versions ============================ You can choose between two sets of Wine packages: wine and wine-development. wine tracks the stable releases from winehq.org (e.g. version 3.0.1), and wine-development tracks the development releases (e.g. version 3.7). wine and wine-development use the Debian alternatives system to provide /usr/bin/wine and other commands. If both packages are installed it defaults to use the commands provided by wine. You may change this by running: $ sudo update-alternatives --config wine.collection You may force a version at any time (as long as the wineserver isn't running yet), by using the suffixed command names, e.g.: $ wine-stable foo.exe $ wine-development foo.exe $ winecfg-stable $ winecfg-development $ winegcc-stable ... $ winegcc-development ... Configuring Wine's Options ========================== Usually everything is automatically configured, but for fine-tuning a good tool is winecfg. If you want to set up Wine manually in a command line only setting, you can force the creation of a ~/.wine directory by running: $ wineboot If something goes horribly wrong, you can always completely wipe your Wine setup with "rm -rf ~/.wine". This will destroy everything you've installed, including configuration and data files, so if you have anything important, please back it up first. You can then start fresh. Running 32-bit Windows applications on 64-bit systems ===================================================== 32-bit Windows applications are now supported on amd64 and arm64 natively via wine64. The wine32 package and multiarch are no longer strictly necessary. Certain 32-bit applications currently do not yet perform as well with wine64 compared to the purely native wine32 build. As such, the wine32 package will continue to be provided. If you are still interested in installing wine32 on a 64-bit system (via multiarch), as root please execute: # dpkg --add-architecture i386 && apt update && apt install wine32 or # dpkg --add-architecture i386 && apt update && apt install wine32-development If both wine32 and wine64 (or wine32-development and wine64-development) are installed and wine32 specifically is desired, please execute /usr/bin/wine32 directly since the more general /usr/bin/wine helper script launches wine64 by default when both are available. Default wine prefix locations ============================= The default prefix for wine64 is "$HOME/.wine" (upstream wine's default). The default prefix for wine32 is "$HOME/.wine32" (to not overlap wine64). When migrating from prior versions of the Debian packages, "$HOME/.wine" may still be a 32-bit prefix. You will see an error stating this fact when launching wine or wine64. If you run into this, the easiest solution is to move the old 32-bit prefix where wine32 will use it by default: $ mv $HOME/.wine $HOME/.wine32 32-bit results from the tools (winegcc, ...) on 64-bit systems ============================================================== You may generate 32-bit results with the programs in wine32-tools (or wine32-development-tools) as well as with those in wine64-tools (or wine64-development-tools). Enable multiarch (see above). Than install the matching 32-bit Wine development files. As root, execute e.g. on amd64: # apt install libwine-dev:i386 # apt install libwine-development-dev:i386 Use the programs with the option "-m32" (for winemaker --wine32). Wine Gecko ========== The automated downloader for Wine Gecko is intentionally disabled in the Debian wine packages. If you are interested in using Gecko, the appropriate version needs to be downloaded and installed manually. Information about which Wine Gecko should be associated with any particular Wine version is available at: https://wiki.winehq.org/Gecko Once the Wine Gecko installer is downloaded (on 64-bit systems you need both the 32-bit and the 64-bit version), copy it to one of the following locations (note that checksums only get verified in $HOME, not in /usr/share/): - /usr/share/wine/gecko/ or /usr/share/wine-development/gecko/ - /opt/wine/gecko/ - $XDG_CACHE_HOME/wine/ - $HOME/.cache/wine/ (if XDG_CACHE_HOME is not set) Official gecko packages used to be available but have not been maintained for a very long time. Help building new libwine-gecko packages is currently needed: https://tracker.debian.org/pkg/wine-gecko-1.4 Wine Mono ========= The downloader for Wine Mono is intentionally disabled in the Debian packages. Unfortunately Wine Mono is not available in the official Debian archives. You can find more information at: https://wiki.winehq.org/Mono You can download the Wine Mono installer and copy it to similar locations as shown for Wine Gecko above, just replace gecko with mono. System and desktop integration ============================== You can configure your system to automatically launch Windows executables. But this increases the risk of inadvertently launching Windows malware, so please make sure that you understand the security risks before blindly setting this up. See this discussion for some details: https://bugs.launchpad.net/ubuntu/+source/wine/+bug/256880 System integration (binfmt) --------------------------- If you install the wine-binfmt package, Wine will be registered as interpreter for Windows executables. Note that each executable has to be in a directory that is in your system PATH (or its path must be fully specified) and the executable mode bit (+x) must be set on the file. Once that is done, "./foo.exe" can be used instead of "wine foo.exe" to launch Windows PE files. Please take note that once this is enabled, Windows executables (including malware) might get auto-started this way, even as root. This feature is probably most interesting for automatic software testing. Desktop users probably don't need it, so don't install wine-binfmt, unless you know that you need it. Desktop integration ------------------- To make Wine known to your desktop environment you can install a wine.desktop file. Then you may e.g. double-click on Windows executables in a filebrowser to start them, or right-click on them to "Open With Wine Windows Programs Loader". Enable system-wide: $ sudo cp /usr/share/doc/wine/examples/wine.desktop /usr/share/applications/ or $ sudo cp /usr/share/doc/wine-development/examples/wine.desktop /usr/share/applications/ Enable only for your current user: $ cp /usr/share/doc/wine/examples/wine.desktop ~/.local/share/applications/ or $ cp /usr/share/doc/wine-development/examples/wine.desktop ~/.local/share/applications/ Remove: $ sudo rm -f /usr/share/applications/wine.desktop $ sudo update-desktop-database $ rm -f ~/.local/share/applications/wine.desktop $ update-desktop-database ~/.local/share/applications/ Opening files with Windows applications (MIME) ---------------------------------------------- Some applications register themselves for opening files of a specified type. Generally these associations are propagated to your Linux desktop, so that you can directly open files with the matching Windows application. Creation of these associations is disabled for some common file types to avoid unwanted associations with general purpose Windows applications, while a preferred native application exists (e.g. it prevents .txt files from being opened with Wine's notepad instead of your system's preferred editor). To remove all these file type associations: $ rm -rf ~/.local/share/applications/wine/ $ rm -f ~/.local/share/applications/wine-extension-* $ update-desktop-database ~/.local/share/applications/ The Wine FAQ has further information on this topic.