Menu

Tree [33f669] main /
 History

HTTPS access


File Date Author Commit
 Other-Notes 2022-10-08 Asif Ali Rizvan Asif Ali Rizvan [251b98] Change exe only changes exe, not prefix; sed ch...
 assets 2022-10-06 Asif Ali Rizvan Asif Ali Rizvan [19f625] restore old winezgui.svg
 bin 2023-05-21 Asif Ali Rizvan Asif Ali Rizvan [372fa1] fix >/dev/null -> 2>/dev/null for gtk-update-ic...
 flatpak-manifest 2023-03-31 Asif Ali Rizvan Asif Ali Rizvan [acee91] shortcut clean up use flatpakname
 flowcharts 2022-10-04 Asif Ali Rizvan Asif Ali Rizvan [8d9f65] setup installer if 1 exe found, create/change p...
 resources 2023-05-22 Asif Ali Rizvan Asif Ali Rizvan [f6043d] IFS SAVEIFS before for loop
 .gitignore 2022-08-22 Asif Ali Rizvan Asif Ali Rizvan [c5485a] git ignore nohup.out
 LICENSE 2022-06-06 Asif Ali Rizvan Asif Ali Rizvan [66c91e] Initial commit
 README.md 2023-05-22 Asif Ali Rizvan Asif Ali Rizvan [67aa38] 0.97.12
 Summary.md 2023-06-11 Asif Ali Rizvan Asif Ali Rizvan [33f669] change some icons
 Todo.md 2023-05-21 Asif Ali Rizvan Asif Ali Rizvan [2d2fde] use SOURCE function to load files either from D...
 VERSION.txt 2023-05-22 Asif Ali Rizvan Asif Ali Rizvan [67aa38] 0.97.12
 setup 2023-05-15 Asif Ali Rizvan Asif Ali Rizvan [94f66c] Use generic package icon instead of winezgui fo...
 winezgui-start.sh 2022-09-27 Asif Ali Rizvan Asif Ali Rizvan [072eb0] new branch 0.88
 xfce4-terminal-requirement.txt 2023-03-12 Asif Ali Rizvan Asif Ali Rizvan [7986a8] Release 0.95.1

Read Me

WineZGUI

Wine GUI using Zenity - Play and Share!

What is WineZGUI

WineZGUI (pronounced Wine-Zee-Goo-Eee) is a wine frontend for playing windows games with wine easily. It is a collection of Bash scripts for Wine Prefix Management and Linux Desktop Integration for easier wine gaming experience using Zenity. It allows quick launching of Direct play (not installed) EXE application or game from File Manager like Nautilus and allow creating separate wine prefix for each Windows' EXE binary.

Why WineZGUI?

  1. Runs windows games or exe files from file manager
  2. Creates application shortcut for easier access.
  3. Focus on playing games and not setting up prefixes.
  4. Backup and Restore prefixes for later use.
  5. Create Game Bundles for sharing (prefix+game)

How it works

  1. When a windows binary or exe is opened with WineZGUI,
  2. It create a new prefix (copies template) and a desktop shortcut with the EXE filename.
  3. When the user launches the script, the exe is launched.
  4. If it is a setup, it will detect installed exe and creates shortcuts in Games menu category.

Install WineZGUI

I highly recommend using flatpak version, because, distro based wine (wine-staging) keeps on updating and games may break every few days. Using wine stable from flathub is better or use wine stable 5.0 or 7.0 from the distro packages.

Install WineZGUI flatpak on supported Linux distros

WineZGUI is packaged in flatpak-wine by yours truly. Please visit flatpak-wine

Build and install flatpak from source

Please install flatpak-builder in the Linux system before running these commands. Install script will install org.freedesktop.Sdk/x86_64/21.08and org.winehq.Wine

Version 0.97.12 (copy paste this on a terminal)
git clone --depth 1 --branch 0.97.12 https://github.com/fastrizwaan/WineZGUI.git
./WineZGUI/flatpak-manifest/install.sh

Development version

git clone https://github.com/fastrizwaan/WineZGUI.git
./WineZGUI/flatpak-manifest/install.sh

flatpak's optional requirement is gnome-terminal if we need to access prefix using shell

SETUP on a Linux system, see Requirements

Setup is instant as it copies a few files to specific directories.

Version 0.97.12

Downoad source WineZGUI-0.97.12.tar.gz or use git tag 0.97.12

Using tar.gz
wget https://github.com/fastrizwaan/WineZGUI/archive/refs/tags/0.97.12.tar.gz
tar -zxvf 0.97.12.tar.gz
cd WineZGUI-0.97.12
sudo ./setup --install ; #systemwide
git tag 0.97.12
git clone --depth 1 --branch 0.97.12 https://github.com/fastrizwaan/WineZGUI.git
cd WineZGUI
sudo ./setup --install ; #systemwide
Development version
git clone https://github.com/fastrizwaan/WineZGUI.git
cd WineZGUI
sudo ./setup --install ; #systemwide

Uninstall WineZGUI

Flatpak uninstall
flatpak remove io.github.fastrizwaan.WineZGUI
System uninstall

Run uninstall from the same installation source directory

sudo ./setup --uninstall

Requirements

wine - main program

winetricks - must have wine addon script

perl‑image‑exiftool - to extract application/game name

icoutils - to extract icon from exe file

gnome-terminal - (optional) to access prefix directory in shell

Install Requirements for Linux OS

Flatpak Supported Distros

Get flatpak-wine which includes all dependencies. Useful for distros who do not package wine.

flatpak --user remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
flatpak --user -y install flathub org.winehq.Wine/x86_64/stable-22.08

Runtime Dependencies:

Fedora 36

sudo dnf install zenity wine winetricks perl-Image-ExifTool icoutils gnome-terminal wget zstd

Debian / Ubuntu

sudo dpkg --add-architecture i386 && sudo apt update
sudo apt install zenity wine wine32 wine64 winetricks libimage-exiftool-perl icoutils gnome-terminal wget zstd

Solus

sudo eopkg it zenity wine wine-32bit winetricks perl-image-exiftool icoutils gnome-terminal wget zstd diffutils

Arch Linux / EndeavourOS

sudo pacman -Sy zenity wine winetricks perl-image-exiftool icoutils gnome-terminal wget \
                lib32-alsa-plugins lib32-libpulse lib32-openal zstd

XBOX compatible controllers

build and install kernel drivers for xbox 360 compatible controllers from https://github.com/paroj/xpad