FAQ

Linux setup

Use Linux Support for installation, permissions, controls, displays, and migration. Windows security and repair steps below apply to Windows.

HyperSpin install fails or finishes with missing files. What should I check?

Check the HyperSpin folder path and permissions first. Check write access for the account running HyperHQ on either operating system.

1. Open Settings > Paths in HyperHQ.
2. Confirm the HyperSpin path points to the folder where HyperSpin should install.
3. Select Check Permissions.
4. Fix every failed path before continuing setup.
5. Make sure the HyperSpin folder is not read-only and does not have partial permissions.
6. On Windows, open Properties > Security for the HyperSpin folder and give the account running HyperHQ full control.
7. On Linux, confirm your user owns or has write access to the library. Check executable permission and mount options for app and plugin binaries.

HyperHQ application files and managed content use the configured HyperSpin folder. User data lives separately in .HyperHQ under your home folder. Portable Linux packages still need the correct library path and user profile. See Data and Reinstall.

Where do I turn RetroArch bezels on or off?

RetroArch bezels use RetroArch video overlays. In HyperHQ, use Video Overlay (required for The Bezel Project).

For every system using RetroArch:

1. Open Platforms.
2. Select RetroArch.
3. Open Details.
4. Open Video.
5. Set Video Overlay (required for The Bezel Project) to On or Off.
6. Select Save Changes.

For one system:

1. Open Systems.
2. Select the system.
3. Open Details.
4. Confirm Default Emulator uses RetroArch.
5. Open Video.
6. Set Video Overlay (required for The Bezel Project) to On or Off.
7. Select Save Changes.

HyperHQ changes the RetroArch overlay setting. Your bezel or overlay files still need to exist in RetroArch.