/irecovery

A program used to communicate with iBoot / iBSS using the libusb-1.0 api.

Primary LanguageCGNU General Public License v3.0GPL-3.0

== What is iRecovery? ==
iRecovery is a libusb-based command-line utility for macOS and Linux (perhaps Windows too but I'm not developing/testing under Windows). It is able to talk to the iBoot/iBSS in Apple's iPhone/iPad/iPod touch via USB.

It's completely open-source, the source-code is released under the terms of the GNU General Public License version 3.
The full license text can be found in the LICENSE file.

== Usage ==

	./iRecovery -a			enables auto-boot and reboots the device (exit recovery loop).
	./iRecovery -s 			starts a shell.
	./iRecovery -g <datafile>	get data.
	./iRecovery -r 			USB reset.
	./iRecovery -f <file>		sends a file.
	./iRecovery -u <file>		uploads a file.
	./iRecovery -c "command"	send a single command.
	./iRecovery -b <file>		runs batch commands from a file (one per line).
	./iRecovery -x <file>		uploads a file then resets the USB connection.
	./iRecovery -e <file>		upload a file then run USB exploit.
	./iRecovery -x21 <command>	send a raw command to 0x21.
	./iRecovery -x40 <command>	send a raw command to 0x41.
	./iRecovery -xA1 <command>	send a raw command to 0xA1.
	./iRecovery -l <dev>		exploit with limera1n.

== Console / Batch Commands ==

	/auto-boot			enables auto-boot and reboots the device (exit recovery loop).
	/exit				exit the recovery console.
	/send	<file>			send a file to the device.
	/upload	<file>			upload a file to the device.
	/exploit <file>			upload a file then execute a USB exploit.
	/batch	<file>			execute commands from a batch file.