The xPack WineHQ
A standalone cross-platform (macOS/Linux) WineHQ binary distribution, intended for reproducible builds.
In addition to the the binary archives and the package meta data, this project also includes the build scripts.
This distribution follows the official WineHQ build system project.
The binaries can be installed automatically as binary xPacks or manually as portable archives.
The upstream release cycle is about two weeks, with one major release every year.
This distribution generally plans to have at least one, possibly two releases per year.
This section is intended as a shortcut for those who plan to use the WineHQ binaries. For full details please read the xPack WineHQ pages.
It is recommended to update to the latest version with:
npm install --location=global xpm@latest
For details please follow the instructions in the xPack install page.
xpm tool available, installing
the latest version of the package and adding it as
a dependency for a project is quite easy:
cd my-project xpm init # Only at first use. xpm install @xpack-dev-tools/wine@latest ls -l xpacks/.bin
This command will:
- install the latest available version, into the central xPacks store, if not already there
- add symbolic links to the central store
.cmdforwarders on Windows) into the local
The central xPacks store is a platform dependent
folder; check the output of the
xpm command for the actual
folder used on your platform).
This location is configurable via the environment variable
XPACKS_STORE_FOLDER; for more details please check the
xpm folders page.
It is also possible to install WineHQ globally, in the user home folder:
xpm install --global @xpack-dev-tools/wine@latest
After install, the package should create a structure like this (macOS files; only the first two depth levels are shown):
$ tree -L 2 /Users/ilg/Library/xPacks/\@xpack-dev-tools/wine/7.22.0-1.1/.content/ /Users/ilg/Library/xPacks/\@xpack-dev-tools/wine/7.22.0-1.1/.content/ /home/ilg/Work/wine-xpack.git/build/linux-x64/application/ ├── bin │ ├── function_grep.pl │ ├── msidb │ ├── msiexec │ ├── notepad │ ├── regedit │ ├── regsvr32 │ ├── widl │ ├── wine │ ├── wine64 │ ├── wine64-preloader │ ├── wineboot │ ├── winebuild │ ├── winecfg │ ├── wineconsole │ ├── winecpp -> winegcc │ ├── winedbg │ ├── winedump │ ├── winefile │ ├── wineg++ -> winegcc │ ├── winegcc │ ├── winemaker │ ├── winemine │ ├── winepath │ ├── wine-preloader │ ├── wineserver │ ├── wmc │ └── wrc ├── distro-info │ ├── CHANGELOG.md │ ├── licenses │ ├── patches │ └── scripts ├── include │ └── wine ├── lib │ └── wine ├── lib32 │ └── wine ├── libexec │ ├── libgcc_s.so.1 │ ├── libresolv-2.27.so │ └── libresolv.so.2 -> libresolv-2.27.so ├── README.md └── share ├── applications └── wine 15 directories, 32 files
No other files are installed in any system folders or other locations.
To remove the links created by xpm in the current project:
cd my-project xpm uninstall @xpack-dev-tools/wine
To completely remove the package from the global store:
xpm uninstall --global @xpack-dev-tools/wine
For all platforms, the xPack WineHQ binaries are released as portable archives that can be installed in any location.
The archives can be downloaded from the GitHub Releases page.
For more details please read the Install page.
The version strings used by the WineHQ project are two number strings
6.17; to make it semver compatible,
.0 is added as the third digit;
the xPack distribution adds a four number,
but since semver allows only three numbers, all additional ones can
be added only as pre-release strings, separated by a dash,
7.22.0-1. When published as a npm package, the version gets
a fifth number, like
Since adherence of third party packages to semver is not guaranteed,
it is recommended to use semver expressions like
with caution, and prefer exact matches, like
For maintainer info, please see the README-MAINTAINER
The quick advice for getting support is to use the GitHub Discussions.
For more details please read the Support page.
The binary distributions include several open-source components; the
corresponding licenses are available in the installed
- latest xPack release
- all xPack releases
- individual file counters (grouped per release)