A wrapper script for launching the official Touhou games on Steam with the Touhou Community Reliant Automatic Patcher (thcrap), and optionally the Vsync patch (vpatch) and thprac from the Steam client using Proton on GNU/Linux.
This script works by setting up and managing a global thcrap instance, launching the configuration tool when needed, all without user intervention.
Before launching a game, this script takes the command Steam would normally run, and alters it to include the patch loader. This creates a seamless integration between the Steam client and thcrap, allowing the games to function as if they weren't patched at all!
On Windows, when launching a game bought on Steam with thcrap, Steam will be able to detect and automatically wrap it, so integration will work fine.
On Linux, this isn't the case. Due to the compatibility layer used to run the games, launching them from outside the Steam client will make Steam unable to detect that they are running. This means that, while using thcrap, Steam integration won't be available, your playtime won't be tracked, and your friends won't be able to see that you are playing weird indie Japanese shmups.
Also, with Steam Play/Proton, it is expected that you can run your games without having to mess around with Wine. For Touhou, it's annoying having to fire up Wine to be able to set-up the translation patches, and then having no proper integration with Steam when trying to play the games. It gets more annoying when trying to also launch thprac specially with non-steam games.
Here's a video tutorial by Maxmani. Here is a reddit post to help you set up this on the Steam Deck by Mino_nosty (somewhat outdated)
Download the script, mark it as executable, and put under /usr/local/bin/ (or somewhere that you find convenient):
curl -O https://raw.githubusercontent.com/redirectto/thprac-steam-proton-wrapper/master/thprac_proton
chmod +x thprac_proton
mv thprac_proton /usr/local/bin
or (/home/deck/.local/share/thcrap/scripts/)
mv thprac_proton /home/deck/.local/share/thcrap/scripts
Download the latest asset from thprac (the .exe file) and put it wherever you please. You can place it for example on /home/deck/.local/share/thprac/ You can also rename it to thprac.exe or create a symlink to avoid renaming the file on each update.
If you have gone through the manual installation, you have the opportunity to change the following variables inside the script:
- The
THCRAP_FOLDERvariable points to where the thcrap installation will be located. You can to change it, for example, if you want it to point to your current thcrap installation. - The
THCRAP_CONFIGdefines the config file that will be loaded when no other is specified in the launch options. - The
THPRAC_LOCATIONvariable points to where the thprac file is located.
Go to your Steam library -> right click the game -> Properties -> and edit the launch options to:
thprac_proton -p -- %command%
In case you have put your script outside /usr/local/bin/, you'll have to provide the full path:
/path/to/thprac_proton -p -- %command%
example (/home/deck/.local/share/thcrap/scripts/)
/home/deck/.local/share/thcrap/scripts/thprac_proton -p -- %command%
This is the base command, which will run the game with the default config with thprac.
To enable thprac for that game, you have to add the -p flag inside launch options for the game.
To change the config file loaded by thcrap, use the -c flag. By default it uses en.js (english translation patch)
To enable vpatch for that game, install vpatch on the game folder and then add the -v flag on launch options.
You can force launch custom.exe with the -k flag. It doesn't work with -v or -p flags.
You can also disable thcrap, you have to use the -d flag inside launch options for the game.
If you want to launch a game with vpatch, thprac and the Spanish translation, the command would look like this:
thprac_proton -v -p -c lang_es.js -- %command%
or (generic path)
/path/to/thprac_proton -v -p -c lang_es.js -- %command%
example (/home/deck/.local/share/thcrap/scripts/)
/home/deck/.local/share/thcrap/scripts/thprac_proton -v -p -c lang_es.js -- %command%
Note: the %command% always comes at the end
If you want to use any environment variables in your launch options, you have to put them before the %command%, like this:
thprac_proton -- LANG=ja_JP.utf8 %command%
or (generic path)
/path/to/thprac_proton -- LANG=ja_JP.utf8 %command%
example (/home/deck/.local/share/thcrap/scripts/)
/home/deck/.local/share/thcrap/scripts/thprac_proton -- LANG=ja_JP.utf8 %command%
You can also launch non-steam titles with this script (sadly thprac only works if installed on the games folder for non-steam titles)
target: "/run/media/deck/3886ce52-b6d7-4ab4-b3c6-7c2c9a03391e/Games/Touhou/TH08 Imperishable Night/th08.exe"
start in: "/run/media/deck/3886ce52-b6d7-4ab4-b3c6-7c2c9a03391e/Games/Touhou/TH08 Imperishable Night/"
launch options: /home/deck/.local/share/scripts/thprac_proton -p -- %command%
target: "/run/media/deck/3886ce52-b6d7-4ab4-b3c6-7c2c9a03391e/Games/Touhou/TH06 the Embodiment of Scarlet Devil/東方紅魔郷.exe"
start in: "/run/media/deck/3886ce52-b6d7-4ab4-b3c6-7c2c9a03391e/Games/Touhou/TH06 the Embodiment of Scarlet Devil/"
launch options: /home/deck/.local/share/scripts/thprac_proton -p -- LANG="ja_JP.utf8" %command%
When thprac is installed on the same folder as the game it detects if vpatch is installed so the -v flag is not needed
Upon first launch, the script will download and set-up a thcrap instance, if there's not one already, and then launch the configuration tool, so you can generate your config files.
If you are using Big Picture (game mode) I would suggest to keep the updater running on the background due to a bug that prevents the keyboard from working, that can be fixed by switching to a different window.
And thats it!
The script sends all it's output to /tmp/thprac_proton.log, which includes the original and the modified launch commands and the command that launches thprac.
If you want to debug thprac after game launch you will have to modify the first sh -c "$COMMAND" line, if you want to debug the game launch you will either leave the code as is or modify the second sh -c "$COMMAND" line.
sh -c "$COMMAND" > /dev/null 2>&1 &