Skip to content
SilvercodeStudioPublic

About

eXo Client for Mac - Emulator Frontend for eXoDOS and eXoWin9x

Resources

Stars

1 star

Watchers

1 watching

Forks

Repository files navigation

Silverbox

Welcome to Silverbox!

Silverbox icon

Silverbox is an emulation front-end for the Mac, built for eXoDOS, eXoWin3x, eXoWin9x and the other game preservation projects by the eXo team (https://www.retro-exo.com). It sets up an eXo download without Windows, reads the collection in place (the LaunchBox XML metadata, box art, screenshots, manuals, music and videos), and starts each game in a Mac emulator such as DOSBox Staging, DOSBox-X, 86Box, ScummVM, Spatterlight or GSplus, with the settings eXo uses on Windows.

The games, media and emulators are not part of this project.

FAQ

What is this?

Silverbox is an emulator front-end (launcher) for Apple Mac computers that is designed to allow you to enjoy the eXo projects (retro game collections such as eXoDOS and eXoWin9x) directly on your Mac without needing a Windows PC.

Silverbox provides an experience on Mac similar to what Windows users get with LaunchBox: an integrated game and media browser that lets you view game collections, see game descriptions and details, view images, read game manuals, magazines, and books, and listen to music and game soundtracks. However, to actually play the games, you will need to download additional Mac versions of game emulators like DOSBox that are not provided with Silverbox.

(Note: Silverbox is not affiliated with or endorsed by the eXo Project.)

What is the eXo project?

eXo is an incredible community project to preserve games and media from the 1980s-1990s era on various systems including MS-DOS / IBM PC, early Windows, Apple IIgs, and others including the ScummVM (adventure game) project. They offer various collections that you can download that include games, manuals, hint books and other literature, box art, screenshots, music, and other goodies. eXo's collections come set up for LaunchBox, a Windows front-end; Silverbox provides an alternative front-end for Mac users.

See the eXo FAQ for more details.

What do I need to do to use this?

Silverbox does not include the actual eXo project downloads, or any Mac emulators. To get started:

  1. Get a BitTorrent client such as qBittorrent or Transmission.

  2. Visit retro-exo.com and grab the torrent file for the eXo collection that you're interested in. Note: some of these collections, particularly eXoDOS, are very large and may take a long time to download.

eXoDOS also comes as "Lite": about 6 GB instead of about 700 GB, because it leaves out the games and downloads each one when you install it. Silverbox does the same with aria2 (brew install aria2), from the eXoDOS torrent that Lite includes. The first download can take a minute or so to find other computers sharing the torrent; later ones start in seconds.

Currently, Silverbox supports the following collections:

  • eXoDOS MS-DOS games from the 1980s and 1990s.
  • eXoWin3x Windows 3.1-era games, educational materials and other multimedia.
  • eXoWin9x Windows 95/98-era games and other multimedia.
  • eXoIF Interactive Fiction (text adventures such as Zork)
  • eXoScummVM "Point-and- click" adventures that run under the ScummVM game engine, including classic Sierra games (King's Quest, etc.)
  • eXoDemoScene primarily MS-DOS based "demos" (graphics / multimedia demonstrations)
  • eXoAppleIIGS - Apple IIgs games and educational software. Most play in GSplus; the 74 games that eXo runs in MAME need one ROM file that you supply (see Emulators).
  • (Coming soon) - eXoDREAMM - Loom and similar adventure games
  1. Emulators for Mac: All you need to browse the collections are Silverbox itself and one or more eXo collection downloads. However, to actually play the games, you will need to download one or more additional emulators for Mac depending on which titles you want to play.

See the Emulators section below for exactly what Mac emulators you need to play which titles.

  1. Launch Silverbox and drag one of your eXo folders from the Finder to the app, or click Add Collection… on the welcome screen (later, in Settings › Library). For a download that is not set up yet, Silverbox asks whether to unpack the required files inside the download folder, or in a separate local folder. If you choose the latter, your eXo download is not changed.

Can I share eXo files with a Windows install?

Yes, if you download your eXo collections to somewhere that is accessible to both your Mac and Windows PCs, such as a NAS or other network share, you can share the installation between both systems. However, don't open the same folder on multiple PCs at the same time unless the Mac uses a separate folder for unpacked files.

Can I use this for other consoles (SNES, etc.)?

Yes, but currently Silverbox depends on an existing LaunchBox library, and launching these games is experimental. Silverbox does not find games or fetch their metadata and art itself ("scraping"), and you cannot add single games by hand yet. However, if you have a LaunchBox installation from Windows, Silverbox can recognize and use that folder and take advantage of the metadata, media, etc. already registered by LaunchBox.

Who are you?

I am a software engineer with decades of industry experience, who is interested in classic game and media preservation.

Note: this app was developed with extensive AI coding tool assistance, under my close supervision and direction.

Requirements

  • macOS 15 or later, on Apple silicon or Intel.
    • Building the app from source needs Xcode 27 or higher.
  • One or more eXo downloads, such as eXoDOS v6, eXoWin3x and eXoWin9x. Silverbox runs their setup itself, so a Windows PC is not needed; a folder set up on Windows works too.
  • For eXoDOS Lite, aria2 (brew install aria2), which downloads each game when you install it.
  • The emulators for the packs you play; see Emulators. Most are optional: a game whose emulator is missing still shows, with its box art, manual and extras.

Emulators

Silverbox starts games in Mac emulators that you install yourself. Put them in /Applications (or ~/Applications), or choose them in Settings › Emulators. eXo ships Windows builds of the same emulators; the app does not use them.

General MIDI music plays through FluidSynth with the eXoDOS Sound Canvas SoundFont. DOSBox-X and DOSBox Staging 0.83 or later have FluidSynth built in; for an older DOSBox Staging, install it with brew install fluid-synth.

Collection Emulator What for
eXoDOS DOSBox Staging Most games.
eXoDOS DOSBox-X Games that eXo runs in DOSBox-X or SVN Daum, and the Windows 3.x titles. Optional; Staging runs them less faithfully.
eXoWin3x DOSBox Staging, DOSBox-X Each game boots its own Windows 3.1. Staging for most; DOSBox-X for the games eXo runs in DOSBox-X or SVN Daum.
eXoWin9x DOSBox-X Windows 98 for almost every game.
eXoWin9x 86Box The thirty or so games that eXo runs in 86Box.
eXoDemoScene DOSBox-X About 95% of the demos; DOSBox Staging for the rest. The three MartyPC demos (8088 MPH, Area 5150, CGADEMO) are not supported.
eXoScummVM ScummVM 2026.4 or later Every game. Five games use engines that ScummVM leaves out of its release builds (In Cold Blood, The Adventures of Robin Hood, Star Trek: 25th Anniversary, Lost Eden, Ultima I); set a daily build as the second ScummVM in Settings to play them.
eXoAppleIIGS GSplus 1.38 or later Most games, with the Apple IIGS ROM that eXo ships, including the ten that eXo runs in GSport.
eXoAppleIIGS MAME (brew install mame) The 74 games eXo runs in MAME. Current MAME needs one ROM file that eXo's set (for MAME 0.245) lacks: 344s0047.bin, the Apple IIGS character ROM. Add it in Settings › Emulators.
eXoIF DOSBox Staging or DOSBox-X The MS-DOS versions of the games.
eXoIF RetroArch cores C64 and other Commodores (VICE), ZX Spectrum and ZX81 (Fuse, 81), Apple II (AppleWin), Atari 8-bit (atari800, with eXo's ROMs), Amstrad CPC (cap32), Amiga (PUAE, with a Kickstart ROM you supply).
eXoIF Spatterlight Infocom and other story files that eXo plays in WinFrotz, Lectrote, Gargoyle and similar interpreters. Versions that need Windows programs, MAME or mainframe emulators are not supported.
LaunchBox libraries RetroArch, Dolphin, MAME or Mednafen Console, computer and arcade platforms. Settings › Emulators assigns one per platform, following the library's Emulators.xml by default.

What plays

With the right Mac emulators installed, nearly every game in the DOS and Windows packs, the demo scene pack and the ScummVM pack can start. The exceptions are a few games in some packs, whole systems in eXoIF, and the eXoAppleIIGS games that eXo runs in MAME until you add one ROM file. "Can start" means a Mac emulator is known to load the game. Each game has not been played through.

Pack Games Can start Notes
eXoDOS 7,667 Nearly all DOSBox Staging or DOSBox-X. A few games show their own version menu inside DOSBox, and a few menu choices need a Windows helper.
eXoWin9x (1994–1996) 665 All Windows 98 in DOSBox-X, about thirty games in 86Box. Network play (Host, Join) is not supported; games start in Solo mode.
eXoWin3x 1,139 Nearly all Windows 3.1 in DOSBox Staging or DOSBox-X. Set up and spot-checked: games boot to Windows and start.
eXoDemoScene 2,425 About 99% DOSBox. Not supported: the three MartyPC demos (8088 MPH, Area 5150, CGADEMO). Four demos have no archive in eXo's download either.
eXoScummVM 832 About 99% (all with a daily build) Five games need engines that ScummVM's release builds leave out.
eXoIF 2,331 About 64% (about 68% with extra cores and a Kickstart ROM) Story files in Spatterlight, MS-DOS versions in DOSBox, Commodore, ZX Spectrum, Apple II and Atari 8-bit versions in RetroArch. Not supported yet: BBC Micro, TRS-80, Dragon/CoCo, Oric, TI-99 and other machines, and versions that need MAME, mainframes or Windows programs.
eXoAppleIIGS 460 About 84% (all with a ROM file) GSplus, with eXo's settings; a sample of games boot. The 74 games that eXo runs in MAME need the Apple IIGS character ROM, which you supply.

Many eXoIF games come in versions for several computers, and a game counts when any of its versions can start. Where a version needs a RetroArch core or ROM that is not installed, the launch options say which.

Where your data goes

A collection can be read-only (an external drive or a network share). Silverbox changes your eXo download only when you ask it to: when you set up the download in place, or install games in place. eXoDOS Lite games download into the set-up collection: the download folder itself after an in-place setup, otherwise the collection's copy in the local data folder. Installed games, save backups, edited configs, unpacked soundtracks and caches are kept in a local data folder, by default ~/Library/Application Support/Silverbox, which Settings can point at another drive; favorites, play history and settings stay in Application Support. Installing games in place inside eXo/eXoDOS, as eXoDOS does on Windows, is available in Settings.

Installations are unpacked in a temporary folder and become available only when they finish. Operations that would change the same game or virtual machine cannot run together. New save backups are kept separately for each installation under Saves/Installations; older backups remain available for restore. Favorites and play history keep one previous readable copy, and a damaged file is preserved before recovery.

Build

Open Silverbox.xcodeproj and run the "Silverbox" scheme, or use the Makefile:

make run                  # build with xcodebuild, then start the app
make run ARGS='-libraryPath /Volumes/eXoDOS_ro -musicEnabled 0'
make build                # build only; CONFIG=Release for a release build
make test                 # core tests (swift test)
make sweep                # translate every eXoDOS config in the mounted library
make format               # reformat the Swift sources with swift-format
make lint                 # report formatting problems without changing files
make install-app          # universal Release build copied to ~/Applications
make reset                # delete the app's settings and local data folder, to test a first start
make site                 # serve the website (docs/site) at http://localhost:8001

The core library (XML parsing, media lookup, config translation, music decoders) is a Swift package at the repo root, so swift build and swift test work without Xcode's project. The app links the package's SilverboxCore product as a local package dependency.

Instructions for coding agents are in AGENTS.md. To let Claude Code build and read diagnostics through the open Xcode, enable MCP under Xcode › Settings › Intelligence, then register the server:

claude mcp add --transport stdio xcode -- xcrun mcpbridge

Xcode asks for permission when a new session connects.

Third-party code

Two small C libraries are vendored under Sources/, each with its license and a note on its origin:

  • stb_vorbis (public domain or MIT) decodes Ogg Vorbis menu music.
  • libxmp-lite (MIT) plays MOD, S3M, XM and IT tracker modules.

macOS plays the other music formats itself.

To do

What changed in each version is in CHANGELOG.md; the milestones, with what is done and what is not, are in docs/internal/Milestones.md.

  • Exercise the new file safeguards with real running games: overlapping Windows 98 launch attempts and quitting with an active game or job. The automated tests cover reservations, interrupted installs, backup failures and recovery of favorites and play history.
  • Launch console, computer and arcade games for real with RetroArch, Dolphin, MAME and Mednafen. The planner and the emulator assignments exist; nothing has been played yet.
  • ROM-folder collections: plain Games/<Platform> folders with no LaunchBox XML beside them, plus single titles configured by hand.
  • More eXo packs. eXoWin3x, eXoDemoScene, eXoScummVM and eXoAppleIIGS launch, and eXoIF launches its story-file, MS-DOS and most 8-bit versions (about 1,500 of 2,331 games). Still to do: eXoIF's BBC Micro, TRS-80, Dragon/CoCo, Oric and TI-99 versions (MAME or native emulators). Later: the eXoScummVM hint files (UHS).
  • tvOS client app: a full-screen, controller-first view on top of the grid and the controller input that exist today.
  • Metadata and media scraping for games outside the eXo collections.

About

eXo Client for Mac - Emulator Frontend for eXoDOS and eXoWin9x

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages