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

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.

Disclosure: I used AI-assisted coding and writing tools while building and documenting this project. I reviewed the resulting code and article, and the project is covered by its automated test suite.