WineBuilder

WineBuilder is a script that makes it easier to build Wine binaries, including versions with custom patches, using Docker.

You can find prebuilt binaries on the Releases page.

---

Builds description

WineBuilder uses the latest Proton SDK (with a few changes) to build Wine inside a Docker container. This ensures great compatibility and feature completeness — including seamless usage within the Steam Linux Runtime. The wine-builder container is hosted here, built from its apposite GitHub CI.

By default, the script creates osu!-specific builds, with patches from wine-osu-patches, also used in osu-winello.

To build a regular Wine-Staging version instead, run WINE_OSU="false" ./build.sh or simply set WINE_OSU="false" in wine_builder.sh—the same file where all customizations can be made.

wine-tkg by Kron4ek is also supported: WINE_OSU=false USE_TKG=true ./build.sh will do the job.

Custom patches: To use your own patches in your custom builds, just place them in the custompatches/ folder.

---

Workflows

WineBuilder currently provides two weekly automated builds, available via GitHub Actions:

• wine-osu-winello, an osu!-specific Wine build with patches from wine-osu-patches.

• wine-staging-git, with daily Wine-Staging builds based on master (might fail sometimes due to staging rebases needed!)

---

Requirements

Install the following packages using your system's package manager:

• docker
• docker-buildx

Ubuntu/Debian:

sudo apt install -y docker docker-buildx

Arch Linux:

sudo pacman -Sy --needed --noconfirm docker docker-buildx

Fedora:

sudo dnf install -y docker docker-buildx

After installing, add yourself to the Docker group and enable the Docker service:

sudo gpasswd -a $USER docker
sudo systemctl enable docker docker.socket

---

Building Wine

First, clone the repo and go into the folder:

git clone https://github.com/NelloKudo/WineBuilder.git
cd WineBuilder

Then run the build script:

./build.sh

The built Wine binaries will be saved in the same folder when it's done. 🎉

---

Spritz-Wine

If you came here for Spritz-Wine builds included in AAGL and such, you can find those at my fork of Wine-Builds.