gitwtfhub

wtf is ultima1-ios?

dmaynard51/ultima1-ios — explained in plain English

Analysis updated 2026-05-18

6ShellAudience · generalComplexity · 3/5LicenseSetup · moderate

TL;DR

A build script that turns an existing iOS DOSBox app into a one-tap Ultima I game for iPhone and iPad, using your own legally owned copy of the game.

Mindmap

mindmap
  root((ultima1-ios))
    What it does
      Packages DOSBox for iOS
      Boots straight into Ultima I
      Uses your own game files
    Tech stack
      Shell
      Xcode
      DOSBox
    Use cases
      Play Ultima I on iPhone
      Sideload without a Mac
      Play similarly on Android
    Audience
      Retro gamers
    Setup
      Bring your own game files
      Free Apple ID sideload

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

Play a legally owned copy of Ultima I directly on an iPhone or iPad without a computer nearby.

REASON 2

Sideload the prebuilt app on Windows or Linux using free tools if you do not own a Mac.

REASON 3

Learn how to patch and rebrand an existing open source DOSBox app for a specific game.

REASON 4

Play the same classic game on Android using a similar DOSBox-style app and your own files.

What's in the stack?

ShellXcodeDOSBoxiOS

How it stacks up

dmaynard51/ultima1-iosjerlinn/jerlin-wereadjonluca/dotfiles
Stars666
LanguageShellShellShell
Last pushed2024-06-02
MaintenanceDormant
Setup difficultymoderateeasy
Complexity3/51/5
Audiencegeneraldeveloperdeveloper

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

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires your own legally owned copy of Ultima I game files, a Mac with Xcode is easiest, but sideloading tools work without one.

The build script and app icon are MIT licensed and free to reuse, the underlying DOSBox app is GPLv2, and the Ultima I game itself is commercial software you must own separately.

Wtf does this do

ultima1-ios is a build script that turns the classic 1981 computer game Ultima I into an app you can play directly on an iPhone or iPad. It does not include the game itself. Instead, it takes an existing open source iOS version of DOSBox, the tool that lets old MS-DOS programs run on modern devices, patches it so it boots straight into Ultima I, adds a matching icon, and copies in your own legally owned copy of the game files, most commonly from the GOG version sold as part of an Ultima bundle. If you own a Mac with Xcode and git installed, you can build and install the app onto your phone with a single script and a free Apple ID, no paid Apple developer account required. The script automatically detects the signing details it needs and points out the exact manual steps in Xcode if command line signing does not work. A free Apple ID can keep up to three sideloaded apps installed at once, and the app needs to be re-signed roughly every week. For anyone without a Mac, the project also publishes a ready-made app file that can be installed on Windows, Linux, or Mac using free sideloading tools such as Sideloadly or AltStore, again using nothing but a free Apple ID. After installing, you still need to copy your own Ultima I game files onto the device yourself, placed directly at the top level of the app's folder rather than inside a subfolder, since that folder acts as the game's main drive. Once running, the app displays the original DOS game in landscape mode with a custom on-screen layout built for the game, including a movement pad and labeled buttons for common Ultima I commands, plus a way to bring up a full keyboard when needed. The README also explains how to play the same game on Android using existing DOSBox-style apps instead. The build script and icon are MIT licensed, the underlying DOSBox app is GPLv2, and the actual Ultima I game data remains the property of its original publisher and is never distributed by this project.

Yoink these prompts

Prompt 1
Walk me through building and installing ultima1-ios on my iPhone using a Mac and Xcode.
Prompt 2
Explain how to sideload the prebuilt Ultima I app on Windows using Sideloadly or AltStore.
Prompt 3
Help me figure out where to place my GOG Ultima I game files so the app finds ULTIMA.EXE correctly.
Prompt 4
How would I adapt this project's approach to package a different DOS game for iOS?

Frequently asked questions

wtf is ultima1-ios?

A build script that turns an existing iOS DOSBox app into a one-tap Ultima I game for iPhone and iPad, using your own legally owned copy of the game.

What language is ultima1-ios written in?

Mainly Shell. The stack also includes Shell, Xcode, DOSBox.

What license does ultima1-ios use?

The build script and app icon are MIT licensed and free to reuse, the underlying DOSBox app is GPLv2, and the Ultima I game itself is commercial software you must own separately.

How hard is ultima1-ios to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is ultima1-ios for?

Mainly general.

View the repo → Decode another repo

This repo across BitVibe Labs

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