summaryrefslogtreecommitdiffstats
path: root/README.md
blob: 2e6a70a37e54677997bf7d2418a3d9f21aa83f7d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
# idevicerestore

## About

The idevicerestore tool allows to restore firmware files to iOS devices.

It is a full reimplementation of all granular steps which are performed during
restore of a firmware to a device.

In general, upgrades and downgrades are possible, however subject to
availability of SHSH blobs from Apple for signing the firmare files.

To restore a device, simply run:
```bash
idevicerestore -l
```

This will print a selection of firmware versions that are currently being signed
for the attached device. It will then download and restore the selected firmware.

By default, an update restore is performed, which will preserve the user data
(unless the firmware image does not contain a 'Customer Upgrade Install' variant,
in which case an erase restore will be performed).

**WARNING**

This tool can easily __destroy your user data__ irreversibly. Use with caution
and make sure to backup your data before trying to restore.

**In any case, usage is at your own risk.**

## Requirements

Development Packages of:
* libimobiledevice
* libirecovery
* libusbmuxd
* libplist
* libcurl
* libzip
* openssl

Software:
* usbmuxd
* make
* autoheader
* automake
* autoconf
* libtool
* pkg-config
* gcc or clang

## Installation

To compile run:
```bash
./autogen.sh
make
sudo make install
```

## Who/What/Where?

* Home: https://libimobiledevice.org/
* Code: `git clone https://git.libimobiledevice.org/idevicerestore.git`
* Code (Mirror): `git clone https://github.com/libimobiledevice/idevicerestore.git`
* Tickets: https://github.com/libimobiledevice/idevicerestore/issues
* Mailing List: https://lists.libimobiledevice.org/mailman/listinfo/libimobiledevice-devel
* Twitter: https://twitter.com/libimobiledev

## Credits

Apple, iPhone, iPad, iPod, iPod Touch, and Apple TV are trademarks of Apple Inc.

idevicerestore is an independent software application and has not been
authorized, sponsored, or otherwise approved by Apple Inc.

README Updated on: 2020-06-08