Getting Started with AmpShell: Setup, Commands, and Examples

AmpShell — The Ultimate Guide to High-Performance Shell Tools

What AmpShell is

AmpShell is an open-source .NET front-end for DOSBox that simplifies launching and managing DOS games on Windows (portable builds include DOSBox). It provides a GUI to avoid manual DOS commands, speeds startup, and offers features for organizing and configuring games.

Key features

• Fast startup / No install: Single executable; portable mode available.
• AutoConfig: Detects DOSBox and its config file automatically.
• Multiple DOSBox support: Use different DOSBox forks per game (DOSBox, DOSBox-X, SVN variants).
• Drag & drop: Add games by dropping EXEs or links.
• Per-game advanced options: Custom working directory, additional DOSBox command lines, icons, notes.
• Portable Pack: AmpShell + preconfigured DOSBox for portable use.
• Command-line mode: Launch games directly via -g (run), -s (setup), -v (verbosity).
• Compatibility: Targets .NET (runs across many Windows versions; some builds support legacy Windows).

Typical usage flow

1. Download and extract AmpShell (or portable pack).
2. Add a game via New Game → choose game executable (or drag & drop).
3. Optionally set per-game DOSBox executable/config, icon, and additional commands.
4. Double-click a game to launch it in DOSBox; use command-line options for scripts/automation.

Installation & requirements

• Requires .NET runtime (varies by release; many builds target .NET 5 or .NET Framework 4 for legacy).
• Portable zip available (includes DOSBox); otherwise point AmpShell to an existing DOSBox executable.

Releases & maintenance

• Latest official release series: v1.3.x (latest listed v1.3.8 — June 29, 2021).
• Project repository archived (GitHub: maximilien-noal/AmpShell) and project site available (ampshell.tuxfamily.org). Licensed under GPLv3.

When to use AmpShell

• You want an easy GUI to run/configure DOS games without