Thatch is a native, ultra-lightweight, and strictly minimalist Wine Prefix & Compatibility Commander written in Python and PySide6. It is designed as a direct, lightning-fast alternative to bloated compatibility managers like Bottles, optimized specifically to run natively outside Flatpak sandboxes, eliminate container overhead, and offer native system integration.

While Bottles is a powerful tool, it suffers from heavy sandboxing overhead, container permission issues (Flatpak), and nested container complications (such as running Steam or third-party launchers).

Thatch is rewritten from scratch to offer a simpler, native, secure, and highly performant experience:

When a "Chest" (prefix) is sandboxed, Thatch locks it down immediately:

• Host Filesystem Isolation: Standard user folders (Desktop, Documents, Downloads, Music, Pictures, Videos) under drive_c/users/steamuser/ are securely unlinked and replaced with localized clean directories.
• Root Drive Elimination: The standard Wine Z: symlink pointing to the Linux root / filesystem is entirely destroyed, sealing the prefix.

To allow installation of games without breaching isolation:

• Zeus Engine Temporary Mounting: When running an installer (like a GOG setup), Zeus automatically maps the installer's parent directory as a virtual Unidad D: inside the prefix's dosdevices/.
• Wine sees the installer as running safely from D:\setup.exe and has access only to that folder.
• Once the installation exits, the D: drive is unlinked instantly, sealing the sandbox again.
• Drives Manager UI: Users can permanently map custom letters (D:, E:, Y:, etc.) via a gorgeous visual panel inside Settings only when the Sandbox is active, keeping operations clean and clear.

Initializing prefixes (wineboot -u) inside a graphical environment often triggers invisible prompts for Wine Mono/Gecko download, causing silent deadlocks. Thatch completely bypasses this via:

• Silent DLL Overrides: Setting WINEDLLOVERRIDES="mscoree,mshtml=d" tells Wine to bypass Gecko/Mono installation prompts entirely.
• Log Suppression: Injected WINEDEBUG="-all" prevents verbose Wine logs from saturating standard streams, avoiding classical QProcess pipe write deadlocks.
• Universal Runner Call: Avoids looking for standalone wineboot binaries (which are missing in modern runners like Proton 10) by routing operations universally through the core wine wineboot -u caller.

Instead of loading massive 10MB+ registry files into memory and running slow multiline regular expressions, Thatch uses an ultra-optimized line-by-line tokenizer:

• Scans system.reg and user.reg using buffered block streams.
• Discards non-Uninstall registry lines instantly under micro-seconds.
• Results in 0% CPU spikes and virtually zero memory allocations during UI updates.

Thatch runs natively and requires Python 3.10+, PySide6, and Winetricks installed on your Linux system.

# On Ubuntu / Debian:
sudo apt update
sudo apt install python3 python3-venv winetricks wine

1. Clone the repository:

   git clone https://github.com/esfingex/thatch.git
   cd thatch

2. Create a virtual environment and install requirements:

   python3 -m venv venv
   source venv/bin/activate
   pip install -r setup.py # or pip install -r requirements.txt

3. Launch Thatch:

   ./venv/bin/python thatch.py

thatch/
├── src/
│   ├── main.py                  # Coordinator main window & installer hooks
│   ├── database.py              # Atomic SQLite database & schema migrations
│   ├── hardware.py              # GPU manufacturer and Zen synchronization probing
│   ├── style.py                 # Pure flat dark QSS Stylesheet
│   └── views/
│       ├── __init__.py          # Modular views exports
│       ├── chests_view.py       # Treasure prefix grid list
│       ├── chest_details_view.py# Detailed tabs (Details, Programs, Deps, Settings)
│       ├── cargo_view.py        # App catalog and search store
│       ├── wine_runners_view.py # Asynchronous downloader and old runtime cleaner
│       ├── preferences_view.py  # Consolidated defaults and path settings
│       ├── create_chest_wizard.py# Stepper visual wizard
│       └── toast_notification.py# Overlay float notifications
├── config/
│   └── recipes/                 # Game/App preset JSON templates (Grim Dawn, Elden Ring, etc.)
├── runners/                     # Extracted custom Wine compiler runtimes
├── prefixes/                    # Default storage path for created Wine Chests
├── thatch_db.sqlite             # Local active SQLite database configuration
└── thatch.py                    # App launcher entrypoint

Thatch is open-source software licensed under the MIT License.