Madeira runs Windows PC games on an iPhone, with no jailbreak. Games run as they are, unmodified, inside a single iOS app.

[!NOTE] Madeira is an active research project. Many games start and some play well, but performance and compatibility vary from game to game, and things change quickly. Expect rough edges.

How it works

iOS apps cannot start other programs, so everything runs in one process: even Wine's server runs as a thread instead of a separate program.

Features

• Game library with artwork, search and a Windows desktop session.
• Steam: sign in, browse the games you own, install and update them, and start them through Valve's own Windows Steam client (Madeira Dock).
• Steam Cloud saves: saves sync with Steam Cloud when Madeira starts and before a game starts, and Upload saves and close Madeira in the game menu sends them when you stop playing. Saves that changed on both sides are never overwritten without asking, and anything a sync replaces is backed up.
• Controllers: Bluetooth controllers through XInput, plus customisable on-screen touch controls.
• Keyboard, mouse and trackpad passed through to games as real input.
• Video and audio for cutscenes and music, through FFmpeg, VideoToolbox and AudioToolbox.

Requirements

• An iPhone on iOS 26 or later, the only version Madeira currently runs on reliably. Development happens on recent Pro iPhones.
• JIT, which iOS only allows while a debugger is attached. Madeira can use StikDebug or its built-in StikJIT helper. On iOS 27 the built-in helper can pair the iPhone itself, without a computer.
• An Apple ID to sideload the app. A free account works; its signing expires after 7 days, so the app needs refreshing weekly. Madeira refreshes itself: installed with SideInstaller it needs nothing more, otherwise sign in under Settings → Signing. Your games and saves are kept across reinstalls.

Because JIT needs a debugger, Madeira cannot be offered on the App Store.

Installing

1. Download the IPA from the latest release.
2. Sideload it with your own Apple ID using SideStore, AltStore, Sideloadly, Plume or a similar tool.
3. Open Madeira and enable JIT. Automatic mode uses StikDebug when installed, otherwise it guides you through the built-in setup; see JIT setup.
4. In Settings, check that JIT and Memory+ both show a green check: Madeira then says Ready to play.

Some 64-bit games need Microsoft's Visual C++ runtime, which is not included (see Licensing).

Building from source

git clone --recurse-submodules https://github.com/willfaust/Madeira.git

FEX, wine, dxmt and madeira-dock are submodules that point at Madeira's own forks; upstream checkouts will not build here. The build has several parts (the Wine unix libraries, the ARM64EC Windows modules, FEX, DXMT and the app) and some inputs that are not in the repository, such as the toolchains. docs/BUILDING.md walks through all of it. git clone --recurse-submodules cd Madeira ./tools/build-ipa.sh # produces dist/Madeira.ipa ```

See BUILDING.md for prerequisites, timing, and re-run notes.

Note that FEX, wine and research/dxmt are submodules pointing at forks containing the iOS work; upstream clones will not build here.

Repository layout

Documentation

Licensing

Madeira is licensed under GPL-3.0-or-later (LICENSE) with the Madeira Converter Exception (LICENSE-EXCEPTION.md), an additional permission that allows it to work with Apple's Metal Shader Converter.

The projects it builds on keep their own licenses upstream, but Madeira's forks are not all licensed the same way as their upstreams:

Anything obtained earlier under a permissive license stays available under it. Per-component details, including GnuTLS, Nettle, GMP, FFmpeg and LLVM, are in THIRD-PARTY-NOTICES.md; the license texts are in LICENSES/.

Microsoft's Visual C++ runtime DLLs are not distributed with Madeira. To build with them, supply them yourself as described in tools/fetch-vcruntime.md.

Contributing

Contributions are welcome under GPL-3.0-or-later; see CONTRIBUTING.md.

Madeira's forks contain a lot of AI-assisted work. FEX-Emu does not accept AI-generated code, so please do not send changes from these forks upstream to FEX-Emu, and check each upstream project's contribution policy before proposing anything to it.

Credits

• Will Faust (@willfaust): created Madeira
• Nick (@125hz): 32-bit game support, the game library and Madeira Dock
• Jfishin (@Jfishin): the original native Steam sign-in, library and downloads
• Jesse (@JesseLovelace): Steam Cloud saves, faster game launches, and fixes that let more games run
• Dan Perks (@danperks): in-app JIT without StikDebug, and pairing without a computer
• bahacan16 (@bahacan16): Direct3D 12 and DXMT fixes, game launcher windows, per-game settings, PlayStation controllers, and save backups
• spitefulowl (@spitefulowl): Wine and FEX runtime fixes, DXMT texture and memory fixes, audio, the swap tier, and library launch options
• meshoklv (@meshoklv): controller fixes for games that ship their own XInput or need focus, touch taps that stay off the mouse, and a crash-guard fix
• TheHadesc (@TheHadesc): Madeira Dock starts for games whose Steam launch entries do not start at zero, and a touch gamepad that survives the in-game keyboard

Madeira is built on Wine, FEX-Emu, DXMT by Feifan He (3Shain) with the Direct3D 9 frontend by David Acevedo (dacevedo12), rpmalloc by Mattias Jansson, StikDebug, StikJIT and idevice for enabling JIT. Thank you to everyone who contributes to them.

Join the community on Discord