Frequently Asked Questions
Common questions about the project, iOS support, JIT requirements, and memory limits.
What is Metaspero?
Metaspero is an open-source PlayStation 5 emulator for Apple Silicon, with iOS as the primary target. It is forked from KytyPS5 and uses custom FEXCore for ARM64 Darwin JIT translation and MoltenVK for Vulkan-to-Metal graphics.
Which operating system versions and Apple Silicon hardware are supported?
macOS requires an Apple Silicon Mac (M1 or newer, 16 GB RAM recommended, 8 GB for light 2D games). iOS/iPadOS requires an A-series or M-series chip with JIT enabled and 12 GB RAM recommended (8 GB for light 2D games).
Can running the emulator cause device freezes or crashes due to memory usage?
Yes. PS5 emulation is highly experimental and memory intensive. Running out of unified memory can cause severe system lag, device freezes, or immediate process kills by iOS Jetsam. For 3D titles on iOS, the increased memory limit entitlement is strictly required.
Where can I find the source code and git repositories?
The project is hosted on GitHub at https://github.com/alamshafil/metaspero. The custom ARM64 Darwin JIT submodule is hosted at https://github.com/alamshafil/fexcore-darwin, and the documentation website repository is at https://github.com/alamshafil/metaspero-site.
Why does the macOS version not use Rosetta 2?
Upstream KytyPS5 relies on Rosetta 2 by compiling an x86_64 binary. Apple is expected to remove Rosetta 2 in a future macOS release (anticipated in macOS 28). This fork shares a unified ARM64 codebase across both iOS and macOS, running natively via FEXCore dynamic binary translation and MoltenVK Metal rendering.
How does JIT activation work on iOS?
iOS requires Just-In-Time compilation to translate x86_64 code into ARM64 instructions at runtime. On iOS, JIT is attached using StikDebug with the universal.js script over LocalDevVPN.
What is the increased memory entitlement, and why is it needed?
Some smaller games run without it, but larger games require the com.apple.developer.kernel.increased-memory-limit entitlement to allocate extra RAM on iOS. If memory pressure gets too high, the app presents an in-app warning toast alerting you that iOS Jetsam may terminate the process.
Is this emulator affiliated with Sony?
No. This is an independent, non-commercial open-source research initiative and is not endorsed by, affiliated with, or associated with Sony Interactive Entertainment Inc.
Does it support controllers?
Yes. Physical DualSense, DualShock 4, and Xbox controllers are supported over Bluetooth or USB-C.
How do I submit test results?
You can use the report generator at /report to create a formatted test report for GitHub Issues or Pull Requests.