Sideloading .ipa Files with Xcode

Prerequisites

• Mac with Xcode installed
• iOS device with a Lightning/USB-C cable
• Apple ID (free Apple Developer account)

Step-by-Step Instructions

1. Download the .ipa File

• Download the .ipa file from the releases section
• Save it to a location you can easily find (like Downloads folder)

2. Connect Your Device

• Connect your iOS device to your Mac via cable
• If prompted, trust the computer on your device

3. Open Xcode Device Manager

• Open Xcode
• Go to Window → Devices and Simulators (or press Cmd+Shift+2)
• Select your device from the left sidebar

4. Install the App

• In the Installed Apps section, click the + button
• Navigate to and select your downloaded .ipa file
• Click Open
• Wait for the installation to complete

5. Trust the Developer Certificate

• On your iOS device, go to Settings → General → VPN & Device Management
• Find your Apple ID under "Developer App"
• Tap on it and select Trust
• Confirm by tapping Trust again

6. Enable Developer Mode (iOS 16+ only)

• Go to Settings → Privacy & Security → Developer Mode
• Toggle Developer Mode on
• Restart your device when prompted
• After restart, confirm you want to turn on Developer Mode

**7. Add Quake 3 Game Files

• Use Files app or macOS Finder to copy baseq3 folder or other mods

Important Notes

• Apps signed with free Apple Developer accounts expire after 7 days
• You'll need to re-install the app when it expires
• Paid Apple Developer accounts have 1-year signing
• Checkout example configuration files and potential iOS Shortcuts and customize to your liking

Troubleshooting

• "Untrusted Developer": Make sure you completed step 5
• "Unable to install": Check that your device iOS version is supported
• App crashes: Enable Developer Mode (step 6) if on iOS 16+

That's it! The app should now be installed and ready to use on your device.