A native iOS/iPadOS port of Ship of Harkinian that brings Ocarina of Time to Apple devices with Metal rendering, touch controls, and ROM import via Files.

Stars

169

7-day growth

No data

Forks

12

Open issues

0

License

No data

Last updated

2026-07-28

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It solves the long-standing demand for a native Ocarina of Time on iOS without emulation, with official-quality touch controls and reproducible builds.

Who it is for

  • iOS gamers who own a legally acquired Ocarina of Time ROM
  • Developers interested in porting PC games to iOS
  • Nintendo 64 enthusiasts seeking modern mobile play
  • Homebrew and emulation community members

Use cases

  • Playing Ocarina of Time on iPad with touch or game controller
  • Testing and developing iOS game ports using Ship of Harkinian engine
  • Understanding the process of integrating a C++ game engine with Metal and iOS frameworks
  • Evaluating performance of Metal rendering for N64-era games on modern iOS hardware

Strengths

  • Native Metal rendering provides smooth performance on supported devices
  • Full-featured touch control layout designed specifically for landscape iPad
  • Reproducible build scripts ensure transparency and no bundled game data
  • Supports a wide range of input methods: touch, keyboard, mouse, and iOS game controllers

Considerations

  • Not available on App Store or TestFlight; requires manual sideloading via AltStore
  • Touch control stick is eight-way only, lacking true analog precision
  • Audio and controller reconnect testing are incomplete; some hardware combinations may have issues
  • No top-level project license, which may complicate redistribution and contributions

README quick start

HarkinianPad

Ocarina of Time via Ship of Harkinian, rebuilt for iPhone and iPad. Native Metal rendering, touch controls, Files-based setup, and support for keyboards, pointing devices, and iOS game controllers.

HarkinianPad packages the full Ship of Harkinian source port as a native iOS/iPadOS app. It renders through Metal, imports a user-provided supported Ocarina of Time ROM through Files, and includes a landscape touch controller that can be hidden whenever a physical controller is connected.

This repository contains the mobile integration and reproducible build scripts. It does not contain Ocarina of Time, a ROM, or a playable ROM-derived archive.

Install status

OptionStatusWhat to do
Developer-preview .ipaAvailable nowDownload preview 0.1.0, then re-sign it with your Apple ID by following the AltStore Classic guide.
Local iPad buildAvailable nowBuild and sign with your Apple development team using the instructions below.
SimulatorAvailable nowBest for development and UI testing; it is not a substitute for physical-device testing.
App Store / TestFlightNot announcedNo listing or public TestFlight currently exists.

The current development build has been signed, installed, and played on a 12.9-inch iPad Pro (6th generation) running iPadOS 26.5.2. Files import, on-device archive loading, touch gameplay, save loading, the settings menu, and in-place app updates have all been exercised on that hardware.

Audio has been heard during repeated physical-iPad playtests. Headphone, Bluetooth, and interruption recovery still need a complete device matrix. The iOS controller path is present, but physical controller reconnect, rumble, and motion testing is also incomplete.

Get started

You need:

  • a Mac with Xcode and its command-line tools;
  • Homebrew;
  • an Apple ID configured in Xcode for physical-device signing; and
  • your own legally acquired, supported Ocarina of Time ROM.

Install the build dependencies:

brew install cmake ninja pkgconf sdl2 glew nlohmann-json libpng libzip \
  tinyxml2 libogg libvorbis opus opu

Description

Ocarina of Time native on iOS and iPadOS via Ship of Harkinian with Metal rendering, touch controls, controller support, and ROM-free reproducible builds.

Related repositories

Similar projects matched by category, topics, and programming language.

makecindy
Featured
makecindy GitHub avatar

cindy

Cindy is an open-source AI agent that runs locally on your machine, integrates multiple AI harnesses and models, and provides memory, skills, and automation to perform real work in your projects and apps.

AI & Machine LearningLarge Language Models
958
uzairansaruzi
Featured
uzairansaruzi GitHub avatar

hermex

Hermex is a native SwiftUI iPhone app that lets you control a self-hosted Hermes AI agent directly from your phone, with no subscriptions, tracking, or third-party relay.

AI & Machine LearningLarge Language Models
941
nsdkinx
Featured
nsdkinx GitHub avatar

twell

Twell is a tiny, embeddable, zero-allocation physics engine for interruptible, Apple-style UI animations, available as a single-header C library with Python bindings.

MobileDesign & Creative
17