@@ -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
1873appdecrypt is a tool to make decrypt application encrypted binaries on macOS when SIP-enabled.
1974
2075Examples:
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
2381USAGE: appdecrypt encryptMachO_Path decryptMachO_Path
2482
2583ARGUMENTS:
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
2987OPTIONS:
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
34113This was discovered independently when analyzing kernel sources, but it appears that the technique was first introduced on iOS :
35114
0 commit comments