iphonetool 0.1.2__tar.gz → 0.2.0__tar.gz

{iphonetool-0.1.2 → iphonetool-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: iphonetool
-Version: 0.1.2
+Version: 0.2.0
 Summary: All of the modern iOS tools. Unified
 Author: Jacob Freeman
 Author-email: Jacob Freeman <t00niyf5@duck.com>
@@ -44,6 +44,13 @@ or from the mirror:
 
 `uv tool install https://github.com/Jacoblightning/iphonetool.git`
 
+## Prerequisites
+
+> [!IMPORTANT]  
+> When you clone [https://github.com/yhavry/remote_boot](https://github.com/yhavry/remote_boot), make sure you switch to the `d421-a12-a13-postpwned-prep` branch!
+
+Before you can run linux (or remote boot) on a phone, you must run `iphonetool-linuxprep` with a path to `remoteboot.sh`, which is located in [https://github.com/yhavry/remote_boot](https://github.com/yhavry/remote_boot)
+
 ## Usage
 
 - Run `iphonetool.py info` to give info on connected devices
@@ -54,7 +61,7 @@ or from the mirror:
 - `palera1n --dfuhelper`
 - `palera1n --exit-recovery`
 - `ideviceenterrecovery`
-- `remote_boot'ing linux`
+- `remote_booting linux`
 - `usbliter8ctl`
 
 ## License

{iphonetool-0.1.2 → iphonetool-0.2.0}/README.md

@@ -29,6 +29,13 @@ or from the mirror:
 
 `uv tool install https://github.com/Jacoblightning/iphonetool.git`
 
+## Prerequisites
+
+> [!IMPORTANT]  
+> When you clone [https://github.com/yhavry/remote_boot](https://github.com/yhavry/remote_boot), make sure you switch to the `d421-a12-a13-postpwned-prep` branch!
+
+Before you can run linux (or remote boot) on a phone, you must run `iphonetool-linuxprep` with a path to `remoteboot.sh`, which is located in [https://github.com/yhavry/remote_boot](https://github.com/yhavry/remote_boot)
+
 ## Usage
 
 - Run `iphonetool.py info` to give info on connected devices
@@ -39,7 +46,7 @@ or from the mirror:
 - `palera1n --dfuhelper`
 - `palera1n --exit-recovery`
 - `ideviceenterrecovery`
-- `remote_boot'ing linux`
+- `remote_booting linux`
 - `usbliter8ctl`
 
 ## License

{iphonetool-0.1.2 → iphonetool-0.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "iphonetool"
-version = "0.1.2"
+version = "0.2.0"
 authors = [
 	{ name="Jacob Freeman", email="t00niyf5@duck.com" },
 ]
@@ -24,6 +24,7 @@ build-backend = "uv_build"
 
 [project.scripts]
 iphonetool = "iphonetool.__main__:runmain"
+iphonetool-linuxprep = "iphonetool.dfu:linux_prep"
 
 [dependency-groups]
 dev = [

{iphonetool-0.1.2 → iphonetool-0.2.0}/src/iphonetool/dfu.py

@@ -12,8 +12,19 @@ from typing import Any, Optional
 
 import usb.core
 
-from . import config
-from . import helpers
+try:
+    from . import config
+    from . import helpers
+except ImportError:
+    try:
+        import config
+        import helpers
+    except ImportError:
+        try:
+            from iphonetool import config
+            from iphonetool import helpers
+        except ImportError:
+            raise ImportError("Could not import needed modules")
 
 
 async def main(
@@ -65,8 +76,7 @@ async def main(
         boot_remote_parser.add_argument(
             "-m", "--monitor", type=pathlib.Path, help="m1n1 monitor stub"
         )
-
-        subparsers.add_parser("linux_prep", help="Run this once per-device before booting linux on it")
+        boot_remote_parser.add_argument("--remoteboot", type=pathlib.Path, help="Path to remoteboot.sh", required=True)
 
         # High-level linux booter
         linux_parser = subparsers.add_parser("linux", help="Boot linux on device")
@@ -98,6 +108,7 @@ async def main(
         linux_parser.add_argument(
             "-m", "--monitor", type=pathlib.Path, help="m1n1 monitor stub"
         )
+        linux_parser.add_argument("--remoteboot", type=pathlib.Path, help="Path to remoteboot.sh", required=True)
 
     args = parser.parse_args()
 
@@ -141,12 +152,11 @@ def usbliter8_download(dev: usb.core.Device, data: bytes) -> True:
     send_usbliter8_command(dev, Usbliter8Command.DFU_DNLOAD, None, 100)
 
 
-def linux_remote_boot(m1n1_blob: pathlib.Path, monitor_stub: Optional[pathlib.Path]):
-    subprocess.check_call(["./remote_boot/remoteboot.sh", "build"])
+def linux_remote_boot(m1n1_blob: pathlib.Path, monitor_stub: Optional[pathlib.Path], remoteboot: pathlib.Path):
     if monitor_stub is not None:
         subprocess.check_call(
             [
-                helpers.base_directory() / "./remote_boot/remoteboot.sh",
+                "bash", remoteboot,
                 "boot",
                 m1n1_blob,
                 monitor_stub,
@@ -159,7 +169,7 @@ def linux_remote_boot(m1n1_blob: pathlib.Path, monitor_stub: Optional[pathlib.Pa
         )
     else:
         subprocess.check_call(
-            [helpers.base_directory() / "./remote_boot/remoteboot.sh", "boot", m1n1_blob],
+            ["bash", remoteboot, "boot", m1n1_blob],
             env={
                 "USBLITER8CTL": helpers.base_directory() / "usbliter8ctl.py",
                 "PYTHON": sys.executable,
@@ -167,6 +177,19 @@ def linux_remote_boot(m1n1_blob: pathlib.Path, monitor_stub: Optional[pathlib.Pa
             },
         )
 
+def linux_prep():
+    parser = argparse.ArgumentParser()
+    parser.add_argument("remoteboot", type=pathlib.Path, help="Path to remoteboot.sh")
+
+    args = parser.parse_args()
+
+    subprocess.check_call(
+        ["bash", args.remoteboot, "build"]
+    )
+    subprocess.check_call(
+        ["sudo", "bash", args.remoteboot, "prep"]
+    )
+    print("You can now boot linux on your device")
 
 async def main_real(
     dev: usb.core.Device, pwned: bool, serial: str, action: str, args: dict
@@ -206,15 +229,7 @@ async def main_real(
                     send_usbliter8_command(dev, Usbliter8Command.CUSTOM_BOOT, None, 100)
                     send_usbliter8_command(dev, Usbliter8Command.DFU_ABORT, None, 100)
                 case "remote":
-                    linux_remote_boot(args["m1n1"], args.get("monitor"))
-        case "linux_prep":
-            subprocess.check_call(
-                [helpers.base_directory() / "./remote_boot/remoteboot.sh", "build"]
-            )
-            subprocess.check_call(
-                [helpers.base_directory() / "./remote_boot/remoteboot.sh", "prep"]
-            )
-            print("You can now boot linux on your device")
+                    linux_remote_boot(args["m1n1"], args.get("monitor"), args["remoteboot"])
         case "linux":
             print("Preapring iboot...")
             with tempfile.NamedTemporaryFile(mode="wb") as m1n1_blob_file:
@@ -247,5 +262,7 @@ async def main_real(
                     with args["initramfs"].open("rb") as f:
                         shutil.copyfileobj(f, m1n1_blob_file)
                 linux_remote_boot(
-                    pathlib.Path(m1n1_blob_file.name), args.get("monitor")
+                    pathlib.Path(m1n1_blob_file.name), args.get("monitor"), args["remoteboot"]
                 )
+
+    return 0

{iphonetool-0.1.2 → iphonetool-0.2.0}/src/iphonetool/helpers.py

@@ -7,7 +7,16 @@ from typing import Optional
 
 import usb.core
 
-from .config import APPLE_VENDORID, AppleProductId
+try:
+    from .config import APPLE_VENDORID, AppleProductId
+except ImportError:
+    try:
+        from config import APPLE_VENDORID, AppleProductId
+    except ImportError:
+        try:
+            from iphonetool.config import APPLE_VENDORID, AppleProductId
+        except ImportError:
+            raise ImportError("Could not import needed modules")
 
 
 class DeviceMode(Enum):

iphonetool-0.1.2/src/iphonetool/remote_boot/.git

@@ -1 +0,0 @@
-gitdir: ../../../.git/modules/remote_boot

iphonetool-0.1.2/src/iphonetool/remote_boot/.gitignore

@@ -1,4 +0,0 @@
-cache
-firmware
-*.macho
-*.bin

iphonetool-0.1.2/src/iphonetool/remote_boot/.gitmodules

@@ -1,9 +0,0 @@
-[submodule "vendor/gaster"]
-	path = vendor/gaster
-	url = git@github.com:HoolockLinux/gaster.git
-[submodule "vendor/hBootPatcher"]
-	path = vendor/hBootPatcher
-	url = git@github.com:HoolockLinux/hBootPatcher.git
-[submodule "vendor/hKernelFWExtractor"]
-	path = vendor/hKernelFWExtractor
-	url = git@github.com:HoolockLinux/hKernelFWExtractor

iphonetool-0.1.2/src/iphonetool/remote_boot/LICENSE

@@ -1,29 +0,0 @@
-BSD 3-Clause License
-
-Copyright (c) 2025, HoolockLinux contributors
-All rights reserved.
-
-Redistribution and use in source and binary forms, with or without
-modification, are permitted provided that the following conditions are met:
-
-1. Redistributions of source code must retain the above copyright notice, this
-   list of conditions and the following disclaimer.
-
-2. Redistributions in binary form must reproduce the above copyright notice,
-   this list of conditions and the following disclaimer in the documentation
-   and/or other materials provided with the distribution.
-
-3. Neither the name of the copyright holder nor the names of its
-   contributors may be used to endorse or promote products derived from
-   this software without specific prior written permission.
-
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
-AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
-DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
-FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
-DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
-SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
-CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
-OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
-OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

iphonetool-0.1.2/src/iphonetool/remote_boot/README.md

@@ -1,30 +0,0 @@
-# remote_boot
-
-m1n1 remote booter for HoolockLinux
-
-## Dependencies
-
-You need [ipsw](https://github.com/blacktop/ipsw) and [irecovery](https://github.com/libimobiledevice/libirecovery).
-On Linux, you will also need `util-linux`'s `lsusb`. Other dependencies are vendored as git submodules. For them to
-compile however, you must have clang and GNU make installed.
-
-## Usage
-
-- `./remoteboot.sh build` - Compile vendored dependencies
-- `./remoteboot.sh prep` - prepare boot files (requires internet connection)
-- `./remoteboot.sh boot /path/to/m1n1-idevice.macho [/path/to/monitor-stub.macho]` - boot
-- `./remoteboot.sh firmware` - Download firmware in `/lib/firmware` layout (does not work on A12/A13 at this moment).
-
-Preparation needs to be ran once for each model of device.
-The `m1n1-idevice.macho` and `monitor-stub.macho` are generated as part of the
-HoolockLinux m1n1 build process, which are mock XNU kernel and mock XNU
-watchtower (KPP) respectively.
-
-## Licensing
-
-BSD-3-Clause.
-
-The files in `im4m/*` are signature files and is not a work of art, so it
-cannot be protected by copyright. `empty_trustcache.bin` is an empty
-instance of the trustcache file format and is essentially API. It is not
-protected by copyright.