Skip to content

Commit

Permalink
use github action badge
Browse files Browse the repository at this point in the history
  • Loading branch information
blacktop committed Sep 7, 2019
1 parent d1736d6 commit 73f8b59
Show file tree
Hide file tree
Showing 2 changed files with 20 additions and 19 deletions.
37 changes: 18 additions & 19 deletions README.md
@@ -1,7 +1,6 @@
# ipsw

[![Circle CI](https://circleci.com/gh/blacktop/ipsw.png?style=shield)](https://circleci.com/gh/blacktop/ipsw) [![Build status](https://ci.appveyor.com/api/projects/status/jcx0faojt820p5w4?svg=true)](https://ci.appveyor.com/project/blacktop/ipsw)
[![Github All Releases](https://img.shields.io/github/downloads/blacktop/ipsw/total.svg)](https://github.com/blacktop/ipsw/releases/latest) [![GitHub release](https://img.shields.io/github/release/blacktop/ipsw.svg)](https://github.com/blacktop/ipsw/releases) [![License](http://img.shields.io/:license-mit-blue.svg)](http://doge.mit-license.org)
![actions](https://github.com/blacktop/ipsw/workflows/Go/badge.svg) [![Build status](https://ci.appveyor.com/api/projects/status/jcx0faojt820p5w4?svg=true)](https://ci.appveyor.com/project/blacktop/ipsw) [![Github All Releases](https://img.shields.io/github/downloads/blacktop/ipsw/total.svg)](https://github.com/blacktop/ipsw/releases/latest) [![GitHub release](https://img.shields.io/github/release/blacktop/ipsw.svg)](https://github.com/blacktop/ipsw/releases) [![License](http://img.shields.io/:license-mit-blue.svg)](http://doge.mit-license.org)

> Download and parse ipsw(s) from [ipsw.me](https://ipsw.me) or [theiphonewiki.com](https://theiphonewiki.com)
Expand Down Expand Up @@ -55,17 +54,17 @@ Flags:
Use "ipsw [command] --help" for more information about a command.
```

### `download`
### `download`

#### Download an `ipsw` and extract/decompress the `kernelcache`
#### Download an `ipsw` and extract/decompress the `kernelcache`

``` bash
$ ipsw download --device iPhone11,2 --build 16A366

• Getting IPSW build=16A366 device=iPhone11,2 signed=true version=12.0
3.4 GiB / 3.4 GiB [==========================================================| 00:00 ] 79.08 MiB/s
• verifying sha1sum...

$ ipsw extract --kernel iPhone11,2_12.0_16A366_Restore.ipsw

• Extracting Kernelcache from IPSW
Expand All @@ -82,7 +81,7 @@ $ file kernelcache.release.iphone11.decompressed
kernelcache.release.iphone11.decompressed: "Mach-O 64-bit executable arm64"
```

#### Download all the iOS 12.0 `ipsws`
#### Download all the iOS 12.0 `ipsws`

``` bash
$ ipsw download --version 12.0
Expand All @@ -96,7 +95,7 @@ $ ipsw download --version 12.0
...
```

#### Download all the LATEST `ipsws`
#### Download all the LATEST `ipsws`

Queries iTunes XML for latest version _(maybe run this as a cron job)_ 😉

Expand Down Expand Up @@ -124,7 +123,7 @@ $ ipsw download -V latest --yes --white-list ipod

#### Only download and decompress the kernelcaches _(which is CRAZY fast)_

Single `kernelcache`
Single `kernelcache`

``` bash
ipsw download kernel --device iPhone11,2 --build 16B92
Expand Down Expand Up @@ -175,17 +174,17 @@ To disable cert verification
$ ipsw download --insecure --device iPhone11,2 --build 16B92
```

### `extract`
### `extract`

#### Extract `kernelcache` from a previously downloaded `ipsw`
#### Extract `kernelcache` from a previously downloaded `ipsw`

``` bash
$ ipsw extract --kernel iPhone11,2_12.0_16A366_Restore.ipsw
```

#### Extract `dyld_shared_cache` from a previously downloaded `ipsw`
#### Extract `dyld_shared_cache` from a previously downloaded `ipsw`

- `macOS`
* `macOS`

``` bash
$ ipsw extract --dyld iPhone11,2_12.0_16A366_Restore.ipsw
Expand All @@ -195,19 +194,19 @@ $ ipsw extract --dyld iPhone11,2_12.0_16A366_Restore.ipsw
• Unmounting DMG
```

- `docker` 🆕
* `docker` 🆕

``` bash
$ docker run --init -it --rm \
--device /dev/fuse \
--cap-add=SYS_ADMIN \
-v `pwd`:/data \
-v `pwd` :/data \
blacktop/ipsw -V extract --dyld iPhone11_2_12.4.1_16G102_Restore.ipsw
```

### `webkit`
### `webkit`

Extract WebKit version from `dyld_shared_cache`
Extract WebKit version from `dyld_shared_cache`

``` bash
$ ipsw dyld webkit dyld_shared_cache
Expand All @@ -216,7 +215,7 @@ $ ipsw dyld webkit dyld_shared_cache

### `split` _(only on macOS)_ 🆕

Split up a `dyld_shared_cache`
Split up a `dyld_shared_cache`

``` bash
$ ipsw dyld split dyld_shared_cache
Expand All @@ -233,9 +232,9 @@ $ ipsw dyld split dyld_shared_cache
1444/1445
```

### `decompress`
### `decompress`

Decompress a previously extracted `kernelcache`
Decompress a previously extracted `kernelcache`

``` bash
$ ipsw kernel decompress kernelcache.release.iphone11
Expand Down
2 changes: 2 additions & 0 deletions go.mod
Expand Up @@ -27,3 +27,5 @@ require (
howett.net/plist v0.0.0-20181124034731-591f970eefbb
howett.net/ranger v0.0.0-20171016084633-e2e137620847
)

go 1.13

0 comments on commit 73f8b59

Please sign in to comment.