nick-botticelli/usbpatchd

Patch iOS USB restriction for SSH over USB on the lock screen on checkm8-compatible devices

usbpatchd

Patch the USB restriction on iOS, which blocks USB accessories from accessing the device. This can be used to provide SSH over USB (courtesy of dropbear) from a locked iOS device.

This is a free alternative to "minaUSB patcher" that is not as buggy or malicious—there have been numerous reports of "minaUSB patcher" deleting and hiding files it has no right to.

Most files in this repository have been aligned similar to the checkra1n bootstrap (/binpack); as such, the GPLv3 license applies as labelled in the License section to only the files that I have written (and therefore claim copyright on).

Using

1. Boot into an SSH ramdisk capable of SSH and mounting the System volume
   • A ramdisk capable of such can be created through a free public tool created by u/meowcat454 which can be found here (instructions may not be provided, but it should be simple enough).
2. Run install-usbpatchd.sh from Terminal and follow any instructions.

Notes

• You will have to run some manual commands. This shouldn't be too difficult. I will try to improve this to let snappy run automatically in the future.
• This is a work in progress. Pull requests are encouraged.
• As this is a work in progress, stability should not be expected. This script has been a little buggy, but the implementation itself is one I created for my own personal use and have found it to work perfectly to suit my needs (i.e. tested on A10 iOS 13 via macOS 12).

TODO

• Fix renaming snapshots automatically
• Check for gzip on SSH ramdisk
• Provide ramdisk building capabilities (submodule?)
• Determine whether .bootstrapped file should be added

License

install-usbpatchd.sh, root/Library/LaunchDaemons/com.apple.usbpatchd.plist, and root/usr/libexec/usbpatchd.sh are my copyright and are licensed with the GNU General Public License Version 3