16 Commits
v1.3 ... dev

Author SHA1 Message Date
zx
740d3716dc chore: start satisfying Designated Requirement
the ipas are now more demure

this shouldnt break nor add anything i mean
2025-03-18 19:00:40 -04:00
zx
5ce7a0cb43 fix: unchecked @loader_path dependency
fuck this
2025-02-17 08:22:13 -05:00
zx
04a40f2aa6 chore: bump version to v1.4.4 2025-02-15 09:15:23 -05:00
zx
6845281446 fix: unchecked /usr/lib dependencies
idk why i didnt do this before. either im stupid or there was a reason so im just praying this doesnt break anything rn
2025-02-15 09:14:55 -05:00
zx
54da4485a5 chore: change contact email 2025-02-01 21:52:05 -05:00
zx
f7b0169ee9 chore: bump version to v1.4.3 2025-02-01 21:39:41 -05:00
zx
ffbff5c78d feat: use multiple cyans 2025-02-01 21:38:15 -05:00
zx
eba32c22e6 chore: bump version to v1.4.2 (stable) 2025-01-08 19:10:32 -05:00
zx
a96632f1b0 chore: ignore DS_Store
macos moment
2025-01-08 19:06:52 -05:00
zx
86e45cc186 feat(cgen): plist and entitlement merging 2024-11-26 22:21:13 -05:00
zx
e09351287b feat: plist merging 2024-11-26 22:07:22 -05:00
zx
403e5d65a5 chore: bump version to v1.4.1 2024-11-07 22:32:58 -05:00
zx
354a1d9ac5 fix: not auto-injecting already fixed dependency names
whoops
2024-11-07 22:31:43 -05:00
zx
73d1495eff chore: bump version to v1.4 (stable) 2024-11-02 10:43:45 -04:00
zx
31169d6c65 refactor: move orion check out of loop 2024-11-02 10:42:47 -04:00
zx
0808fd8c1b feat: manually modified dylib support (#6) 2024-10-31 14:35:22 -04:00
12 changed files with 167 additions and 59 deletions

6
.gitignore vendored
View File

@@ -3,3 +3,9 @@ __pycache__/
build/ build/
*.egg-info/ *.egg-info/
*.cyan
.DS_Store
*.ipa
*.app/

View File

@@ -2,6 +2,8 @@
a rewrite of [pyzule](https://github.com/asdfzxcvbn/pyzule) that doesn't (completely) suck !! a rewrite of [pyzule](https://github.com/asdfzxcvbn/pyzule) that doesn't (completely) suck !!
wouldn't a go rewrite be really cool? (or in rust or something, adding features to this makes me realize PYTHONM FUCKING SUCKS SOMEONE PLEASE REWRITE IN LIKE ANY COMPILED AND STATICALLY TYPED LANGUAGE PLEASE!!!!!!!
## features ## features
you can open an issue to request a feature :D !! also see my [recommended flags](https://github.com/asdfzxcvbn/pyzule-rw/wiki/recommended-flags) you can open an issue to request a feature :D !! also see my [recommended flags](https://github.com/asdfzxcvbn/pyzule-rw/wiki/recommended-flags)
@@ -15,6 +17,7 @@ you can open an issue to request a feature :D !! also see my [recommended flags]
- remove watch app - remove watch app
- change the app icon - change the app icon
- fakesign the output ipa/tipa/app - fakesign the output ipa/tipa/app
- merge a plist into the app's existing Info.plist
- add custom entitlements to the main executable - add custom entitlements to the main executable
- thin all binaries to arm64, it can LARGELY reduce app size sometimes! - thin all binaries to arm64, it can LARGELY reduce app size sometimes!
- remove all app extensions (or just encrypted ones!) - remove all app extensions (or just encrypted ones!)

View File

@@ -42,6 +42,14 @@ def main() -> None:
"-k", metavar="icon", "-k", metavar="icon",
help="modify the app's icon" help="modify the app's icon"
) )
parser.add_argument(
"-l", metavar="plist",
help="a plist to merge with the app's Info.plist"
)
parser.add_argument(
"-x", metavar="entitlements",
help="add or modify entitlements to the main binary"
)
parser.add_argument( parser.add_argument(
"-u", "--remove-supported-devices", action="store_true", "-u", "--remove-supported-devices", action="store_true",
@@ -83,6 +91,10 @@ def generate_cyan(parser: argparse.ArgumentParser) -> None:
parser.error(f"invalid minimum OS version: {args.m}") parser.error(f"invalid minimum OS version: {args.m}")
if args.k is not None and not os.path.isfile(args.k): if args.k is not None and not os.path.isfile(args.k):
parser.error(f"{args.k} does not exist") parser.error(f"{args.k} does not exist")
if args.l is not None and not os.path.isfile(args.l):
parser.error(f"{args.l} does not exist")
if args.x is not None and not os.path.isfile(args.x):
parser.error(f"{args.x} does not exist")
if args.f is not None: if args.f is not None:
fake = [f for f in args.f if not os.path.exists(f)] fake = [f for f in args.f if not os.path.exists(f)]
@@ -107,7 +119,7 @@ def generate_cyan(parser: argparse.ArgumentParser) -> None:
real_args = {k: v for k, v in dict(vars(args)).items() if v} real_args = {k: v for k, v in dict(vars(args)).items() if v}
del real_args["output"] del real_args["output"]
for key in "fk": # these need files for key in "fkxl": # these need files
if key in real_args: if key in real_args:
real_args[key] = True real_args[key] = True
@@ -136,6 +148,12 @@ def generate_cyan(parser: argparse.ArgumentParser) -> None:
if args.k is not None: if args.k is not None:
zf.write(args.k, "icon.idk") zf.write(args.k, "icon.idk")
if args.l:
zf.write(args.l, "merge.plist")
if args.x:
zf.write(args.x, "new.entitlements")
if __name__ == "__main__": if __name__ == "__main__":
main() main()

View File

@@ -21,15 +21,16 @@ def main() -> None:
"-o", "--output", metavar="output", "-o", "--output", metavar="output",
help="if unspecified, overwrites input" help="if unspecified, overwrites input"
) )
parser.add_argument(
"-z", "--cyan", metavar="cyan",
help="the .cyan file to use"
)
parser.add_argument(
"-z", "--cyan", metavar="cyan", nargs="+",
help="the .cyan file(s) to use"
)
parser.add_argument( parser.add_argument(
"-f", metavar="file", nargs="+", "-f", metavar="file", nargs="+",
help="a tweak to inject/item to be added to the bundle" help="a tweak to inject/item to be added to the bundle"
) )
parser.add_argument( parser.add_argument(
"-n", metavar="name", "-n", metavar="name",
help="modify the app's name" help="modify the app's name"
@@ -50,6 +51,10 @@ def main() -> None:
"-k", metavar="icon", "-k", metavar="icon",
help="modify the app's icon" help="modify the app's icon"
) )
parser.add_argument(
"-l", metavar="plist",
help="a plist to merge with the app's Info.plist"
)
parser.add_argument( parser.add_argument(
"-x", metavar="entitlements", "-x", metavar="entitlements",
help="add or modify entitlements to the main binary" help="add or modify entitlements to the main binary"
@@ -99,7 +104,7 @@ def main() -> None:
) )
parser.add_argument( parser.add_argument(
"--version", action="version", version="cyan v1.3" "--version", action="version", version="cyan v1.4.4"
) )
from cyan import logic from cyan import logic

Binary file not shown.

View File

@@ -45,7 +45,7 @@ def main(parser: ArgumentParser) -> None:
if args.cyan is not None: if args.cyan is not None:
changing = vars(args) changing = vars(args)
tbhutils.parse_cyan(changing, tmpdir) tbhutils.parse_cyans(changing, tmpdir)
# this goes before injection, # this goes before injection,
# since user might inject their own extensions # since user might inject their own extensions
@@ -66,6 +66,8 @@ def main(parser: ArgumentParser) -> None:
app.plist.change_minimum_version(args.m) app.plist.change_minimum_version(args.m)
if args.k is not None: if args.k is not None:
app.change_icon(args.k, tmpdir) app.change_icon(args.k, tmpdir)
if args.l is not None:
app.plist.merge_plist(args.l)
if args.x is not None: if args.x is not None:
app.executable.merge_entitlements(args.x) app.executable.merge_entitlements(args.x)

View File

@@ -105,7 +105,7 @@ class AppBundle:
def change_icon(self, path: str, tmpdir: str) -> None: def change_icon(self, path: str, tmpdir: str) -> None:
try: try:
from PIL import Image from PIL import Image # type: ignore
except Exception: except Exception:
return print("[?] pillow is not installed, -k is not available") return print("[?] pillow is not installed, -k is not available")

View File

@@ -13,17 +13,35 @@ class Executable:
otool = f"{specific}/otool" otool = f"{specific}/otool"
idylib = f"{specific}/insert_dylib" idylib = f"{specific}/insert_dylib"
starters = ("\t/Library/", "\t@rpath", "\t@executable_path") # adding /usr/lib/ now, idk why i didnt before. lets hope nothing breaks
common = { ## LITERALLY 2 DAYS LATER. WHAT THE FUCK IS @LOADER_PATH HELP
# substrate could show up as ## i will cry if only checking for '@' will break this.
# CydiaSubstrate.framework, libsubstrate.dylib, EVEN CydiaSubstrate.dylib starters = ("\t/Library/", "\t/usr/lib/", "\t@")
# AND PROBABLY EVEN MORE !!!! IT'S CRAZY.
"CydiaSubstrate.framework": "CydiaSubstrate.framework", # substrate could show up as
"Orion.framework": "Orion.framework", # CydiaSubstrate.framework, libsubstrate.dylib, EVEN CydiaSubstrate.dylib
"Cephei.framework": "Cephei.framework", # AND PROBABLY EVEN MORE !!!! IT'S CRAZY.
"CepheiUI.framework": "CepheiUI.framework", common = {
"CepheiPrefs.framework": "CepheiPrefs.framework" "substrate.": {
"name": "CydiaSubstrate.framework",
"path": "@rpath/CydiaSubstrate.framework/CydiaSubstrate"
},
"orion.": {
"name": "Orion.framework",
"path": "@rpath/Orion.framework/Orion"
},
"cephei.": {
"name": "Cephei.framework",
"path": "@rpath/Cephei.framework/Cephei"
},
"cepheiui.": {
"name": "CepheiUI.framework",
"path": "@rpath/CepheiUI.framework/CepheiUI"
},
"cepheiprefs.": {
"name": "CepheiPrefs.framework",
"path": "@rpath/CepheiPrefs.framework/CepheiPrefs"
}
} }
def __init__(self, path: str): def __init__(self, path: str):
@@ -64,14 +82,29 @@ class Executable:
stderr=subprocess.DEVNULL stderr=subprocess.DEVNULL
) )
def fix_dependencies(self, tweaks: dict[str, str], need: set[str]) -> None: def fix_common_dependencies(self, needed: set[str]) -> None:
self.remove_signature() self.remove_signature()
for dep in self.get_dependencies(): for dep in self.get_dependencies():
for cname in (tweaks | self.common): for common, info in self.common.items():
if common in dep.lower():
needed.add(common)
if dep != info["path"]:
self.change_dependency(dep, info["path"])
print(
f"[*] fixed common dependency in {self.bn}: "
f"{dep} -> {info['path']}"
)
def fix_dependencies(self, tweaks: dict[str, str]) -> None:
for dep in self.get_dependencies():
for cname in tweaks:
if cname in dep: if cname in dep:
# i wonder if there's a better way to do this? # i wonder if there's a better way to do this?
if cname.endswith(".framework"): if cname.endswith(".framework"):
# nah, not gonna parse the plist,
# i've never seen a framework with a "mismatched" name
npath = f"@rpath/{cname}/{cname[:-10]}" npath = f"@rpath/{cname}/{cname[:-10]}"
else: else:
npath = f"@rpath/{cname}" npath = f"@rpath/{cname}"
@@ -80,9 +113,6 @@ class Executable:
self.change_dependency(dep, npath) self.change_dependency(dep, npath)
print(f"[*] fixed dependency in {self.bn}: {dep} -> {npath}") print(f"[*] fixed dependency in {self.bn}: {dep} -> {npath}")
if cname in self.common:
need.add(cname)
def get_dependencies(self) -> list[str]: def get_dependencies(self) -> list[str]:
proc = subprocess.run( proc = subprocess.run(
[self.otool, "-L", self.path], [self.otool, "-L", self.path],

View File

@@ -5,7 +5,7 @@ import subprocess
from typing import Optional from typing import Optional
try: try:
import lief import lief # type: ignore
except Exception: except Exception:
pass pass
@@ -58,14 +58,22 @@ class MainExecutable(Executable):
os.chdir(cwd) # i fucking hate jailbroken iOS utils. os.chdir(cwd) # i fucking hate jailbroken iOS utils.
needed: set[str] = set() needed: set[str] = set()
# inject/fix user things
for bn, path in tweaks.items(): for bn, path in tweaks.items():
if os.path.islink(path):
continue # symlinks can potentially have some security implications
if bn.endswith(".appex"): if bn.endswith(".appex"):
fpath = f"{PLUGINS_DIR}/{bn}" fpath = f"{PLUGINS_DIR}/{bn}"
existed = tbhutils.delete_if_exists(fpath, bn) existed = tbhutils.delete_if_exists(fpath, bn)
shutil.copytree(path, fpath) shutil.copytree(path, fpath)
elif bn.endswith(".dylib"): elif bn.endswith(".dylib"):
path = shutil.copy2(path, tmpdir) path = shutil.copy2(path, tmpdir)
Executable(path).fix_dependencies(tweaks, needed)
e = Executable(path)
e.fix_common_dependencies(needed)
e.fix_dependencies(tweaks)
fpath = f"{FRAMEWORKS_DIR}/{bn}" fpath = f"{FRAMEWORKS_DIR}/{bn}"
existed = tbhutils.delete_if_exists(fpath, bn) existed = tbhutils.delete_if_exists(fpath, bn)
@@ -89,11 +97,13 @@ class MainExecutable(Executable):
# orion has a *weak* dependency to substrate, # orion has a *weak* dependency to substrate,
# but will still crash without it. nice !!!!!!!!!!! # but will still crash without it. nice !!!!!!!!!!!
if "Orion.framework" in needed: ## edit: actually, maybe this is in case someone uses Internal backend?
needed.add("CydiaSubstrate.framework") ## someone test it pls!!!
if "orion." in needed:
needed.add("substrate.")
for missing in needed: for missing in needed:
real = self.common[missing] # "real" name, thanks substrate! real = self.common[missing]["name"] # e.g. "Orion.framework"
ip = f"{FRAMEWORKS_DIR}/{real}" ip = f"{FRAMEWORKS_DIR}/{real}"
existed = tbhutils.delete_if_exists(ip, real) existed = tbhutils.delete_if_exists(ip, real)
shutil.copytree(f"{self.install_dir}/extras/{real}", ip) shutil.copytree(f"{self.install_dir}/extras/{real}", ip)
@@ -127,9 +137,12 @@ class MainExecutable(Executable):
print("[!] failed to merge new entitlements, are they valid?") print("[!] failed to merge new entitlements, are they valid?")
def sign_with_entitlements(self, entitlements: str) -> bool: def sign_with_entitlements(self, entitlements: str) -> bool:
return subprocess.run( return subprocess.run([
[self.ldid, f"-S{entitlements}", "-M", "-Cadhoc", self.path] self.ldid,
).returncode == 0 f"-S{entitlements}", "-M", "-Cadhoc",
f"-Q{self.install_dir}/extras/zero.requirements",
self.path
]).returncode == 0
def lief_inject(self, cmd: str) -> None: def lief_inject(self, cmd: str) -> None:
if self.inj is None: # type: ignore if self.inj is None: # type: ignore

View File

@@ -10,11 +10,13 @@ class Plist:
try: try:
with open(path, "rb") as f: with open(path, "rb") as f:
self.data: dict[str, Any] = plistlib.load(f) self.data: dict[str, Any] = plistlib.load(f)
self.success = True
except Exception: except Exception:
if throw: if throw:
sys.exit(f"[!] couldn't read {path}") sys.exit(f"[!] couldn't read {path}")
else:
return None self.success = False
self.path = path self.path = path
self.app_path = app_path self.app_path = app_path
@@ -44,7 +46,7 @@ class Plist:
try: try:
if all(self[key] == val for key in keys): if all(self[key] == val for key in keys):
return False return False
raise KeyError # lets pretend this was always here.. raise KeyError
except KeyError: except KeyError:
for key in keys: for key in keys:
self[key] = val self[key] = val
@@ -121,3 +123,18 @@ class Plist:
else: else:
print(f"[?] minimum version was already \"{minimum}\"") print(f"[?] minimum version was already \"{minimum}\"")
def merge_plist(self, path: str) -> None:
pl = Plist(path, throw=False)
if not pl.success:
return print(f"[!] couldn't parse {path}")
changed = False
for k, v in pl.data.items():
if self.change(v, k):
changed = True
if not changed:
print("[?] no modified plist entries")
else:
print("[*] set plist keys:", ", ".join(pl.data))

View File

@@ -67,8 +67,13 @@ def validate_inputs(args: Namespace) -> Optional[str]:
if args.k is not None and not os.path.isfile(args.k): if args.k is not None and not os.path.isfile(args.k):
sys.exit(f"[!] {args.k} does not exist") sys.exit(f"[!] {args.k} does not exist")
if args.cyan is not None and not os.path.isfile(args.cyan): if args.l is not None and not os.path.isfile(args.l):
sys.exit(f"[!] {args.cyan} does not exist") sys.exit(f"[!] {args.l} does not exist")
if args.cyan is not None:
for cyan in args.cyan:
if not os.path.isfile(cyan):
sys.exit(f"[!] {cyan} does not exist")
if args.x is not None: if args.x is not None:
if not os.path.isfile(args.x): if not os.path.isfile(args.x):
@@ -186,7 +191,7 @@ def extract_deb(deb: str, tweaks: dict[str, str], tmpdir: str) -> None:
glob(f"{t2}/**/*.framework", recursive=True) glob(f"{t2}/**/*.framework", recursive=True)
), []): # type: ignore ), []): # type: ignore
if ( if (
os.path.islink(hi) # symlinks are broken iirc os.path.islink(hi) # symlinks are broken iirc, also for security
or hi.count(".bundle") > 1 # prevent sub-bundle detection (rip) or hi.count(".bundle") > 1 # prevent sub-bundle detection (rip)
or hi.count(".framework") > 1 or hi.count(".framework") > 1
): ):
@@ -229,28 +234,37 @@ def make_ipa(tmpdir: str, output: str, level: int) -> None:
print(f"[?] was unable to zip {weird} file(s) due to timestamps") print(f"[?] was unable to zip {weird} file(s) due to timestamps")
def parse_cyan(args: dict[str, Any], tmpdir: str) -> None: def parse_cyans(args: dict[str, Any], tmpdir: str) -> None:
print("[*] parsing .cyan file..") for ind, cyan in enumerate(args["cyan"]):
with zipfile.ZipFile(args["cyan"]) as zf: print(f"[*] parsing {os.path.basename(cyan)} ..")
DOT_PATH = f"{tmpdir}/cyan"
os.mkdir(DOT_PATH)
with zf.open("config.json") as f: with zipfile.ZipFile(cyan) as zf:
config = json.load(f) DOT_PATH = f"{tmpdir}/cyan-{ind}"
os.mkdir(DOT_PATH)
if "f" in config: with zf.open("config.json") as f:
NAMES = [n for n in zf.namelist() if n.startswith("inject/")] config = json.load(f)
zf.extractall(DOT_PATH, NAMES)
# ensure not None if "f" in config:
args["f"] = args["f"] if args["f"] is not None else {} NAMES = [n for n in zf.namelist() if n.startswith("inject/")]
for e in os.scandir(f"{DOT_PATH}/inject"): zf.extractall(DOT_PATH, NAMES)
args["f"][e.name] = e.path
del config["f"]
if "k" in config:
args["k"] = zf.extract("icon.idk", DOT_PATH)
del config["k"]
for k, v in config.items(): # ensure not None
args[k] = v args["f"] = args["f"] if args["f"] is not None else {}
for e in os.scandir(f"{DOT_PATH}/inject"):
args["f"][e.name] = e.path
del config["f"]
if "k" in config:
args["k"] = zf.extract("icon.idk", DOT_PATH)
del config["k"]
if "l" in config:
args["l"] = zf.extract("merge.plist", DOT_PATH)
del config["l"]
if "x" in config:
args["x"] = zf.extract("new.entitlements", DOT_PATH)
del config["x"]
# the rest of the config (not the ones above, we `del` them)
for k, v in config.items():
args[k] = v

View File

@@ -4,10 +4,10 @@ from setuptools import setup
setup( setup(
name="cyan", name="cyan",
version="1.3", version="1.4.4",
description="finally, pyzule doesn't suck", description="finally, pyzule doesn't suck",
author="zx", author="zx",
author_email="zx@hrzn.email", author_email="z@zxcvbn.fyi",
packages=["cyan", "cyan.tbhtypes", "cgen"], packages=["cyan", "cyan.tbhtypes", "cgen"],
python_requires=">=3.9", python_requires=">=3.9",
include_package_data=True, include_package_data=True,