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.5.8.tar.gz (34.0 kB view details)

Uploaded Source

Built Distribution

vapor_steam-1.5.8-py3-none-any.whl (29.3 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: vapor_steam-1.5.8.tar.gz
  • Upload date:
  • Size: 34.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.0 CPython/3.12.7

File hashes

Hashes for vapor_steam-1.5.8.tar.gz
Algorithm Hash digest
SHA256 c1d74f5d086b0dc5a46f2a75884602b7fce312d6a6af6ef2391c91ee8a1ad136
MD5 f2c138d16c0d8e56e90a7ef9605a0895
BLAKE2b-256 414c2af9e2f36afc225a7667afb3a9aa6cb35b94a265b988fcb1aaa6b54306a0

See more details on using hashes here.

File details

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

File metadata

  • Download URL: vapor_steam-1.5.8-py3-none-any.whl
  • Upload date:
  • Size: 29.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.0 CPython/3.12.7

File hashes

Hashes for vapor_steam-1.5.8-py3-none-any.whl
Algorithm Hash digest
SHA256 29e55602e2fa0a80e59028f540e9596d7e7195d89a2dd275b05298612c72a6d3
MD5 1f47feac320816958b0915cd18b6b44d
BLAKE2b-256 49e8e5aabbece9ada7fe0a0bae5430b8a29d75207bb8a9cd26cf124b3c2b96df

See more details on using hashes here.

Supported by

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