Neptune

neptune unpack

Extract files from firmware container images

neptune unpack

Unpacks firmware container images, extracting embedded filesystems and files. Supports nested containers with configurable recursion depth.

Usage

neptune unpack <FIRMWARE> [OPTIONS]

Arguments

ArgumentDescription
<FIRMWARE>Path to the firmware image

Options

FlagDefaultDescription
-o, --output <DIR>./neptune-unpackedOutput directory for extracted files
--max-depth <N>5Maximum recursion depth for nested containers

Supported formats

  • SquashFS
  • JFFS2
  • CramFS
  • CPIO
  • UBI
  • Android Boot

Examples

neptune unpack router-firmware.img
neptune unpack firmware.bin --output ./extracted --max-depth 3

On this page