Skip to main content

TUI program to check the ProtonDB compatibility of all the games of a Steam user.

Project description

Vapor: Steam Proton Compatibility Checker

PyPI AUR version Downloads License Maintenance GitHub Issues Coverage GitHub followers
Kofi Badge

Vapor is a Python package built on Textual which offers a simple Terminal User Interface for checking ProtonDB compatibility ratings of games in a Steam user's library. The tool seamlessly integrates Steam and ProtonDB APIs to provide insightful compatibility information.

Vapor Showing Information

Installation

pipx is a great tool for installing Python packages in an isolated environment. If wanting to install via pipx, just run

pipx install vapor-steam

This project can also be installed with pip normally with

pip3 install vapor-steam

Arch users can install the package from the AUR with your favorite AUR helper:

paru -S python-vapor-steam

Or manually with makepkg:

git clone https://aur.archlinux.org/python-vapor-steam.git && cd python-vapor-steam
makepkg -si

Quick Start

  1. Obtain a Steam API Key: Get your Steam API key by filling out this form.
  2. Run the Program: Run vapor with the vapor command. It can also be ran without installation, with python3 vapor/main.py.

Features

  • User Library Analysis: Fetches and displays game compatibility ratings from ProtonDB for a specified Steam user.
  • User Average Compatibility: Calculates and presents the average game compatibility for the user's library.
  • Automatic Steam ID Resolution: Vapor automatically resolves the given Steam ID, so you can use either your vanity name or your 64-bit Steam ID.
  • Automatic Steam URL Detection: Directly paste a Steam user profile URL, like https://steamcommunity.com/id/<user> or https://steamcommunity.com/profiles/<user> into the "User ID" box and it will be detected and parsed correctly.
  • AreWeAntiCheatYet Integration: Integartion with Are We Anti-Cheat Yet? to show the anti-cheat compatibility status of your games.

Requirements

This package is built on top of textual and aiohttp, and uses poetry to manage dependencies. To install dependencies locally, just run poetry install in the repository's directory.

Private Steam Account Error

This error occurs if your game details are set to private in your privacy settings. First, double check that you're using the correct Steam ID or vanity URL. This is different from your display name. To make sure, you can directly copy your profile URL into Vapor and your Steam ID will be extracted. Your profile URL will look like https://steamcommunity.com/id/<vanity_name> or https://steamcommunity.com/profiles/<steam_id>.

If you've double checked that your account information is correct, please complete the following steps to fix this issue:

  1. From Steam, click the user dropdown and select "View my profile"
  2. Click the "Edit Profile" button
  3. Click the "Privacy Settings" tab
  4. Set "Game details" to Public
  5. Uncheck the Always keep my total playtime private option

Contributing

Contributions are welcomed! For bug fixes, improvements, or feature requests, feel free to open an issue or pull request.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

vapor_steam-1.7.0.tar.gz (33.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

vapor_steam-1.7.0-py3-none-any.whl (29.2 kB view details)

Uploaded Python 3

File details

Details for the file vapor_steam-1.7.0.tar.gz.

File metadata

  • Download URL: vapor_steam-1.7.0.tar.gz
  • Upload date:
  • Size: 33.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.2

File hashes

Hashes for vapor_steam-1.7.0.tar.gz
Algorithm Hash digest
SHA256 f4cd38f4b9aa8c98cf31de4cfc0a790cdafdd5dc127245a64917acf9ae9896bb
MD5 625b8336379f6ef3a615cb8f2404dc15
BLAKE2b-256 0a960b0ab5c9bdf7d36871e38507a551c2c21b35d8e7afaf0e5045f14e5f53c6

See more details on using hashes here.

File details

Details for the file vapor_steam-1.7.0-py3-none-any.whl.

File metadata

  • Download URL: vapor_steam-1.7.0-py3-none-any.whl
  • Upload date:
  • Size: 29.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.2

File hashes

Hashes for vapor_steam-1.7.0-py3-none-any.whl
Algorithm Hash digest
SHA256 42d55b6380865bb95427ded1d6eece3d5b310f398656c2ecd535fe85a49e5ef4
MD5 9a9712205521435913458006862a8ae2
BLAKE2b-256 92c1c11135b67be16ffb085870a16c01b6f057a5cd300320ce536ac0df597d8b

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page