Skip to content

m24ih/ProtonDB_Companion

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ProtonDB Companion Extension 🎮

Version License

A browser extension that integrates ProtonDB compatibility tiers directly into Steam and Epic Games Store pages. Perfect for Linux and Steam Deck users!

Screenshots 📸

Steam

Steam Home Page

Steam Game Page 1 Steam Game Page 2

Epic Games

Epic Game Page 1 Epic Game Page 2

Features ✨

  • Steam Integration: Displays ProtonDB badges (Native, Platinum, Gold, etc.) on game store pages and search results.
  • Epic Games Support (Experimental): Matches Epic Games titles with Steam AppIDs to show compatibility info.
  • Performance Focused: Uses caching and request batching to minimize API usage.
  • Visual Clarity: Color-coded badges matching the official ProtonDB theme.

Installation 📦

From Store (Coming Soon)

Manual Installation (For Developers)

  1. Clone this repository:
    git clone https://github.com/m24ih/ProtonDB_Companion.git
  2. Open your browser's extension manager:
    • Chrome/Brave/Edge: Go to chrome://extensions, enable Developer mode, click Load unpacked, and select the project folder.
    • Firefox: Go to about:debugging#/runtime/this-firefox, click Load Temporary Add-on, and select manifest.json.

How It Works

  1. Steam: Extracts the AppID from the URL or data attributes and queries the ProtonDB API.
  2. Epic Games: Since Epic doesn't expose Steam AppIDs, the extension searches for the game title on Steam API to find the corresponding ID, then queries ProtonDB. Note: This may occasionally result in mismatches.

Disclaimer ⚠️

This project is not affiliated with Valve, Steam, Epic Games, or ProtonDB. It is a community-made tool.

License 📄

Distributed under the MIT License. See LICENSE for more information.

About

A browser extension that integrates ProtonDB compatibility tiers directly into Steam and Epic Games Store pages. Perfect for Linux and Steam Deck users!

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages