RomM iOS App

A native iOS companion app for RomM. Connect to your self-hosted RomM server to browse, play, and manage your retro game ROM collection directly from your iPhone or iPad.

Compatible with RomM 5.0.*

Join the beta program and help improve the app:

Join TestFlight Beta

• 🎮 Play ROMs directly on your iPhone or iPad
• 🕹️ Native Delta emulator cores for GBA, GBC, GB, NES, SNES, N64, and NDS
• 🖥️ Libretro-based emulation for Sega Genesis/Mega Drive, Master System, Game Gear, Saturn, Dreamcast, PlayStation, PSP, and Arcade
• ☁️ Cloud save sync — upload and download save states and save files to/from your RomM server
• 🎛️ Physical controller support

• 📱 Native SwiftUI design with dark mode support
• 🖼️ Game covers, screenshots, and full metadata from your RomM server
• 📊 Card and list view layouts
• 🔍 Search across your entire ROM library
• 📚 Browse by platform with ROM counts and platform logos
• 📁 Organize games in custom collections
• 📈 Server statistics and platform insights
• ⚙️ QR code scanner for quick server setup

• 💾 Download ROMs for offline play
• 🔄 Transfer ROMs to remote devices via SFTP
• 🗂️ BIOS file management for emulator cores

• 📲 iPhone and iPad support

This repository uses git submodules for the emulator cores in Vendor/. Clone with submodules:

git clone --recurse-submodules https://github.com/ilyas-hallak/romm-ios-app.git

If you already cloned without submodules:

git submodule update --init --recursive

Then open romm/romm.xcodeproj in Xcode and build.

Standing on the shoulders of giants.

This app would not be possible without the outstanding open-source emulation work of:

• Delta / DeltaCore by Riley Testut — the emulation framework powering GB, GBC, GBA, NES, SNES, N64, and NDS
• PCSX ReARMed via Libretro — PlayStation emulation on ARM

1. Follow the established Clean Architecture patterns (Domain / Data / UI layers)
2. Maintain one ViewModel per View — no sharing between views
3. Use Cases must not call other Use Cases — compose at the ViewModel level
4. Use the existing dependency injection system
5. Follow SwiftUI best practices
6. All user-facing strings must be in English

MIT — see LICENSE for details. This project is part of the RomM ecosystem.