← Back
Live

DOSCrate

A native macOS library manager and launcher for MS-DOS games — drop in a folder, ZIP, or disc image, get box art from LaunchBox, and play through a bundled DOSBox Staging runtime without writing a .conf file by hand.

macOSSwiftSwiftUIRetro gaming

DOSCrate is a native macOS library manager and launcher for MS-DOS games, written in Swift 6 and SwiftUI for Apple Silicon Macs. It pairs a Finder-friendly .doscrate bundle format with a bundled DOSBox Staging runtime so you can import, organise, configure, and play classic DOS games without writing .conf files by hand.

Why I built it

I grew up playing DOS games in the ’90s — my first computer was a 486 running DOS and Windows 3.1.

DOSBox Staging is a great emulator for revisiting those games today, and a terrible bookshelf. Playing a pile of old DOS games on a Mac usually means a folder full of cryptic eight-character directory names, a separate .conf file for each one, mount c commands in [autoexec], and trying to remember whether the executable you want is PLAY.BAT, GAME.EXE, or SIERRA.COM.

I wanted a shelf where every game is a box with a cover, clicking Play just launches it, and all the era-specific hardware switches live in an inspector instead of a text editor.

Importing & the .doscrate bundle

Drop a game folder, .zip archive, CD-ROM image (.iso, .cue/.bin), or floppy image (.img, .ima) onto the window — or point it at a parent directory and import every subfolder as its own game.

Each game can either be copied into the library as a self-contained .doscrate package or kept in place via a security-scoped bookmark. On import, DOSCrate ranks the executables inside to pick the main program and any setup utility (SETUP.EXE / INSTALL.EXE), matches the game against the LaunchBox Games Database, and pulls down the front box art, release metadata, and screenshots.

Filtering the library by Role-Playing games

Filtering by genre, year, publisher, or developer — with LaunchBox cover art and screenshots in the inspector.

Hardware presets without the .conf

Instead of editing INI sections by hand, DOSCrate generates a deterministic DOSBox Staging configuration on launch from global defaults and per-game overrides:

Default hardware and DOSBox settings in the DOS theme

Global defaults in the Settings sheet; every game can override them in its own inspector.

Two visual themes

The default DOS Theme leans all the way into the 16-colour VGA palette — #0000AA desktop blue, #C0C0C0 beveled panels, pixel icons, and VileR’s PxPlus IBM VGA 8x16 bitmap font. If you prefer your Mac to look like a Mac, a single toggle switches the whole app to a native macOS split view and standard controls.

Under the hood

The core logic lives in DOSCrateKit, a Swift 6 package under strict concurrency split into five modules: LibraryKit (.doscrate bundle I/O and FSEvents watching), ConfigKit (hardware presets and .conf generation), ImportKit (archive/disc import and executable ranking), LauncherKit (child-process lifecycle and play-time tracking), and MetadataKit (LaunchBox XML indexing and fuzzy matching).

DOSCrate ships as a Developer ID–signed, notarized DMG for macOS 15+ on Apple Silicon, with in-app updates via Sparkle and an unmodified DOSBox Staging 0.83.0 runtime bundled inside.