gitwtfhub

wtf is dospad?

burnermcburnface33/dospad — explained in plain English

Analysis updated 2026-05-18

0CAudience · developerComplexity · 4/5LicenseSetup · hard

TL;DR

An iOS app called iDOS 3 that emulates an MS-DOS computer, letting you run classic DOS software on a real iPhone or iPad using a full set of touch controls.

Mindmap

mindmap
  root((iDOS 3))
    What it does
      Emulates MS-DOS PC
      Runs on iPhone and iPad
      Uses DOSBox-X core
    Tech stack
      SwiftUI
      DOSBox-X
      SDL
    Use cases
      Import DOS software
      Use touch controls
      Adjust CPU speed
    Audience
      Retro computing fans
      iOS developers
    Setup
      Needs Xcode and XcodeGen
      Device only, no simulator

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Run classic MS-DOS programs and games on a real iPhone or iPad.

REASON 2

Import DOS software as a ZIP file or through the Files app onto the emulated drive C.

REASON 3

Use onscreen touch controls, a virtual joystick, or a Bluetooth controller to play DOS games.

REASON 4

Adjust the emulated CPU speed, including a turbo mode for running software faster.

What's in the stack?

CSwiftSwiftUIDOSBox-XSDLXcodeGen

How it stacks up

burnermcburnface33/dospadac000/find-flvacc4github/kdenlive-omnifade
Stars00
LanguageCCC
Last pushed2013-04-05
MaintenanceDormant
Setup difficultyhardmoderatemoderate
Complexity4/52/52/5
Audiencedeveloperdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · hard Time to first run · 1h+

Requires a Mac with Xcode and XcodeGen, an Apple Developer account, and a real iOS 17+ device since the simulator is not supported.

The source code is released under GPLv2, meaning you can use and modify it, but any distributed version must also be open source under the same license.

Wtf does this do

This project, called iDOS 3, is an iPhone and iPad app that lets you run old MS-DOS PC programs and games directly on your device. It is built on top of an existing DOS emulator called DOSBox-X, wrapped inside a native Apple app made with SwiftUI, and it continues a line of earlier apps known as dospad and iDOS. Because the emulator's underlying code is only built for real iPhones and iPads, it will not run in Apple's simulator, only on an actual device. The app is designed around making a keyboard-and-mouse era operating system usable purely by touch. It offers seven different input methods, including an onscreen keyboard with function keys, a virtual joystick, a customizable D-pad, and a mode where the whole screen behaves like a mouse trackpad. It also supports Sound Blaster style audio, lets you adjust how fast the emulated computer runs through a CPU cycles setting, and includes a turbo mode for full speed. For storage, the app automatically treats your device's Documents folder as drive C, which you can browse from the Files app. You can also import zipped DOS software directly, or open specially prepared folders called idos packages that bundle a DOS configuration with the software itself. There are basic save states for restoring your drive setup and launch settings, though the README notes that full save states are still experimental and can sometimes cause display problems. To build the app you need a Mac with Xcode and a tool called XcodeGen, an Apple Developer account, and a real iOS device. DOS software and disk images are not included. You must supply your own and are responsible for using them legally. The README states the source code is released under the GPLv2 license, while bundled visual assets are for personal use only.

Yoink these prompts

Prompt 1
Walk me through building and installing this DOS emulator on my own iPhone using the steps in this README.
Prompt 2
Explain how drive C and idos packages work in this app, based on what the README describes.
Prompt 3
Help me understand why this app can only run on a real device and not in the iOS Simulator.
Prompt 4
Summarize the seven touch input modes this README lists and what each is best suited for.

Frequently asked questions

wtf is dospad?

An iOS app called iDOS 3 that emulates an MS-DOS computer, letting you run classic DOS software on a real iPhone or iPad using a full set of touch controls.

What language is dospad written in?

Mainly C. The stack also includes C, Swift, SwiftUI.

What license does dospad use?

The source code is released under GPLv2, meaning you can use and modify it, but any distributed version must also be open source under the same license.

How hard is dospad to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is dospad for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.