Skip to main content

Working With Games

Once you've added systems to HyperHQ, it's time to manage your game library. This is where you import, organize, and customize your game collection.

Importing Games​

HyperHQ makes importing games automatic. When you add ROM paths to a system, it scans those folders and finds your games.

Automatic Import​

Here's what happens behind the scenes:

  1. You add a system with ROM paths
  2. HyperHQ scans those folders for files matching your extensions
  3. Games are imported into the system automatically
  4. You see the count of games found

That's it! No manual imports or database editing needed.

Manual Rescan​

Added more games after the initial import? Easy:

  1. Go to your system's ROMs tab
  2. Click Rescan ROMs
  3. HyperHQ finds new games and adds them
  4. Existing games stay untouched

Rescanning is safe—it only adds new games, it doesn't remove or change existing ones.

What Gets Imported​

HyperHQ looks for files matching the extensions you specified:

  • .zip for MAME and compressed ROMs
  • .bin, .md, .gen for cartridge-based games
  • .iso, .cue, .bin for disc-based games
  • Whatever extensions you configured for the system

Each file becomes a game entry in your library.

Viewing Your Games​

Click on any system in the sidebar to see its games:

List View Shows all games in an organized list with:

  • Game name
  • File name
  • Year (if available)
  • Genre and other metadata

Search and Filter Use the search bar at the top to find specific games quickly. Great for large libraries.

Sorting Click column headers to sort by:

  • Name (alphabetically)
  • Year (chronologically)
  • Genre
  • Play count

Editing Game Information​

Want to fix a game title or add details? Click on any game to edit it.

Basic Information​

Name

  • What shows up in HyperSpin
  • Fix typos or use friendlier names
  • Example: "suprmrio.zip" → "Super Mario Bros."

Description

  • Add a summary of the game
  • Useful for identifying games in large collections

Year

  • Release year
  • Helps with sorting and organization

Manufacturer

  • Who made it (Sega, Capcom, Konami, etc.)
  • Great for filtering and collections

Detailed Metadata​

Genre

  • Action, RPG, Fighting, Puzzle, etc.
  • Helps organize and filter games

Rating

  • ESRB rating (Everyone, Teen, Mature, etc.)
  • Useful if you're building a family-friendly setup

Players

  • How many can play
  • Important for party game collections

Developer and Publisher

  • Who created and released the game
  • Good for tracking favorite studios

Region

  • USA, Japan, Europe, etc.
  • Helps identify different versions

Language

  • English, Japanese, Spanish, etc.
  • Useful for multi-region collections

Multi-File Games​

Some games need multiple files (like PlayStation games):

In the File Name field, separate files with |:

game.cue|game.bin

List the main file first (usually the .cue for disc games). Most emulators want this file as the launch point.

Organizing Your Library​

Mark Favorites​

Love a game? Mark it as a favorite:

  • Click the star icon on any game
  • Favorites can be filtered and highlighted
  • Great for quick access to your go-to games

Hide Games​

Got ROM sets with lots of duplicates or broken games? Hide them:

  • Toggle the visibility icon on any game
  • Hidden games don't show up in HyperSpin
  • They're still in your library—just hidden

This is perfect for:

  • Duplicate regions (hide all but your preferred version)
  • Broken or incomplete ROM dumps
  • Games you don't want to see but might want later

Play Counts​

HyperHQ tracks how many times you've played each game:

  • Automatic tracking when launched through HyperSpin
  • View counts in the game list
  • Sort by play count to see your most-played games

Want to reset a count? Edit the game and change the number.

Custom Game Entries​

Sometimes you want to add a game manually (like a shortcut or custom launcher):

  1. Click Add Game in the ROMs tab
  2. Fill in the details:
    • Name (what shows in HyperSpin)
    • File path (the actual executable or ROM)
    • Metadata (optional but helpful)
  3. Save and it appears in your system

This is useful for:

  • PC games that aren't detected automatically
  • Custom launchers or batch files
  • Homebrew games
  • Anything that doesn't fit the normal pattern

Batch Operations​

Got a lot of games to manage? Batch operations save time:

Selecting Multiple Games​

  • Hold Ctrl and click to select individual games
  • Hold Shift and click to select a range
  • Use Ctrl+A to select all

Batch Actions​

With multiple games selected, you can:

  • Hide/show all at once
  • Mark as favorites in bulk
  • Edit metadata for multiple games (coming soon)
  • Delete games you don't want

Working With ROM Sets​

Many arcade and console collections come as complete ROM sets. Here's how to handle them:

Full Sets vs. Favorites​

You don't need to keep every game visible:

  1. Import the full set (let HyperHQ scan everything)
  2. Hide clones and duplicates (regional variants, alternate versions)
  3. Keep your favorites visible (the games you actually play)
  4. Use search when you need something specific

This gives you access to everything without cluttering your wheel.

MAME Sets​

MAME ROM sets can have thousands of games:

Non-Merged Sets (Recommended)

  • Each game is self-contained
  • Easier to manage individual games
  • HyperHQ works great with these

Split Sets

  • Parent ROMs and clone ROMs are separate
  • You need both to play clones
  • Still works, but less convenient

Merged Sets

  • Multiple games in one ZIP file
  • Can be tricky to manage
  • Consider converting to non-merged
Too Many Games?

With MAME's 10,000+ games, use filters and favorites liberally. Most people play 50-100 games regularly—focus on those.

Game Collections​

Want to group games across systems? That's what Collections are for!

For example, create a "Fighting Games" collection with:

  • Street Fighter (Arcade)
  • Mortal Kombat (Arcade)
  • Soul Calibur (Dreamcast)
  • Tekken (PlayStation)

See Creating Collections for the full guide.

Metadata Sources​

Where does game information come from?

Automatic Metadata​

When you import games, HyperHQ tries to match them with databases:

  • ROM file names often include metadata
  • CRC matching for arcade games
  • Filename parsing for consoles

Manual Entry​

If automatic matching doesn't work, just edit the game and fill it in yourself. It takes a minute but makes your library much nicer.

Community Databases​

In the future, HyperHQ may connect to community databases for automatic metadata. For now, it's mostly based on filenames and your manual edits.

Searching Your Library​

The search bar at the top is powerful:

Search by Name

  • Type any part of the game name
  • Results update as you type
  • Works across all systems

Quick Navigation

  • Find games in seconds
  • Especially useful for large libraries
  • Case-insensitive (no need to worry about capitals)

Clear Results

  • Click the X to clear the search
  • Returns to full game list

Removing Games​

Need to remove games from your library?

Hide vs. Delete​

Hide (Recommended)

  • Game stays in your library
  • Doesn't show in HyperSpin
  • Can be unhidden later
  • ROM file stays on disk

Delete

  • Removes from HyperHQ's database
  • Can be re-imported by rescanning
  • ROM file stays on disk (HyperHQ never deletes your files)

Removing a Game​

  1. Select the game
  2. Click Delete or press Delete key
  3. Confirm the removal
  4. Game is removed from the database
Important

HyperHQ NEVER deletes your actual ROM files. Removing a game only removes it from the database. Your files are safe on disk.

Handling Game Issues​

Game Won't Launch?​

Check these things:

  1. Verify the ROM file exists at the path shown
  2. Make sure the emulator is configured correctly
  3. Test the emulator directly (run it manually to verify it works)
  4. Check the logs (Settings > View Logs) for error messages

Wrong Game Name?​

Just edit it! Click the game and change the name to whatever you want. The file name doesn't change—only what shows in HyperSpin.

Duplicate Games?​

Hide the ones you don't want:

  • Keep your preferred region/version visible
  • Hide alternates and clones
  • Or delete them entirely if you're sure

Games Missing After Rescan?​

HyperHQ only adds new games—it doesn't remove existing ones. If games are missing:

  • Check if they're hidden (toggle visibility filter)
  • Verify ROM files still exist on disk
  • Check file extensions match your system settings

Performance Tips​

Large Libraries (1000+ Games)​

HyperHQ handles large libraries well, but here are tips:

Use Search Instead of Scrolling

  • Faster to find specific games
  • Reduces UI lag with huge lists

Hide Games You Don't Play

  • Keeps your HyperSpin wheel manageable
  • Games are still available via search

Organize Into Collections

  • Group by genre, era, or preference
  • Easier to navigate than one giant list

Virtual Scrolling​

HyperHQ uses virtual scrolling for game lists:

  • Only renders visible rows
  • Handles thousands of games smoothly
  • You won't notice any lag even with huge libraries

What's Next?​

Now that your games are organized, make them look amazing! Head to Managing Media to download artwork, videos, and themes.

Want to create custom game collections? Check out Creating Collections.