explaingit

pomran/steam-friend-finder

★ 24JavaScriptAudience · generalComplexity · 1/5Setup · easy

TLDR

A tool that scans your Steam library and ranks your friends by gaming compatibility, whoever shares the most hours in your top five games rises to the top. Use it instantly on the website or install it as a Chrome/Edge extension.

Mindmap

mindmap
  root((repo))
    What It Does
      Rank friends by taste
      Compare game hours
      Show shared games
    Tech Stack
      JavaScript
      Cloudflare Pages
      Cloudflare Workers
    How to Use
      Website no install
      Browser extension
      Share results image
    Audience
      Steam gamers
      Co-op seekers
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Find out which Steam friend shares your gaming taste most closely, based on how many hours you both put into the same games.

USE CASE 2

See a side-by-side breakdown of your top-game hours versus a specific friend's, along with a list of games you both own.

USE CASE 3

Generate a shareable image of your friend match results to send to your friends directly.

Tech stack

JavaScriptCloudflare PagesCloudflare Workers

Getting it running

Difficulty · easy Time to first run · 5min
License not mentioned in the explanation.

In plain English

Steam Friend Finder is a tool that looks at your Steam gaming history and tells you which of your friends are the best match for playing together. You paste in your Steam profile link, the tool scans your library and your friends' libraries, and it produces a ranked list showing who shares your gaming tastes most closely. The matching is based on how much time you and each friend have spent in your top five most-played games. Friends who have put similar hours into the same games rank higher. When you click on any friend in the list, you get a side-by-side breakdown of your top five hours versus theirs, along with a list of games you both own. You can use it two ways. The first is through a website at steam.i-test.top, where you just paste your Steam profile URL and wait for the scan to finish. No account or install needed. The second way is as a browser extension for Chrome or Edge, which you load manually by downloading the code and pointing the browser's extension manager at the folder. The technical setup runs on Cloudflare's free services. The website is a static page hosted on Cloudflare Pages. A Cloudflare Worker acts as a middleman between the page and Steam's official API, handling network routing. The Steam API key is built into the code in an obfuscated form so users do not need to supply their own. The tool also has a share button that generates an image of your match results, useful for sending to friends. It accepts several Steam ID formats, including the long 64-bit number, a full profile URL, and the older SteamID2 and SteamID3 string formats. The README is written in Chinese but the tool itself is accessible to any Steam user.

Copy-paste prompts

Prompt 1
I used Steam Friend Finder and discovered a friend who has the most hours in common with me. Help me figure out which games we should play together first based on our overlap.
Prompt 2
How exactly does Steam Friend Finder calculate the compatibility score between me and a friend, what does it measure and how are the rankings determined?
Prompt 3
I want to install the Steam Friend Finder as a Chrome extension. Walk me through downloading the code, loading it as an unpacked extension, and testing it with my Steam profile URL.
Prompt 4
My Steam profile is set to private. Will Steam Friend Finder still be able to read my library and friends list, or do I need to change my privacy settings?
Open on GitHub → Explain another repo

← pomran on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.