A modern GUI application for managing Wine prefixes and Proton-GE installations on Linux. Features a sleek dark theme interface with comprehensive Wine prefix management, automated Proton-GE downloads, and an intuitive favorites system. Start your .exe files the way you want!

• Automatic Discovery: Finds Wine and Bottles prefixes in standard locations (~/.wine, ~/.local/share/wineprefixes, Bottles directories)
• Custom Directories: Add your own prefix search locations
• Visually Appealing: Star icons show prefixes with favorites, folder icons for regular prefixes
• Search & Filter: Quickly find prefixes with real-time search

• Automated Downloads: Direct integration with GloriousEggroll's Proton-GE releases
• Version Management: Install, remove, and manage multiple Proton versions
• Runtime Selection: Choose between Wine or any installed Proton version

• Smart Launcher: Browse and launch Windows applications within prefixes
• Favorites System: Save frequently used applications for quick access
• System File Filtering: Hide Windows system files to focus on user applications
• Dual Runtime Support: Launch apps with Wine or Proton-GE

• Dark Theme: Modern, eye-friendly dark interface
• Efficient Layout: Effective use of screen space with organized sections
• Responsive Design: Adaptive layout that works on various screen sizes
• Status Feedback: Clear status messages and progress indicators
• Comprehensive Logging: Built-in log viewer for debugging and troubleshooting

• Operating System: Linux (tested on Ubuntu and Arch Linux)
• Python: 3.8 or higher
• Wine: Installed and configured
• Desktop Environment: Any (Gnome, KDE, XFCE, etc.)

# Core dependencies
PySide6>=6.0.0      # Qt6 GUI framework
requests>=2.25.0    # HTTP requests for Proton downloads

# Standard library (included with Python)
pathlib, json, subprocess, threading, tempfile, tarfile, shutil

# Create virtual environment
python3 -m venv wine-manager-env
source wine-manager-env/bin/activate

# Install dependencies
pip install PySide6 requests

# Run the application
python3 wine_manager.py

1. Start the application: Run python3 wine_manager.py
2. Automatic Scan: The app will automatically discover existing Wine prefixes
3. Add Custom Directories: Use "📁 Add Dir" to include additional prefix locations
4. Install Proton-GE: Click "⚙️ Proton" to manage Proton versions

• View Prefixes: All discovered prefixes appear in the left panel
• Search: Use the search box to filter prefixes by name
• Select Runtime: Choose Wine or Proton-GE from the runtime dropdown
• Launch Applications: Use "📂 choose custom .exe to run" for custom executables or "🎮 Browse Apps" to explore installed software

• Add Favorites: Browse applications and add frequently used ones to favorites
• Quick Launch: Double-click favorites or use the "🚀 Launch" button
• Remove Favorites: Select and click "🗑️ Remove" to clean up your list
• Visual Indicators: Prefixes with favorites show a ⭐ icon and count

• Access Logs: Click "📋 Logs" to open the comprehensive log viewer
• Filter Logs: Use the dropdown to filter by log level (INFO, WARNING, ERROR)
• Search Logs: Use the search box to find specific log entries
• Export Logs: Save logs to a file for sharing or analysis
• Real-time Updates: Log viewer updates automatically as new events occur

• Browse Versions: Click "⚙️ Proton" to see available releases
• Install Versions: Click "⬇️ Install" next to desired versions
• Remove Versions: Click "🗑️ Remove" for installed versions
• Progress Tracking: Watch download progress in real-time

While there is no need to manually (not with the GUI) configure anything, there still is the option to do so. This may help in error situations. The application stores its configuration in ~/.config/wine-manager/settings.json:

{
  "proton_dir": "~/.local/share/proton-builds",
  "default_proton": "",
  "prefix_proton_map": {},
  "extra_prefix_dirs": [
    "/custom/path/to/prefixes"
  ],
  "prefix_favorites": {
    "/home/user/.wine": [
      "/home/user/.wine/drive_c/Program Files/MyApp/app.exe"
    ]
  }
}

• proton_dir: Directory where Proton-GE versions are installed
• extra_prefix_dirs: Additional directories to scan for prefixes
• prefix_favorites: Favorite applications for each prefix

"No prefixes found"

• Ensure Wine is installed: wine --version
• Check if ~/.wine exists or create a prefix: winecfg
• Add custom directories using "📁 Add Dir" button

"Application won't launch"

• Verify the executable path is correct
• Check Wine prefix integrity: wine winecfg in the prefix
• Ensure required dependencies are installed in the prefix
• Check the logs: Click "📋 Logs" to see detailed error messages

"GUI looks wrong/broken"

• Update PySide6: pip install --upgrade PySide6
• Try a different desktop environment
• Check if Qt6 themes are properly installed

Run with debug output:

python3 wine_manager.py 2>&1 | tee debug.log

rm -rf ~/.config/wine-manager/

I welcome contributions!

Please include:

• Operating system and version
• Python version
• Full error traceback
• Steps to reproduce the issue

This project is licensed under the MIT License - see the LICENSE file for details.

MIT License

Copyright (c) 2025 ZeloteZ

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

• GloriousEggroll for Proton-GE builds
• Wine Project for the Wine compatibility layer
• Qt/PySide6 for the excellent GUI framework
• Community Contributors for testing and feedback
• OpenAIs ChatGPT This project relied on OpenAI’s ChatGPT for much of the code and testing.

• ✅ Stable: Core functionality is stable and tested

• Wine - Windows compatibility layer
• Proton-GE - Enhanced Proton builds
• Bottles - Another Wine prefix manager