Skip to content
Pull ratings from ProtonDB and import them into your Steam library as tags.
Python
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
travis-tests
.gitignore
.travis.yml
LICENSE
ProtonDB-Tags.py
README.md
requirements.txt
screenshot.png

README.md

ProtonDB-Tags Build StatusDiscord

Just a quick heads up, the script has been renamed to ProtonDB-Tags.py!

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:

Screenshot

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 and requests before this can run. You can install them via pip with:

pip install requests vdf

Alternatively you can use the included requirements.txt file:

pip install -r requirements.txt

Running

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

This can be simply run with:

python ProtonDB-Tags.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.

By default this will not check the Steam API for native titles. This can be enabled with the --check-native flag. This will add a 1 second wait to each Steam API call, as without this you will get rate-limited. The script will build a cache of these as it runs, so after the first run it will go faster.

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

python ProtonDB-Tags.py --sharedconfig /path/to/sharedconfig.vdf

The full command line options can be viewed with:

python ProtonDB-Tags.py --help

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 most Linux Native games will not be categorized without the --check-native flag, as ProtonDB doesn't return anything for them.

If you get an error which looks like this:

WARNING: This may clear your current tags on Steam!
Would you like to save sharedconfig.vdf? (y/N)y
Traceback (most recent call last):
  File "ProtonDB-Tags.py", line 220, in 
    main(arguments)
  File "ProtonDB-Tags.py", line 207, in main
    check = input("Would you like to save sharedconfig.vdf? (y/N)")
  File "", line 1, in 
    NameError: name 'y' is not defined

It means you ran the script with python2, please run it with python3. More info about why this error happens can be found here.

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

You can’t perform that action at this time.