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.
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.
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.
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.
-
spritz-wine-tkg, a custom build of wine-tkg with patches from WineSpritz, including game-specific fixes, select upstream MRs and some QoL improvements.
- Also provides an ntsync version at: spritz-wine-tkg-ntsync
Install the following packages using your system's package manager:
dockerdocker-buildx
Ubuntu/Debian:
sudo apt install -y docker docker-buildxArch Linux:
sudo pacman -Sy --needed --noconfirm docker docker-buildxFedora:
sudo dnf install -y docker docker-buildxAfter installing, add yourself to the Docker group and enable the Docker service:
sudo gpasswd -a $USER docker
sudo systemctl enable docker docker.socketFirst, clone the repo and go into the folder:
git clone https://github.com/NelloKudo/WineBuilder.git
cd WineBuilderThen run the build script:
./build.shThe built Wine binaries will be saved in the same folder when it's done. 🎉