I built a DOS game launcher for Windows 11 with automatic DOSBox setup

Brad Perry — Fri, 17 Jul 2026 02:52:12 +0000

Getting a DOS game running on a modern PC often means finding the right executable, writing mount commands, tuning a config file, and keeping every installation organized. I wanted that setup to feel more like using a modern game library.

So I built AI DOS Game Launcher, a source-available Windows 11 desktop app powered by Python, PySide6, and DOSBox Staging.

What it does

The launcher can:

Search legitimate freeware and shareware catalogs from the Internet Archive MS-DOS collections and classicdosgames.com
Download and extract a selected game
Rank the available executables and choose the most likely game entry point
Generate a per-game dosbox.conf
Download and manage a portable DOSBox Staging installation
Import user-owned folders and ZIP archives
Keep installed games available for offline play
Let users edit executable choices and DOSBox settings

The project does not bundle games or search piracy sites. Users remain responsible for each game's license and copyright terms.

How the automatic setup works

The executable detector filters out common installers, setup tools, uninstallers, and utilities. It then scores the remaining files using the game title, folder name, and executable naming patterns.

Once an executable is selected, the launcher creates a configuration that mounts the game directory as C: and starts the game automatically. Deterministic heuristics handle the core workflow, so no AI key is required.

There is optional support for OpenAI-compatible providers, including OpenRouter, for search-term cleanup, executable selection, and configuration suggestions. API keys stay in a local gitignored config.json file.

Stack and quality checks

Python 3.12+
PySide6 desktop interface
DOSBox Staging portable runtime
Offline, fixture-based pytest suite
25 passing tests
GitHub Actions coverage for Python 3.12 and 3.13 on Windows

The interface uses a dark retro theme, while the application keeps downloaded games, emulator files, and local settings outside source control.

Current limitations

The first release targets Windows 11. Catalog coverage can still improve, and executable detection will always have edge cases for unusual archives. The repository is currently source-available with no software license granted yet.

I'd especially appreciate feedback on:

The install and first-run experience
Executable detection edge cases
Useful DOSBox settings to expose in the interface
Additional legitimate freeware or shareware catalogs worth supporting

Try it

The code, setup instructions, tests, and implementation notes are on GitHub:

Skynet-Pro-Plus/ai-dos-game-launcher

If you try it, let me know which DOS game you tested and where the setup experience could be smoother.