Unofficial asdf plugin for GloriousEggroll custom Proton distribution.
Install asdf-vm
and add this
repo as a plugin:
asdf plugin-add protonge https://github.com/augustobmoura/asdf-protonge.git
Optional tools:
pv
: We usepv
to show progress bars when extracting the tarballs. It is specially useful in slower computers which could take a few minutes to finish extraction.jq
: We usejq
to extract the changelog, and it might become a hard requirement to have it installed in the future.highlight
: We usehighlight
to highlight the changelog output
Configuration of the plugin is done by environment variables, you can set them
by default in the rc file of your shell of preference (.bashrc
, .zshrc
,
.profile
, etc.).
Variable | Description |
---|---|
ASDF_PROTONGE_STEAM_COMPAT_DIR | directory in which the custom protons will be installed. Defaults to ~/.steam/root/compatibilitytools.d . See tip below |
GITHUB_API_TOKEN | GH token used for downloading the tarballs. This is useful because Github tends to rate limit API calls |
Tip
If you are using flatpak's Steam you need to set the ASDF_PROTONGE_STEAM_COMPAT_DIR
variable to:
~/.var/app/com.valvesoftware.Steam/data/Steam/compatibilitytools.d/
You can install any pre-compiled release from the Github release page.
# Install latest version available
asdf install protonge latest
# Install latest version starting with prefix
asdf install protonge latest:GE-Proton8
# Install specific version
asdf install protonge GE-Proton9-18
Note
asdf ref versions (build from source) are not supported yet.
This will not work:
asdf install protonge ref:master
If you already have custom installations in your compatibilitytools.d
directory you can start managing them with asdf-protonge by running:
asdf cmd protonge manage $version
An useful one-liner to manage all already installed versions is:
ls ~/.steam/root/compatibilitytools.d | xargs asdf cmd protonge manage
We are basically doing the instructions for manual installation:
- Download the tarball and checksum from the GitHub releases page
- Validate the checksum
- Extract the tarball to the
compatibilitytools.d
directory - Symlink the extracted directory to the asdf directory
We manage installed versions by symlinking the extracted directory to
$ASDF_DIR/installs/protonge/$version
, that way we can prevent double
installations and manage uninstallations with asdf.
asdf uninstall protonge $version
- Build from source and support asdf
ref:
installs