forked from MeloNX/MeloNX
Update Read-me
This commit is contained in:
Stossy11
parent
b5b4a71b13
commit
14de6a018f
106
README.md
106
README.md
@ -12,22 +12,27 @@
|
|||||||
|
|
||||||
<p align="center">
|
<p align="center">
|
||||||
MeloNX is an iOS Nintendo Switch emulator based on Ryujinx, written primarily in C#. Designed to bring accurate performance and a user-friendly interface to iOS, MeloNX makes Switch games accessible on Apple devices.
|
MeloNX is an iOS Nintendo Switch emulator based on Ryujinx, written primarily in C#. Designed to bring accurate performance and a user-friendly interface to iOS, MeloNX makes Switch games accessible on Apple devices.
|
||||||
Developed from the ground up, MeloNX is open-source and available on Github under the <a href="https://github.com/MeloNX-Emu/MeloNX/blob/master/LICENSE.txt" target="_blank">MeloNX license (Based on MIT)</a>. <br
|
Developed from the ground up, MeloNX is open-source and available on Github under the <a href="https://github.com/MeloNX-Emu/MeloNX/blob/master/LICENSE.txt" target="_blank">MeloNX license</a>. <br
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
# Compatibility
|
# Compatibility
|
||||||
|
|
||||||
MeloNX works on iPhone XS/XR and later and iPad 8th Gen and later. Check out the Compatibility on the <a href="https://melonx.org/compatibility/" target="_blank">website</a>.
|
MeloNX works on iPhone 11 (XS/XR may work but can have issues) and later and iPad 8th Gen and later. Check out the Compatibility on the <a href="https://melonx.org/compatibility/" target="_blank">website</a>.
|
||||||
|
|
||||||
|
|
||||||
# Usage
|
# Usage
|
||||||
|
|
||||||
|
## Paid Certificates are **NOT** supported and we will not give any help when using them.
|
||||||
|
|
||||||
## FAQ
|
## FAQ
|
||||||
- MeloNX is made for iOS 17+, on iOS 15 - 16 MeloNX can be installed but may have issues or not work at all.
|
|
||||||
- MeloNX cannot be Sideloaded normally and requires the use of the following Installation Guide(s).
|
- MeloNX cannot be Sideloaded normally and requires the use of the following Installation Guide(s).
|
||||||
|
- [SideStore](https://sidestore.io/) is recommended for Sideloading MeloNX
|
||||||
|
- Apple ID with free developer account
|
||||||
- MeloNX requires JIT
|
- MeloNX requires JIT
|
||||||
- Recommended Device: iPhone 15 Pro or newer.
|
- Recommended Device: iPhone 15 Pro or newer.
|
||||||
- Low-End Recommended Device: iPhone 13 Pro.
|
- Low-End Recommended Device: iPhone 13 Pro.
|
||||||
|
|
||||||
|
|
||||||
## Discord Server
|
## Discord Server
|
||||||
|
|
||||||
We have a discord server!
|
We have a discord server!
|
||||||
@ -37,81 +42,82 @@ We have a discord server!
|
|||||||
|
|
||||||
### Paid Developer Account
|
### Paid Developer Account
|
||||||
|
|
||||||
1. **Sideload the App**
|
#### 1. Sideload MeloNX
|
||||||
- Use any sideloading tool that supports Apple IDs.
|
Download and install MeloNX using your preferred Apple ID sideloader:
|
||||||
|
- [Download MeloNX from Releases](https://git.743378673.xyz/MeloNX/MeloNX/releases)
|
||||||
|
|
||||||
2. **Enable Entitlements**
|
#### 2. Enable Memory Entitlement
|
||||||
- Visit [Apple Developer Identifiers](https://developer.apple.com/account/resources/identifiers).
|
- Visit [Apple Developer Identifiers](https://developer.apple.com/account/resources/identifiers).
|
||||||
- Locate **MeloNX** and enable the following entitlements:
|
- Locate **MeloNX** and enable the following entitlements:
|
||||||
- `Increased Memory Limit`
|
- `Increased Memory Limit`
|
||||||
- `Increased Debugging Memory Limit`
|
- `Increased Debugging Memory Limit`
|
||||||
|
|
||||||
3. **Reinstall the App**
|
#### 3. Reinstall MeloNX
|
||||||
- Delete the existing installation.
|
- Delete existing MeloNX installation
|
||||||
- Sideload the app again with the updated entitlements.
|
- Sideload MeloNX again
|
||||||
|
- Verify **Increased Memory Limit** is enabled in app
|
||||||
|
|
||||||
4. **Enable JIT**
|
#### 4. Setup Files
|
||||||
- Use your preferred method to enable Just-In-Time (JIT) compilation.
|
- Add Encryption Keys and Firmware using the file picker inside MeloNX
|
||||||
- We reccomend using [StikDebug](https://apps.apple.com/us/app/stikdebug/id6744045754)
|
- If having Issues installing firmware:
|
||||||
|
- You can Install firmware and keys from **Ryujinx Desktop** (or forks).
|
||||||
5. **Add Necessary Files**
|
|
||||||
|
|
||||||
If having Issues installing firmware (Make sure your Keys are installed first)
|
|
||||||
- If needed, install firmware and keys from **Ryujinx Desktop** (or forks).
|
|
||||||
- Copy the **bis** and **system** folders
|
- Copy the **bis** and **system** folders
|
||||||
|
|
||||||
### Free Developer Account (Experimental)
|
#### 5. Enable JIT
|
||||||
|
- Enable JIT using your preferred method. We recommend [StikDebug](https://apps.apple.com/us/app/stikdebug/id6744045754).
|
||||||
|
|
||||||
1. **Sideload MeloNX**
|
|
||||||
- Use [SideStore](https://sidestore.io/) or [AltStore](https://altstore.io/) (**NOT** AltStore PAL).
|
|
||||||
|
|
||||||
2. **Sideload the Entitlement App**
|
|
||||||
- Install [this app](https://github.com/hugeBlack/GetMoreRam/releases/download/nightly/Entitlement.ipa) using [SideStore](https://sidestore.io/) or [AltStore](https://altstore.io/) (**NOT** AltStore PAL).
|
|
||||||
|
|
||||||
3. **Sign In to Your Account**
|
### Free Developer Account
|
||||||
- Open **Settings** in the entitlement app and sign in with your Apple ID.
|
|
||||||
|
|
||||||
4. **Refresh App IDs**
|
***The Entitlement App is **NOT** needed for AltStore Classic***
|
||||||
- Navigate to the **App IDs** page.
|
- You may skip Step 2 and Step 3
|
||||||
- Tap **Refresh** to update the list.
|
|
||||||
|
|
||||||
5. **Enable Increased Memory Limit**
|
#### 1. Sideload Applications
|
||||||
- Select **MeloNX** (should be like "com.stossy11.MeloNX" or some variation) from the list.
|
Download and install both apps using your preferred sideloader:
|
||||||
- Tap **Add Increased Memory Limit**.
|
- **MeloNX**: [Download from Releases](https://git.743378673.xyz/MeloNX/MeloNX/releases)
|
||||||
|
- **Entitlement App**: [Download IPA](https://github.com/hugeBlack/GetMoreRam/releases/download/nightly/Entitlement.ipa)
|
||||||
|
|
||||||
6. **Reinstall MeloNX**
|
#### 2. Enable Memory Entitlement
|
||||||
- Delete the existing installation.
|
- Open the **Entitlement app** > **Settings**
|
||||||
- Sideload the app again using SideStore or AltStore.
|
- Sign in with your Apple ID
|
||||||
|
- Go to **App IDs** > tap **Refresh**
|
||||||
|
- Select **MeloNX** (e.g., "com.stossy11.MeloNX.XXXXXX")
|
||||||
|
- Tap **Add Increased Memory Limit**
|
||||||
|
|
||||||
7. **Verify Increased Memory Limit**
|
#### 3. Reinstall MeloNX
|
||||||
- Open MeloNX and check if the **Increased Memory Limit** is enabled.
|
- Delete existing MeloNX installation
|
||||||
|
- Sideload MeloNX again
|
||||||
|
- Verify **Increased Memory Limit** is enabled in app
|
||||||
|
|
||||||
8. **Add Necessary Files**
|
#### 4. Setup Files
|
||||||
|
- Add Encryption Keys and Firmware using the file picker inside MeloNX
|
||||||
If having Issues installing firmware (Make sure your keys are installed first)
|
- If having Issues installing firmware:
|
||||||
- If needed, install firmware and keys from **Ryujinx Desktop** (or forks).
|
- You can Install firmware and keys from **Ryujinx Desktop** (or forks).
|
||||||
- Copy the **bis** and **system** folders
|
- Copy the **bis** and **system** folders
|
||||||
|
|
||||||
9. **Enable JIT**
|
#### 5. Enable JIT
|
||||||
- Use your preferred method to enable Just-In-Time (JIT) compilation.
|
- Enable JIT using your preferred method. We recommend [StikDebug](https://apps.apple.com/us/app/stikdebug/id6744045754).
|
||||||
- We recommend using [StikDebug](https://apps.apple.com/us/app/stikdebug/id6744045754)
|
|
||||||
|
|
||||||
|
|
||||||
### TrollStore
|
### TrollStore
|
||||||
As Said in FAQ:
|
As Said in FAQ:
|
||||||
> MeloNX is made for iOS 17+, on iOS 15 - 16 MeloNX can be installed but may have issues or not work at all.
|
> MeloNX is made for iOS 17+, on iOS 15 - 16 MeloNX can be installed but may have issues or not work at all.
|
||||||
|
|
||||||
1. **Install MeloNX with TrollStore**
|
#### 1. Install MeloNX
|
||||||
|
- Use TrollStore to install MeloNX.
|
||||||
|
|
||||||
2. **Add Necessary Files**
|
#### 2. Setup Files
|
||||||
|
- Add Encryption Keys and Firmware using the file picker inside MeloNX
|
||||||
|
- If having Issues installing firmware:
|
||||||
|
- You can Install firmware and keys from **Ryujinx Desktop** (or forks).
|
||||||
|
- Copy the **bis** and **system** folders
|
||||||
|
|
||||||
3. **Enable TrollStore JIT**
|
|
||||||
- MeloNX includes automatic JIT using the TrollStore URL Scheme
|
#### 2. Enable TrollStore JIT
|
||||||
- Open MeloNX Settings
|
- Open **Settings** inside **MeloNX**
|
||||||
- Scroll down and enable the "TrollStore JIT" toggle
|
- Under **Misc**, scroll down and enable the **"TrollStore" toggle**
|
||||||
- Profit
|
- Profit
|
||||||
|
|
||||||
|
|
||||||
### Free Developer Account (Xcode)
|
### Free Developer Account (Xcode)
|
||||||
|
|
||||||
**NOTE: These Xcode builds are nightly and may have unfinished features.**
|
**NOTE: These Xcode builds are nightly and may have unfinished features.**
|
||||||
|
|||||||
Loading…
x
Reference in New Issue
Block a user