by tsarpaul

tsarpaul / FBUnpinner

Bypass Facebook/Instagram Certificate Pinning for Android

136 Stars 30 Forks Last release: Not found 34 Commits 0 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:


Works for Instagram & Facebook

TLS1.3 & TLS1.2 for x86/ARM32/ARM64
Instagram x86 currently does not work, feel free to open a pull request :)

A script to automate removing certificate pinning defense from Facebook applications.

TESTED FOR THE FOLLOWING APPS: - com.facebook.katana (Facebook for Android) - com.facebook.orca (Messenger) - com.facebook.lasso (Lasso) - com.instagram.android (Instagram for Android)


  • Note: for Instagram replace lib-xzs/libcoldstart.so with lib-zstd/libliger.so
  1. Make sure you have run the desired Facebook application atleast once - what happens is that the cert pinning library (libcoldstart.so) is unpacked from an archive embedded in the APK.

  2. Get root shell in your device:

    $(comp): adb shell
    $(phone): su
  3. Pull libcoldstart.so from your desired Facebook application: ```

    (phone): cp /data/data/com.facebook.katana/lib-xzs/libcoldstart.so /sdcard/libcoldstart.so

    (phone): exit

    $(phone): exit $(comp): adb pull /sdcard/libcoldstart.so FBUnpinner/ ```

  4. Patch the file:

    $ python3 patch.py
    $ python3 patch.py libliger.so libliger-patched.so
  5. Replace libcoldstart.so in the phone with the patched version: ``` $(comp): adb push libcoldstart-patched.so /sdcard/libcoldstart.so $(comp): adb shell $(phone): su

    (phone): cp /sdcard/libcoldstart.so /data/data/com.facebook.katana/lib-xzs/libcoldstart.so

    (phone): chmod 777 /data/data/com.facebook.katana/lib-xzs/libcoldstart.so

  6. (Optional) Setting up Burp to work with TLS 1.3 ("no cipher suites in common")

    /jdk-11.0.2.jdk/Contents/Home/bin/java -jar burpsuite_community.jar


A script to just patch an APK

Tested Emulators

Android Studio: Nexus6API_24 - Google APIs Intel Atom (x86)

Genymotion: Google Nexus 5X API 26 (x86)



We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.