# Bourbon-OSS

> What Bourbon learned, in the open.

Canonical page: https://pyrosoft.pro/software/bourbon-oss

Status: active
Platforms: macOS

Bourbon-OSS is the open, reusable layer of Bourbon 26, published on GitLab under the MIT licence. It carries the Smart Play recipes, community compatibility catalogs and small fixes Bourbon relies on, so anyone running Windows games through Wine on a Mac can use them in their own setup. The Bourbon 26 app itself, with its SwiftUI interface, orchestration and Smart Play launch engine, stays private. Inside are managed recipes graded verified, recipe or known_failure, plus Smart Play launch plans; a mined catalog of Mac-safe per-game fixes; an Apple Gaming Wiki and Are We Anti-Cheat Yet snapshot; a DXVK-macOS Direct3D 9 patch for MoltenVK; a shim that fixes Steam's black window under Wine on Apple Silicon; and minimal Direct3D 11 probes for checking GPTK, DXVK and DXMT. The Python tools use only the standard library: compat_sources.py looks up a community verdict offline and refreshes the data, mine_fixes.py re-mines protonfixes, Whisky and Lutris notes, and rom_metadata.py matches console ROMs to the Libretro database. The project thanks Wine, Whisky, CrossOver, Apple Gaming Wiki and the wider Windows-on-Mac community; publishing what Bourbon verifies is how PyroSoft gives back.

Price: Free.

## Features

- Managed Smart Play recipes graded verified, recipe or known_failure
- Per-game fixes for 528 Steam games (236 concrete), mined from protonfixes, Whisky, Lutris
- Apple Gaming Wiki and Are We Anti-Cheat Yet community snapshot
- MoltenVK-friendly DXVK-macOS Direct3D 9 patch
- Steam CEF shim that fixes the black Steam window under Wine on Apple Silicon
- Minimal D3D11 clear and cube probes for GPTK, DXVK and DXMT
- ROM titles, box art and clear logos from the Libretro database
- Standard-library Python tools with offline compatibility lookups

## How to get it

- [Source code](<https://git.pyrosoft.pro/pyrosoft/bourbon/bourbon-oss>)

## Recorded details

- License: MIT
- Updated: 2026-08-04
- First release: Repository created Jul 20, 2026
- Tech: Python 3 (standard library); mingw-w64 for the shim and probes

## Screenshots

![The PyroSoftPro/Bourbon-OSS repository on GitHub: data, patches, probes, recipes and tools folders, an MIT licence and 40 stars](https://pyrosoft.pro/store-assets/media/1ac6172b2d-960.webp)
![The README's What's included table listing recipes, data, the DXVK patch, the Steam shim, three Python tools, the DXVK build script and the probes](https://pyrosoft.pro/store-assets/media/c1e90387e5-960.webp)
![The data folder on GitHub with eight JSON catalogs, from anticheat_blocklist.json to save_sync_rules.json](https://pyrosoft.pro/store-assets/media/df958eeee5-960.webp)
![The tools README: the Steam CEF shim build line and install steps, and the community refresh commands](https://pyrosoft.pro/store-assets/media/53ee6949dc-960.webp)
![The DXVK bourbon-d3d9 patch README explaining the three fixes: device creation, the MSL sampler matrix and an obsolete MinGW stub](https://pyrosoft.pro/store-assets/media/5d5825dcc4-960.webp)
![Bourbon 26's compatibility page: titles tracked, native macOS and Wine counts, bottle filters, and game cards marked Homegrown or Not Compatible](https://pyrosoft.pro/store-assets/media/32b992e56b-960.webp)

## Questions

### Is this Bourbon 26 for free?

No. Bourbon-OSS is data, patches and small tools, not the app. Bourbon 26's orchestration, SwiftUI interface and Smart Play launch engine stay private.

### Can I use the catalogs in my own launcher?

Yes. Bourbon-authored data is MIT. For the community-derived files, keep the attribution described in NOTICE and respect each upstream project's terms.

### What do I need to run the tools?

Python 3 and nothing else for the Python tools. Building the Steam shim and the probes needs mingw-w64.

### Does anything here download games, ROMs or BIOS files?

No. rom_metadata.py fetches only catalogue text and cover images from the Libretro projects.