sceutils 0.1.0__py3-none-any.whl

sceutils/util.py

@@ -0,0 +1,72 @@
+import os
+import struct
+import sys
+from importlib import import_module
+from typing import Literal
+
+
+def _make_unpacker(fmt):
+    size = struct.calcsize(fmt)
+    unpacker = struct.Struct(fmt)
+
+    def f(data, off=0):
+        return unpacker.unpack(data[off:off + size])[0]
+    return f
+
+u8 = _make_unpacker("<B")
+u16 = _make_unpacker("<H")
+u32 = _make_unpacker("<I")
+u64 = _make_unpacker("<Q")
+
+u8b = _make_unpacker(">B")
+u16b = _make_unpacker(">H")
+u32b = _make_unpacker(">I")
+u64b = _make_unpacker(">Q")
+
+
+def c_str(data):
+    return data[:data.find(b"\x00")].decode("utf8")
+
+
+
+FSTYPE = [
+    "unknown0",
+    "os0",
+    "unknown2",
+    "unknown3",
+    "vs0_chmod",
+    "unknown5",
+    "unknown6",
+    "unknown7",
+    "pervasive8",
+    "boot_slb2",
+    "vs0",
+    "devkit_cp",
+    "motionC",
+    "bbmc",
+    "unknownE",
+    "motionF",
+    "touch10",
+    "touch11",
+    "syscon12",
+    "syscon13",
+    "pervasive14",
+    "unknown15",
+    "vs0_tarpatch",
+    "sa0",
+    "pd0",
+    "pervasive19",
+    "unknown1A",
+    "psp_emulist",
+]
+
+def make_filename(hdr, filetype, typecount):
+    magic, version, flags, moffs, metaoffs = struct.unpack("<IIIIQ", hdr[0:24])
+    if magic == 0x454353 and version == 3 and flags == 0x30040:
+        meta = hdr[metaoffs:]
+        t = u8(meta, 4)
+        if t < 0x1C:
+            name = f"{FSTYPE[t]}-{typecount[t]:02}.pkg"
+            typecount[t] += 1
+            return name
+    return f"unknown-0x{filetype:x}.pkg"

sceutils-0.1.0.dist-info/METADATA

@@ -0,0 +1,106 @@
+Metadata-Version: 2.4
+Name: sceutils
+Version: 0.1.0
+Summary: Utilities for PlayStation Vita SCE files
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pycryptodomex>=3.23.0
+Dynamic: license-file
+
+sceutils
+========
+
+Utilities for working with PlayStation Vita SCE / SELF / PUP files.
+
+Requirements
+------------
+
+* Python 3.11+
+* pycryptodomex
+
+Installation
+------------
+
+```sh
+pip install .
+```
+
+Usage
+-----
+
+### As a command line tool
+
+```sh
+sceutils --help
+sceutils selfinfo file.self
+sceutils self2elf -i eboot.bin -o eboot.elf -K keys_external.py
+sceutils pup_fiction PSP2UPDATE.pup output keys_external.py
+```
+
+The ARZL helper is also available directly:
+
+```sh
+unarzl kernel_boot_loader.self.seg03 nsbl.bin
+```
+
+### As a library
+
+```python
+from sceutils import self2elf, read_self_info, scedecrypt, unarzl, keys
+
+keys.use_keys("keys_external.py")
+
+with open("eboot.bin", "rb") as inf, open("eboot.elf", "wb") as outf:
+    self2elf(inf, outf)
+
+with open("eboot.bin", "rb") as inf:
+    info = read_self_info(inf)
+
+with open("kernel_boot_loader.self.seg03", "rb") as f:
+    nsbl = unarzl(f.read())
+```
+
+Modules
+-------
+
+pup_fiction
+-----------
+### usage:
+* `sceutils pup_fiction PUP_filename output_folder keys_file`
+
+### examples:
+* `sceutils pup_fiction PSP2UPDATE.pup 368 keys_external.py`
+
+---
+
+self2elf
+--------
+### usage:
+* `sceutils self2elf -i [input self] -o [output elf] -k [RIF file] [-K keys_external.py]`
+* `sceutils self2elf -i [input self] -o [output elf] -z [zRIF]`
+
+### examples:
+* `sceutils self2elf -i eboot.bin -o eboot.elf -z [zRIF here] [-K keys_external.py]`
+* `sceutils self2elf -i eboot.bin -o eboot.elf -k [RIF] [-K keys_external.py]`
+
+---
+
+selfinfo
+--------
+### usage:
+* `sceutils selfinfo [input self] [-K keys_external.py]`
+
+Prints the SCE header, SELF header, app info, control info, ELF headers,
+segment metadata and (when possible) module imports/exports.
+
+---
+
+axfs
+----
+### usage:
+* `sceutils axfs [list|tar] image_name [output_name]`
+
+### examples:
+* `sceutils axfs list fsimage.img`
+* `sceutils axfs tar fsimage.img [fsimage.tar]`

sceutils-0.1.0.dist-info/RECORD

@@ -0,0 +1,31 @@
+sceutils/__init__.py,sha256=95tgh27PQQKCx52_etSIBj3EUNPoOQ7BmFISrGWVMFw,1181
+sceutils/__main__.py,sha256=453MYrq9Lz13S9ykpvmX7TQIbJ7KurkXmcxzF5YVo9Q,1297
+sceutils/axfs.py,sha256=DO8lv6eJgMlClKDCLw7IhmKZ_oplmF85FrWA_G0SxNk,11529
+sceutils/decrypt_cpupdate.py,sha256=foXCVfgmIaqDzGkc-EdaEQ3YLrjmwO9Zv239levWt_s,5389
+sceutils/emmc_extract.py,sha256=IDLuMRgfJF6qACCok3NyZLqIciCxtRPhopx1PdKd6Gg,6853
+sceutils/extract_idstorage.py,sha256=r779X0luAZFieUZc9FxQKqTaXU9EN3PKQZfHysvLiOU,653
+sceutils/find_imported_by.py,sha256=uuDUrmTF2E5doeNo_e-yXmh3XEK-juIzVcbTqI8YxWk,1054
+sceutils/keys.py,sha256=fjgZMibj8XI5gKT_s3Fl-lRhLk5HbFafQVezXZF0V7I,1978
+sceutils/keys_external.py,sha256=PZVYfzcD2RrchQX8KmnxfyDIUTsboyYiX8uOBMJMhXc,7869
+sceutils/keys_internal.py,sha256=UhfPrXJCIMqclNlDCuQfEUuscqKQk_lt7gMP3jpVVMU,2898
+sceutils/keys_proto.py,sha256=0Igh2q5oDiFHpjuQLh4K16rXaSfLyZ8SzJ0orFPY_UI,3417
+sceutils/module_info.py,sha256=HLl2EJ-qwp6HrfG1VLtN-hrfkYKMP7zU-HfZ7WbfXkw,5009
+sceutils/pup_fiction.py,sha256=60AqdDOKfdmrRbsjSC-xdBNm0BgTtNXyCZPGvPj7viA,12722
+sceutils/pup_info.py,sha256=UtEKrtMDY_JllFMW0EJKVqo_ISVx9hN5Jaz5TYcs5u0,2480
+sceutils/scedecrypt.py,sha256=1YlSRIWYWefgvmNZD-mxf9hXwZHq_qCvbbqqVtTBnYo,1715
+sceutils/scetypes.py,sha256=48g7_p7G8RrD72XrW-Evz7zxj1x0g3E_jKqShrj07Aw,18157
+sceutils/sceutils.py,sha256=d4omfaoaNjuK0QZXeoJbgf7slvFMoG8TsXqYL9gkkXA,4065
+sceutils/self2elf.py,sha256=9ivS3Bkbrh5NqR1grB2HQknKy6aocUF1wXqpC2ocLzQ,7914
+sceutils/selfinfo.py,sha256=9XDC0ja-ScbkfzmKenVl4QNhIoYUp_649K5NXp-8GPU,7854
+sceutils/ud0_extract_pup.py,sha256=fMVTL73qDx6JSdXqLxDB3Z7X3YVihXwLoAYPuiaXdao,1220
+sceutils/unpack_bootimage_new.py,sha256=X1yfffCQAdthHThOjuLZVYhR1dtrWM5t0W6QEPKET5o,373
+sceutils/util.py,sha256=7GI3j9UKa2GavIoPp1LznwhXANKak5z_jIX6D9N_lIM,1448
+sceutils-0.1.0.dist-info/licenses/LICENSE,sha256=zDwoivyULWWhRP9c0twkTtTpUhUvMDJgQsvmu83NsDs,1075
+unarzl/__init__.py,sha256=lWihepfw_je_4tibtsap74kAp19_7vYcEx9d2QY2RRc,463
+unarzl/__main__.py,sha256=Pbw4NmAc5D_iP2CJsA7HUZLyyJtozpmGjrdGZUQ1UR4,714
+unarzl/arzl.py,sha256=tui-eEYXBSendN3wnv6VG2FeuEI5UE3epOjcLLUY0sk,16442
+sceutils-0.1.0.dist-info/METADATA,sha256=smejdfJF3VDoI2zQOS2j1scvCewEdv1TR9OyBG4DdSk,2121
+sceutils-0.1.0.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+sceutils-0.1.0.dist-info/entry_points.txt,sha256=sjA2HX7g5F7ELj7mWToESNPQtFw4QbKuU6_eEcuYHw4,82
+sceutils-0.1.0.dist-info/top_level.txt,sha256=uM7-OJkk3iJ2iiyUXmo-RgmfiDPYmJK7lkS9fWCOCy4,16
+sceutils-0.1.0.dist-info/RECORD,,

sceutils-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.2.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

sceutils-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+sceutils = sceutils.__main__:main
+unarzl = unarzl.__main__:main

sceutils-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2018 molecule
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

sceutils-0.1.0.dist-info/top_level.txt

@@ -0,0 +1,2 @@
+sceutils
+unarzl

unarzl/__init__.py

@@ -0,0 +1,25 @@
+from .arzl import (
+    ARZL_MAGIC,
+    ArlzBufferOverflowError,
+    ArlzError,
+    ArlzInvalidDataError,
+    arzl_arm_filter,
+    arzl_decode,
+    arzl_decompress,
+    sce_arlz_arm_filter,
+    sce_arlz_decode,
+    unarzl,
+)
+
+__all__ = [
+    "ARZL_MAGIC",
+    "ArlzError",
+    "ArlzInvalidDataError",
+    "ArlzBufferOverflowError",
+    "arzl_decode",
+    "arzl_decompress",
+    "arzl_arm_filter",
+    "unarzl",
+    "sce_arlz_decode",
+    "sce_arlz_arm_filter",
+]

unarzl/__main__.py

@@ -0,0 +1,29 @@
+import argparse
+import sys
+
+from .arzl import unarzl
+
+
+def main(argv: list[str] | None = None) -> int:
+    parser = argparse.ArgumentParser(
+        prog="unarzl",
+        description="Decompress an ARZL-compressed PlayStation Vita segment.",
+    )
+    parser.add_argument("input", help="input file (or - for stdin)")
+    parser.add_argument("output", help="output file")
+    args = parser.parse_args(argv)
+
+    if args.input == "-":
+        data = sys.stdin.buffer.read()
+    else:
+        with open(args.input, "rb") as f:
+            data = f.read()
+
+    output = unarzl(data)
+    with open(args.output, "wb") as f:
+        f.write(output)
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())