Screenshot of DOSPAD running on iPad

UPDATED July 27: How to get DOSPAD on iOS – with or without a jailbreak

Another nerdy post! Yeha! Header image credit goes to TouchArcade.

Hot on the heels of my last post that focused on adding small tweaks to stock iOS 9 using modified iTunes Backups, here is a post about a previously jailbreak-only application running on normal iOS: DOSPAD. (A limited version of DOSPAD called iDos is available on the AppStore. This post is about the fully featured emulator.)

In case you’re wondering out loud, “Why would you want an MS-DOS emulator on your iPhone/iPad?”: Check out this YouTube video (Mac OS 8 on iPhone) and this article on TouchArcade (classic DOS games on iPad) for inspiration. DOSPAD is obviously more fun on iPad because of the added real estate and features, but it works on iPhone as well.

To follow through with this tutorial, you either need:

Alright, so you’ve got Xcode 7 set up with your developer account. There are three ways to go from here. The first one works by creating an .ipa file from the latest version of Dospad available on the lichtie Cydia repository. Though it’s one step longer than way 2, it doesn’t rely on Xcode and the code working together.
Way 2 uses the source code of Dospad that is available on GitHub to compile the lastest beta of the app yourself. The GitHub has been updated in April with a bunch of fixes (thanks to litchie and yoshisuga).
Finally, way 3 is for jailbroken users and is the easiest method

It should be noted that, since ways 1 and 2 rely on a free developer provisioning certificate, you’ll have to re-do the process every seven days because the free certificate expires every week.

Way 1: using the “iOS App Signer” and the .deb file

This way of installing DOSPAD will give you exactly the same app that you would get if you’re downloading it via Cydia. This means it might be more stable than the Beta from GitHub.

  1. Open Xcode and create a new project. Choose “iOS” and “Single View Application” and “Next”. Enter “dospad” and click “Create”.
  2. In the bundle ID field, enter “com.mycompany.dospad”.
  3. Connect your iDevice. Next to the Play and Stop buttons in the top left, select the “dospad” target and your device. (Screenshot)
  4. Click “Fix Issue” (Screenshot)
  5. Download and run “iOS App Signer” (direct link)
  6. Download the DOSPAD .deb file from the official Litchie repo (direct link) (the repo is back up with an updated version of dospad! yay) (md5(dospad.deb) = 131753909186aa92a4ae5a897ae2d942)
  7. In “iOS App Signer”, click “Browse” and select the “dospad.deb” file you just downloaded.
  8. Next, choose the provisioning profile that matches the bundle id you entered in step two.
  9. Press ”Start”, choose a destination folder, click “Save” and wait a few seconds. When the status text at the bottom of the window reads “Done, output at…”, you can move on
  10. Open iTunes and select the App Library
  11. Drag the new dospad.ipa file to the app library.
  12. Find the (blank) DOSPAD app in your iTunes App Library
  13. Connect your iDevice to your Mac
  14. Drag the DOSPAD app from the App Library to your device (a small sidebar will appear on the left of the screen when you start dragging). Wait a few seconds.

Done!

Way 2: Using Xcode and the source code

This way of installing DOSPAD will give you the latest beta with changes and additions that might not be availabe in the Cydia release yet. Keep in mind that it’s a beta, so things might be unstable.

  1. Download the DOSPAD source code from the GitHub page (“Clone or download” => “Download ZIP”).
  2. Extract the contents of the .zip and navigate to the new “dospad-master” folder.
  3. Double-click the “dospad.xcodeproj” file in the “dospad-master” folder to open the project in Xcode.
  4. Select the “dospad” project in the left navigator. Then select the “dospad” target and the “General” tab. (Screenshot)
  5. Change the Bundle Identifier to something else.
  6. Connect your iDevice. Next to the Play and Stop buttons in the top left, select the “dospad” target and your device. (Screenshot)
  7. Click “Fix Issue” (Screenshot)
  8. Click the Play button to install the app on your device and run it. (If you see a huge number of compiler warnings, that’s ok. I got 335 warnings.)

Done! That’s six steps less than way 1, but since people tend to get lost in Xcode and their brain turns off when they see source code, way 1 is probably easier to go for most.

Way 3: Installing DOSPAD through Cydia

  1. Jailbreak your iDevice. (visit http://www.canijailbreak.com/ to check whether that is possible.)
  2. Open Cydia and go to the sources tab.
  3. Tap “edit” and “add”, then type/paste “http://cydia.litchie.com/” and tap “add source”. Wait for Cydia to refresh.
  4. Go to the search tab and search for “dospad”. Tap on “DOSPAD – dosbox for iOS”.
  5. Tap “Install” and “Confirm”.
  6. Tap “Back to Cydia”.
  7. Go to your homescreen and tap DOSPAD to open it! (note: dospad doesn’t launch if you’ve modified your resolution using Upscale!)

Done! That was easy!

If you liked this tutorial, please tell me in the comments below (Disqus) and consider sharing this post with others. Thanks!

If you want to get notified when I write the next post, you can subscribe via email (see left sidebar) or Facebook or follow me on Twitter. Cheers!