Media Overrides

Media overrides let you customize individual game artwork without affecting your main media library. They're perfect for personalized touches, custom artwork, and per-game customizations.

What Are Media Overrides?

Media overrides are custom media files that take priority over your regular media library. When HyperSpin loads a game:

1. First, it checks for an override file
2. If found, it uses the override
3. If not found, it falls back to the regular media

Think of overrides as a "custom layer" on top of your standard media. The original files stay untouched, but you can override what shows up for specific games.

Why Use Overrides?

Personalization Create custom system and game logos, backgrounds, or artwork that reflects your style without replacing official media.

Testing Changes Try out new artwork before committing to it in your main library. Keep the originals safe while you experiment.

Region-Specific Art Want Japanese box art for some games and US art for others? Overrides let you mix and match.

Custom Collections Create special artwork for your curated collections without affecting system-wide media.

Easy Rollback Don't like your changes? Just delete the override. Your original media is still there.

How Overrides Work

The Override Structure

HyperHQ stores media in two locations:

System-Managed Media: HyperSpin/Media/_hsm/[media-id]/ Your standard media library automatically downloaded from HyperTheme and EmuMovies. This folder contains a DO_NOT_MODIFY.txt file - HyperHQ manages these files automatically.

Override Media: HyperSpin/Media/[System Name]/[Media Type]/ Your custom overrides that take priority when present. This is where YOU place custom media files.

The override structure is much simpler:

HyperSpin/Media/
  _hsm/                           # System-managed (DO NOT MODIFY)
    [media-id]/
      metadata.json
      game1.jpg
      game2.png
      ...

  [System Name]/                  # Your override folders
    [Media Type]/
      _README_Place_Override_Media_Here.txt
      game1.jpg                   # Your custom files go here
      game2.png
      ...

  Default/                        # Default media overrides
    [Media Type]/
      _README_Place_Override_Media_Here.txt
      background.jpg
      ...

  Collections/                    # All collection media
    _Shared/                      # Library you pick from in HyperHQ
      [Media Type]/
        any-name.png
    _ByName/                      # Named after a collection, applied automatically
      [Media Type]/
        [Collection Name].png
    [Collection Name]/            # One collection's media
      [Media Type]/
        logo.png                  # Any filename

The Priority System

When HyperSpin needs media for a game, it checks locations in this order:

1. Override Media (highest priority)
2. Regular Media (fallback)
3. Placeholder Graphics (if nothing found)

This means you can override one game logo without touching anything else.

Wheel sound overrides

Each system supports SFX - Main Menu and SFX - System override folders. Place supported audio files directly inside the folder, with filenames of your choice. HyperSpin chooses a random sound from the pool when scrolling.

A usable local pool takes priority over the installed catalog pack selected for the same system and SFX type. Clearing the override pool restores the selected pack. Without either pool, HyperSpin uses its existing global scrolling SFX. Entry, exit, and wheel-loaded cues use the global pack.

See Per-system Wheel Sounds for paths, supported audio formats, and playback-error fallbacks.

Creating Media Overrides

Using HyperHQ (Recommended)

The easiest way to create overrides is through HyperHQ:

Step 1: Find Your Game

1. Navigate to the system containing your game
2. Find the game you want to customize
3. Right-click or select the game

Step 2: Add Override Media

1. Click Edit Game or Manage Media
2. Select the media type you want to override (Wheel, Background, etc.)
3. Click Upload Custom Override
4. Choose your custom media file
5. HyperHQ places it in the correct override folder

The override takes effect immediately.

Step 3: Preview Your Changes

1. Click Preview in HyperSpin to see how it looks
2. Adjust if needed by uploading a different file
3. Original media remains untouched

Manual Override Creation

Prefer to manage files yourself? You can add overrides manually:

Find the Override Folder

Open Settings, Paths and find your configured HyperSpin folder. The override path is relative to this root:

[HyperSpin]/Media/[System Name]/[Media Type]/

For Sega Genesis game logos, default locations are:

Windows	Linux
C:/ProgramData/HyperSpin/Media/Sega Genesis/Wheel/	~/HyperSpin/Media/Sega Genesis/Wheel/

Use your chosen root if different. Linux setup uses ~/HyperSpin/ regardless of XDG_DATA_HOME. Match folder and filename case exactly.

You'll see a _README_Place_Override_Media_Here.txt file in this folder explaining how to use it.

Add Your Media File

1. Create your custom media file (logo, background, etc.)
2. Name it exactly like the ROM file (without the extension)
3. Place it in the appropriate override folder

Example:

• ROM file: Sonic The Hedgehog (USA, Europe).zip
• Override game logo: Sonic The Hedgehog (USA, Europe).png
• Location: Media/Sega Genesis/Wheel/

Verify It Works

Launch HyperSpin and navigate to that game. Your override should appear instead of the regular media.

Override Types

Game-Specific Overrides

Override media for individual games within a system folder:

Game Logos Media/[System]/Wheel/

Backgrounds Media/[System]/Background/

Box Art Media/[System]/Boxart/

Videos Media/[System]/Video/

Gameplay Snapshots Media/[System]/Snaps/

Marquees Media/[System]/Marquee/

Game-Level Marquee Overrides

New in HyperHQ: override marquee artwork on a per-game basis.

Why Use Game Marquee Overrides?

• Use different marquee art for specific games
• Custom marquees for your favorites
• Regional variants (US vs Japanese marquees)
• Fix incorrect or missing marquees

Setting Up:

1. Go to a game's details page
2. Find the Marquee section in media
3. Click Upload Override or drag a file
4. Your custom marquee takes priority

File Location: Place marquee overrides in Media/[System]/Marquee/ with the filename matching your ROM name exactly.

Priority Order:

1. Game-level marquee override (highest)
2. System-level marquee setting
3. Default marquee behavior

System Marquee Settings: Each system can configure marquee behavior:

• Inherit - Use global marquee settings
• Enable - Always show marquees for this system
• Disable - Never show marquees for this system

Game-level overrides work regardless of system settings - if you add an override, it shows.

System-Level Overrides

Override system-wide elements (MainMenu folder):

System Logos Media/MainMenu/Wheel/

System Music Media/MainMenu/Music/

Pointers Media/MainMenu/Pointer/

Default Media Overrides

Override fallback media used when game-specific media isn't available:

Default Backgrounds Media/Default/Background/

Default Music Media/Default/Music/

Default Sounds Media/Default/Sound/

Collection Overrides

All collection media lives in Media/Collections/. Collections never share a folder with a system.

Open or save the collection media diagram (PNG).

Collection folder Media/Collections/[Collection Name]/[Media Type]/

Only one collection reads this folder. Use any filename. With several files, HyperSpin prefers a file named after the collection, then the first file in alphabetical order.

By name Media/Collections/_ByName/[Media Type]/

Every collection reads this folder. Name each file after the collection. Matching ignores upper and lower case. For example, Media/Collections/_ByName/Logos - Collection/Beat 'Em Ups.png belongs to the "Beat 'Em Ups" collection. HyperSpin ignores files with other names, so one collection never borrows another collection's media.

Shared library Media/Collections/_Shared/[Media Type]/

Files here never apply on their own. In HyperHQ, open a collection and choose a media section. Shared files appear in the list, labeled Shared. Pick a file to use for the collection. Several collections share one file without copies.

HyperHQ creates these folders. A new collection gets its folder right away. Existing collections get theirs shortly after HyperHQ starts. Names _Shared and _ByName are reserved, and HyperHQ skips collections whose names contain characters a folder name does not allow, such as : or ?.

Moving from older folders

Shortly after HyperHQ starts, HyperHQ moves existing collection media into Media/Collections/ once and updates every collection pointing at a moved file:

Old location	New location
Media/Collections/[Media Type]/[Collection Name].png	Media/Collections/_ByName/[Media Type]/
Other files in Media/Collections/[Media Type]/	Media/Collections/_Shared/[Media Type]/
Media/Shared/ (collection media)	Media/Collections/_Shared/[Media Type]/
Media/[Collection Name]/ (collection media)	Media/Collections/[Collection Name]/
Media/Collections/Video Snaps - Collection/[Collection Name]/	Media/Collections/[Collection Name]/Video Snaps/
Media/[Collection Name]/Video Snaps/	Media/Collections/[Collection Name]/Video Snaps/

HyperHQ never overwrites a file. If the new location already holds a file with the same name, the old file stays in place and HyperSpin still reads the old file. System media in a folder with the same name as a collection stays in place, including the system's video snaps. If the HyperSpin drive is offline, HyperHQ waits and moves the media on a later start.

Theme projects move as whole folders, keeping their definitions and assets together. If the destination folder already holds media, the entire source project stays in place. Empty folders and HyperHQ instruction files do not block the move. Saved theme selections follow completed moves.

HyperSpin reads collection folders from HyperSpin/Media/ only. If you moved the Media Overrides Folder in Application Paths, place collection media in HyperSpin/Media/Collections/.

Collection media types

Folder	Shows	Files
Logos - Collection	Collection logo on the main menu	Images
Backgrounds - Collection	Collection background on the main menu	Images
Marquees - Collection	Marquee while the collection is selected	Images or videos
Video Snaps - Collection	Collection intro video on the main menu	Videos
Music - Collection	Music while the collection is selected on the main menu	MP3
Pointers - Collection	Wheel pointer on the collection's game wheel	Images
Video Themes - Collection	Collection theme video on the main menu	Videos
Collection Theme	Collection theme on the main menu	Theme folder or video
Collection Default Theme	Game wheel theme for games without their own theme	Theme folder or video

A theme folder contains theme_data.json or a protected theme_data.hte definition. In _ByName, name the theme folder or video after the collection. To rotate several videos on the main menu, place them in Media/Collections/[Collection Name]/Video Snaps/.

Collection priority

1. Media you select for the collection in HyperHQ, including a file from _Shared
2. The collection folder
3. _ByName
4. Downloaded media

A theme HyperHQ selects automatically from downloads ranks below the collection folder and _ByName. A theme you select yourself ranks above them.

Main menu and game wheel themes

Collection Theme appears only on the main menu. Games inside the collection use their own theme first, then Collection Default Theme, then the system default theme.

Practical Examples

Example 1: Custom Game Logo

You want a custom game logo for "Street Fighter II" in your Arcade system:

System-Managed Location: Media/_hsm/[media-id]/street_fighter_ii.png (automatically downloaded)

Override Location: Media/Arcade/Wheel/street_fighter_ii.png (your custom file)

Result: HyperSpin shows your custom game logo instead of the downloaded one.

Example 2: Personalized System Background

Create a custom background for your MAME system:

System-Managed Location: Media/_hsm/[media-id]/background.jpg (automatically downloaded)

Override Location: Media/MAME/Background/custom_bg.jpg (your custom file)

Result: Your MAME system shows your custom background.

Example 3: Collection-Specific Artwork

You created a "Beat 'Em Ups" collection and want custom art:

Override Locations: Media/Collections/Beat 'Em Ups/Logos - Collection/logo.png Media/Collections/_ByName/Backgrounds - Collection/Beat 'Em Ups.jpg

Result: Your collection displays with completely custom artwork.

Managing Overrides

Viewing Your Overrides

See all your overrides in HyperHQ:

1. Go to Media > Overrides
2. Browse by system or media type
3. Preview override files
4. See which games have overrides

Editing Overrides

Change an existing override:

1. Find the override in HyperHQ
2. Click Edit or Replace
3. Upload a new file
4. Previous override is replaced

Or manually replace the file in the override folder.

Removing Overrides

Don't need an override anymore?

In HyperHQ:

1. Select the override
2. Click Delete Override
3. Game reverts to regular media

Manually:

1. Navigate to the override folder
2. Delete the override file
3. Regular media takes over immediately

Bulk Override Management

Working with lots of overrides?

Export Overrides Back up your custom overrides for safekeeping or sharing.

Import Overrides Restore backed-up overrides or use overrides from other users.

Clear All Overrides Remove all overrides for a system in one action (careful - this can't be undone!).

Override File Requirements

Supported Formats

Images:

• PNG (recommended for system and game logos)
• JPG (good for backgrounds)
• BMP (works but larger file sizes)

Videos:

• MP4 (recommended)
• AVI (works but less efficient)
• WMV (older format, still supported)

Audio:

• MP3 (most common)
• OGG (smaller files)
• WAV (uncompressed, larger)

Size and Resolution

System and Game Logos:

• Recommended: 400-600px wide
• Format: PNG with transparency
• Keep file size under 500KB for fast loading

Backgrounds:

• Match your display resolution (1080p, 4K, etc.)
• Format: JPG for smaller files, PNG for transparency
• Reasonable file sizes (under 5MB) load faster

Videos:

• 720p or 1080p works great
• 30-60 seconds is ideal length
• Higher bitrates look better but use more space

Naming Rules

For Game Media (boxes, snaps, game logos, etc.):

HyperSpin matches override files using three naming formats:

• Game name - the internal name as it appears in your game list
• Display name - the custom display name, if one is set
• ROM filename (without extension) - the actual ROM filename, minus the file extension

Matching is case-insensitive. HyperSpin cleans and normalizes names, so exact capitalization doesn't matter.

Match priority:

1. Game name (cleaned)
2. Display name (cleaned)
3. ROM filename without extension
4. MAME format match (MAME systems only)

Example - Pinball FX:

Pinball FX tables use generic ROM filenames that don't match the display name. Both formats work:

Override Filename	Matches By
Medieval Madness.png	Display name
Table 01.png	ROM filename

For System Media (system logos, system backgrounds, etc.): Files can have ANY name - just place them in the folder:

• Any supported image file in the folder will be used
• If multiple files exist, one will be chosen randomly
• Example: my_custom_logo.png, background_v2.jpg, or logo1.png

This flexibility lets you easily swap between different logo/background options.

Advanced Override Techniques

Regional Variants

Create multiple override sets for different regions:

US Versions: Standard override structure with US artwork.

Japanese Versions: Duplicate structure with Japanese artwork, swap folders as needed.

European Versions: Same approach - create separate override sets and switch between them.

Manage sets with HyperHQ's override import/export.

Theme-Specific Overrides

Some themes need specific media formats. Use overrides to adapt:

1. Download or create media matching theme requirements
2. Place in override folders
3. Theme uses your custom media
4. Switch themes without affecting overrides

Seasonal Overrides

Want holiday-themed artwork?

1. Create seasonal override set (Halloween logos, Christmas backgrounds, etc.)
2. Import overrides during that season
3. Export and remove when season ends
4. Re-import next year

Keep seasonal sets organized in backup folders.

Testing Themes

Building a custom theme and need test media?

1. Use overrides for all test artwork
2. Iterate quickly without affecting main library
3. Once happy, migrate to regular media
4. Delete overrides or keep as alternates

Overrides vs. Regular Media

When to Use Overrides

Use Overrides When:

• Customizing specific games only
• Testing new artwork
• Creating temporary seasonal themes
• Maintaining multiple art styles for the same games
• Personalizing without permanent changes

When to Use Regular Media

Use Regular Media When:

• Downloading from HyperTheme or EmuMovies
• Applying consistent artwork across entire systems
• Setting up a new system
• Sharing media with others
• Maintaining a "stock" media library

Best Practice: Hybrid Approach

Most users do both:

• Regular media from official sources for baseline quality
• Overrides for personal customization and special cases

This gives you professional media with personal touches.

Sharing Overrides

Created amazing custom art? Share it with the community:

Export Your Overrides

1. In HyperHQ, go to Media > Overrides
2. Select overrides to share
3. Click Export
4. Choose a location
5. HyperHQ creates a package file

Share the Package

Upload your override package to:

• HyperSpin community forums
• Your personal website or cloud storage
• Discord or other community channels

Include preview images so people know what they're getting!

Import Community Overrides

Found overrides you like?

1. Download the override package
2. In HyperHQ, go to Media > Overrides
3. Click Import
4. Select the package file
5. Choose which overrides to import

HyperHQ installs them in the right locations.

Common Questions

Do overrides affect downloads from HyperTheme? Nope! HyperTheme downloads go to regular media folders. Overrides stay separate.

Can I override videos? Absolutely! Video overrides work the same as image overrides.

What happens if I delete the override folder? Everything reverts to regular media. Your main library is unaffected.

Do overrides work with all themes? Yes! Themes check for overrides first, so they work universally.

Can I have overrides for some games and regular media for others? Yes! That's the whole point. Mix and match as you like.

Will overrides slow down HyperSpin? Not noticeably. HyperSpin checks overrides quickly - it's designed for this.

Can I use overrides from older HyperSpin versions? If the file naming matches, they should work. You might need to reorganize folder structures.

How much disk space do overrides use? Only what you add. Unlike regular media, overrides are entirely manual - they don't download automatically.

Troubleshooting

Override Not Showing?

• Verify file name matches one of the accepted formats: game name, display name, or ROM filename (without extension). Matching is case-insensitive - check the game's detail view in HyperHQ to see exactly which filenames will work
• Check file is in the correct override folder
• Confirm file format is supported (PNG, JPG for images)
• Restart HyperSpin to reload media

Override Showing for Wrong Game?

• Check for duplicate files with similar names
• Verify ROM name exactly (use "View ROM Details" in HyperHQ)
• Remove incorrect override file

Override Looks Distorted?

• Check image resolution matches your display
• Verify aspect ratio is correct
• Try higher quality source image
• Ensure file isn't corrupted (re-upload)

Can't Find Override Folder?

• Check HyperSpin installation path in Settings
• Verify Media folder exists in your HyperSpin directory
• Look for _README_Place_Override_Media_Here.txt files - these mark override folders
• Create folders manually if needed: [HyperSpin]/Media/[System Name]/[Media Type]/

Overrides Not Taking Priority?

• Confirm file naming is exact (no extra spaces or characters)
• Check folder structure matches regular media structure
• Try clearing HyperSpin cache (Settings > Cache > Clear)

Regular Media Showing Instead?

• Override file might be corrupted (try re-uploading)
• Check file permissions (should be readable)
• Verify no typos in filename or folder path

What's Next?

Want to create custom themes to go with your overrides? Check out the ThemeBuilder Documentation.

Need to organize your customized games? Learn about Creating Collections.

Got your arcade looking perfect? Time to configure those LED Lights for the full cabinet experience.