How to check TSS signing status of iOS version on Mac

Checking the signing status of a certain iOS version can usually be done by simply attempting to restore that firmware in iTunes.  This isn’t always practical, however, so we will use tsschecker to find out instead.

First, download tsschecker.

When you first open it, tsschecker will not be executable.  To fix it, point terminal into the directory with ‘cd’, then run

$ chmod +x tsschecker_macos

The Finder icon for tsschecker will change from a white sheet of paper to a black executable icon.  The file type will also change to Unix executable.

You should now be able to execute tsschecker with

$ ./tsschecker_macos

This gives us a list of parameters.  The ones we will be using are -d and -i.  -d is used to specify the device by its model identifier. For example, if we are checking for iPhone 6, we would enter ‘-d iPhone7,2’.  You cannot specify a device by its retail name.  For example, ‘-d iPhone 6’ will NOT work.

Next is -i.  This is used to specify iOS version. It is very simple, just ‘-i 11.4.1’.

Now that we have these two things, we can put it together to get

$ ./tsschecker_macos -d iPhone7,2 -i 11.4.1

Our output should look something like this:

Version: 7d267698cb16ab4699fa9cba20783ee041ac999e - 212

[TSSC] opening firmware.json

[DOWN] downloading file

[JSON] counting elements

[JSON] parsing elements

[TSSC] got firmwareurl for iOS 11.4.1 build 15G77

[TSSC] opening Buildmanifest for iPhone7,2_11.4.1_15G77

[LFZP] downloading BuildManifest.plist from

100 [===========================================================================033 [================================>                                          058 [=========================================================>                 083 [===========================================================================100 [===================================================================================================>]

[TSSR] Request URL set to

[TSSR] Sending TSS request attempt 1... success

iOS 11.4.1 15G77 IS signed!

iOS 11.4.1 for device iPhone7,2 IS being signed!


Tsschecker will present you with the build number of the version and its signing status.

That’s all there is to it.  If you would like to save SHSH for the version you checked, just add -e and -s.





To check beta firmware, BuildManifest.plist from the ipsw is required.  To specify the manifest, we will use -m.

Additionally, we need to use – -beta and – -buildid to tell tsschecker that the firmware is beta.  The use of – -beta is simple.  Just put it right after -i.  As for – -buildid, put that right after the version number, and specify the build number of the firmware being checked.  When completed, the command should look like this:

$ ./tsschecker -d iPhone7,2 -m /Users/jf/Desktop/iPhone_4.7_11.4.1_15G5077a_Restore/BuildManifest.plist -i --beta 11.4.1 --buildid 15G5077a


Special Devices

Some devices have different board configs.  iPhone 6s for example, can be N71AP, or N71mAP.  N71AP being the Samsung CPU version and N71mAP being TSMC.  For devices like this, we need to use -B (yes, uppercase).  This allows us to specify our board config.  Here is what it should look like:

$ ./tsschecker -d iPhone8,1 -B n71map -i 11.4.1

Keep in mind, this is only necessary when saving SHSH.  If you are simply checking the version, board config can be left out.



2 thoughts on “How to check TSS signing status of iOS version on Mac

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s