diff --git a/docs/installation/linux.mdx b/docs/installation/linux.mdx index b307a9fb..3ea7fc13 100644 --- a/docs/installation/linux.mdx +++ b/docs/installation/linux.mdx @@ -6,8 +6,9 @@ sidebar_position: 4 Before you start, make sure to have all steps completed found in the [prerequisites](prerequisites)! -1. Make sure you have usbmuxd and either Docker or Podman installed on your machine. -2. Plug in your iDevice. If you recieve a prompt, select "trust" and enter your passcode. +1. Ensure you have usbmuxd installed and updated by running `sudo apt install -y usbmuxd` in the Linux terminal. +2. Install either Docker or Podman on your machine. +2. Plug in your secondary iDevice. If you recieve a prompt, select "trust" and enter your passcode. 3. Now, run Altcon with Docker or Podman using the following commands (may require `sudo`): @@ -19,12 +20,11 @@ Podman setup: ```bash podman run --rm -it -v ${PWD}/:/mnt/ -v /var/run/usbmuxd:/var/run/usbmuxd ghcr.io/sidestore/altcon ``` -3. Altcon will pair with your device. When you recieve another prompt, select "trust" and enter your passcode again. -4. On your secondary device, do the following: +5. Altcon will pair with your device. When you receive another prompt, select "trust" and enter your passcode again. +6. On your secondary device, do the following: * Approve the "Developer App" under your Apple ID's email (you can find this in Settings, under "General", and then "VPN & Device Management"). * Open the Settings app. * Navigate to the 'Privacy and Security' section. * Turn on 'Developer Mode' at the bottom. -5. Open SideStore and select "allow" for prompts until SideStore requests a pairing file. Exit the app now. Now, proceed to generate your [pairing file](pairing-file). diff --git a/docs/installation/mac.mdx b/docs/installation/mac.mdx index 59ae94c4..aeb4bb24 100644 --- a/docs/installation/mac.mdx +++ b/docs/installation/mac.mdx @@ -14,6 +14,5 @@ Before you start, make sure to have all steps completed found in the [prerequisi * Open the Settings app. * Navigate to the 'Privacy and Security' section. * Turn on 'Developer Mode' at the bottom. -5. Open SideStore and select "allow" for prompts until SideStore requests a pairing file. Exit the app now. Now, proceed to generate your [pairing file](pairing-file). diff --git a/docs/installation/pairing-file.mdx b/docs/installation/pairing-file.mdx index 3cb0cd69..eb6238d1 100644 --- a/docs/installation/pairing-file.mdx +++ b/docs/installation/pairing-file.mdx @@ -4,43 +4,34 @@ description: Pairing files are essential to SideStore's functionality. sidebar_position: 5 --- -idevice pair is a program which creates a Jitterbug pairing file, allowing programs like SideStore to talk to your device remotely. This is required to use SideStore, otherwise it will not function. +idevice_pair is a program which generates a pairing file which allows apps like SideStore to perform actions on your device remotely. This is required to use SideStore, otherwise it will not function. :::warning -Caution, if you update or reset your iDevice, your pairing file will expire and you will need to generate a new one. This also occurs at random times, and there is nothing we can do at this point to fix it. +Caution, if you update or reset your iDevice, your pairing file will expire and you will need to generate a new one. This also occurs at random times due to Apple's policies, and there is nothing we can do at this point to fix it. ::: -Download idevice pair for: -- [macOS](https://github.com/jkcoxson/idevice_pair/releases/latest/download/iDevicePair--macos-universal.dmg) -- [Windows](https://github.com/jkcoxson/idevice_pair/releases/latest/download/iDevicePair--windows-x86_64.exe) -- 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 +## Installation Instructions ### macOS -1. Download `iDevicePair--macos-universal.dmg`. Open the file and drag `idevice pair` to `Applications`. -2. Connect your secondary device to your computer via cable. If a prompt appears, tap "trust" and type in your passcode. -3. Unlock your device, then open idevice pair and select your device in the drop-down menu. -4. 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. -5. 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. +1. Download [idevice pair for macOS](https://github.com/jkcoxson/idevice_pair/releases/latest/download/idevice_pair--macos-universal.dmg). +2. Open the Disk Image and drag `idevice pair` to `Applications`. -### Windows (64-bit) +### Windows -1. If not already installed for AltServer, install [iTunes](https://apple.com/itunes/download/win64) from Apple's website. -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, then, in File Explorer, open `idevice pair` 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. +1. Ensure iTunes ([64-bit](https://apple.com/itunes/download/win64) or [32-bit](https://apple.com/itunes/download/win32)) is installed from from Apple's website (it should already be installed from the process of setting up AltServer). +2. Download [idevice pair for Windows](https://github.com/jkcoxson/idevice_pair/releases/latest/download/idevice_pair--windows-x86_64.exe) and move it somewhere you will remember it. ### Linux -1. Ensure usbmuxd is installed on your machine. -2. Download the version of idevice pair that corresponds to your PC's architecture and make it executable. -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, then execute idevice pair 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. +1. Ensure usbmuxd is installed on your machine by running `sudo apt install -y usbmuxd` in the Linux terminal. +2. Download the version of idevice_pair for Linux ([x86_64](https://github.com/jkcoxson/idevice_pair/releases/latest/download/idevice_pair--linux-x86_64.AppImage) or [AArch64](https://github.com/jkcoxson/idevice_pair/releases/latest/download/idevice_pair--linux-aarch64.AppImage)) which corresponds to your PC's architecture. Move it somewhere you will remember it, and make it executable. + +## Pairing Instructions + +1. Connect your secondary device to your computer via cable. If a prompt appears, select `trust` and type in your passcode. +2. Unlock your device, then open `idevice pair` and select your device in the drop-down menu. +3. Ensure your device is unlocked and opened to the home screen, then select `load`. If a prompt appears on your device, tap `trust`. Your pairing file should appear. +4. Ensure your device is still open to the home screen, then scroll down and select `install` underneath "SideStore". `Success` should appear in green. ## Next steps Now, follow the [post-install instructions](post-install). diff --git a/docs/installation/prerequisites.mdx b/docs/installation/prerequisites.mdx index 64af168c..d15b31a0 100644 --- a/docs/installation/prerequisites.mdx +++ b/docs/installation/prerequisites.mdx @@ -11,7 +11,7 @@ SideStore's installation process may seem tricky, but with the ***one-time*** us To install SideStore, you will need: - An iPhone or iPad [with a passcode](https://support.apple.com/en-us/119586) running iOS/iPadOS 14 or higher -- A [Mac](/docs/installation/mac), [Windows](/docs/installation/windows), or [Linux](/docs/installation/linux) (Linux support is experimental) computer +- A [Mac](/docs/installation/mac), [Windows](/docs/installation/windows), or [Linux (support is experimental)](/docs/installation/linux) computer - An Apple ID - The StosVPN app (see below) - A Wi-Fi connection @@ -30,5 +30,5 @@ This VPN is required to be turned on any time you wish to install, update, or re Next, follow the installation instructions for your operating system! - [macOS](mac) -- [Windows (64-bit)](windows) +- [Windows](windows) - [Linux (experimental)](linux) diff --git a/docs/installation/windows.mdx b/docs/installation/windows.mdx index 3f012a93..3233d97e 100644 --- a/docs/installation/windows.mdx +++ b/docs/installation/windows.mdx @@ -6,7 +6,7 @@ sidebar_position: 3 Before you start, make sure to have all steps completed found in the [prerequisites](prerequisites)! -On your machine, uninstall any version of iCloud or iTunes you may have downloaded from the Microsoft store, then install the non-Microsoft Store versions of [iCloud](https://updates.cdn-apple.com/2020/windows/001-39935-20200911-1A70AA56-F448-11EA-8CC0-99D41950005E/iCloudSetup.exe) and [iTunes](https://apple.com/itunes/download/win64). The non-Microsoft Store version of iCloud was removed from Apple’s website in mid-September 2022, so the above link directs to an older version of iCloud that is still compatible with AltServer, and still available directly from Apple’s servers (safe). +On your machine, uninstall any version of iCloud or iTunes you may have downloaded from the Microsoft store, then install the non-Microsoft Store versions of iTunes ([64-bit](https://apple.com/itunes/download/win64) or [32-bit](https://apple.com/itunes/download/win32)) and [iCloud](https://updates.cdn-apple.com/2020/windows/001-39935-20200911-1A70AA56-F448-11EA-8CC0-99D41950005E/iCloudSetup.exe). The non-Microsoft Store version of iCloud was removed from Apple’s website in mid-September 2022, so the above link directs to an older version of iCloud that is still compatible with AltServer, and still available directly from Apple’s servers (safe). 1. Download `altinstaller.zip` from [AltStore's website](https://cdn.altstore.io/file/altstore/altinstaller.zip). Extract `altinstaller.zip` and run `setup.exe`. In your Windows taskbar, type in "AltServer" and click "Run as administrator." Make sure to allow access to private networks if prompted. AltStore will appear as an icon in the system tray (where Internet, Wi-Fi, Battery, etc. are displayed). 2. Download the SideStore IPA which you can find [here](https://github.com/sidestore/sidestore/releases/latest/download/sidestore.ipa). @@ -16,6 +16,5 @@ On your machine, uninstall any version of iCloud or iTunes you may have download * Open the Settings app. * Navigate to the 'Privacy and Security' section. * Turn on 'Developer Mode' at the bottom. -5. Open SideStore and select "allow" for prompts until SideStore requests a pairing file. Exit the app now. Now, proceed to generate your [pairing file](pairing-file).