InstallationInstallation

Detailed per-platform installation instructions for RetroVoid.

RetroVoid is available for Windows, macOS, and Linux. Choose your platform below for step-by-step instructions.

Windows#

EXE Installer (Recommended)#

1. Download the .exe installer from the purchase page.
2. Double-click the downloaded file to launch the installer.
3. Follow the prompts. The default installation directory is C:\Program Files\RetroVoid.
4. Once complete, RetroVoid will appear in your Start Menu.

MSI Installer#

An .msi installer is also available as an alternative to the EXE format. The installation process is the same.

Windows Defender: On first launch, Windows SmartScreen may show a warning because the app is new. Click "More info" and then "Run anyway".

System Requirements (Windows)#

• Windows 7 SP1 or later
• WebView2 Runtime (automatically installed by the EXE/MSI installer)

macOS#

DMG Installer#

1. Download the .dmg file from the purchase page.
2. Open the DMG and drag RetroVoid into your Applications folder.
3. On first launch, macOS may warn that the app is from an "unidentified developer."
   • Go to System Settings > Privacy & Security and click "Open Anyway".
   • Alternatively, right-click the app and select Open.
   • If macOS hard-quarantines the app and neither option above works, open Terminal and run:

     xattr -cr /Applications/RetroVoid.app

Apple Silicon Support#

RetroVoid ships as a universal binary that runs natively on both Apple Silicon (M1/M2/M3/M4) and Intel Macs. No need to choose between architectures.

Linux#

AppImage (Universal)#

The AppImage is a portable single-file executable that works on virtually any Linux distribution:

chmod +x RetroVoid-*.AppImage
./RetroVoid-*.AppImage

No installation needed, just make it executable and run. To integrate with your desktop environment, use a tool like AppImageLauncher.

Debian / Ubuntu (.deb)#

sudo dpkg -i retrovoid_*.deb
sudo apt-get install -f  # Install any missing dependencies

Required Dependencies (Linux)#

Make sure these libraries are installed:

• libwebkit2gtk-4.1
• libgtk-3-0
• libssl (OpenSSL)

App Data Locations#

RetroVoid stores its database and media files in the following locations:

The app data directory contains:

retrovoid.db                      # SQLite database (settings, games, metadata)
images/
  covers/                         # Cover art (one per game)
  screenshots/                    # IGDB screenshots
media/
  {game_id}/                      # User-uploaded media (images/videos)

Updating RetroVoid#

RetroVoid does not currently have an auto-update system. To update to a new version:

• Windows: Download the latest installer and run it. It will upgrade in place.
• macOS: Download the new DMG and replace the app in your Applications folder.
• Linux AppImage: Download the new AppImage and replace the old one.
• Linux .deb: Download and install the new package with dpkg -i.

Uninstalling#

Windows#

• Open Settings > Apps > Installed Apps, find RetroVoid, and click Uninstall.
• To remove app data, delete %APPDATA%\RetroVoid\.

macOS#

• Drag RetroVoid from Applications to the Trash.
• To remove app data: delete ~/Library/Application Support/com.retrovoid.app/.

Linux#

# Debian/Ubuntu
sudo apt remove retrovoid
 
# AppImage - just delete the file
rm RetroVoid-*.AppImage

To remove app data: delete ~/.config/retrovoid/ and/or ~/.local/share/retrovoid/.