Metadata-Version: 2.4
Name: superpack
Version: 1.0.0
Summary: Extractor for Superpack archives used by Android applications
Author: Ahmed Alhrrani - T.me : @maho_s9
Keywords: superpack,archive,android,instagram,facebook,extractor
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Operating System :: POSIX :: Linux
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Utilities
Requires-Python: >=3.9
Description-Content-Type: text/markdown

Superpack

A lightweight wrapper around Facebook's Superpack runtime used to extract files from Superpack archives (".spk", ".spo", and related formats).

Overview

Many Meta applications such as Instagram Lite, Facebook Lite, Messenger Lite, and other Android applications may package native libraries and assets using Superpack archive formats.

This project provides a simple command-line interface and Python API that automate the extraction process by invoking the bundled Java runtime and Superpack native library.

Features

- Extract ".spk" archives
- Extract ".spk.xz" archives
- Python API support
- Command-line interface
- Automatic Java detection
- ARM64 support
- Termux-friendly
- Works with archives containing one or multiple files

Installation


Install the package:

pip install .

or 

pip install superpack

Usage

Command Line

Extract an archive:

superpack libs.spk

Specify output directory:

superpack -i libs.spk -o output

Show help:

superpack --help

Python API

import superpack

superpack.extract("libs.spk")

Custom output directory:

import superpack

superpack.extract(
    "libs.spk",
    output="output"
)

Supported Environments

- Android (Termux)
- Linux ARM64 (aarch64)

Notes

This project is intended for research, reverse engineering, compatibility testing, and archive inspection.

The package itself does not modify application behavior and only extracts files from supported Superpack archives.

Disclaimer

Instagram, Facebook, Messenger, Meta, and related trademarks belong to their respective owners. This project is an independent utility and is not affiliated with, endorsed by, or sponsored by Meta.
