Skip to main content

Steam Library Setup

HyperHQ can import your Steam library — games, artwork, metadata, and achievement progress. This guide covers the Steam import flow and how Steam achievements appear on the game detail screen.

What You'll Need​

  • A Steam account with games in your library
  • Steam installed on the same PC if you want HyperHQ to read local achievement progress
  • A Steam Web API key for the Steam library import flow (free, takes 30 seconds)
  • A public Steam profile for Steam web API library import and refreshes

Getting Your Steam API Key​

Steam requires each app to use its own API key. Getting one is quick:

  1. Go to steamcommunity.com/dev/apikey
  2. Sign in with your Steam account
  3. Enter https://hyperspin-fe.com/ as the domain name
  4. Agree to the terms and click Register
  5. Copy the API key — you'll paste it into HyperHQ in the next section
Keep Your Key Safe

Your API key is tied to your Steam account. Don't share it publicly. HyperHQ encrypts it before storing it locally.

Profile Privacy for Library Import​

Steam profiles are private by default. HyperHQ needs your profile set to Public when it uses Steam's web APIs to read your game library.

  1. Open Steam (desktop client or browser)
  2. Click your profile name in the top menu
  3. Click Edit Profile, then go to Privacy Settings
  4. Set My profile to Public
  5. Set Game details to Public

If your profile is private, HyperHQ won't be able to retrieve your game library through Steam's web APIs. Local Steam achievement progress can still be read from your PC without making your profile public.

The Steam Import Wizard​

Go to Systems and click the Steam card to start the import wizard.

Step 1: API Key​

Paste the API key you got from Steam's developer page. If you've already entered it before, it'll be pre-filled.

Step 2: Profile Visibility​

A reminder to check your profile and game details are set to Public (see above). If you've already done this, just click Next.

Step 3: Steam Username​

Enter your Steam username — this is the custom URL name from your Steam profile, not your display name.

To find it:

  1. Go to your Steam profile
  2. Click Edit Profile
  3. Look at the Custom URL field — that's your username

If the username is valid, HyperHQ resolves your Steam ID and fetches your game list.

Step 4: Game Preview​

You'll see your full Steam library with game logos. Review the list, then click Next.

Step 5: Media Selection​

Choose which artwork and media to download for your games. Options include:

  • Game-level media — themes, backgrounds, box art, logos, marquees, bezels, manuals, music, pointers, video snaps
  • System-level media — themes, backgrounds, logos, marquees, manuals, music, pointers
  • Main menu themes and video snaps

Everything's enabled by default. Uncheck what you don't need to save time and disk space.

Click Next to start the import. HyperHQ creates the Steam system, imports your games, and queues media downloads in the background. You can start using the system immediately while media downloads finish.

Steam Achievements​

Once your Steam games are in HyperHQ, achievement progress can appear on the game detail screen. HyperHQ can read local Steam achievement data from your PC, so you do not need to create or authenticate a Steam Web API key just to see achievement progress.

What You'll See​

  • Progress bar with unlocked / total count and completion percentage
  • Achievement grid (or list view) with badge icons, names, descriptions, and rarity percentages
  • Rarity indicators — rare achievements get a gem badge and color-coded borders
  • Unlock dates shown as relative time ("3 days ago", "2 months ago")
  • Filter tabs to show all, unlocked only, or locked only
  • Hidden achievements stay hidden until you unlock them

Requirements for Achievements​

For achievements to show up, you need:

RequirementWhy
Steam installed with local user dataLets HyperHQ read achievement progress from your PC without API auth
The game has been played or synced in SteamSteam needs local stats data before HyperHQ has anything to read
Game has Steam achievementsNot all Steam games support achievements
Optional Steam API key and public profileUsed for Steam web API library import and online refresh data, not required for local achievement progress

Refreshing Achievements​

Achievement data is cached locally so the game detail screen loads fast. To check for updates, click the refresh button in the achievements header. HyperHQ rereads local Steam data and uses online Steam data when you have configured it.

No Achievements Showing?​

  • Launch or sync the game in Steam — local achievement files need to exist before HyperHQ can read them
  • Check that Steam is installed and logged in — HyperHQ reads local Steam user data from your PC
  • Not all games have achievements — some games on Steam simply don't support them
  • Using online refresh data? — check your API key and Steam profile privacy if you want HyperHQ to use Steam's web APIs
  • Just unlocked something? — hit the refresh button to pull the latest data

Updating Your Steam Settings Later​

Already imported Steam but need to change your API key or username? You can update these in the Steam system settings without re-running the wizard.

Re-Importing / Syncing​

Running the Steam wizard again when you already have a Steam system won't create a duplicate — it syncs your library instead. New games get added, existing games get updated metadata, and media downloads queue up for anything missing.