Introduction
Kaon is an preliminary set of configurations, tools, and instructions for use with the macOS Steam client which allows Windows games to be more easily installed and run (via CrossOver or Wine) while still making as much as possible use of the the native macOS Steam client. It's vaguely reminiscent of the Linux Steam client's Steam Play & Proton integration, but with a large number of hacky rough edges.
TL;DR
Have a working macOS Steam client installation, and a working CrossOver installation with the Windows Steam client installed in its own bottle (e.g. a Bottle name "Steam", referred to as \ in these instructions). Both installations should be on the same volume of your Mac.
Configure the macOS Steam client to think its user interface and Install/Play logic are on Windows by putting the line @sSteamCmdForcePlatformType windows into a new file named ~/Library/Application Support/Steam/Steam.AppBundle/Steam/Contents/MacOS/steamdev.cfg
Connect the Windows Steam client's default library to the macOS Steam client as a shared library. This takes a few steps to convince the macOS Steam client since it works hard to prevent two libraries from existing on the same volume -- detailed instructions below.
Copy the scripts directory of this project into your shared library (for example to ~/Library/Application Support/CrossOver/Bottles//drivec/Program Files (x86)/Steam/steamapps/common/Kaon).
Install pyton3.11 and its dependencies and use the modified steammetadataeditor tool in this project to create additional Windows launch options for your games, adding a new Windows launch menu options to launch them through ../Kaon/launchwithlog.sh for debugging launching issues, or through ../Kaon/launchcrossover.sh once all is well.
[truncated]
Kaon is an preliminary set of configurations, tools, and instructions for use with the macOS Steam client which allows Windows games to be more easily installed and run (via CrossOver or Wine) while still making as much as possible use of the the native macOS Steam client. It's vaguely reminiscent of the Linux Steam client's Steam Play & Proton integration, but with a large number of hacky rough edges.
TL;DR
Have a working macOS Steam client installation, and a working CrossOver installation with the Windows Steam client installed in its own bottle (e.g. a Bottle name "Steam", referred to as \ in these instructions). Both installations should be on the same volume of your Mac.
Configure the macOS Steam client to think its user interface and Install/Play logic are on Windows by putting the line @sSteamCmdForcePlatformType windows into a new file named ~/Library/Application Support/Steam/Steam.AppBundle/Steam/Contents/MacOS/steamdev.cfg
Connect the Windows Steam client's default library to the macOS Steam client as a shared library. This takes a few steps to convince the macOS Steam client since it works hard to prevent two libraries from existing on the same volume -- detailed instructions below.
Copy the scripts directory of this project into your shared library (for example to ~/Library/Application Support/CrossOver/Bottles//drivec/Program Files (x86)/Steam/steamapps/common/Kaon).
Install pyton3.11 and its dependencies and use the modified steammetadataeditor tool in this project to create additional Windows launch options for your games, adding a new Windows launch menu options to launch them through ../Kaon/launchwithlog.sh for debugging launching issues, or through ../Kaon/launchcrossover.sh once all is well.
[truncated]