Skip to content

Commit 479466e

Browse files
authored
Refactor installation instructions with Tabs component (@CelloSerenity)
2 parents e970bc0 + 78ae418 commit 479466e

File tree

3 files changed

+125
-108
lines changed

3 files changed

+125
-108
lines changed

docs/advanced/alternative.mdx

Lines changed: 104 additions & 89 deletions
Original file line numberDiff line numberDiff line change
@@ -3,35 +3,46 @@ title: Alternative/Outdated Instructions
33
description: "A place for alternative/outdated SideStore setup instructions. Note: many of these walkthroughs may be incompatible with latest iOS or SideStore versions."
44
---
55

6+
```mdx-code-block
7+
import Tabs from '@theme/Tabs';
8+
import TabItem from '@theme/TabItem';
9+
```
10+
611
## Installation
712
### AltServer
8-
#### macOS
9-
Follow the instructions (steps 1-3) [here](https://faq.altstore.io/altstore-classic/how-to-install-altstore-macos) to setup AltServer
10-
#### Windows
11-
Follow the instructions (steps 1-3) [here](https://faq.altstore.io/altstore-classic/how-to-install-altstore-windows) to setup AltServer
12-
#### Linux (Altcon)
13-
Before you start, make sure to have installed usbmuxd.
14-
15-
1. Ensure you have usbmuxd installed and updated by running `sudo apt install -y usbmuxd` in the Linux terminal.
16-
2. Install either Docker or Podman on your machine.
17-
2. Plug in your secondary iDevice. If you receive a prompt, select "trust" and enter your passcode.
18-
19-
3. Now, run Altcon with Docker or Podman using the following command (may require `sudo`):
20-
21-
Docker setup:
22-
```bash
23-
docker run --rm -it -v ${PWD}/:/mnt/ -v /var/run/usbmuxd:/var/run/usbmuxd -v /var/lib/lockdown:/tmp/lockdown ghcr.io/sidestore/altcon
24-
```
25-
Podman setup:
26-
```bash
27-
podman run --rm -it -v ${PWD}/:/mnt/ -v /var/run/usbmuxd:/var/run/usbmuxd -v /var/lib/lockdown:/tmp/lockdown ghcr.io/sidestore/altcon
28-
```
29-
5. Altcon will pair with your device. When you receive another prompt, select "trust" and enter your passcode again.
3013

31-
#### Setting up SideStore for multiple devices on the same account using AltServer
14+
<Tabs groupId="operating-systems">
15+
<TabItem value="mac" label="macOS">
16+
Follow the instructions (steps 1-3) [here](https://faq.altstore.io/altstore-classic/how-to-install-altstore-macos) to setup AltServer
17+
</TabItem>
18+
<TabItem value="win" label="Windows">
19+
Follow the instructions (steps 1-3) [here](https://faq.altstore.io/altstore-classic/how-to-install-altstore-windows) to setup AltServer
20+
</TabItem>
21+
<TabItem value="linux" label="Linux (Altcon)">
22+
Before you start, make sure to have installed usbmuxd.
23+
1. Ensure you have usbmuxd installed and updated by running `sudo apt install -y usbmuxd` in the Linux terminal.
24+
2. Install either Docker or Podman on your machine.
25+
3. Plug in your secondary iDevice. If you receive a prompt, select "trust" and enter your passcode.
26+
4. Now, run Altcon with Docker or Podman using the following command (may require `sudo`):
27+
28+
Docker setup:
29+
```bash
30+
docker run --rm -it -v ${PWD}/:/mnt/ -v /var/run/usbmuxd:/var/run/usbmuxd -v /var/lib/lockdown:/tmp/lockdown ghcr.io/sidestore/altcon
31+
```
32+
33+
Podman setup:
34+
```bash
35+
podman run --rm -it -v ${PWD}/:/mnt/ -v /var/run/usbmuxd:/var/run/usbmuxd -v /var/lib/lockdown:/tmp/lockdown ghcr.io/sidestore/altcon
36+
```
37+
38+
5. Altcon will pair with your device. When you receive another prompt, select "trust" and enter your passcode again.
39+
</TabItem>
40+
</Tabs>
41+
42+
#### Setting up SideStore for multiple devices on the same account using AltServer (only works with macOS/Windows)
3243
Steps:
3344
1. Setup AltServer on macOS/Windows using instructions above
34-
2. Install AltStore to one device using AltServer (We need AltStore once since it seems AltServer won't put machine identifier in apps other than AltStore)
45+
2. Install AltStore to one device using AltServer
3546
3. Sign in Apple ID in AltStore
3647
4. Export Certificate
3748
5. Delete AltStore
@@ -71,20 +82,20 @@ This VPN is required to be on any time you use SideStore, as most functions will
7182
### idevice_pair
7283
#### Installation Instructions
7384

74-
##### macOS
75-
76-
1. Download [idevice pair for macOS](https://github.com/jkcoxson/idevice_pair/releases/latest/download/idevice_pair--macos-universal.dmg).
77-
2. Open the Disk Image and drag `idevice pair` to `Applications`.
78-
79-
##### Windows
80-
81-
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).
82-
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.
83-
84-
##### Linux
85-
86-
1. Ensure usbmuxd is installed on your machine by running `sudo apt install -y usbmuxd` in the Linux terminal.
87-
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.
85+
<Tabs groupId="operating-systems">
86+
<TabItem value="mac" label="macOS">
87+
1. Download [idevice pair for macOS](https://github.com/jkcoxson/idevice_pair/releases/latest/download/idevice_pair--macos-universal.dmg).
88+
2. Open the Disk Image and drag `idevice pair` to `Applications`.
89+
</TabItem>
90+
<TabItem value="win" label="Windows">
91+
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).
92+
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.
93+
</TabItem>
94+
<TabItem value="linux" label="Linux">
95+
1. Ensure usbmuxd is installed on your machine by running `sudo apt install -y usbmuxd` in the Linux terminal.
96+
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.
97+
</TabItem>
98+
</Tabs>
8899

89100
#### Pairing Instructions
90101

@@ -105,57 +116,61 @@ Download JitterbugPair for [Windows (64-bit)](https://github.com/osy/Jitterbug/r
105116
Depending on your method, when transferring your .mobiledevicepariring file, the file extension might change (usually to .txt or cropping off the "ing"). It is always recommended to zip your pairing file before transferring it. SideStore only accepts .mobiledevicepairing files (or .plist files in older versions).
106117
:::
107118

108-
##### Windows
109-
110-
1. **Extract** `jitterbugpair-win64.zip`.
111-
2. **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.
112-
3. Open your device to the homescreen.
113-
4. In File Explorer, locate `jitterbugpair.exe` and run it by double-clicking or right-clicking and selecting "open". The first time you run 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.
114-
5. JitterbugPair will generate a **pairing file** in the same folder. This file will have the extension `.mobiledevicepairing`.
115-
6. For best results, compress the file into a .zip folder. Then, **transfer the pairing file** to your iOS device using One/iCloud/Google Drive, email, or another method you prefer.
116-
117-
On Windows, you might have to execute the program using Command Prompt or Powershell, as double-clicking the `.exe` file doesn't always open it.
118-
119-
7. In File Explorer, navigate to the folder where jitterbugpair is located.
120-
8. 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.
121-
9. From there, type `./jitterbugpair.exe` and press enter while your device is plugged in.
122-
123-
##### macOS
124-
125-
1. **Extract** `jitterbugpair-macos.zip`.
126-
2. **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.
127-
3. Open your device to the homescreen.
128-
4. Find and open the extracted `jitterbugpair` file (it should have a black and green icon) by double-clicking it or right-clicking it and selecting "open". The first time you run 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.
129-
5. If you get the message" "macOS cannot verify that this app is free from malware":
130-
- Go to System Settings > Privacy & Security
131-
- Scroll down to the message about the app
132-
- Click "Open Anyway," if the program doesn't run automatically, try manually running it again
133-
6. JitterbugPair will generate a **pairing file** with the extension `.mobiledevicepairing` to your user's home folder.
134-
7. If you can't find the pairing file:
135-
- Copy the name of the pairing file generated
136-
- Paste it into Finder
137-
- If you ran the program more than once, all pairing files for your device should appear since they share the same name
138-
8. For best results, compress the file into a .zip folder. Then, **transfer the pairing file** to your iOS device via AirDrop, iCloud/One/Google Drive, email, or another method you prefer.
139-
140-
##### Linux
141-
142-
These instructions expect that you are familiar with the linux commandline.
143-
144-
1. **Extract** `jitterbugpair-linux.zip`.
145-
2. Open a terminal in the extracted directory.
146-
3. Make the program executable:
147-
```bash
148-
chmod +x ./jitterbugpair
149-
```
150-
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.
151-
5. Open your device to the homescreen.
152-
6. Execute the program:
153-
```bash
154-
./jitterbugpair
155-
```
156-
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.
157-
8. JitterbugPair will generate a **pairing file** with the extension `.mobiledevicepairing`.
158-
9. For best results, 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.
119+
<Tabs groupId="operating-systems">
120+
<TabItem value="mac" label="macOS">
121+
1. Download JitterbugPair for [macOS](https://github.com/osy/Jitterbug/releases/download/v1.3.1/jitterbugpair-macos.zip).
122+
2. **Extract** `jitterbugpair-macos.zip`.
123+
3. **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.
124+
4. Open your device to the homescreen.
125+
5. Find and open the extracted `jitterbugpair` file (it should have a black and green icon) by double-clicking it or right-clicking it and selecting "open". The first time you run 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.
126+
6. If you get the message" "macOS cannot verify that this app is free from malware":
127+
- Go to System Settings > Privacy & Security
128+
- Scroll down to the message about the app
129+
- Click "Open Anyway," if the program doesn't run automatically, try manually running it again
130+
7. JitterbugPair will generate a **pairing file** with the extension `.mobiledevicepairing` to your user's home folder.
131+
8. If you can't find the pairing file:
132+
- Copy the name of the pairing file generated
133+
- Paste it into Finder
134+
- If you ran the program more than once, all pairing files for your device should appear since they share the same name
135+
9. For best results, compress the file into a .zip folder. Then, **transfer the pairing file** to your iOS device via AirDrop, iCloud/One/Google Drive, email, or another method you prefer.
136+
</TabItem>
137+
<TabItem value="win" label="Windows">
138+
1. Download JitterbugPair for [Windows (64-bit)](https://github.com/osy/Jitterbug/releases/download/v1.3.1/jitterbugpair-win64.zip).
139+
2. **Extract** `jitterbugpair-win64.zip`.
140+
3. **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.
141+
4. Open your device to the homescreen.
142+
5. In File Explorer, locate `jitterbugpair.exe` and run it by double-clicking or right-clicking and selecting "open". The first time you run 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.
143+
6. JitterbugPair will generate a **pairing file** in the same folder. This file will have the extension `.mobiledevicepairing`.
144+
7. For best results, compress the file into a .zip folder. Then, **transfer the pairing file** to your iOS device using One/iCloud/Google Drive, email, or another method you prefer.
145+
146+
On Windows, you might have to execute the program using Command Prompt or Powershell, as double-clicking the `.exe` file doesn't always open it.
147+
148+
8. In File Explorer, navigate to the folder where jitterbugpair is located.
149+
9. 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.
150+
10. From there, type `./jitterbugpair.exe` and press enter while your device is plugged in.
151+
152+
</TabItem>
153+
<TabItem value="linux" label="Linux">
154+
These steps expect that you are familiar with the Linux commandline
155+
1. Download JitterbugPair for [Linux](https://github.com/osy/Jitterbug/releases/download/v1.3.1/jitterbugpair-linux.zip).
156+
2. **Extract** `jitterbugpair-linux.zip`.
157+
3. Open a terminal in the extracted directory.
158+
4. Make the program executable:
159+
```bash
160+
chmod +x ./jitterbugpair
161+
```
162+
5. **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.
163+
6. Open your device to the homescreen.
164+
7. Execute the program:
165+
```bash
166+
./jitterbugpair
167+
```
168+
8. 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.
169+
9. JitterbugPair will generate a **pairing file** with the extension `.mobiledevicepairing`.
170+
10. For best results, 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.
171+
</TabItem>
172+
</Tabs>
173+
159174
## SideStore exploits
160175
### SparseRestore (3-app limit)
161176
:::note

docs/installation/install.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,17 +3,17 @@ title: Install
33
description: Installing SideStore to your iDevice
44
sidebar_position: 2
55
---
6-
Before you start, make sure to download all software and complete all setup found in [prerequisites](prerequisites)!
6+
Before you start, make sure to download all software and complete all setup found in the [prerequisites page](prerequisites)!
77

88
## Installing SideStore
9+
### On your Computer
910
1. Connect your iDevice to your computer via cable. If you are prompted, trust the computer and enter your passcode.
1011
2. Open iloader.
1112
3. Sign in to an Apple Account (It doesn't need to be the account associated with the device. Remember that it is case-sensitive!).
1213
4. Select your iDevice.
1314
5. Select 'Install SideStore (Stable)'.
1415

1516
### On your iDevice
16-
Do the following:
1717
1. Open the Settings app.
1818
2. Navigate to 'General', and then 'VPN & Device Management'.
1919
3. Approve the "Developer App" under the Apple Account's email.

docs/installation/prerequisites.mdx

Lines changed: 19 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,11 @@ description: 'The first steps of installation.'
44
sidebar_position: 1
55
---
66

7+
```mdx-code-block
8+
import Tabs from '@theme/Tabs';
9+
import TabItem from '@theme/TabItem';
10+
```
11+
712
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!
813

914
## Requirements
@@ -29,20 +34,17 @@ This VPN is required to be turned on any time you wish to install, update, or re
2934

3035
Now, follow the instructions corresponding to your computer's OS:
3136

32-
### On your Mac
33-
1. Download and install iloader for [Mac](https://github.com/nab138/iloader/releases/latest/download/iloader-darwin-universal.dmg).
34-
35-
### On your Windows PC
36-
1. Download and install [iTunes](https://apple.co/ms).
37-
2. Download the iloader installer ([.exe](https://github.com/nab138/iloader/releases/latest/download/iloader-windows-x64.exe) or [.msi](https://github.com/nab138/iloader/releases/latest/download/iloader-windows-x64.msi)). (Note: The iloader installer .exe is currently flagged as a virus/trojan, we are positive it's not and are looking into it, but in the meantime we recommend you download the .msi).
38-
3. Run the installer.
39-
40-
### On your Linux Machine
41-
1. Download and install `usbmuxd` (may be preinstalled for your distro, otherwise install with your package manager).
42-
2. Download and install iloader for your distro ([.deb](https://github.com/nab138/iloader/releases/latest/download/iloader-linux-amd64.deb) for Debian/Ubuntu, [.rpm](https://github.com/nab138/iloader/releases/latest/download/iloader-linux-x86_64.rpm) for Fedora/openSUSE, [.AppImage](https://github.com/nab138/iloader/releases/latest/download/iloader-linux-amd64.AppImage) for other).
43-
44-
45-
## Next Steps
46-
47-
Next, follow the installation instructions to install SideStore!
48-
- [Install](install)
37+
<Tabs groupId="operating-systems">
38+
<TabItem value="mac" label="macOS">
39+
1. Download and install iloader for [Mac](https://github.com/nab138/iloader/releases/latest/download/iloader-darwin-universal.dmg).
40+
</TabItem>
41+
<TabItem value="win" label="Windows">
42+
1. Download and install [iTunes](https://apple.co/ms).
43+
2. Download the iloader installer ([.exe](https://github.com/nab138/iloader/releases/latest/download/iloader-windows-x64.exe) or [.msi](https://github.com/nab138/iloader/releases/latest/download/iloader-windows-x64.msi)). (Note: The iloader installer .exe is currently flagged as a virus/trojan, we are positive it's not and are looking into it, but in the meantime we recommend you download the .msi).
44+
3. Run the installer.
45+
</TabItem>
46+
<TabItem value="linux" label="Linux">
47+
1. Download and install `usbmuxd` (may be preinstalled for your distro, otherwise install with your package manager).
48+
2. Download and install iloader for your distro ([.deb](https://github.com/nab138/iloader/releases/latest/download/iloader-linux-amd64.deb) for Debian/Ubuntu, [.rpm](https://github.com/nab138/iloader/releases/latest/download/iloader-linux-x86_64.rpm) for Fedora/openSUSE, [.AppImage](https://github.com/nab138/iloader/releases/latest/download/iloader-linux-amd64.AppImage) for other).
49+
</TabItem>
50+
</Tabs>

0 commit comments

Comments
 (0)