Provides a few tools to manipulate a SuperBinary.
This tool permits you to extract the various UARP (Universal Accessory Restore Protocol) payload types within SuperBinaries. SuperBinaries are used in various Apple accessories, including the AirPods Pro (2nd generation), Beats devices with a MediaTek chip and MagSafe accessories. On Beats devices with a MediaTek chip, it can also extract the FOTA (MediaTek OTA) in a SuperBinary container.
Note
This tool aims to maintain compatability with the latest version of SuperBinary available.
For example, with AirPods Pro (2nd generation), the version of SuperBinary increased from 2 to 3 in version 6.0. If parsing fails with a version 3 SuperBinary in the future, please file an issue!
This package has no further dependencies.
Previously, a separate package was required for LZMA decompression with FOTA payloads.
This requirement has been removed as the built-in Python lzma module functions.
If your version of Python encounters an error while decompressing, please file an issue with your operating system and precise Python version (such as 3.13.1).
First, clone this repository. You can then python3 main.py:
> python3 main.py
usage: main.py [-h] [--extract-payloads | --no-extract-payloads] [--decompress-fota | --no-decompress-fota] [--extract-rofs | --no-extract-rofs] [--decompress-payload-contents | --no-decompress-payload-contents] source output_dir
main.py: error: the following arguments are required: source, output_dir
If you are parsing a device that does not have an FOTA, you can split the SuperBinary and its plist using this syntax:
> python3 main.py --extract-payloads source output_dir
On Beats devices with a MediaTek chip and an FOTA container (like the Beats Studio Buds), it is also possible to extract the firmware sounds from the Read Only File System (ROFS) using this syntax:
> python3 main.py --extract-payloads --decompress-fota --extract-rofs FirmwareUpdate.uarp output_dir
The script will then extract all assets, such as sounds, to the output direction.