Skip to content

Commit 9e42e39

Browse files
hugeBlackhugeBlack
committed
update ss+lc guide
1 parent d73befe commit 9e42e39

11 files changed

Lines changed: 128 additions & 54 deletions

File tree

‎docs/guides/add-to-home-screen.md‎

Lines changed: 40 additions & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -1,30 +1,34 @@
11
# Add to Home Screen
22
There are 3 ways to add an app to you home screen. The first "Launch App Shortcut" is the best way to add an app to your home screen.
33

4-
## Mathod 1: Launch App Shortcut (Recommended)
5-
:::note
6-
This feature is available in LiveContainer 3.6.62+
7-
Please make sure LiveContainer is installed with at least "LaunchAppExtension" extension ("Use Main Profile" or "Keep All Extensions" is selected when installing)
4+
## Method 1: Launch App Shortcut (Recommended)
5+
:::note
6+
This feature is available in LiveContainer 3.6.62+.
7+
8+
Please make sure LiveContainer is installed with at least the "LaunchAppExtension" extension (select "Use Main Profile" or "Keep All Extensions" during installation).
89
:::
910

10-
This is the most recommended way of adding an app to HomeScreen, as it directly launch the app without the need of open LiveContainer's UI first, and it automatically finds a free LiveContainer to open the app, which saves you approximately 1.5~3s each launch comparing to other methods below.
11+
This is the recommended way to add an app to your Home Screen. It launches the app directly without opening LiveContainer’s UI first, and it automatically finds a free LiveContainer to open the app. This saves about 1.5–3 seconds per launch compared to the other methods below.
1112

1213
Follow these steps to add an app to your home screen using Launch App Shortcut:
1314
### Save Icon & Copy Launch URL
14-
1. Save App Icon: Hold the app -> tap "Add to Home Screen" -> tap "Save App Icon" -> Select an icon style you prefer -> Save it and we'll use it later
15-
2. Copy Launch URL: Hold the app -> tap "Add to Home Screen" -> tap "Copy Launch URL"
15+
:::note
16+
If an app has multiple containers, hold the app and select the target container first to get its launch URL.
17+
:::
18+
1. Save App Icon: Hold the app → tap "Add to Home Screen" → tap "Save App Icon" → select an icon style you prefer → save it (we’ll use it later).
19+
2. Copy Launch URL: Hold the app → tap "Add to Home Screen" → tap "Copy Launch URL".
1620
<p>
1721
<img height="500px" src="/img/add-to-home-screen/1.jpg" />
1822
</p>
1923

20-
### Create and Setup the Shortcut
21-
3. Open Apple's Shortcuts App. If you can't find it you may download it from AppStore.
22-
4. Press the + button on top right to create a new shortcut
23-
5. In "Search Actions" bar type and search "Launch App", choose the one from LiveContainer and tap to add it to your shourcut
24-
6. In "Search Actions" bar type and search "Open URLs". Make sure it opens the result of the previous "Launch App" action. If not, tap the gray "URL" text, then from the bar above the keyboard, tap "Launch App". (Unfortunately we can't embed the open URL action directly into the Launch App action due to iOS limitations which prohibits background process from Opening URL)
25-
7. Tap the gray "Launch URL" text in the first action, paste the launch URL you copied just now in step 2.
26-
8. Press "x" button to close the keyboard
27-
9. Tap the play/run button to test the shortcut. If the app opens, then the shortcut is working.
24+
### Create and Set Up the Shortcut
25+
3. Open Apple’s Shortcuts app. If you can’t find it, download it from the App Store.
26+
4. Tap the + button in the top-right corner to create a new shortcut.
27+
5. In the "Search Actions" bar, search for "Launch App," choose the LiveContainer action, and add it to your shortcut.
28+
6. In the "Search Actions" bar, search for "Open URLs." Make sure it opens the result of the previous "Launch App" action. If not, tap the gray "URL" text, then in the bar above the keyboard, tap "Launch App." (We can’t embed the Open URL action directly into the Launch App action due to iOS limitations that prevent background processes from opening URLs.)
29+
7. Tap the gray "Launch URL" text in the first action and paste the launch URL you copied in step 2.
30+
8. Tap the "x" button to close the keyboard.
31+
9. Tap the play/run button to test the shortcut. If the app opens, the shortcut works.
2832
<p>
2933
<img height="500px" src="/img/add-to-home-screen/2.jpg" />
3034
<img height="500px" src="/img/add-to-home-screen/3.jpg" />
@@ -34,35 +38,35 @@ Follow these steps to add an app to your home screen using Launch App Shortcut:
3438
<img height="500px" src="/img/add-to-home-screen/7.jpg" />
3539
</p>
3640

37-
### Adding Icon to Home Screen
38-
10. Go back to the shoutcut editor. If it's accidentally closed, you may tap the "..." button in top right corner of your shoutcut to reopen it.
39-
11. Tap the share button, slide down, select "Add to Home Screen"
40-
12. Tap the text under the icon to set a name
41-
13. Tap "Image" -> Tap "Choose File" -> Select the image file you saved in step 1
42-
14. Tap "Add" to add the icon to home screen
43-
15. If you want to add more apps to home screen, you can directly hold your shortcut, tap "duplicate", and edit the Launch URL to another app's URL.
41+
### Add the Icon to the Home Screen
42+
10. Go back to the shortcut editor. If it closed, tap the "..." button in the top-right corner of your shortcut to reopen it.
43+
11. Tap the share button, scroll down, and select "Add to Home Screen."
44+
12. Tap the text under the icon to set a name.
45+
13. Tap "Image" → tap "Choose File" → select the image file you saved in step 1.
46+
14. Tap "Add" to add the icon to your home screen.
47+
15. To add more apps to your home screen, hold your shortcut, tap "Duplicate," and edit the Launch URL to another app’s URL.
4448
<p>
4549
<img height="500px" src="/img/add-to-home-screen/8.jpg" />
4650
<img height="500px" src="/img/add-to-home-screen/9.jpg" />
4751
<img height="500px" src="/img/add-to-home-screen/10.jpg" />
4852
</p>
49-
### Adding SideStore to Home Screen
50-
If you installed "LiveContainer+SideStore" version, you may also add SideStore to your home screen. You can directly create a shoutcut, but set the launch URL to `sidestore://`.
53+
### Add SideStore to the Home Screen
54+
If you installed the "LiveContainer+SideStore" version, you can also add SideStore to your home screen. Create a shortcut and set the launch URL to `sidestore://`.
5155

5256
## Method 2: Launch URL Shortcut
53-
It's basically the same as using "Launch App Shortcut" method. The only difference is in the "Create and Setup the Shortcut" stage
57+
This is basically the same as the "Launch App Shortcut" method. The only difference is in the "Create and Set Up the Shortcut" stage.
5458

55-
### Create and Setup the Shortcut
56-
3. Open Apple's Shortcuts App. If you can't find it you may download it from AppStore.
57-
4. Press the + button on top right to create a new shortcut
58-
6. In "Search Actions" bar type and search "Open URLs".
59-
7. tap the gray "URL" text, paste the launch URL you copied just now in step 2.
60-
8. Press "x" button to close the keyboard
61-
9. Tap the play/run button to test the shortcut. If the app opens, then the shortcut is working.
59+
### Create and Set Up the Shortcut
60+
3. Open Apple’s Shortcuts app. If you can’t find it, download it from the App Store.
61+
4. Tap the + button in the top-right corner to create a new shortcut.
62+
6. In the "Search Actions" bar, search for "Open URLs."
63+
7. Tap the gray "URL" text and paste the launch URL you copied in step 2.
64+
8. Tap the "x" button to close the keyboard.
65+
9. Tap the play/run button to test the shortcut. If the app opens, the shortcut works.
6266

6367
## Method 3: Create App Clip (Not Recommended)
64-
You may also add an app to your home screen by creating an app clip. This method is not recommended because the App Clip will itself remains in the app switcher and more jumps are needed. Also the MDM profile remains in your settings even after the icon is deleted, so it has to be manually deleted.
68+
You can also add an app to your home screen by creating an app clip. This method is not recommended because the App Clip stays in the app switcher, requires extra jumps to open, and the MDM profile remains in Settings even after the icon is removed, so it must be deleted manually.
6569

66-
1. Hold the app -> tap "Add to Home Screen" -> tap "Create App Clip" -> Select a icon style you prefer -> tap "Allow" to download the profile.
67-
2. Open iOS Settings App ->tap "Profile Downloaded" -> In the popup tap "Install" and goes through the installation process
68-
3. You'll find your app's icon in your home screen
70+
1. Hold the app → tap "Add to Home Screen" → tap "Create App Clip" → select an icon style you prefer → tap "Allow" to download the profile.
71+
2. Open the iOS Settings app → tap "Profile Downloaded" → in the popup, tap "Install" and complete the installation.
72+
3. You’ll find the app icon on your home screen.

‎docs/installation/lc_sidestore.md‎

Lines changed: 81 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,81 @@
1+
---
2+
title: LiveContainer + SideStore
3+
sidebar_position: 2
4+
---
5+
6+
# LiveContainer + SideStore
7+
This version of LiveContainer comes with a built-in SideStore, which allows you to refresh LiveContainer and other apps using only one of your 3 free app slots.
8+
9+
You can install this version through [Impactor](https://github.com/khcrysalis/Impactor) (recommended), [iloader](https://github.com/nab138/iloader), or an existing standalone [SideStore](https://sidestore.io).
10+
11+
:::note
12+
If you're installing LiveContainer+SideStore on a Windows PC, you need to download [iTunes](https://support.apple.com/en-us/106372) so your sideloader can use the drivers for interacting with Apple devices.
13+
14+
**Connect your device to your computer and trust it before you start**
15+
:::
16+
17+
## Downloads
18+
Please download the LiveContainer + SideStore .ipa file first:
19+
|Stable|Nightly|
20+
|:-:|:-:|
21+
|<a href="https://github.com/LiveContainer/LiveContainer/releases/latest/download/LiveContainer+SideStore.ipa" target="_blank"><img src="https://github.com/CelloSerenity/altdirect/blob/main/assets/png/Download_Blue.png?raw=true" alt="Download .ipa" width="200" /></a>|<a href="https://github.com/LiveContainer/LiveContainer/releases/download/nightly/LiveContainer+SideStore.ipa" target="_blank"><img src="https://github.com/CelloSerenity/altdirect/blob/main/assets/png/Download_Blue.png?raw=true" alt="Download .ipa" width="200" /></a>|
22+
23+
## Method 1: Impactor
24+
[Impactor](https://github.com/khcrysalis/Impactor) (previously known as Plume Impactor) is a cross-platform, modern sideloader developed by [khcrysalis](https://github.com/khcrysali). Impactor is recommended here because it can correctly handle all the entitlements LiveContainer needs.
25+
26+
1. Download the correct version of Impactor from [GitHub](https://github.com/khcrysalis/Impactor/releases/latest) based on your OS and architecture. Note that we're downloading "Impactor", not "plumesign".
27+
2. Install and open Impactor.
28+
3. Make sure your device appears in the top right corner. If not, check the note above or use another USB port/cable.
29+
4. Click the settings (gear) icon, then click "Add Account" to sign in with your Apple ID. For any sign-in issues, please refer to [here](https://docs.sidestore.io/docs/troubleshooting/error-codes) or contact Impactor's developer.
30+
5. Tap the back button.
31+
6. Drag and drop the LiveContainer + SideStore .ipa file into Impactor.
32+
7. Make sure "Only Register Main Bundle" is selected.
33+
8. Click "Install"
34+
9. Go to iOS Settings App -> General -> VPN & Device Management and verify LiveContainer
35+
10. Go to the [Setup after Installing](#setup-after-installing) section to complete LiveContainer and SideStore's setup.
36+
37+
<p>
38+
<img width="300px" src="/img/lc_sidestore/1.jpg" />
39+
<img width="300px" src="/img/lc_sidestore/2.jpg" />
40+
<img width="300px" src="/img/lc_sidestore/3.jpg" />
41+
</p>
42+
43+
## Method 2: iloader
44+
:::note
45+
At the time of writing, iloader cannot correctly handle LiveContainer's entitlements (keychain access groups), so the keychain separation / multiple container feature will not work correctly.
46+
:::
47+
48+
[iloader](https://github.com/nab138/iloader) is a cross-platform, modern Sideloader developed by [nab138](https://github.com/nab138).
49+
50+
You can follow [SideStore's installation guide](https://docs.sidestore.io/docs/installation/install) to install LiveContainer+SideStore. Just click "LiveContainer+SideStore" instead of "SideStore" when selecting the app to sideload.
51+
52+
After installing, go to the [Setup after Installing](#setup-after-installing) section to complete LiveContainer and SideStore's setup.
53+
54+
Alternatively, you can reinstall the LiveContainer+SideStore .ipa file in the built-in SideStore to correct the entitlement issue.
55+
56+
## Method 3: Standalone SideStore
57+
You can also migrate from a standalone LiveContainer and SideStore setup to the LiveContainer + SideStore setup, which saves you one free slot for other apps or another LiveContainer.
58+
59+
You can simply install the LiveContainer + SideStore .ipa file in the standalone SideStore. This works like an upgrade, so all your data will be preserved. When installing, be sure to select "Keep All Extensions (Use Main Profile)". After setting up the built-in SideStore, you can remove the standalone SideStore.
60+
61+
After installing, go to the [Setup after Installing](#setup-after-installing) section to complete LiveContainer and SideStore's setup.
62+
63+
## Setup after Installing
64+
Once LiveContainer+SideStore is installed, you need to import the certificate from SideStore so LiveContainer can also sign apps.
65+
66+
1. Open SideStore using the SideStore button in the top left corner of the "Apps" page.
67+
2. Go to SideStore's settings and log in. If you previously had SideStore installed, you might find yourself already logged in, but since the built-in SideStore cannot retrieve your credentials, please log out and sign in again.
68+
3. Connect to LocalDevVPN, go to "My apps" page and tap "Refresh All"
69+
4. Quit SideStore and open LiveContainer. You can do this by either tapping the "quit" icon in SideStore's Apps page or using the app switcher.
70+
5. Go to LiveContainer's settings, tap "Import Certificate from SideStore", and tap "OK".
71+
6. If the "Import Certificate" button changes to "Remove Certificate", the certificate has been imported. You can check the "JIT-Less Mode Diagnose" page to verify that everything is configured correctly.
72+
73+
<p>
74+
<img height="500px" src="/img/lc_sidestore/4.jpg" />
75+
<img height="500px" src="/img/lc_sidestore/5.jpg" />
76+
<img height="500px" src="/img/lc_sidestore/6.jpg" />
77+
<img height="500px" src="/img/lc_sidestore/7.jpg" />
78+
</p>
79+
80+
## Auto-Refresh Shortcut
81+
You can use the auto-refresh shortcut just like you would with the standalone SideStore—simply replace SideStore's "Refresh All Apps" action with LiveContainer's.

docs/installation.md renamed to docs/installation/standalone.md

Lines changed: 2 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,23 +1,9 @@
11
---
2-
title: Installation
2+
title: Standalone LiveContainer
33
sidebar_position: 1
44
---
55

6-
# Installation
7-
8-
:::warning
9-
**Important Notice Regarding Third-Party Builds of LiveContainer**
10-
11-
We have recently noticed the appearance of certain closed-source third-party builds of LiveContainer. Please be aware that all your apps are installed within LiveContainer, which means these third-party builds **have full access to your data, including sensitive information such as keychain items and login credentials**.
12-
13-
For instance, if you log into YouTube within such a LiveContainer, the third-party build will have complete access to your YouTube (Google) account credentials. Please avoid using these closed-source builds unless you have absolute trust in their developers or are able to personally review the source code and build yourself.
14-
15-
Furthermore, please note that we do not provide any support for issues of these third-party builds.
16-
:::
17-
18-
:::note
19-
It’s recommended to follow the following steps to set up JIT-Less mode for using LiveContainer without JIT. If you encounter any issues, please review [#265](https://github.com/LiveContainer/LiveContainer/issues/265) first before reporting them.
20-
:::
6+
# Standalone LiveContainer
217

228
## Requirements
239

‎sidebars.js‎

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -11,9 +11,12 @@ const sidebars = {
1111
label: 'Introduction',
1212
},
1313
{
14-
type: 'doc',
15-
id: 'installation',
14+
type: 'category',
1615
label: 'Installation',
16+
items: [
17+
'installation/standalone',
18+
'installation/lc_sidestore'
19+
]
1720
},
1821
{
1922
type: 'category',

‎static/img/lc_sidestore/1.jpg‎

49.9 KB
Loading

‎static/img/lc_sidestore/2.jpg‎

59.4 KB
Loading

‎static/img/lc_sidestore/3.jpg‎

108 KB
Loading

‎static/img/lc_sidestore/4.jpg‎

34.5 KB
Loading

‎static/img/lc_sidestore/5.jpg‎

81.3 KB
Loading

‎static/img/lc_sidestore/6.jpg‎

47.5 KB
Loading

0 commit comments

Comments
 (0)