GRepoWatch
Daily at 07:00 UTC+8Subscribe中文
← Back to today’s ranking

willfaust /

Madeira

Run x86-64 Windows PC games on jailed iOS via FEX-Emu + Wine + DXMT

Visit GitHub repository ↗
Last recorded · 2026-09-30#12

Rank in that snapshot

+85Daily Stars1,081Total Stars

Project overview

Run x86-64 Windows PC games on jailed iOS via FEX-Emu + Wine + DXMT

Recorded Trending signals

willfaust/Madeira was recorded 2 times between 2026-09-28 and 2026-09-30. Its best recorded rank is #9. The latest saved snapshot reports 85 daily Stars and 1,081 total Stars. These are archive observations, not quality ratings or continuous activity measurements.

Official project documentation

The following is an excerpt from the project’s official README, fetched from GitHub. It may change independently of this archive. RepoWatch has not installed or functionally tested this project.

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

LayerWhat it does
FEX-EmuTranslates the game's x86 and x86-64 code to ARM64 as it runs.
Wine 11.4Provides Windows. It is built for ARM64EC, so Wine itself runs natively and only the game's own code is translated. 32-bit games run through WoW64.
DXMTDraws Direct3D 9, 10 and 11 with Metal.
madeira-d3d12Madeira's own Direct3D 12 implementation on Metal, converting DXIL shaders at run time with Apple's Metal Shader Converter.

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.
  • Japanese locale per game, for Japanese games and visual novels whose text shows as squares or gibberish or that do not start: Shift-JIS (code page 932) and a bundled Japanese font (details).

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 with the installer that signed it. Madeira's own refresh is off by default (details). 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.
  5. Add a game. Steam games come from Sign in to Steam in the library. For a Windows game you already have, copy its whole folder into Madeira › wine › drive_c with the Files app, then tap + in the library and choose its .exe, .bat or .cmd; see Adding games.

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

PathContents
app/The iOS app: SwiftUI front end, Wine bridge and bundled resources
wine/, FEX/, dxmt/, madeira-dock/Madeira's forks and the Steam client launcher (submodules)
madeira-d3d12/The native Direct3D 12 runtime
build/Build scripts and iOS-side sources, one folder per component
tests/Host checks and x86, x86-64 and DXMT test programs
tools/Helper scripts
docs/Documentation
research/Experiments that are not part of the app

Documentation

TopicDocument
Building from a clean checkoutdocs/BUILDING.md
StikDebug and built-in JIT setupdocs/JIT.md
The game librarydocs/LIBRARY.md
Steam sign-in, library and downloadsdocs/STEAM_SIGNIN.md, docs/STEAM_LIBRARY.md
Steam Cloud savesdocs/STEAM_CLOUD.md
Madeira Dock (the Steam client)docs/MADEIRA_DOCK.md
32-bit games (WoW64)docs/WOW64.md
Controllers and touch controlsdocs/CONTROLLERS.md
Keyboard, mouse and trackpaddocs/KEYBOARD_MOUSE.md
Audio and videodocs/MEDIA.md
Licensing in detaildocs/LICENSING.md

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:

ComponentLicense
Wine forkLGPL-2.1-or-later, like upstream Wine
FEX-Emu fork, DXMT forkUpstream code stays MIT; Madeira's changes are GPL-3.0-or-later with the exception
rpmalloc forkUpstream code stays 0BSD; Madeira's changes are GPL-3.0-or-later with the exception
Madeira DockGPL-3.0-or-later with the exception

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
  • thebcd69 / BCD (@thebcd69, also bahacan16 above): engine memory, exception, WoW64, win32u and D3D12 fixes, the memory-host extension experiment, host tests and tested game lists, taken from his bcd-games fork and from his pull requests #337 to #346 (credited late; see THIRD-PARTY-NOTICES.md)
  • 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