🍷 BottleForge for macOS

BottleForge is an experimental macOS utility for managing and fixing CrossOver/CXPatcher bottles. It serves as a macOS-friendly alternative to the Linux Winetricks tool. Whether you're a gamer or tinkerer, it helps apply common fixes for compatibility issues on macOS.

• 🎯 Also check out StealthPointer - hide/show your macOS cursor with hotkeys. Perfect for Wine fullscreen gaming!

---

Features

• Diagnostics Panel

  • Quickly apply well-known fixes like Visual C++ overrides
  • Great for games that keep asking for missing DLLs

• File Explorer

  • Browse and manage Wine bottle files visually
  • Inspired by Finder, so you can inspect a bottle prefix without digging through hidden folders

• WineTricks macOS (optional JSON-powered tweaks)

  • Load Wine-specific tweaks from a remote JSON database
  • One-click install/uninstall with metadata

• Game Config

  • Generate per-game launch configs directly from the app
  • Configure engine, display mode, selected tweaks, and notes without writing long shell commands

• Bottle Config

  • Manage environment variables for each bottle
  • Includes quick-add options for GPTK/D3DMetal related variables such as Metal HUD, MetalFX, DXR, FPS cap, and Metal 4 backend

• Runtime Detection

  • Detect and support both CrossOver and CXPatcher runtimes
  • Easy toggle between runtimes

• Dependencies

  • Check required tools such as GStreamer and Homebrew
  • Download GPTK 3 or GPTK 4 beta and open the selected runtime's apple_gptk install path

• Classic Winetricks Support

  • Run upstream winetricks shell scripts directly from the app
  • Useful for power users, though not all tweaks are uninstallable or macOS-friendly

• Homebrew Integration

  • Automatically detects missing tools, such as cabextract, wget, and unzip
  • Offers to install them via Homebrew with one click

• Tweak Log Panel

  • Live terminal-style output for Classic Winetricks installs
  • Helps identify errors or stuck installations

• Stuck Process Protection

  • Automatic timeout and watchdog detection if Winetricks becomes unresponsive
  • Prevents app freezes and gives useful error feedback

---

Experimental Tips

Max Files Limit Trick (for heavy games)

Boost your macOS file descriptor limits. This can help with games using thousands of assets:

sudo launchctl limit maxfiles 1048576 1048576
ulimit -n 1048576

Only works until next reboot. Not persistent.

Thermal Tip

High temperatures while gaming?

Try enabling VSync to reduce CPU/GPU load. It may reduce FPS slightly, but it lowers heat and can prevent thermal throttling.

---

Pros

• Works out-of-the-box with CrossOver and CXPatcher
• Lightweight and native app
• JSON-based tweak integration
• Friendly UI with zero CLI knowledge needed

Limitations

• Still in early development
• No auto-updates yet
• Advanced tweaks require editing external JSON

---

Building & Usage

1. Clone this repo
2. Open BottleForge.xcodeproj in Xcode
3. Build & Run (macOS 12.4+ required)

---

License

This project is licensed under the Mozilla Public License 2.0. If you modify and distribute any part of the source, you must publish those changes under the same license. More info: https://mozilla.org/MPL/2.0/

---

Made by Alien4042x