### Install WineZGUI from Source

Source: https://context7.com/fastrizwaan/winezgui/llms.txt

Installs WineZGUI from source using the setup script. This can be a system-wide installation or to a custom prefix. Uninstall using the --uninstall flag.

```bash
# Clone the repository
git clone --depth 1 --branch 0.99.13 https://github.com/fastrizwaan/WineZGUI.git
cd WineZGUI

# Install system-wide
sudo ./setup --install

# Or install to a custom prefix
sudo ./setup --install --prefix=/usr/local

# For flatpak-specific installation
sudo ./setup --install --flatpak --prefix=/app

# Uninstall
sudo ./setup --uninstall
```

--------------------------------

### Install WineZGUI from Git Tag

Source: https://github.com/fastrizwaan/winezgui/blob/main/README.md

Install a specific version (0.99.13) of WineZGUI using Git. This clones the repository to the specified tag and then runs the setup script.

```bash
git clone --depth 1 --branch 0.99.13 https://github.com/fastrizwaan/WineZGUI.git
cd WineZGUI
sudo ./setup --install ; #systemwide
```

--------------------------------

### Prompt to Change Exe for Setup/Install Files

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

If a program's name contains 'Setup' or 'Install', the user will be prompted to change the executable after launching.

```bash
If name contains Setup or Install, ask to change exe after launch
```

--------------------------------

### Install WineZGUI

Source: https://github.com/fastrizwaan/winezgui/blob/main/INSTALL.txt

Use the --install option to install WineZGUI to the default prefix. This is the basic installation command.

```bash
./setup --install
```

--------------------------------

### Install WineZGUI from Tarball

Source: https://github.com/fastrizwaan/winezgui/blob/main/README.md

Download and install WineZGUI version 0.99.13 from a tarball. This method requires manual extraction and running the setup script.

```bash
wget https://github.com/fastrizwaan/WineZGUI/archive/refs/tags/0.99.13.tar.gz
tar -zxvf 0.99.13.tar.gz
cd WineZGUI-0.99.13
sudo ./setup --install ; #systemwide
```

--------------------------------

### Install Flatpak Version of WineZGUI

Source: https://github.com/fastrizwaan/winezgui/blob/main/INSTALL.txt

Use the --flatpak option to install the Flatpak version of WineZGUI. The --prefix=/app is typically used for Flatpak installations.

```bash
./setup --install --flatpak --prefix=/app
```

--------------------------------

### Create All Desktop Shortcuts for Found Executables

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

After a setup, WineZGUI now creates desktop shortcuts for all detected executables. This streamlines the process of launching installed applications.

```bash
Create all desktop shortcuts for one or more found exe after setup
```

--------------------------------

### Winetricks GUI and Registry Backup

Source: https://context7.com/fastrizwaan/winezgui/llms.txt

Explains how to use the winetricks GUI for installing components and how to restore the registry from automatic backups.

```bash
# The winetricks GUI option:
# 1. Downloads latest winetricks if not present
# 2. Backs up registry files automatically
# 3. Opens winetricks GUI for the current prefix
# 4. Allows installing DLLs, fonts, and Windows components

# Registry backup location:
# ~/.local/share/winezgui/Prefixes/MyGame-abc1234567/registry_backup_20240115_14_30_00.tar.gz

# Restore registry if winetricks causes issues:
cd ~/.local/share/winezgui/Prefixes/MyGame-abc1234567/
tar -xvf registry_backup_20240115_14_30_00.tar.gz
```

--------------------------------

### Install WineZGUI to Custom Prefix

Source: https://github.com/fastrizwaan/winezgui/blob/main/INSTALL.txt

Specify a custom installation prefix using the --prefix option. This allows installation to user-defined directories like /usr or /usr/local.

```bash
./setup --install --prefix=/usr
```

```bash
./setup --install --prefix=/usr/local
```

--------------------------------

### Launch Single Script After Setup

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

If only one executable is found after a setup, WineZGUI automatically launches the single script created for it. This provides immediate access to the installed application.

```bash
After Setup, launch the single script created
```

--------------------------------

### Show List of Multiple Executables After Setup

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

After a setup completes and multiple executables are found, WineZGUI now displays a list of all available script/exe files to launch. This helps users choose the correct application.

```bash
Show list of multiple exe installed after setup
- [x] default script should show all the available scripts/exe to launch
- [x] restore works with script which lists multiple exe and single
```

--------------------------------

### Uninstall WineZGUI from Source

Source: https://github.com/fastrizwaan/winezgui/blob/main/README.md

Uninstall WineZGUI when it was installed from source. Run the uninstall command from the same directory where the setup script was executed.

```bash
sudo ./setup --uninstall
```

--------------------------------

### Example Info.yml Metadata

Source: https://context7.com/fastrizwaan/winezgui/llms.txt

Shows the structure of the Info.yml file, which contains metadata for each WineZGUI prefix.

```yaml
# Example Info.yml content
Name:My Game
Exe:/path/to/games/MyGame/game.exe
Sha256sum:abc123def456...
Exe Path:/path/to/games/MyGame
Prefix:MyGame-abc1234567
Script:/home/user/.local/share/winezgui/Prefixes/MyGame-abc1234567/MyGame.sh
Icon:/home/user/.local/share/winezgui/Prefixes/MyGame-abc1234567/MyGame.png
Shortcut:/home/user/.local/share/winezgui/Prefixes/MyGame-abc1234567/MyGame.desktop
Created:2024-01-15_1430
Wine:wine-9.0
Runner:/usr/bin/wine
Wine Arch:win64
WineZGUI:0.99.16
WineZGUI Prefix:/home/user/.local/share/winezgui
Install:system
```

--------------------------------

### Install Wine Dependencies on Solus

Source: https://github.com/fastrizwaan/winezgui/blob/main/README.md

Installs Wine (including 32-bit support) and necessary development tools on Solus using the eopkg package manager. Includes winetricks, exiftool, and samba development files.

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

--------------------------------

### Remove Setup Script After Creating Shortcuts

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

After the setup process is complete and shortcuts have been created, the setup script itself is automatically deleted. This helps keep the installation directory clean.

```bash
Remove setup's script file after creating shortcuts
```

--------------------------------

### Install Flatpak MPV Player

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

Installs the MPV media player as a Flatpak application using the provided Flatpak reference file. This command is typically run in a Linux environment with Flatpak support.

```bash
flatpak install --user https://dl.flathub.org/build-repo/72058/io.mpv.Mpv.flatpakref
```

--------------------------------

### Install Development Version of WineZGUI

Source: https://github.com/fastrizwaan/winezgui/blob/main/README.md

Clone the latest development version of WineZGUI from its GitHub repository and install it. This is useful for testing the newest features or contributing to development.

```bash
git clone https://github.com/fastrizwaan/WineZGUI.git
cd WineZGUI
sudo ./setup --install ; #systemwide
```

--------------------------------

### Install Runtime Dependencies for Linux Distributions

Source: https://context7.com/fastrizwaan/winezgui/llms.txt

Installs the necessary dependencies for WineZGUI on various Linux distributions. Ensure your package manager is up-to-date before installation.

```bash
# Fedora 36+
sudo dnf install zenity wine winetricks perl-Image-ExifTool icoutils gnome-terminal wget zstd samba-winbind-clients.x86_64 samba-winbind-clients.i686

# Debian / Ubuntu / Linux Mint
sudo dpkg --add-architecture i386 && sudo apt update
sudo apt install zenity wine wine32 wine64 winetricks libimage-exiftool-perl icoutils gnome-terminal wget zstd winbind

# Arch Linux / EndeavourOS
sudo pacman -Sy zenity wine winetricks perl-image-exiftool icoutils gnome-terminal wget lib32-alsa-plugins lib32-libpulse lib32-openal zstd samba

# Solus
sudo eopkg it zenity wine wine-32bit winetricks perl-image-exiftool icoutils gnome-terminal wget zstd diffutils samba-devel
```

--------------------------------

### Install WineZGUI via Flatpak

Source: https://context7.com/fastrizwaan/winezgui/llms.txt

Installs WineZGUI using Flatpak from Flathub. Ensure Flathub is added as a remote repository. Optionally grant access to additional directories or the entire host filesystem.

```bash
# Add Flathub repository if not already added
flatpak --user remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo

# Install WineZGUI from Flathub
flatpak --user -y install flathub io.github.fastrizwaan.WineZGUI

# Grant access to additional directories (optional)
flatpak override --user --filesystem=/path/to/your/drive io.github.fastrizwaan.WineZGUI

# Grant read-only access to entire host filesystem
flatpak --user override --filesystem=host:ro io.github.fastrizwaan.WineZGUI
```

--------------------------------

### Install MF-Install using Wget and Tar Directly

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

This change modifies the mf-install process to use wget and tar commands directly, rather than relying on potentially undefined WGET_CMD and TAR_CMD variables. This ensures the installation works even if those variables are not set.

```bash
mf-install use wget and tar directly instead of $WGET_CMD and $TAR_CMD
```

--------------------------------

### Launch WineZGUI GUI Application

Source: https://context7.com/fastrizwaan/winezgui/llms.txt

Starts the main graphical user interface of WineZGUI. This is typically done by running the command without any arguments.

```bash
# Launch the main WineZGUI window
winezgui
```

--------------------------------

### Manage Prefix Templates

Source: https://context7.com/fastrizwaan/winezgui/llms.txt

Templates provide pre-configured Wine prefixes as starting points for new games. Options include configuring, backing up, downloading, creating, cloning, changing, and deleting templates. Templates are stored in ~/.local/share/winezgui/Templates/.

```bash
# Template options:
# - Configure <template>...  - Run winetricks/configure current template
# - Backup <template>...     - Backup current template
# - Download Template...     - Download pre-configured templates
# - Create New...            - Create new template from scratch
# - Clone...                 - Clone existing template
# - Change...                - Switch active template
# - Backup...                - Backup any template
# - Restore...               - Restore template from backup
# - Delete...                - Remove templates
# - Help...                  - Template help

# Templates directory:
# ~/.local/share/winezgui/Templates/

# When creating a new prefix:
# 1. Template is copied to Prefixes directory
# 2. Symlinks to home directories are replaced with real directories
# 3. H: drive is linked to user's home directory
# 4. wineboot initializes the prefix

# Pre-configure templates with common dependencies:
# Use "Configure..." to install winetricks verbs
```

--------------------------------

### Install Wine Dependencies on Arch/EndeavourOS

Source: https://github.com/fastrizwaan/winezgui/blob/main/README.md

Installs Wine and its required libraries and utilities on Arch Linux or EndeavourOS using Pacman. Includes 32-bit ALSA and PulseAudio support, and Samba.

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

--------------------------------

### Use Flatpak Commands for Installation

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

When installing within a Flatpak environment, this ensures that tools are accessed using the 'flatpak --command' option. This is necessary because Flatpak isolates applications and their dependencies.

```bash
flatpak install use tools from using flatpak --command
```

--------------------------------

### Launch EXE/MSI with WineZGUI

Source: https://context7.com/fastrizwaan/winezgui/llms.txt

Launches Windows executables or MSI installers. This action automatically creates a new Wine prefix, extracts icons, generates a launch script, and creates a desktop shortcut.

```bash
# Open a Windows executable - creates prefix and desktop shortcut automatically
winezgui /path/to/game/Setup.exe

# Open an MSI installer
winezgui /path/to/application/installer.msi

# Open a portable EXE application
winezgui /path/to/games/Game.exe
```

--------------------------------

### Install Wine Dependencies on Debian/Ubuntu/Mint

Source: https://github.com/fastrizwaan/winezgui/blob/main/README.md

Installs Wine (32-bit and 64-bit) and related dependencies on Debian, Ubuntu, or Linux Mint systems using APT. Enables i386 architecture and installs packages like winetricks and exiftool.

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

--------------------------------

### Use Flatpak Tools for Exiftool, Icotool, Zenity, Tar, Wget

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

Ensures that essential tools like exiftool, icotool, zenity, tar, and wget are used from within the Flatpak environment. This is crucial for systems like Silverblue where these tools might not be installed globally.

```bash
Use exiftool, icotool, zenity, tar and wget from flatpak. Silverblue does not have them installed.
```

--------------------------------

### Error Message for No Installed Exes

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

Displays an error message if the prefix does not contain any installed executables.

```bash
If prefix do not have any installed exe, show error message
```

--------------------------------

### Install WineHQ Stable Flatpak

Source: https://github.com/fastrizwaan/winezgui/blob/main/README.md

Adds the Flathub repository if it doesn't exist and installs the stable version of WineHQ's Wine using Flatpak. This is recommended for distros that don't package Wine.

```bash
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-24.08
```

--------------------------------

### Delete Setup/Installer Script After Shortcut Creation

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

Once desktop shortcuts are successfully created following a setup, the original setup/installer script is deleted to maintain a clean environment.

```bash
Delete Setup/Installer script after creating shortcuts
```

--------------------------------

### Manage Installed Executables

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

Provides functions for changing installed executables and finding them.

```bash
winezgui-change-installed-exe and script-find-installed-exe
```

--------------------------------

### Update Desktop File After Installer

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

After an installer runs and new executables are found, this updates the name in the desktop file.

```bash
update name in desktop file
```

--------------------------------

### Install Wine Dependencies on Fedora

Source: https://github.com/fastrizwaan/winezgui/blob/main/README.md

Installs Wine and its essential dependencies on Fedora 36 using the DNF package manager. Includes utilities like zenity, winetricks, and exiftool.

```bash
sudo dnf install zenity wine winetricks perl-Image-ExifTool icoutils gnome-terminal wget zstd samba-winbind-clients.x86_64 samba-winbind-clients.i686
```

--------------------------------

### Open Other Executables

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

Allows both installed and non-installed executables to be run.

```bash
Open Other EXE, allow Installed and non installed exe to run
```

--------------------------------

### Remove Installer Created Desktop Shortcuts

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

Finds and removes desktop shortcuts created by installers from the user's local applications directory.

```bash
Find and remove Installer Created desktop shortcuts from wine directory
  
      grep -r "$WINEPREFIX" ~/.local/share/applications/wine/|cut -f1 -d ":"|sort -u
```

--------------------------------

### Copy System Runner

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

Copies a system runner from a Flatpak Wine installation to a local directory. This operation might fail due to permission issues.

```bash
cp /var/lib/flatpak/app/org.winehq.Wine/x86_64/stable-23.08/active/files ~/wine-8.0-flathub
```

--------------------------------

### Ask User to Allow Flatpak System Access

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

For Flatpak installations, users are prompted to allow system access for 'kill' and 'open terminal' operations. This is a necessary step for WineZGUI to manage processes within the Flatpak sandbox.

```bash
Ask user to allow flatpak system access for kill and open terminal
```

--------------------------------

### Use System Tar and Zstd for Backups

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

Optimizes backup and save operations by utilizing the system's installed tar and zstd binaries if available. This can lead to faster and more efficient compression and archiving.

```bash
Use system's tar and zstd if found, to backup/save
```

--------------------------------

### Open Terminal with Specific Environment

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

Opens a terminal (gnome-terminal in this case) with specific environment variables (WINEPREFIX, WINEARCH) and executables (wine, winetricks) set for Flatpak or system installations.

```bash
gnome-terminal flatpak
  - [x] WINEPREFIX
  - [x] WINEARCH
  - [x] wine
  - [x] winetricks
```

```bash
gnome-terminal system
```

--------------------------------

### Get Latest Kron4ek Wine Build URL

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

Fetches the download URL for the latest Wine build from Kron4ek's GitHub releases. This is useful for downloading the most recent Wine version.

```bash
WINEBUILDS=$(curl -s https://api.github.com/repos/Kron4ek/Wine-Builds/releases/latest|grep browser_download_url|grep tar|cut -f2- -d ":"|sed "s|'|'|g")
for i in $WINEBUILDS ; do echo $i; done|head -n1
```

--------------------------------

### Remove Broken Links After Deleting .desktop File

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

After deleting a setup's .desktop file, any associated broken links are now removed. This helps maintain a clean and organized application menu.

```bash
Remove broken links after deleting setup's .desktop file
```

--------------------------------

### Launch Setup.exe and Prompt for Default

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

Launches setup.exe or install.exe and prompts the user to set it as the default executable.

```bash
Launch setup.exe/install.exe and ask to set default exe
```

--------------------------------

### Get Kron4ek Wine 8.0 Build URL

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

Fetches the download URL for Wine 8.0 from Kron4ek's GitHub releases. This command is used to download specific Wine 8.0 versions.

```bash
WINEBUILDS=$(curl -s https://api.github.com/repos/Kron4ek/Wine-Builds/releases|grep browser_download_url|grep tar|cut -f2- -d ":"|sed "s|'|'|g")
for i in $WINEBUILDS ; do echo $i; done|grep -i wine-8.0|head -n1
```

--------------------------------

### Get Kron4ek Wine 9.0 Build URL

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

Retrieves the download URL for Wine 9.0 from Kron4ek's GitHub releases. This command specifically targets Wine 9.0 builds.

```bash
WINEBUILDS=$(curl -s https://api.github.com/repos/Kron4ek/Wine-Builds/releases|grep browser_download_url|grep tar|cut -f2- -d ":"|sed "s|'|'|g")
for i in $WINEBUILDS ; do echo $i; done|grep -i wine-9.0|head -n1
```

--------------------------------

### Use wzt-info.yml for Configuration

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

Switches to using 'wzt-info.yml' for configuration information.

```bash
Use wzt-info.yml
```

--------------------------------

### Launching Game Scripts

Source: https://context7.com/fastrizwaan/winezgui/llms.txt

Demonstrates how to launch game scripts directly from the command line and with specific actions.

```bash
# The game script window provides these options:
# - Launch...              - Run the game
# - Open Other EXE...      - Run another EXE in the same prefix
# - Winetricks GUI...      - Open winetricks graphical interface
# - Winetricks CLI...      - Install winetricks verbs via command line
# - Wine Programs...       - Access Wine configuration tools
# - Open File Manager...   - Browse prefix directory
# - Open Shell...          - Open terminal in prefix directory
# - Change...              - Modify game settings
# - Backup...              - Create prefix/bundle backup
# - Save/Load...           - Manage game saves
# - More...                - Additional options
# - About...               - Game script information
# - Help...                - Help for script options
# - Quit....               - Close script window

# Launch script directly from command line:
~/.local/share/winezgui/Prefixes/MyGame-abc1234567/MyGame.sh

# Launch with specific action:
~/.local/share/winezgui/Prefixes/MyGame-abc1234567/MyGame.sh launch
~/.local/share/winezgui/Prefixes/MyGame-abc1234567/MyGame.sh backup
~/.local/share/winezgui/Prefixes/MyGame-abc1234567/MyGame.sh delete
~/.local/share/winezgui/Prefixes/MyGame-abc1234567/MyGame.sh shortcut
```

--------------------------------

### Create Shortcuts: Script, Icon, and Desktop File

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

This section details the creation of shortcuts, including generating a script file with the new EXE name, creating an icon file, and setting up the desktop file for integration with the system.

```bash
Shortcuts
  - [x] Create
    - [x] Create Script file with New EXE Name,
    - [x] Create Icon file, and desktop file
    - [x] Create Prefix should create shortcut!
```

--------------------------------

### Delete Temp Directory After Install

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

After an application installation is finished, the temporary directory 'drive_c/users/$user/Temp' is deleted. This cleans up any temporary files created during the installation process.

```bash
Delete drive_c/users/$user/Temp directory after install
```

--------------------------------

### Enable Direct Launch Mode

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

Sets WineZGUI to direct launch mode by finding and deleting the 'direct-launch.txt' file.

```bash
Set as direct launch, winezgui find and delete direct-launch.txt to enable disable
```

--------------------------------

### Restore Backup via Command Line

Source: https://context7.com/fastrizwaan/winezgui/llms.txt

Restores Wine prefixes or game bundles from .wzt files using the command line. After restoration, the prefix is created in the Prefixes directory, the desktop shortcut is regenerated, and configuration files are updated.

```bash
# Restore via GUI:
# 1. Open WineZGUI
# 2. Select "Restore..."
# 3. Choose .wzt file
# 4. Prefix is extracted to Prefixes directory

# Restore via command line:
winezgui /path/to/MyGame-WineZGUI-0.99-Prefix-Backup.wzt

# After restoration:
# - Prefix is created in ~/.local/share/winezgui/Prefixes/
# - Desktop shortcut is regenerated
# - Wine prefix is updated for current Wine version
# - found-exe-files.yml is regenerated to prevent new exe prompts
```

--------------------------------

### Copy Default to Create Prefix Directory

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

Copies default settings to the create-prefixdir before running winezgui-create-prefix.

```bash
copy default to create-prefixdir then run winezgui-create-prefix
```

--------------------------------

### WineZGUI Directory Structure Overview

Source: https://context7.com/fastrizwaan/winezgui/llms.txt

Understand the main WineZGUI data directory structure, including locations for settings, game prefixes, templates, and custom Wine runners. Also notes the locations for desktop shortcuts and application data.

```bash
# Main WineZGUI data directory:
~/.local/share/winezgui/ 
├── About.yml                    # Application info
├── Settings.yml                 # Global settings
├── winetricks                   # Downloaded winetricks script
├── tmp/                         # Temporary files
├── Prefixes/                    # Game prefixes
│   ├── Game1-abc123/
│   │   ├── drive_c/             # Windows C: drive
│   │   │   ├── Program Files/
│   │   │   ├── users/
│   │   │   │   └── <user>/
│   │   │   │       ├── Documents/  # Isolated (not symlinked)
│   │   │   │       ├── Downloads/
│   │   │   │       └── Temp/
│   │   │   └── windows/
│   │   ├── dosdevices/
│   │   │   ├── c: -> ../drive_c
│   │   │   └── h: -> /home/<user>  # Home directory link
│   │   ├── Game1.sh             # Launch script
│   │   ├── Game1.desktop        # Desktop shortcut
│   │   ├── Game1.png            # Extracted icon
│   │   ├── Info.yml             # Metadata
│   │   ├── winezgui-scripts/    # Module copies
│   │   ├── system.reg           # Registry
│   │   ├── user.reg
│   │   └── userdef.reg
│   └── WineZGUI-Single-Prefix/  # Shared prefix (if enabled)
├── Templates/                   # Prefix templates
│   └── Default/
└── Runners/                     # Custom Wine runners
    └── wine-9.0/

# Desktop shortcuts location:
~/.local/share/applications/
├── system_winezgui_Game1.desktop -> <prefix>/Game1.desktop
└── system_winezgui_Game2.desktop -> <prefix>/Game2.desktop

# Application data directory (system install):
/usr/share/winezgui/             # Script modules and data
```

--------------------------------

### Suggest Product Name for Backup Filename

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

When creating a bundle or prefix backup, WineZGUI now suggests using the 'PRODUCT NAME' instead of the 'PREFIXNAME' for the backup filename. This can make backups more identifiable.

```bash
While creating bundle/prefix backup, suggest PRODUCT NAME instead of PREFIXNAME as filename
```

--------------------------------

### Uninstall WineZGUI Flatpak

Source: https://github.com/fastrizwaan/winezgui/blob/main/README.md

Command to remove the WineZGUI Flatpak installation from your system.

```bash
flatpak remove io.github.fastrizwaan.WineZGUI
```

--------------------------------

### Check Winetricks Availability and Download Latest

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

On the first run, WineZGUI checks if winetricks is available. If not, it prompts the user to download the latest version from GitHub.

```bash
On 1st run, check if winetricks is available, if ask download latest from github
```

--------------------------------

### WineZGUI Command Line Help and Version

Source: https://context7.com/fastrizwaan/winezgui/llms.txt

Displays the version or help information for the WineZGUI command-line interface. Use -v or --version for version, and -h or --help for usage instructions.

```bash
# Show version
winezgui --version
winezgui -v

# Show help
winezgui --help
winezgui -h
```

--------------------------------

### Create Script File with New EXE Name, Icon, and Desktop File

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

This process involves creating a new script file named after the new EXE, generating an icon file, and creating a corresponding desktop file. This is part of the shortcut creation workflow.

```bash
Create Script file with New EXE Name,
    Create Icon file, and desktop file
```

--------------------------------

### Download Wine Builds

Source: https://context7.com/fastrizwaan/winezgui/llms.txt

Downloads pre-built Wine versions from Kron4ek's Wine Builds, including stable, latest development, and Proton-based versions. Downloads are stored in ~/.local/share/winezgui/Runners/<runner-name>/ and affect the WINE_CMD environment variable.

```bash
# Available download options:
# - wine-8.0-stable: Stable Wine 8.0 release
# - wine-9.0-stable: Stable Wine 9.0 release
# - wine-latest: Latest Wine development build
# - wine-proton-latest: Latest Proton-based Wine

# Downloads are stored in:
# ~/.local/share/winezgui/Runners/<runner-name>/

# Runner selection affects WINE_CMD environment variable
# which is used for all Wine operations
```

--------------------------------

### Format Info.yml with Columns

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

Formats the 'info.yml' file using columns, similar to how 'restore-wzt' operates.

```bash
Use column to format info.yml like restore-wzt does
```

--------------------------------

### Show Templates Change After Extraction

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

After template files are extracted, WineZGUI now displays information about the changes or additions made. This helps users understand what templates have been updated or installed.

```bash
Show Tempaltes Change after extraction
```

--------------------------------

### Adjust Dialog Height for Found Exes

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

Dynamically adjusts the height of the 'found Installed exe' dialog based on the number of executables found, determined by 'wc -l found-exe-files.yml'.

```bash
found Installed exe dialog height based on no. of exe found (wc -l found-exe-files.yml)
```

--------------------------------

### Check SHA256sum for Executable Dissimilarity

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

Before creating a new Wine prefix, this check compares the SHA256 checksum of an existing executable (e.g., setup.exe) with a known one. If they differ, a new prefix is created to avoid potential conflicts or corruption.

```bash
exe with same name (e.g., setup.exe), check sha256sum, create new prefix if dissimilar
```

--------------------------------

### WineZGUI Prefix Structure

Source: https://context7.com/fastrizwaan/winezgui/llms.txt

Illustrates the directory structure for WineZGUI prefixes, including game data, scripts, and configuration files.

```bash
# When you open an EXE file, WineZGUI:
# 1. Copies the template prefix to a new directory
# 2. Names it based on EXE filename and SHA256 hash
# 3. Creates isolation by replacing home directory symlinks

# Prefix location structure:
# ~/.local/share/winezgui/
#  Prefixes/
#   GameName-abc1234567/           # Prefix directory
#    drive_c/                   # Windows C: drive
#    GameName.sh                # Launch script
#    GameName.desktop           # Desktop shortcut
#    GameName.png               # Extracted icon
#    Info.yml                   # Metadata file
#    winezgui-scripts/          # Module scripts
#    *.reg                      # Registry files
#  AnotherGame-def7890123/
#  Templates/                          # Prefix templates
#  Runners/                            # Wine runners
#  Settings.yml                        # Global settings
```

--------------------------------

### Prefix Template Downloads from GitHub

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

Enables the download of prefix templates directly from GitHub. This allows users to easily obtain pre-configured Wine environments for various applications.

```bash
Prefix Template Downloads
  - [x] Download templates from github
  - [x] WineZGUI-win64-UE4 (mf-install)
  - [x] Fix delete Template
```

--------------------------------

### Backup Wine Prefix

Source: https://context7.com/fastrizwaan/winezgui/llms.txt

Creates a .wzt file containing the Wine prefix, registry, configuration, and metadata. The backup process involves selecting a prefix, compression level, and destination directory, resulting in a tar.zst archive.

```bash
# Prefix backup creates a .wzt file containing:
# - Wine prefix directory
# - Registry files
# - Configuration files
# - wzt-info.yml metadata

# Backup file naming convention:
# <GameName>-WineZGUI-<version>-Prefix-Backup-<wine-version>-<date>.wzt
# Example: MyGame-WineZGUI-0.99.16-Prefix-Backup-wine-9.0-20240115_1430.wzt

# Backup process:
# 1. Select prefix to backup
# 2. Choose compression level (1-19, default 10)
# 3. Select destination directory
# 4. Creates tar.zst compressed archive
```

--------------------------------

### Download Templates from GitHub

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

Enables the download of prefix templates directly from a GitHub repository. This provides users with easy access to pre-configured Wine environments for various applications.

```bash
Download templates from github
```

--------------------------------

### Get Latest Glorious Eggroll Wine-GE Build URL

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

Retrieves the download URL for the latest Wine-GE (Glorious Eggroll) custom build from GitHub. This is used for obtaining the most recent GE-Proton version.

```bash
WINEGE=$(curl -s https://api.github.com/repos/GloriousEggroll/wine-ge-custom/releases/latest |grep browser_download_url|grep tar|cut -f2- -d ":"|sed "s|'|'|g")
```

--------------------------------

### Use info.yml instead of Info.yml

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

Standardizes the info file name to 'info.yml' instead of 'Info.yml'.

```bash
Use info.yml for info file instead of Info.yml
```

--------------------------------

### Display Template in About Section

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

Shows the currently used template in the 'About' section of WineZGUI.

```bash
Show Template in USE in about
```

--------------------------------

### Backup Prefix and Templates

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

Ensures that both the prefix and its associated templates are backed up.

```bash
make sure both prefix and templates are back up
```

--------------------------------

### Download Kron4ek Proton Wine Build

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

Downloads the latest Proton-compatible Wine build from Kron4ek's GitHub releases. It uses a loop to find the Proton build URL and then downloads it using wget.

```bash
WINEBUILDS=$(curl -s https://api.github.com/repos/Kron4ek/Wine-Builds/releases|grep browser_download_url|grep tar|cut -f2- -d ":"|sed "s|'|'|g")
wget $(for i in $WINEBUILDS ; do echo $i; done|grep -i proton|head -n1)
```

--------------------------------

### Show Runtime Dependencies

Source: https://github.com/fastrizwaan/winezgui/blob/main/INSTALL.txt

Use the --deps option to list the runtime dependencies required for WineZGUI.

```bash
./setup --deps
```

--------------------------------

### Use GAMEDIR for Game Bundles

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

Replaces the 'bundled_game' directory with 'GAMEDIR' for handling game bundles.

```bash
Use GAMEDIR instead of bundled_game directory for Game Bundle.
```

--------------------------------

### Winetricks CLI Verb List

Source: https://context7.com/fastrizwaan/winezgui/llms.txt

Lists common winetricks verbs for game requirements and explains their purpose.

```bash
# Default verb list for common game requirements:
# mfc42 xact xact_x64 gmdls vcrun2003 vcrun2005 vcrun2008 vcrun2010 vcrun2019 faudio quartz avifil32 corefonts

# The CLI interface allows editing the verb list before installation
# Common verbs for games:
# - vcrun20XX: Visual C++ runtimes
# - d3dx9: DirectX 9 components
# - xact: Xbox Audio Cross-Platform Tool

```

--------------------------------

### Template Download using Wget Directly

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

Updates the template download process to use the wget command directly, ensuring reliability even if WGET_CMD is not defined.

```bash
use wget instead of WGET_CMD in Template Download
```

--------------------------------

### Restore WineZGUI Backup or Bundle

Source: https://context7.com/fastrizwaan/winezgui/llms.txt

Restores a previously backed up Wine prefix or game bundle from a .wzt file. The .wzt file is a tar.zst archive containing metadata, prefix, and optionally game files.

```bash
# Restore a WineZGUI backup file
winezgui /path/to/backup/MyGame-WineZGUI-0.99-Prefix-Backup.wzt

# Restore a game bundle (includes game files + prefix)
winezgui /path/to/bundles/MyGame-WineZGUI-0.99-Game-Bundle.wzt
```

--------------------------------

### Create Prefix Shortcut

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

Ensures that when a new Wine prefix is created, a corresponding shortcut is automatically generated. This simplifies the process of launching applications within the new prefix.

```bash
Create Prefix should create shortcut!
```

--------------------------------

### Set Launch Behavior Directly/Script

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

Introduces an option under 'More -> Set Launch Behavior' to choose between 'directly' or 'script'. This allows users to control how applications are launched within their Wine prefixes.

```bash
More->Set Launch Behavior-> directly/script
```

--------------------------------

### Create Game Bundle

Source: https://context7.com/fastrizwaan/winezgui/llms.txt

Generates shareable bundles including the Wine prefix, game directory, and runner metadata. The game directory is copied into the prefix. Ensure the game is in a dedicated folder before bundling and avoid bundling from restricted system directories.

```bash
# Game bundle includes:
# - Wine prefix with all configurations
# - Game directory (copied into prefix)
# - Runner (if using custom runner from Runners directory)
# - wzt-info.yml with restoration metadata

# Bundle file naming convention:
# <GameName>-WineZGUI-<version>-Game-Bundle-<wine-version>-<date>.wzt
# Example: MyGame-WineZGUI-0.99.16-Game-Bundle-wine-9.0-20240115_1430.wzt

# Game directory is stored at:
# <prefix>/drive_c/GAMEDIR/<original-game-folder-name>/

# Restrictions - cannot bundle games from these directories:
# /, /boot, /dev, /etc, /home, /media, /mnt, /opt, /proc, /root
# /run, /srv, /sys, /tmp, /usr, /var, ~, ~/Desktop, ~/Documents
# ~/Downloads, ~/Music, ~/Pictures, ~/Public, ~/Templates, ~/Videos

# Copy game to a dedicated folder before bundling:
mkdir -p ~/Games/MyGame
cp -r /path/to/game/* ~/Games/MyGame/
```

--------------------------------

### Show Progress for Template Download

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

Provides visual feedback to the user during template downloads by displaying a progress indicator. This improves the user experience by showing that the download is active.

```bash
Show progress for template Download
```

--------------------------------

### Granting Host Filesystem Access (Flatpak)

Source: https://github.com/fastrizwaan/winezgui/blob/main/README.md

Use this command to grant read-only access to the host filesystem for the WineZGUI Flatpak if files are not in standard directories. This requires the Flatseal application or command-line usage.

```bash
flatpak --user override --filesystem=host:ro io.github.fastrizwaan.WineZGUI
```

--------------------------------

### Use df Instead of mount for Partition Information

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

Switches from using the 'mount' command to 'df' for retrieving information about mounted partitions. 'df' is generally preferred for checking available disk space and mounted file systems.

```bash
Use df instead of mount to find mounted partitions
```

--------------------------------

### Update Script Help

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

The help documentation for scripts has been updated. This provides users with more current and accurate information on how to use and manage scripts within WineZGUI.

```bash
Update Script help
```

--------------------------------

### Import/Copy Gamedir Inside Sandbox/Prefix

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

Allows users to import or copy game directories directly into the sandbox or prefix. This simplifies the process of adding games to WineZGUI managed environments.

```bash
Import/Copy Gamedir inside sandbox/prefix
```

--------------------------------

### Update Info.txt to Info.yml

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

Updates the usage of info.txt to Info.yml in the create-prefix script.

```bash
Fix info.txt use by info.txt->Info.yml in create-prefix
```

--------------------------------

### Configure Game Environment Variables

Source: https://context7.com/fastrizwaan/winezgui/llms.txt

Set environment variables for individual games by creating or editing the 'environment-variable.yml' file within the game's prefix directory. Common variables for DXVK, Wine debugging, and MangoHud are listed.

```bash
# Environment variables are stored in:
# <prefix>/environment-variable.yml

# Example environment-variable.yml:
# args:DXVK_HUD=fps

# Common environment variables for games:
# DXVK_HUD=fps,memory        # Show DXVK overlay
# WINEDEBUG=-all             # Disable Wine debug output
# WINE_LARGE_ADDRESS_AWARE=1 # Enable large address aware
# MANGOHUD=1                 # Enable MangoHud overlay
# MESA_GL_VERSION_OVERRIDE=4.6 # Override OpenGL version

# Command-line arguments for EXE are stored in:
# <prefix>/cmdline.yml
# Example:
# args:-windowed -skipintro
```

--------------------------------

### Change Zenity and Wget to Command Variables

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

Standardizes the use of command variables ${ZENITY_CMD} and WGET_CMD for Zenity and Wget calls. This allows for easier customization or replacement of these tools if needed.

```bash
change all zenity, wget to $ZENITY_CMD and WGET_CMD
```

--------------------------------

### Use ${HOME} Instead of /home/${user} for Silverblue Compatibility

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

Replaces hardcoded paths like /home/${user} with the ${HOME} variable. This is essential for compatibility with systems like Silverblue, where the user's home directory might be located at /var/home instead of /home.

```bash
Use ${HOME} insetad of /home/${user}. Needed for silverblue's $HOME is at /var/home and not at /home.
```

--------------------------------

### Enable Single Prefix Mode

Source: https://context7.com/fastrizwaan/winezgui/llms.txt

Configure WineZGUI to use a single, shared Wine prefix for all games by setting 'single-prefix:Y' in Settings.yml. This mode can save disk space but may lead to conflicts.

```bash
# When enabled:
# - All EXE files share one prefix
# - Useful for applications that need to interact
# - Reduces disk space usage
# - May cause conflicts between applications

# Single prefix location:
# ~/.local/share/winezgui/Prefixes/WineZGUI-Single-Prefix/

# Enable via Settings -> Use Single Prefix for all Exes... 
# Or set in Settings.yml:
# single-prefix:Y
```

--------------------------------

### Revert Direct Launch on Restore

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

When restoring a prefix, the 'Direct Launch' behavior is reverted. This ensures that the restore process doesn't inadvertently change the default launch behavior.

```bash
Revert Direct Launch on restore wzt
```

--------------------------------

### Save/Load Functionality for Prefixes

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

Introduces comprehensive save and load functionality for Wine prefixes. This includes options to save, restore, and manage backups, with filenames incorporating the prefix name and date/time.

```bash
Save/Load...
     - [x] Save...
     -[x] Restore...
     -[x] PREFIXNAME-DATE_TIME_save.tar.zst
```

--------------------------------

### Configure Template for Prefix

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

This section details issues and fixes related to configuring templates for Wine prefixes, including opening shells and applying changes.

```bash
don't show annoying registry backed up message.
```

```bash
can't configure template, 
     - [x] open shell fails
```

--------------------------------

### Restore Multiple .desktop Files

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

Enhances the restore functionality to correctly handle multiple .desktop files. This ensures that all associated shortcuts are restored properly.

```bash
Restore Multiple .desktop files
```

--------------------------------

### Manage Wine Runners

Source: https://context7.com/fastrizwaan/winezgui/llms.txt

WineZGUI supports multiple Wine runners for compatibility. Options include setting a default runner, downloading new builds, importing local builds, backing up, restoring, and deleting runners. The Runners directory is located at ~/.local/share/winezgui/Runners/.

```bash
# Runner options:
# - Set Default Runner...  - Choose default Wine executable
# - Download Runner...     - Download Wine builds
# - Import Runner...       - Import local Wine builds
# - Backup...              - Backup runners
# - Restore...             - Restore runners
# - Delete...              - Remove runners

# Runners directory:
# ~/.local/share/winezgui/Runners/
# └─ wine-9.0/
# │   └─ bin/wine
# │   └─ lib/
# │   └─ lib64/
# └─ wine-staging-9.0/

# System default runner:
# Uses system Wine installation (e.g., /usr/bin/wine)

# Custom runner paths are stored in:
# - Settings.yml for global default
# - Info.yml for per-prefix runner
```

--------------------------------

### Use Wine Command for Version Check in Flatpak

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

In Flatpak environments, this ensures that the wine version is checked using '$WINE_CMD --version' instead of just 'wine --version'. This accounts for potential differences in how Wine is invoked within a Flatpak.

```bash
for flatpak use $WINE_CMD --version instead of wine --version
```

--------------------------------

### Configure WineZGUI Settings

Source: https://context7.com/fastrizwaan/winezgui/llms.txt

Adjust global settings for WineZGUI behavior by modifying the Settings.yml file. Options include runner, Wine architecture, and debug message settings.

```bash
# Settings options:
# - Help...                           - Settings help
# - Set Runner...                     - Default Wine runner
# - Wine Arch...                      - win32 or win64
# - Prefix Template...                - Default template
# - Launch Behavior...                - Auto-launch options
# - Debug Messages...                 - Enable/disable debug output
# - Disable Shortcuts...              - Don't create desktop shortcuts
# - Edit WZT-Info pre Bundle...       - Edit metadata before bundling
# - Use Single Prefix for all Exes... - Share prefix between games

# Settings file location:
# ~/.local/share/winezgui/Settings.yml

# Example Settings.yml:
# template:/home/user/.local/share/winezgui/Templates/Default
# runner:/usr/bin/wine
# arch:win64
# debug:Y
# no-shortcuts:
# single-prefix:
# launch-behavior:script
```

--------------------------------

### Flathub Requirements for WineZGUI

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

Specifies the necessary Flathub requirements for WineZGUI, including the application ID 'io.github.fastrizwaan.WineZGUI'. This is essential for proper packaging and distribution on Flathub.

```bash
Flathub requirements (io.github.fastrizwaan.WineZGUI)
```

--------------------------------

### Check Wine Version Against Metadata

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

Compares the current Wine version with the version specified in the metadata (Info.yml). If they differ, the user is informed, particularly important for system-installed Wine to ensure compatibility.

```bash
If wine version changes (compared to metada (Info.yml)) inform user esp. for system install (startup-checks)
```

--------------------------------

### Move Templates and Shortcuts

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

Relocates the Templates and Shortcuts sections to a more appropriate 'Configure' area within the application.

```bash
Move Templates and Shortcuts inside Configure
```

--------------------------------

### Change Prefix Executable

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

Allows changing the executable, icon, and prefix for a Wine environment.

```bash
Change Prefix Exe (exe+icon+prefix)
```

--------------------------------

### Execute Script with Specific Prefix Directory and Name

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

Ensures that the winezgui-recreate-script command utilizes the same prefix directory and script name as the original.

```bash
winezgui-recreate-script should use same prefixdir, same name
```

--------------------------------

### Recreate Scripts with Current WineZGUI Version

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

This command is used to regenerate existing scripts to be compatible with the current WineZGUI version. It handles both downgrades and upgrades.

```bash
for i in *.sh; do grep EXE_FILE -$i; winezgui-recreate-script $i; done
```

--------------------------------

### Check Wine Version in Script Launch

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

This script checks and compares the Wine version specified in Info.yml with the one found using $(which wine).

```bash
0.89.1
```

--------------------------------

### Optimize wzt-info.yml Extraction

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

Speeds up the extraction of wzt-info.yml from wzt files by placing it at the beginning of the archive. This change breaks backward compatibility.

```bash
Speed up wzt-info.yml extraction from wzt file by putting it on the top of
  
      archive. Breaks backward compatibility.
```

--------------------------------

### Determine Wine Architecture

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

Determines the Wine architecture (32-bit or 64-bit) by grepping the 'arch' setting from the system.reg file. Refer to 'winezgui-template-change' for more details.

```bash
grep "#arch=" system.reg|cut -f2 -d "="
```

--------------------------------

### Update Info.yml Files

Source: https://github.com/fastrizwaan/winezgui/blob/main/Todo.md

Updates all *_Info.yml files, likely to reflect changes in runner or wine version.

```bash
update all *_Info.yml on script-change-runner
```