GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Sign in
  • ActionsCI/CD and automation
  • CodespacesCloud development environments
  • All Features
  • Documentation
  • Training
  • Certifications
  • Build with Copilot
  • Customize Copilot
  • Integrations
  • Trending repos
  • GitHub Sponsors
  • Developer articles
  • Enterprises

This view

  • Original page
  • New address

GeezerVison is showing github.com — GitHub - Valenced/Shelled: Embeds apps into a container that allows loading external dylibs on jailed devices!

BranchesTags
Open more actions menu
 
 

Latest commit

 

History

870 Commits
870 Commits

Folders and files

NameName
Last commit message
Last commit date
.github
.github
 
 
LaunchAppExtension
LaunchAppExtension
 
 
LiveContainer.xcodeproj
LiveContainer.xcodeproj
 
 
LiveContainer
LiveContainer
 
 
LiveContainerSwiftUI
LiveContainerSwiftUI
 
 
LiveProcess
LiveProcess
 
 
MultitaskSupport
MultitaskSupport
 
 
OpenSSL @ 623c84d
OpenSSL @ 623c84d
 
 
Resources
Resources
 
 
ShareExtension
ShareExtension
 
 
SideStoreSupport
SideStoreSupport
 
 
TestJITLess
TestJITLess
 
 
TweakLoader
TweakLoader
 
 
ZSign
ZSign
 
 
litehook @ 8025e0c
litehook @ 8025e0c
 
 
screenshots
screenshots
 
 
xcconfigs
xcconfigs
 
 
.gitignore
.gitignore
 
 
.gitmodules
.gitmodules
 
 
LICENSE
LICENSE
 
 
README.md
README.md
 
 
entitlements.catalyst.xml
entitlements.catalyst.xml
 
 
entitlements.xml
entitlements.xml
 
 

Repository files navigation

Logo

LiveContainer

An app launcher that runs iOS apps without actually installing them!

Crowdin Project: Crowdin  |   Documentation:liveconainer.github.io

LiveContainer

  • LiveContainer is an app launcher (not emulator or hypervisor) that allows you to run iOS apps inside it.
  • Allows you to install unlimited apps (3 app/10 app id free developer account limit does not apply here) with only one app & app id. You can also have multiple versions of an app installed with multiple data containers.
  • (Below iOS 26) When JIT is available, codesign is entirely bypassed, no need to sign your apps before installing. Otherwise, your app will be signed with the same certificate used by LiveContainer.

Caution

Important Notice Regarding Third-Party Builds of LiveContainer

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.

Furthermore, please note that we do not provide any support for issues of these third-party builds.

Installation

LiveContainer comes with a standalone version and a version with built-in SideStore. Please read the install guide here

If you encounter any issue please read our FAQ here

Standalone

Stable Add AltSource Download .ipa
Nightly Add AltSource Download .ipa

LiveContainer+SideStore

Stable Nightly
Download .ipa Download .ipa

Requirements

  • iOS/iPadOS 15+
    • Multitasking requires iOS/iPadOS 16.0+
  • AltStore 2.0+ / SideStore 0.6.0+

Features & Guides

Installing Apps

  • Open LiveContainer, tap the plus icon in the upper right hand corner and select IPA files to install.
  • Choose the app you want to open in the next launch.
  • You can long-press the app to manage it.

Add Apps to Home Screen

Multiple LiveContainers

Using multiple LiveContainers allows you to run multiples different apps simultaneously, with almost seamless data transfer between the LiveContainers.

Multitasking

You can now launch multiple apps simultaneously in in-app virtual windows. These windows can be resized, scaled, and even displayed using the native Picture-in-Picture (PiP) feature. On iPads, apps can run in native window mode, displaying each app in a separate system window. And if you wish, you can choose to run apps in multitasking mode by default in settings.

To use multitasking, hold its banner and tap "Multitask". You can also make Multitask the default launch mode in settings.

Note

  1. To use multitasking, ensure you select "Keep App Extensions" when installing via SideStore/AltStore.
  2. If you want to enable JIT for multitasked apps, you’ll need a JIT enabler that supports attaching by PID. (StikDebug)

JIT Support

Installing external tweaks

Multiple Containers/External Containers

Hiding Apps

Fix File Picker & Local Notification

Some apps may experience issues with their file pickers or not be able to apply for notification permission in LiveContainer. To resolve this, enable "Fix File Picker" & "Fix Local Notifications" accordingly in the app-specific settings.

"Open In App" Support

  • You can simply share a URL or a file to app simply by using iOS's native share sheet. In share sheet, select LiveContainer, and LiveContainer will ask you which app you'd like to open that URL/file in.
  • What's more, you also can tap the link icon in the top-right corner of the "Apps" tab and input the URL. LiveContainer will detect the appropriate app and ask if you want to launch it.

Compatibility

Unfortunately, not all apps work in LiveContainer, so we have a compatibility list to tell if there is apps that have issues. If they aren't on this list, then it's likely going run. However, if it doesn't work, please make an issue about it.

Building

Open Xcode, edit DEVELOPMENT_TEAM[config=Debug] in xcconfigs/Global.xcconfig to your team id and compile.

Project structure

Main executable

  • Core of LiveContainer
  • Contains the logic of setting up guest environment and loading guest app.
  • If no app is selected, it loads LiveContainerSwiftUI.

LiveContainerSwiftUI

  • SwiftUI rewrite of LiveContainerUI (by @hugeBlack)
  • Language file Localizable.xcstrings is in here for multilingual support. To help us translate LiveContainer, please visit our crowdin project

MultitaskSupport

  • Contains the implementation of multitasking feature.
  • Based on FrontBoardAppLauncher

SideStore

  • Supporting code for SideStore's app refreshing integration

TweakLoader

  • A simple tweak injector, which loads CydiaSubstrate and loads tweaks.
  • Injected to every app you install in LiveContainer.

ZSign

  • The app signer shipped with LiveContainer.
  • Originally made by zhlynn.
  • LiveContainer uses Feather's version of ZSign modified by khcrysalis.
  • Changes are made to meet LiveContainer's needs.

How does it work?

Patching guest executable

  • Patch __PAGEZERO segment:
    • Change vmaddr to 0xFFFFC000 (0x100000000 - 0x4000)
    • Change vmsize to 0x4000
  • Change MH_EXECUTE to MH_DYLIB.
  • Inject a load command to load TweakLoader.dylib

Patching @executable_path

  • Hook dyld4::APIs::_NSGetExecutablePath
  • Call _NSGetExecutablePath
  • Replace config.process.mainExecutablePath
    • Calculate address of config.process.mainExecutablePath using dyld4::APIs instance (passed as first parameter)
    • Use builtin_vm_protect or TPRO unlock to make it writable
    • Replace the address with one we have control of
  • Put the original dyld4::APIs::_NSGetExecutablePath back

Old Method

  • Call _NSGetExecutablePath with an invalid buffer pointer input -> SIGSEGV
  • Do some magic stuff to overwrite the contents of executable_path.

Patching NSBundle.mainBundle

  • This property is overwritten with the guest app's bundle.

Bypassing Library Validation

  • JIT is optional to bypass codesigning. In JIT-less mode, all executables are signed so this does not apply.
  • Derived from Restoring Dyld Memory Loading

dlopening the executable

  • Call dlopen with the guest app's executable
  • TweakLoader loads all tweaks in the selected folder
  • Find the entry point
  • Jump to the entry point
  • The guest app's entry point calls UIApplicationMain and start up like any other iOS apps.

Multi-Account support & Keychain Semi-Separation

128 keychain access groups are created and LiveContainer allocates them randomly to each container of the same app. So you can create 128 container with different keychain access groups.

Limitations

  • Entitlements from the guest app are not applied to the host app. This isn't a big deal since sideloaded apps requires only basic entitlements.
  • App Permissions are globally applied.
  • Guest app containers are not sandboxed. This means one guest app can access other guest apps' data.
  • App extensions aren't supported. they cannot be registered because: LiveContainer is sandboxed, SpringBoard doesn't know what apps are installed in LiveContainer, and they take up App ID.
  • Multitasking can be achieved by using multiple LiveContainer and the multitasking feature. However, while we were able to fix physical keyboard input issue on iPadOS (LiveContainer#524), iPhone Mirroring uses different checks which still broke it (LiveContainer#793).
  • Remote push notification will not work
  • Querying custom URL schemes might not work(?)

TODO

  • Use ChOma instead of custom MachO parser

License

GNU Affero General Public License v3.0

Credits

  • xpn's blogpost: Restoring Dyld Memory Loading
  • LinusHenze's CFastFind: MIT license
  • litehook: MIT license
  • @haxi0 & @m1337v for icon
  • @Vishram1123 for the initial shortcut implementation.
  • @hugeBlack for SwiftUI contribution
  • @Staubgeborener for automatic AltStore/SideStore source updater
  • @fkunn1326 for improved app hiding
  • @slds1 for dynamic color feature
  • @Vishram1123 for iOS 26+ JIT Script Support
  • @StephenDev0 for AltStore source support

About

Embeds apps into a container that allows loading external dylibs on jailed devices!

Resources

Readme
License
Activity
Custom properties

Stars

2 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

Packages

Contributors

Languages

You are visitor 01402520 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.