Skip to content

make installing guide simpler v2 #34

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 10 commits into
base: main
Choose a base branch
from
Open

make installing guide simpler v2 #34

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
10 commits
Select commit Hold shift + click to select a range
465beee
upload the new install guides
slideglide May 3, 2025
be08de6
replace install.md with this
slideglide May 3, 2025
b71905a
add ios 17 requirement
slideglide May 3, 2025
37b3847
fix grammar
slideglide May 3, 2025
75e6ae5
add jailbreak tweak notice
slideglide May 3, 2025
e431377
add esign notice
slideglide May 3, 2025
4e4ffd4
Update INSTALL.md
slideglide May 14, 2025
8a07088
fix dev mode and sidestore sorting
slideglide May 15, 2025
3f035d3
Update INSTALL.md
slideglide May 15, 2025
571e0d2
add trollstore lite
slideglide May 15, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
89 changes: 10 additions & 79 deletions INSTALL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,89 +1,20 @@
# Installation Guide
> [!WARNING]
> For this installation guide, it is **required** to have a computer with Administrator access, as this guide will require installing software on your computer to sideload Geode, and to obtain a pairing file for **JIT**. Additionally, **JIT** is a **__requirement__** if you want to run Geode without jailbreaking.
# Getting Started on Installing Geode
Hello! This page **will help you install Geode on your iDevice**. This page exists because unfortunately, it's more difficult to install Geode on iOS compared to other platforms due to the limitations of Apple.

> [!WARNING]
> Do **not** use enterprise certificates in sideloaders **like ESign and Scarlet.** Those certificates **do not have the entitlements for enabling JIT** (`get-task-allow`). You **won't be able to enable JIT** if you use them. If you want to use ESign, buy a developer certificate.

## Prerequisites
- iOS/iPadOS 14.0 or later
- PC (Windows, Linux) or Mac OS
- Apple ID (Secondary / Throwaway Recommended)
- USB Cable to connect your device (Lightning / USB C)
- An internet connection
- Full version of Geometry Dash from the [App Store](https://apps.apple.com/us/app/geometry-dash/id625334537)
- IPA / TIPA file of Geode launcher from [Releases](https://github.com/geode-sdk/ios-launcher/releases) (only get the TIPA file if you want to use the jailbreak tweak)

## Installing SideStore
> [!TIP]
> After installing **SideStore**, a PC is **not required** after the initial install.
> You can skip this step if you are using Sideloadly or TrollStore, but you may still need to follow the first step, especially if you have never sideloaded an app before.

1. **Enabling Developer Mode (iOS 16+)**
- If you are on iOS 16 or later, you will need to enable **Developer Mode** in order to launch third party apps like SideStore, otherwise you will encounter this error when attempting to sideload SideStore or any app:
- ![](screenshots/install-1.png)
- To enable **Developer Mode** on your iOS device, navigate to `Settings -> Privacy & Security -> Developer Mode`. Do note that this will require restarting your device.
- ![](https://faq.altstore.io/~gitbook/image?url=https%3A%2F%2F2606795771-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FAfe8qEztjcTjsjjaMBY2%252Fuploads%252FWSvXhUTj8UZyGd1ex652%252FFcejvMRXgAE8k3R.jpg%3Falt%3Dmedia%26token%3D5e380cd0-be4e-406a-914b-8fa0519e1196&width=768&dpr=2&quality=100&sign=8860eb96&sv=2)
- After your device restarts, you will be prompted to "Turn on Developer Mode", press "Turn On", and **Developer Mode** should be enabled!

2. **Installing SideStore** (Recommended)
- Follow the steps provided here: https://sidestore.io/#get-started
- SideStore is recommended if you do not want to refresh your apps while keeping your PC on.

Now you can proceed with installing Geode! If you are not jailbroken, **install the IPA**. If you're jailbroken and plan to stay so, **install the TIPA** version.

## Installing Geode through SideStore
> [!NOTE]
> You will need to **refresh** both the store and Geode every week, otherwise you will not be able to run the app.

Navigate to the **My Apps** tab, and tap the `+` button to add an app. Select the IPA for the Geode app, and the Geode app should appear on your home screen!
> Geode **only works from iOS 14 to the latest iOS version**. Geode will not work on iOS versions below 14.

![](screenshots/install-altstore.png)

## Installing Geode through TrollStore
Tap the `+` button and tap either **Install IPA File** or **Install From URL**, depending if you manually downloaded the TIPA file. After either selecting the TIPA file for the Geode app, or providing the URL, the Geode app should appear on your home screen!

![](screenshots/install-trollstore.png)

## Post Installation (IPA / Non-Jailbroken)
> [!TIP]
> You can skip this step if you installed the .tipa version of Geode, and are jailbroken. Simply follow the steps in the setup process in the app.

After going through the setup process, you may have seen the warning that **Just-In-Time** (JIT) compilation is required. This is true if you want to run Geode without being jailbroken, as by default, Apple restricts how apps can manage memory.
> If you **don't know which iOS version you're on**, follow [this page from Apple](https://support.apple.com/en-us/109065) to check your iOS version.

> [!WARNING]
> JIT also requires you to have **Wi-Fi** connection or **Airplane Mode** enabled on your iOS device if you're not jailbroken or don't have Trollstore.

There are a few ways to launch Geode with JIT, depending on both iOS version, and your use case.
> TrollStore and the jailbreak method will only work on versions listed [here](https://ios.cfw.guide/installing-trollstore/), and SideStore method will work on iOS 17.4 and above.

### For iOS 16.7 RC, iOS 17.0 and Below
> Install **TrollStore** using this guide: https://ios.cfw.guide/installing-trollstore

#### TrollStore
1. Enable the **URL Scheme** setting in TrollStore.
2. Go back to Geode and tap the **Launch** button in the Geode app.
3. Geode should launch in Geometry Dash!

### For iOS 17.4+ and Later
#### StikDebug
> [!NOTE]
> For the first time setup, you will need a computer to get a Pairing File. If you installed SideStore, you likely already have a pairing profile, meaning there is no need to reinstall Jitterbug Pair.
> [!WARNING]
> Installing TrollStore on iOS 17.0 or installing SideStore **will require the usage of a computer**.

#### Steps for downloading Jitterbug Pair (Skippable if you already have a Pairing File)
1. Go to [Jitterbug Pair](https://github.com/osy/Jitterbug/releases) and download the version for your computer.
2. Run the program with your iOS device connected to your computer. It will save a file to your computer.
3. Use iCloud, Airdrop, or a website such as [Pairdrop](https://pairdrop.net/) to upload the pairing file to your iOS device.
To get started, choose an installation guide for your iOS version.

#### Downloading StikDebug
1. Download StikDebug from the App Store: https://apps.apple.com/us/app/stikdebug/id6744045754
2. Launch the app
3. It'll ask you to add "StikDebug" as a VPN Configuration. Click "Allow" and enter your passcode to add it.
4. Go back to StikDebug and click on "Select Pairing File". You actually will need **WiFi connection** on your phone for it to download DDI.
5. After DDI is mounted you won't need WiFi. Now you can go back to Geode and click on **Launch**.
6. Geode will now launch in Geometry Dash.
![](screenshots/stikdebug.png)
> [!TIP]
> StikDebug works without Wi-Fi connection, just by Airplane Mode. Unfortunately, this on-device VPN does not support cellular. However, you can use cellular data after launching an app with JIT.
[TrollStore (and optionally jailbreak)](/OLD-IOS-INSTALL.md)

## Conclusion
You should now be able to run Geometry Dash with Geode! You can install mods by tapping the **Geode** button on the bottom of the menu, and browse for mods to install!
[SideStore](/MODERN-IOS-INSTALL.md)
65 changes: 65 additions & 0 deletions MODERN-IOS-INSTALL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,65 @@
# Installation Guide (iOS 17.4-18)

> [!WARNING]
> For this installation guide, it is **required** to have a computer with Administrator access, as this guide will require installing software on your computer to sideload Geode, and to obtain a pairing file for **JIT**. Additionally, **JIT** is a **__requirement__** to run Geode.

> [!WARNING]
> Don't use enterprise certificates to install Geode, as you won't be successful. This is because enterprise certificates **cannot** enable JIT, and Geode **requires** JIT to work. (This also means sideloaders like ESign with enterprise certificates **will not** work.)

## Prerequisites
- PC (Windows, Linux) or Mac OS
- Apple ID (Secondary / Throwaway Recommended)
- USB Cable to connect your device (Lightning / USB C)
- Full version of Geometry Dash installed
- An internet connection
- A passcode on your device
- IPA file of Geode launcher from [Releases](https://github.com/geode-sdk/ios-launcher/releases)

## Install SideStore

1. **Installing SideStore**
- Follow the steps provided here: https://sidestore.io/#get-started

2. **Enabling Developer Mode**
- You will need to enable **Developer Mode** in order to launch third party apps like SideStore, otherwise you will encounter this error when attempting to sideload SideStore or any app:
- ![](screenshots/install-1.png)
- To enable **Developer Mode** on your iOS device, navigate to `Settings -> Privacy & Security -> Developer Mode`. Do note that this will require restarting your device.
- ![](https://faq.altstore.io/~gitbook/image?url=https%3A%2F%2F2606795771-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FAfe8qEztjcTjsjjaMBY2%252Fuploads%252FWSvXhUTj8UZyGd1ex652%252FFcejvMRXgAE8k3R.jpg%3Falt%3Dmedia%26token%3D5e380cd0-be4e-406a-914b-8fa0519e1196&width=768&dpr=2&quality=100&sign=8860eb96&sv=2)
- After your device restarts, you will be prompted to "Turn on Developer Mode", press "Turn On", and **Developer Mode** should be enabled!

## Installing Geode through SideStore
> [!NOTE]
> You will need to **refresh** both the store and Geode every week, otherwise you will not be able to run the app.

Navigate to the **My Apps** tab, and tap the `+` button to add an app. Select the IPA for the Geode app, and the Geode app should appear on your home screen!

![](screenshots/install-altstore.png)

## Post Installation
After going through the setup process, you may have seen the warning that **Just-In-Time** (JIT) compilation is required. This is true if you want to run Geode since Apple restricts how apps can manage memory.

> [!WARNING]
> JIT also requires you to have **Wi-Fi** connection or **Airplane Mode** enabled on your iOS device. Cellular will **not work**.

## Installing and Using StikDebug to enable JIT
> [!NOTE]
> For the first time setup, you will need a computer to get a Pairing File. If you installed SideStore, you likely already have a pairing profile, meaning there is no need to reinstall Jitterbug Pair.

#### Steps for downloading Jitterbug Pair (Skippable if you already have a Pairing File)
1. Go to [Jitterbug Pair](https://github.com/osy/Jitterbug/releases) and download the version for your computer.
2. Run the program with your iOS device connected to your computer. It will save a file to your computer.
3. Use iCloud, AirDrop, [LocalSend](https://localsend.org), or a website such as [Pairdrop](https://pairdrop.net/) to upload the pairing file to your iOS device.

#### Downloading StikDebug
1. Download StikDebug from the App Store: https://apps.apple.com/us/app/stikdebug/id6744045754
2. Launch the app
3. It'll ask you to add "StikDebug" as a VPN Configuration. Click "Allow" and enter your passcode to add it.
4. Go back to StikDebug and click on "Select Pairing File". You actually will need **WiFi connection** on your phone for it to download DDI.
5. After DDI is mounted you won't need WiFi. Now you can go back to Geode and click on **Launch**.
6. Geode will now launch in Geometry Dash.
![](screenshots/stikdebug.png)
> [!TIP]
> StikDebug works without Wi-Fi connection, just by Airplane Mode. Unfortunately, this on-device VPN does not support cellular. However, you can use cellular data after launching an app with JIT.

## Conclusion
You should now be able to run Geometry Dash with Geode! You can install mods by tapping the **Geode** button on the bottom of the menu, and browse for mods to install!
40 changes: 40 additions & 0 deletions OLD-IOS-INSTALL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,40 @@
# Installation Guide (iOS 15-16.6.1, 16.7 RC and iOS 17.0)

This guide is for devices that are compatible with TrollStore (and optionally a jailbreak)

## Prerequisites
- PC (Windows, Linux) or Mac OS (only for iOS 17.0)
- USB Cable to connect your device (Lightning / USB C) (only for iOS 17.0)
- TrollStore (or **if you're on an iOS version where TrollStore is not supported** but you're able to jailbreak, **[TrollStore Lite](https://havoc.app/package/trollstorelite))**
- A jailbreak like Dopamine (optional, only if you want to use the jailbreak tweak)
- Full version of Geometry Dash installed
- IPA / TIPA file of Geode launcher from [Releases](https://github.com/geode-sdk/ios-launcher/releases) (only get the TIPA file if you want to use the jailbreak tweak)
- Jailbreak tweak (optional, you need to be jailbroken)

## Installing TrollStore
Check the table from https://ios.cfw.guide/installing-trollstore/ to install TrollStore depending on your iOS version and your device's chipset (you can find it by searching "iPhone/iPad (your phone/tablet's model) chipset")

## Installing Geode through TrollStore
Tap the `+` button and tap either **Install IPA File** or **Install From URL**, depending if you manually downloaded the IPA or the TIPA file. After either selecting the IPA or the TIPA file for the Geode app, or providing the URL, the Geode app should appear on your home screen!

![](screenshots/install-trollstore.png)

## Installing the Jailbreak Tweak (optional)

> [!WARNING]
> Only follow this if you're jailbroken and have the TIPA version installed!

> [!WARNING]
> If you follow this and your jailbreak goes away (whether from a reboot, battery dying and etc.), Geode will not work. You will have to re-jailbreak your device for Geode to work again.

> [!TIP]
> Once you install the jailbreak tweak, you can launch the game without going to the Geode launcher. However you should keep the launcher if you want to restart the game, enter safe mode and update Geode!

When you **install the TIPA version**, Geode **will ask you to add the repository for the jailbreak tweak**. Choose the package manager you use and add the repository.

Then **go to the Geode repository and install the Geode Inject tweak**. After you install the tweak, **restart SpringBoard**.

Then **go to the Geode launcher, download Geode** and simply launch the game!

## Conclusion
You should now be able to run Geometry Dash with Geode! You can install mods by tapping the **Geode** button on the bottom of the menu, and browse for mods to install!