Merge pull request #115 from CelloSerenity/main

Adds iDevicePair instructions for macOS and Windows + some fixes

Author: polymo1

docs/advanced/app-sources.mdx

@@ -5,9 +5,11 @@ description: A guide on custom app sources.
 
 # Make a Source
 
-SideStore is fully compatible with AltSources. The official AltStore [source documentation](https://faq.altstore.io/developers/make-a-source) provides all the details you need to make your own AltSource. AltSources allow your audience to view, install, and update all your available apps easily across both AltStore and SideStore.
+SideStore is fully compatible with AltStore Sources (or AltSources). The official AltSource [documentation](https://faq.altstore.io/developers/make-a-source) provides all the details you need to make your own AltSource. AltSources allow your audience to view, install, and update all your available apps easily using either AltStore and SideStore.
 
-When editing your source, it is highly recommended to create and view a draft of your changes using the [AltSource Browser](https://altsource.by.lao.sb/browse) to see a visual display of your source and correct any errors before finalizing and publishing changes to your source.
+Here are some recommended third-party tools that can assist in creating viewing your AltSources:
+- You can use the community-built [AltStudio](https://altstudio.app/) (WIP) to generate you an AltSource automatically using an IPA!
+- You can use the community-built [AltSource Browser](https://altsource.by.lao.sb/browse/) to view a visual display of your updates to an AltSource draft before finalizing your changes, allowing you to correct any errors before publishing them!
 
 # Distributing your Source
 
@@ -19,4 +21,4 @@ For more info, see [URL Schema](/docs/advanced/url-schema). It is often helpful
 
 ## That's it!
 
-Here are some good existing AltSources: The [official AltStore](https://apps.altstore.io) source, the [SideStore community](https://github.com/SideStore/Community-Source) source, the [StikJIT](https://raw.githubusercontent.com/StephenDev0/StikJIT/refs/heads/main/repo.json) source, and the [DolphiniOS](https://altstore.oatmealdome.me) source.
+Here are some good existing AltSources you can copy-and-paste into SideStore: The [SideStore Community Source](https://github.com/SideStore/Community-Source), the [official AltStore Source](https://apps.altstore.io), the [StikDebug Source](https://raw.githubusercontent.com/StephenDev0/StikDebug/refs/heads/main/repo.json) source, the [LiveContainer Source](https://raw.githubusercontent.com/LiveContainer/LiveContainer/refs/heads/main/apps.json), and the [DolphiniOS Source](https://altstore.oatmealdome.me).

docs/advanced/jit.mdx

@@ -5,47 +5,48 @@ description: A tutorial on how to enable Just-in-Time (JIT) Compilation for apps
 
 :::note
 
-There are many methods to enabling JIT, such as AltJIT, SideJITServer, and more. This tutorial will cover the use of StikJIT/StikDebug, as it is the method we currently recommend. As an alternative, SideStore 0.6.2-nightly.2025.04.15 also includes updates to minimuxer, allowing built-in JIT functionality similar to StikDebug. To use this, simply ensure you are connected to StosVPN and Wi-Fi or with mobile data and Wi-Fi disabled.
+There are many methods to enabling JIT, such as AltJIT, SideJITServer, and more. This tutorial will cover the use of StikDebug (formerly StikJIT), as it is the method we currently recommend. As an alternative, SideStore 0.6.2-nightly.2025.04.15 also includes updates to minimuxer, allowing built-in JIT functionality similar to StikDebug. To use this, simply ensure you are connected to StosVPN and Wi-Fi or with mobile data and Wi-Fi disabled.
 :::
 
 ## Prerequisites
 * An iDevice on iOS/iPadOS 17.4 or above, excluding 18.4b1. If you are on 17.0-17.3, you must use an alternative such as [SideJITServer](https://github.com/nythepegasus/SideJITServer)
-* At least 1 free app slot for StikJIT
+* At least 1 free app slot (if sideloading)
 
-## StikJIT installation with SideStore
-   
-1. **Obtain StikJIT:**  
-   Add the StikJIT AltSource to SideStore [here](sidestore://source?url=https://raw.githubusercontent.com/StephenDev0/StikJIT/refs/heads/main/repo.json) (You must have SideStore installed or this link will not function).
+## StikDebug installation with Apple App Store (Doesn't require an app slot)
 
-2. **Install:**
-   Use SideStore to install StikJIT.
+1. **Install StikDebug**
+   Install StikDebug from the [Apple App Store](https://apps.apple.com/us/app/stikdebug/id6744045754). Something nice- the VPN present in StikDebug is similar to the one used in SideStore, meaning you use it to install and refresh apps as well.
 
-3. **Installation procedures:**
+2. **Installation procedures:**
    Follow the standard installation procedures in the usage guide below.
 
-## StikDebug installation with App Store (Doesn't require an app slot)
+## StikDebug installation with SideStore
+   
+1. **Obtain StiDebug:**  
+   Add the StikJIT AltSource to SideStore [here](sidestore://source?url=https://raw.githubusercontent.com/StephenDev0/StikDebug/refs/heads/main/repo.json) (You must have SideStore installed or this link will not function).
 
-1. **Install StikDebug**
-   Install StikDebug from the App Store [here](https://apps.apple.com/us/app/stikdebug/id6744045754). Something nice- the VPN present in StikDebug is similar to the one used in SideStore, meaning you use it to install and refresh apps as well.
+2. **Install:**
+   Use SideStore to install StikDebug.
 
-2. **Installation procedures:**
+3. **Installation procedures:**
    Follow the standard installation procedures in the usage guide below.
 
+
 ### Standard installation procedures:
 
 1. **Enable VPN:**  
-   Start by activating StosVPN for StikJIT or the built-in VPN in StikDebug.
+   Start by activating StosVPN (if sideloading StikDebug) or the built-in VPN in the official StikDebug.
 
 2. **Upload the Pairing File:**  
-   When prompted, import the same **unzipped pairing file** obtained via JitterbugPair you use for SideStore. For more information on obtaining this pairing file, see [here](/docs/installation/pairing-file).
+   Import the same **pairing file** you use for SideStore using iDevicePair. For more information on obtaining this pairing file, see [here](/docs/installation/pairing-file).
 
 ## To enable JIT:
 
 1. **Enable VPN:**  
-   Start by activating StosVPN for StikJIT or the built-in VPN in StikDebug.
+   Start by activating StosVPN (if sideloading) or the built-in VPN in StikDebug.
 
 2. **Activate JIT:**  
-   Click the “Enable JIT” button and select an app from the list to activate the JIT functionality.
+   Select the “Enable JIT” button and select an app from the list to attach a debugger/activate JIT functionality.
 
 ### Offline JIT Enabling
-To enable JIT offline, enable the StosVPN VPN or StikDebug. Then, turn both Wi-Fi and Mobile Data OFF when you launch StikJIT (use Airplane Mode). You can then enable JIT as normal.
+To enable JIT offline, activate StosVPN (if sideloading) or the StikDebug VPN. Then, turn both Wi-Fi and Mobile Data OFF when you launch StikDebug (use Airplane Mode). You can then enable JIT as normal.

docs/faq.mdx

@@ -18,7 +18,7 @@ SideStore is an iOS application that allows you to sideload apps onto your iOS d
 
 For users using iOS/iPadOS 16 or lower, you can activate JIT directly from the SideStore 'My Apps' page by holding down on your app and selecting 'Enable JIT'.
 
-Users on iOS or iPadOS 17.4 or higher will need to use a solution such as StikJIT/StikDebug or SideStore nightly. Please refer to the tutorial in the [Advanced](advanced/jit) section.
+Users on iOS or iPadOS 17.4 or higher will need to use a solution such as StikDebug (formerly StikJIT) or SideStore nightly. Please refer to the tutorial in the [Advanced](advanced/jit) section.
 
 ### When will SideStore release?
 

docs/installation/mac.mdx

@@ -6,11 +6,11 @@ sidebar_position: 4
 
 Before you start, make sure to have all steps completed found in the [Prerequisites](prerequisites), and that you have a [pairing file](pairing-file)!
 
-1. Download and run AltServer from [AltStore's website](https://AltStore.io).
+1. Download AltServer from [AltStore's website](https://cdn.altstore.io/file/altstore/altserver.zip). Copy AltServer.app to your /Applications folder, then run it. It should appear as an icon in your menu bar.
 2. Download the SideStore IPA which you can find [here](https://github.com/sidestore/sidestore/releases/latest/download/sidestore.ipa).
-3. Hold option/alt and click on the AltServer menu bar icon. Click "Sideload .ipa", and select the SideStore IPA file.
-4. Approve the "Developer App" with your Apple ID's email.
+3. Hold option and click on the AltServer menu bar icon. Click "Sideload .ipa", and select the SideStore IPA file.
+4. Approve the "Developer App" with your Apple ID's email on your secondary device.
     * You can find this in Settings, under "General", and then "VPN & Device Management".
 5. Open SideStore, select your pairing file, and sign in with your Apple ID.
 
-When you finish, then follow the [post-install instructions](post-install).
+When you finish, follow the [post-install instructions](installation/post-install).

docs/installation/pairing-file.mdx

@@ -4,64 +4,49 @@ description: Pairing files are essential to SideStore's functionality.
 sidebar_position: 2
 ---
 
-Using JitterbugPair (*not* the Jitterbug app) allows us to create a pairing file for programs like SideStore to talk to your device. This is required to use SideStore, or it will not function.
+iDevicePair allows us to create a pairing file for programs like SideStore to talk to your device remotely. This is required to use SideStore, or it will not function.
 
-Download JitterbugPair for [Windows (64-bit)](https://github.com/osy/Jitterbug/releases/download/v1.3.1/jitterbugpair-win64.zip), [macOS](https://github.com/SideStore/SideStore-Docs/releases/download/need-a-place-to-put-jittterbug/jitterbugpair), or [Linux](https://github.com/osy/Jitterbug/releases/download/v1.3.1/jitterbugpair-linux.zip).
+Download iDevicePair for [Windows (64-bit)](https://github.com/jkcoxson/idevice_pair/releases/latest/download/iDevicePair--windows-x86_64.exe), [macOS](https://github.com/jkcoxson/idevice_pair/releases/latest/download/iDevicePair--macos-universal.dmg), or Linux ([x86_64](https://github.com/jkcoxson/idevice_pair/releases/latest/download/iDevicePair--linux-x86_64.AppImage) or [aarch64](https://github.com/jkcoxson/idevice_pair/releases/latest/download/iDevicePair--linux-aarch64.AppImage)).
 
 ## Pairing Instructions
 
-:::tip
-
-When using cloud storage, the file extension might change (usually to .txt). It is always recommended to zip your pairing file before transferring it. SideStore only accepts .mobiledevicepairing files.
-:::
-
 ### Windows
 
-1. Extract the JitterbugPair zip file.
-2. Plug your device into your computer, and open your device to its home screen. Once done, execute the program.
-    * Your device may ask you to trust your computer. Make sure to accept this prompt, as it is required for the pairing process.
-3. Once it is done, you will get a file that ends with `.mobiledevicepairing`.
-4. Transfer this file to your device using iTunes, or any other method. Zipping the file before sending it off is the best way to ensure the pairing file won't break during transport.
-    * Transferring using cloud storage may change the file's extension (most likely turning into a .txt file), so be careful. It is also possible to change the extension to `.plist` for use with older SideStore versions, like `0.1.1`.
-
-On Windows, you might have to execute the program using Command Prompt or Powershell, as it can sometimes not open by double clicking the `.exe` file.
-
-5. In File Explorer, navigate to the folder where jitterbugpair is located.
-6. In the navigation bar where the folder location is, click an empty spot and type `powershell`. It should open a (possibly blue colored) window called PowerShell.
-7. From there, type `./jitterbugpair.exe` and press enter while your device is plugged in.
-
+1. Install iTunes from Apple's website ([64-bit](https://apple.com/itunes/download/win64) or [32-bit](https://apple.com/itunes/download/win32)).
+2. Download `iDevicePair--windows-x86_64.exe` (move it somewhere you won't lose it).
+3. Connect your secondary device to your computer via cable. If a prompt appears, tap "trust" and type in your passcode.
+4. Unlock your device, open iDevicePair, and select your device in the drop-down menu.
+5. Ensure your device is unlocked and opened to the home screen, then select "generate". When a prompt appears on your device, tap "trust". Your pairing file should appear.
+6. Ensure your device is still open to the home screen, then scroll down to the SideStore section and select "install". The word "success" should appear in green.
 
 ### macOS
 
-1. **Extract** `Jitterbugpair-macos.zip`.
-2. **Set a passcode** for your device if you haven't already. Unlock your device, connect it to your computer via cable. If a prompt appears: tap "Trust."
-3. Open your device to the homescreen.
-4. Find the extracted `jitterbugpair` file (it should have a black and green icon).
-5. Open Terminal (in Launchpad, it's in the "Utilities" folder).
-6. Drag the `jitterbugpair` file into Terminal and press "Return" or Enter.
-7. If you get "macOS cannot verify that this app is free from malware":
-   - Go to System Settings > Privacy & Security
-   - Scroll down to the message about the app
-   - Click "Open Anyway"
-   - Try running the program again
-8. JitterBugPair will generate a **pairing file** with the extension `.mobiledevicepairing`.
-9. If you can't find the pairing file:
-   - Copy the name of the pairing file generated
-   - Paste it into Finder
-   - If you ran the program more than once all pairing files for your device should appear since they share the same name
-10. **Transfer the pairing file** to your iOS device using AirDrop, iCloud/One/Google Drive, email, or any other method. For best results, compress the file into a .zip folder first.
+1. Download `iDevicePair--macos-universal.dmg`. Open the file and drag "iDevicePair" to your Applications folder.
+3. Connect your secondary device to your computer via cable. If a prompt appears, tap "trust" and type in your passcode.
+4. Unlock your device, open iDevicePair, and select your device in the drop-down menu.
+5. Ensure your device is unlocked and opened to the home screen, then select "generate". When a prompt appears on your device, tap "trust". Your pairing file should appear.
+6. Ensure your device is still open to the home screen, then scroll down to the SideStore section and select "install". The word "success" should appear in green.
 
 ### Linux
 
-These instructions expect that you are familiar with the linux commandline.
-
-1. Extract the Jitterbug zip file, and open a terminal (if you haven't already) to the extracted directory. 
-2. In that terminal, run `chmod +x ./jitterbugpair`
-3. Plug your device into your computer, and open your device to its home screen. Once done, execute the program in your terminal with `./jitterbugpair`
-    * If you get a prompt saying you need to trust the computer from your iDevice, make sure to do so. You may need to rerun jitterbugpair.
-4. Once it is done, you will get a file that ends with `.mobiledevicepairing` in the directory you ran jitterbugpair from.
-5. Transfer this file to your device in a way of your choosing. Zipping the file before sending it off is the best way to ensure the pairing file won't break during transport
-    * Transferring using cloud storage may change the file's extension (most likely turning into a .txt file), so be careful. It is also possible to change the extension to `.plist` for use with older SideStore versions, like `0.1.1`.
+:::note
+The iDevicePair instructions for Linux are a work-in-progress. For now, instructions to create a pairing file using JitterbugPair for Linux are below!
+:::
 
-You might have success by just adding execute permissions and running jitterbugpair from a file manager, but it is recommended to just do it from the terminal.
+These instructions expect that you are familiar with the linux commandline.
 
+1. **Download** `jitterbugpair-linux.zip` from [here](https://github.com/osy/Jitterbug/releases/download/v1.3.1/jitterbugpair-linux.zip), then extract it.
+2. Open a terminal in the extracted directory.
+3. Make the program executable:
+   ```bash
+   chmod +x ./jitterbugpair
+   ```
+4. **Set a passcode** for your device if you haven't already. Unlock your device and connect it to your computer via cable. If a prompt appears, tap "trust" and type in your passcode.
+5. Open your device to the homescreen.
+6. Execute the program:
+   ```bash
+   ./jitterbugpair
+   ```
+7. The first time you execute the tool, you will get a prompt for your passcode on your secondary device. Type it in, then keep the screen on and unlocked and run the tool again. Type it in, then keep the screen on and unlocked and execute the tool again.
+8. JitterbugPair will generate a **pairing file** with the extension `.mobiledevicepairing`.
+9. Compress the file into a .zip folder. Then, **transfer the pairing file** to your iOS device using email, cloud storage, or another method you prefer.

docs/installation/post-install.mdx

@@ -3,15 +3,17 @@ title: Post-Install Instructions
 description: Almost there, just a few more steps!
 sidebar_position: 6
 ---
-The last step to installing SideStore is to refresh SideStore, within itself.
+The last step to installing SideStore is to refresh SideStore within itself.
 
 To do this, you need to:
 
 1. Connect to StosVPN.
 2. Open SideStore.
 3. If you haven't already, select the pairing file.
-4. Go to "My Apps".
-5. Select the "x DAYS" button, where x is the number of days until expire.
-    * If successful, this will open a blank Safari tab or go to your home screen. You will get a notification also telling you to do this.
+4. Navigate to "My Apps".
+5. Select the "x DAYS" button, (x is the number of days until expiry). A prompt asking about your signing certificate should appear, tap "Refresh Now". If a prompt appears asking you if you want to revoke a certificate from AltStore, tap "yes".
+    * If successful, this will open a blank Safari tab or open to your home screen, accompanied by a notification notating this.
 
 If SideStore is not refreshed, a bug causing early expiry will require you to reinstall SideStore. There is a plan to have this done automatically, but for now it needs to be done manually.
+
+If you reinstall SideStore or install it on another device under the same Apple ID using AltServer, your certificate will be revoked and you will need to refresh it manually again as shown above (on both devices, if applicable).

docs/installation/prerequisites.mdx

@@ -4,12 +4,12 @@ description: 'The first steps of installation.'
 sidebar_position: 1
 ---
 
-SideStore's installation process can seem tricky, but with the ***one-time*** use of a computer, and some time, you'll have SideStore on your device!
+SideStore's installation process may seem tricky, but with the ***one-time*** use of a computer and some time, you'll have SideStore on your device!
 
 ## Requirements
 
 To install SideStore, you will need:
-- An iOS or iPadOS device running iOS or iPadOS 14 or higher.
+- An iPhone or iPad [with a passcode](https://support.apple.com/en-us/119586) running iOS/iPadOS 14 or higher.
 - A Windows, macOS, or Linux computer (Linux support is experimental).
 - An Apple ID.
 - The StosVPN app.
@@ -26,10 +26,10 @@ Users of iOS/iPadOS 16 or higher *must* have Developer Mode enabled. Do this by:
 
 SideStore utilizes an on-device VPN which allows SideStore to communicate with internal services.
 
-1. Download the StosVPN app from the [Official App Store](https://apps.apple.com/us/app/stosvpn/id6744003051).
+1. Download the StosVPN app from the [Apple App Store](https://apps.apple.com/us/app/stosvpn/id6744003051).
 2. Enable the VPN.
 
-This VPN is required to be on any time you wish to install or update apps in SideStore.
+This VPN is required to be turned on any time you wish to install or update apps in SideStore.
 
 ## Next Steps