Run Windows applications on Debian and Ubuntu based Linux Distros with full GPU support

*Note this is a work in progress, experimenting with python, shell and c with the use of AI (to speed things up), some functions may not work the way you or I want it to, as such some tinkering, and troubleshooting is required for installation and proper use of this program.

If you have knowledge in the Shell and Phython coding lanauge, I highly suggest you comment what type of tricks I can use to improve the effectiveness of my code.

curl -sSL https://raw.githubusercontent.com/thomasboy2017/Winpatable-/main/install.sh | bash

winpatable detect

winpatable quick-start

Done! You're ready to install Windows applications.

• Getting Started Index - Find what you need quickly
• Quick Start Guide - Start here! Easy 3-step setup
• Application Guides - How to install specific apps
• GPU Guide - GPU setup and troubleshooting
• Troubleshooting - Common issues & solutions
• Architecture - Technical details

• OS: Ubuntu 20.04+ or Linux Mint 20+
• CPU: Intel Core i5 or AMD Ryzen 5 (x64)
• RAM: 4 GB (8 GB recommended)
• Storage: 30 GB free space

• OS: Ubuntu 24.04 LTS or Linux Mint 21+
• CPU: Intel Core i7/i9 or AMD Ryzen 7/9
• RAM: 16-32 GB
• Storage: 100+ GB on SSD
• GPU: NVIDIA RTX 3060+ or equivalent

curl -sSL https://raw.githubusercontent.com/thomasboy2017/Winpatable-/main/install.sh | bash

Just copy and paste! The installer handles everything.

git clone https://github.com/thomasboy2017/Winpatable-.git
cd Winpatable-
chmod +x install.sh
./install.sh

python3 scripts/wizard.py

Gets you through setup step-by-step with explanations.

See QUICK_START.md for an easy visual guide

# Check if your system is compatible
winpatable detect

# Automatic setup (recommended)
winpatable quick-start

# Install Microsoft Office
winpatable install-app office --installer ~/Downloads/office.exe

# List supported applications
winpatable list-apps

# Get performance tips
winpatable performance-tuning

# View all commands
winpatable --help

A: Usually 90-95% as fast. Professional apps like Premiere run at near-native speeds with GPU acceleration.

A: No, but it helps. Professional apps run much faster with GPU (NVIDIA RTX recommended).

A: Yes! Applications run in an isolated environment (Wine prefix) and can't access your entire system.

A: Yes! They share the same environment and can communicate.

A: Just delete ~/.winpatable and run setup again. Everything is isolated.

A: Check GPU utilization with nvidia-smi. Also close other apps and disable desktop effects.

A: Yes! See uninstall section below.

# Add to PATH
echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

1. Check file path is correct: ls /path/to/installer.exe
2. Verify Wine is installed: wine --version
3. Check free disk space: df -h

1. Check GPU: nvidia-smi (NVIDIA) or rocm-smi (AMD)
2. Close other applications
3. Use SSD for projects

# Try manual installation
winpatable install-gpu-drivers

# Verify
nvidia-smi  # for NVIDIA
rocm-smi    # for AMD

Need more help? See Application Guides

# Remove Winpatable data
rm -rf ~/.winpatable

# Remove command
sudo rm /usr/local/bin/winpatable

# Remove installation (optional)
sudo rm -rf /opt/winpatable

That's it! Everything is isolated and safe to delete.

• QUICK_START.md - Fast setup guide ⭐ START HERE
• APPLICATION_GUIDES.md - App-specific installation
• GPU_GUIDE.md - GPU setup and troubleshooting
• ARCHITECTURE.md - Technical deep dive Bring compatibilty with Windows Apps (coded using ai)