README.md

ProtonDB to Steam Library

This is just a small python script to pull ratings from ProtonDB and import them into your Steam library as tags.

Here is a screenshot which shows how it looks once ran:

Dependencies

This script requires Python 3, you can check your python version with python --version. If your default is Python 2 then you'll need to check with your distro's documentation and install Python 3, then replace all of the below commands with python3 and pip3.

You'll need to install vdf before this can run. You can install it via pip with:

pip install vdf

Running

WARNING: This may clear all of your current tags in Steam. You have been warned!

This can be simply run with:

python ProtonDB-to-Steam-Library.py

It will also ask before saving the file, so if you want to just test it out theres no real danger of overwriting anything.

You can also specify a custom path to your sharedconfig.vdf with:

python ProtonDB-to-Steam-Library.py -s /path/to/sharedconfig.vdf

The full command line options can be viewed with:

python ProtonDB-to-Steam-Library.py -h

Contributing

If you run into any issues please attach the output from the script to your issue, along with the sharedconfig.vdf file which was selected.

All feedback is welcome and appreciated! Please make an issue if you have any ideas or feedback, I would love to hear them!

If you would like to make a PR all I ask is that you are also open to feedback on your written code.

Troubleshooting

If you are finding that only some of your Proton compatible games are being categorized try this:

1. Select all of the games in your library
2. Right click -> Set Categories...
3. Add some random category to them all (you can remove this later)
4. Close Steam to force it to write all of your games to the sharedconfig.vdf file
5. Try running the script again

Please keep in mind that Linux Native games shouldn't be categorized.

If anything is still not working you can open an issue here, or join the ProtonDB to Steam Library Discord server (link is at the top of this README). Please respect the rules of the server if you join!