Skip to content

Commit 4fa535c

Browse files
authored
Update README.md
1 parent 82c0ee0 commit 4fa535c

File tree

1 file changed

+83
-4
lines changed

1 file changed

+83
-4
lines changed

README.md

Lines changed: 83 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -6,30 +6,109 @@ This works well and compiles for iOS nicely, if you want use it at iOS devices,
66

77
## How to use
88

9+
### On mac with M1 CPU
10+
911
```bash
1012
> git clone https://github.com/paradiseduo/appdecrypt.git
1113
> cd appdecrypt
1214
> chmod +x build-macOS_arm.sh
1315
> ./build-macOS_arm.sh
1416
> cd .build/release
1517
> ./appdecrypt
16-
Version 1.0
18+
Version 2.0
19+
20+
appdecrypt is a tool to make decrypt application encrypted binaries on macOS when SIP-enabled.
21+
22+
Examples:
23+
mac:
24+
appdecrypt /Applicaiton/Test.app /Users/admin/Desktop/Test.app
25+
iPhone:
26+
appdecrypt /var/containers/Bundle/Application/XXXXXX /tmp
27+
28+
USAGE: appdecrypt encryptMachO_Path decryptMachO_Path
29+
30+
ARGUMENTS:
31+
<encryptApp_Path> The encrypt app file path.
32+
<decrypt_Path> The path output file.
33+
34+
OPTIONS:
35+
-h, --help Show help information.
36+
```
37+
38+
#### For Example
39+
40+
```bash
41+
> ./appdecrypt /Applicaiton/Test.app /Users/admin/Desktop/Test.app
42+
Success to copy file.
43+
Dump /Applications/Test.app/Wrapper/Test.app/Test Success
44+
Dump /Applications/Test.app/Wrapper/Test.app/PlugIns/TestNotificationService.appex/TestNotificationService Success
45+
Dump /Applications/Test.app/Wrapper/Test.app/Frameworks/trackerSDK.framework/trackerSDK Success
46+
Dump /Applications/Test.app/Wrapper/Test.app/Frameworks/AgoraRtcKit.framework/AgoraRtcKit Success
47+
> cd /Users/admin/Desktop/Test.app
48+
> ls
49+
WrappedBundle Wrapper
50+
> cd Wrapper
51+
> ls
52+
BundleMetadata.plist Test.app iTunesMetadata.plist
53+
```
54+
55+
### On Jailbreak iPhone with arm64 CPU
56+
57+
First you should connect jailbreak iPhone with USB.
58+
```bash
59+
> git clone https://github.com/paradiseduo/appdecrypt.git
60+
> cd appdecrypt
61+
> chmod +x build-iOS.sh
62+
> ./build-iOS.sh
63+
> scp -P 2222 global.xml root@127.0.0.1:/tmp
64+
> cd .build/release
65+
> scp -P 2222 appdecrypt root@127.0.0.1:/tmp
66+
67+
// In iPhone shell
68+
> cd /tmp
69+
> ldid -Sglobal.xml appdecrypt
70+
> ./appdecrypt
71+
Version 2.0
1772

1873
appdecrypt is a tool to make decrypt application encrypted binaries on macOS when SIP-enabled.
1974

2075
Examples:
21-
appdecrypt /Applicaiton/Test.app/Wrapper/Test.app/Test /Users/admin/Desktop/Test
76+
mac:
77+
appdecrypt /Applicaiton/Test.app /Users/admin/Desktop/Test.app
78+
iPhone:
79+
appdecrypt /var/containers/Bundle/Application/XXXXXX /tmp
2280

2381
USAGE: appdecrypt encryptMachO_Path decryptMachO_Path
2482

2583
ARGUMENTS:
26-
<encryptMachO_Path> The encrypt machO file path.
27-
<decryptMachO_Path> The path output decrypt machO file.
84+
<encryptApp_Path> The encrypt app file path.
85+
<decrypt_Path> The path output file.
2886

2987
OPTIONS:
3088
-h, --help Show help information.
3189
```
3290

91+
#### For Example
92+
```bash
93+
> ./appdecrypt /var/containers/Bundle/Application/23E4B0B4-7275-46CE-8EEA-18CADE61FDB8 /tmp
94+
Success to copy file.
95+
Dump /var/containers/Bundle/Application/23E4B0B4-7275-46CE-8EEA-18CADE61FDB8/Aweme.app/Aweme Success
96+
Dump /var/containers/Bundle/Application/23E4B0B4-7275-46CE-8EEA-18CADE61FDB8/Aweme.app/PlugIns/AwemeDYShareExtension.appex/AwemeDYShareExtension Success
97+
Dump /var/containers/Bundle/Application/23E4B0B4-7275-46CE-8EEA-18CADE61FDB8/Aweme.app/PlugIns/AwemeNotificationService.appex/AwemeNotificationService Success
98+
Dump /var/containers/Bundle/Application/23E4B0B4-7275-46CE-8EEA-18CADE61FDB8/Aweme.app/PlugIns/AwemeWidgetExtension.appex/AwemeWidgetExtension Success
99+
Dump /var/containers/Bundle/Application/23E4B0B4-7275-46CE-8EEA-18CADE61FDB8/Aweme.app/PlugIns/AWEVideoWidget.appex/AWEVideoWidget Success
100+
Dump /var/containers/Bundle/Application/23E4B0B4-7275-46CE-8EEA-18CADE61FDB8/Aweme.app/PlugIns/AwemeBroadcastExtension.appex/AwemeBroadcastExtension Success
101+
Dump /var/containers/Bundle/Application/23E4B0B4-7275-46CE-8EEA-18CADE61FDB8/Aweme.app/PlugIns/AWEFriendsWidgets.appex/AWEFriendsWidgets Success
102+
Dump /var/containers/Bundle/Application/23E4B0B4-7275-46CE-8EEA-18CADE61FDB8/Aweme.app/PlugIns/AwemeVideoNotification.appex/AwemeVideoNotification Success
103+
Dump /var/containers/Bundle/Application/23E4B0B4-7275-46CE-8EEA-18CADE61FDB8/Aweme.app/Frameworks/ByteRtcEngineKit.framework/ByteRtcEngineKit Success
104+
Dump /var/containers/Bundle/Application/23E4B0B4-7275-46CE-8EEA-18CADE61FDB8/Aweme.app/Frameworks/byteaudio.framework/byteaudio Success
105+
> ls
106+
Payload/
107+
> cd Payload
108+
> ls
109+
Aweme.app/ BundleMetadata.plist iTunesMetadata.plist
110+
```
111+
33112
## Principle
34113
This was discovered independently when analyzing kernel sources, but it appears that the technique was first introduced on iOS :
35114

0 commit comments

Comments
 (0)