Prepare a fresh Linux install for gaming in one click — Wine, Winetricks, Lutris, GameMode, MangoHud, RetroArch, mGBA, AntiMicroX, Steam, and Proton-GE, all from a single terminal checklist or a native GTK app. No hassle, no hustle.

Supported Operating Systems 🚦

• ZorinOS
• Ubuntu
• Linux Mint
• Kubuntu
• KDE Neon
• Xubuntu
• Manjaro
• Arch Linux
• Any other distro based on Ubuntu 20.04+
• Any other distro based on Arch Linux

Installation Instructions 🚀

Three ways to get GameReady — pick whichever's easiest.

Option 1: One-shot (nothing to download)

Open a terminal (Ctrl+Alt+T on most distros) and run:

curl -L https://raw.githubusercontent.com/Cappyjune4/gameready/main/gameready.sh | bash

That runs the terminal checklist. For the GTK GUI instead:

curl -L https://raw.githubusercontent.com/Cappyjune4/gameready/main/gameready.sh | bash -s -- --gui

Option 2: Clone with git

git clone https://github.com/Cappyjune4/gameready.git
cd gameready
bash gameready.sh          # terminal checklist
python3 gameready-gui.py   # or the GUI

Option 3: Download the ZIP

1. Click Code → Download ZIP at the top of this repo (or grab it directly).
2. Extract it and open a terminal in the extracted folder.
3. Run it the same way as above:

bash gameready.sh          # terminal checklist
python3 gameready-gui.py   # or the GUI

Running through bash/python3 like this works even if the downloaded files aren't marked executable, which is common with ZIP downloads. If you'd rather run them directly (./gameready.sh), make them executable first:

chmod +x gameready.sh gameready-ubuntu.sh gameready-arch.sh gameready-gui.py uninstall-gameready-ubuntu.sh uninstall-gameready-arch.sh install-proton-ge.sh

---

A checklist lets you pick which components to install — everything is ticked by default, untick anything you don't want:

• Wine
• Winetricks & DirectX/.NET/VC++/DXVK — installs the Windows-side dependencies most games actually need: DirectX/D3D redistributables, several .NET Framework versions, Visual C++ runtimes, and DXVK/VKD3D (translates DirectX calls to Vulkan for much better performance under Wine). This is the slowest step by far — it's downloading and installing over a dozen real Microsoft redistributables one at a time, so expect it to take a while. It's slow because it's thorough: skipping it is exactly what causes the classic "game launches then instantly crashes" or "d3d11.dll not found" experience under Wine, so the wait genuinely pays off.
• Lutris
• GameMode
• MangoHud — a Vulkan/OpenGL overlay for FPS, temperatures, CPU/GPU load, and more, shown in-game.
• RetroArch — a retro console emulation frontend.
• mGBA — a Game Boy / Game Boy Advance emulator.
• AntiMicroX — maps gamepad/joystick input to keyboard and mouse actions.
• Steam — installed from your distro's repos (enables multiverse/i386 as needed on Ubuntu-family systems; enables multilib on Arch). Steam doesn't create its real library folder until first launch, so this step pre-creates ~/.local/share/Steam/compatibilitytools.d — that way selecting Steam and Proton-GE together in the same run works without a manual Steam launch in between.
• Proton-GE — the latest GloriousEggroll/proton-ge-custom release (BSD-3-Clause), auto-detected and installed into every Steam compatibilitytools.d directory found on your system (native and/or Flatpak). Lutris and Heroic both pick up compatibility tools from the same native-Steam location, so this one install covers all three.

GUI 🖥️

A GTK front-end (gameready-gui.py) is available as an alternative to the terminal checklist — same components, native widgets instead of a zenity checklist, with a live progress bar per component and a scrolling log instead of a series of popups.

Requirements

• python3-gi and gir1.2-gtk-3.0 (GTK 3 + PyGObject — usually already installed on GNOME/Cinnamon desktops)
• polkit (for the pkexec authentication prompt)
• Arch-family or Debian/Ubuntu-family, same as the rest of GameReady

Usage

Tick/untick whatever you want installed (everything's ticked by default, same as the terminal checklist), then click Run GameReady. That triggers a single pkexec authentication prompt, then runs the appropriate distro script in the background — the checklist gives way to a progress row per selected component (pulsing while it's being worked on, ✅ once done, ❌ if it failed), with every line of output streaming into the log pane below. A red Uninstall button next to the detected-distro line runs the matching uninstall script the same way, with a confirmation dialog first.

gameready-ubuntu.sh / gameready-arch.sh / install-proton-ge.sh all still run exactly as before with no GUI involved — the GUI just supplies the same checklist selection non-interactively via a --components= flag instead of the zenity checklist, and suppresses their zenity popups in favor of its own progress bars and log (necessary since pkexec runs the whole script as root, and a zenity popup as root can't reach your desktop session).

Uninstalling 🗑

Each distro has its own uninstall script that removes only what GameReady itself installed — general-purpose tools it happened to pull in along the way (like the GameMode build toolchain on Ubuntu) are left alone by default since you might use them for other things.

bash uninstall-gameready-ubuntu.sh   # Ubuntu/ZorinOS/Mint/Kubuntu/etc.
bash uninstall-gameready-arch.sh     # Arch/Manjaro/etc.

Options (same on both scripts):

• --with-build-deps — also remove the extra build tooling GameReady installed (e.g. meson/build-essential/etc. on Ubuntu), not just the gaming packages.
• --purge-user-data — also deletes your wine prefix (~/.wine) and Lutris library (~/.local/share/lutris), including installed games, saves, and configs. Asks for a typed yes confirmation first — never done silently.
• --remove-proton-ge — also removes any GE-Proton build(s) GameReady installed, from every detected Steam compatibilitytools.d directory. Opt-in, same reasoning as --with-build-deps: you might keep using Steam + Proton-GE independent of the rest of GameReady.

After installation 🕹

After the installation you can use Lutris (or Steam, if you installed Proton-GE) to play games with ease.

FAQ ❓

• Why not install Bottles? Because Lutris in my experience has worked way better than it and also has had better compatibility.
• Why not install [insert driver here]? Because drivers can be finicky and break systems if done the wrong way. If you know of any drivers that are universally stable and improve gaming in any way, please submit a PR :)

License 📄

MIT — forked from NayamAmarshe/gameready, original copyright retained.