A CLI tool to restore iOS devices on the version they're already on, inspired by the original Succession GUI Application, rewritten from the ground up in Swift.
You must have Theos for this, and if you're not on macOS, you must've installed the swift toolchain for theos before aswell. To generate a deb, run the following:
git clone https://github.com/Serena-io/SuccessorCLI
cd SuccessorCLI
make package
Due to this project using private frameworks, you must be compiling with a patched SDK rather than a normal one.
Open NewTerm2 or SSH Into your device (Preferrably SSH), then run the following command: sudo successorcli
. If you want the rsync restore to be executed, use --restore/-r
.
See below for options that can be used with SuccessorCLI
The follwing options can be used with SuccessorCLI:
-h, --help
Prints the help message then exits
--mnt-point-path /PATH/TO/MOUNT
Specify the directory to where the attached RootfsDMG will be mounted to--ipsw-path /PATH/TO/IPSW
Specify iPSW Which'll be used--dmg-path /PATH/TO/ROOTFSDMG
Specify the rootfsDMG to use--rsync-bin-path /PATH/TO/RSYNC/BIN
Specify the Rsync executable to launch rsync restore with
-
--append-rsync-arg=RSYNC-ARG-TO-APPEND
Specify an additional rsync argument to be passed in to rsync, for example:--append-rsync-arg="--exclude=/some/directory"
will pass in--exclude=/some/directory
to rsync -
--dry-run
Specifies that rsync should run with--dry-run
-
--restore
Do a full restore with rsync. Note that this WILL erase your device.
--restore/-r
must be used if the user wants the restore to be executed.- If -
-mnt-point-path
is not used, then the default Mount Point is set to/var/mnt/successor/
.
The program does work right now, I've tested it multiple times on an iPhone 8 running iOS 14.5, Im just polishing up the project right now.
Note: this project is in beta, im not responsibile for whatever happens to you, your phone, and your cat. Use at your own discretion blah blah you know the bullshit.