Bourbon-OSS

Open-source compatibility data, patches, and tools from Bourbon 26 — our contribution back to the Wine / Whisky / CrossOver / Windows-on-Mac gaming community.

This repository is not the Bourbon app. The paid product’s orchestration, SwiftUI UI, and Smart Play launch engine stay private. What we publish here is the reusable layer: recipes, community catalogs, Mac-safe fix mining, and small fixes anyone can apply in their own Wine prefixes.

Giving back to the community

For years, the Windows-on-Mac community has shared compatibility notes, renderer tips, workarounds, and hard-won knowledge that made projects like Bourbon possible. Publishing these catalogs and tools is how we return the favor — so others can reuse, improve, and extend what we’ve verified.

Thank you to everyone who maintains Wine and its forks, builds tools like Whisky, ships CrossOver, contributes to Apple Gaming Wiki and similar databases, and helps Mac players keep Windows games running. Your support and openness are the foundation this work stands on.

What’s included

Path	Role
recipes/	First-party Smart Play recipes + confirmed plans
data/	Game fixes, community snapshot, resource pins, save-sync rules, anticheat list
patches/dxvk-bourbon-d3d9/	MoltenVK-friendly DXVK-macOS D3D9 patch
tools/steamwebhelper_shim.c	Steam CEF black-UI shim for Wine on Apple Silicon
tools/mine_fixes.py	Mine protonfixes / Whisky / Lutris → Mac-safe game_fixes.json
tools/compat_sources.py	Refresh AGW / AWACY / ProtonDB / MacGamingDB community data
tools/rom_metadata.py	Resolve console ROMs against the Libretro database — canonical titles, box art, clear logos
tools/build_dxvk_bourbon_d3d9.sh	Build the bourbon-d3d9 DXVK drop-in
probes/	Minimal D3D11 clear/cube smoke tests for GPTK / DXVK / DXMT

See tools/README.md and probes/README.md.

Quick start

# Community verdict for a title (uses shipped data/)
python3 tools/compat_sources.py verdict --store steam --game-id 400 --name Portal

# Rebuild mined fixes from public sources
python3 tools/mine_fixes.py --out data/game_fixes.json --skip-lutris

# Canonical title + box art for a ROM, from libretro-database
python3 tools/rom_metadata.py media-batch --base ~/.cache/bourbon \
  --roms "/path/to/SNES/Super Mario World (USA).sfc"

# Build the Steam CEF shim (mingw-w64)
x86_64-w64-mingw32-gcc -O2 -mwindows -municode \
  tools/steamwebhelper_shim.c -o steamwebhelper.exe

Recipe statuses

Managed recipes in recipes/compat_recipes.json use:

• verified — screenshot / local QA proven
• recipe — curated plan, not yet fully verified
• known_failure — intentionally blocked or unsupported

Special thanks

Bourbon and Bourbon-OSS stand on the shoulders of open-source projects, community databases, and Windows-on-Mac tooling. Special thanks to:

Compatibility runtimes & graphics

• Wine / Wine Staging — the foundation for running Windows software on macOS
• Gcenx — especially macOS Wine builds and WineCX-style CrossOver-source packages for Apple Silicon
• CodeWeavers — for publishing CrossOver’s open Wine sources (CrossOver is a trademark of CodeWeavers, Inc.; Bourbon is not affiliated)
• DXVK and DXVK-macOS — DirectX → Vulkan on Apple Silicon
• MoltenVK (Khronos Group) — Vulkan → Metal
• DXMT — DirectX → Metal
• VKD3D-Proton — DirectX 12 → Vulkan
• winetricks — dependency and verb helpers
• Apple Game Porting Toolkit / D3DMetal — optional DirectX → Metal evaluation path

Mac gaming tools & community projects

• Whisky — modern Wine bottle UI and community knowledge on Apple Silicon
• CrossOver — commercial Wine-on-Mac that helped define the category
• Sikarugir — public configure contracts and interoperability study (clean-room behavior review; no source reused)
• umu / protonfixes-style community fix catalogs
• Lutris — install scripts and community game configs that informed our fix notes

Compatibility databases

• Apple Gaming Wiki — Mac compatibility ratings and community reports
• ProtonDB — crowd-sourced Proton / Linux game reports
• Are We Anti-Cheat Yet? — anti-cheat status tracking
• MacGamingDB — Apple Silicon method / translation-layer reports

Host infrastructure Bourbon also relies on

• Homebrew — packaging MoltenVK, Wine, GPTK casks, and related tooling
• Sparkle — macOS app updates
• UTM / QEMU — optional OS Experience virtualization path

If your project belongs here and we missed it, open an issue — we want the credit list to stay accurate.

License

Source and Bourbon-authored recipe data: MIT.

DXVK patch retains upstream zlib licensing — see patches/dxvk-bourbon-d3d9/LICENSE.dxvk.

Third-party community snapshots and attribution: see NOTICE.