Tool

sasquatch

Patches to the unsquashfs utility from squashfs-tools 4.3 that try to read as many vendor-modified SquashFS implementations from embedded firmware as possible. Simple header changes are handled automatically; when a vendor has altered the LZMA compression options or how they are stored in data blocks, it tries to resolve them by brute force with added lzma-adaptive, lzma-alt and lzma-ddwrt decompressors. Extra options let analysts force the decompressor, SquashFS version, endianness and lzma-adaptive parameters and turn on trace output.

Targets: Firmware
Category: Firmware tools
Relationship: Foundation tool
Sources reviewed: 2026-10-27

Stars: 569
Last commit: 2021-03-25
Language: Shell

GitHub data as of 2026-11-09

Copy as Markdown View JSON Cite

Requirements & limits

The README calls the patch set beta. Open issues report build failures with GCC 10 and later; unblob documents a separate ONEKEY package.
build.sh downloads the squashfs-tools 4.3 tarball from SourceForge, applies patches/patch0.txt, builds, and installs with sudo make install; on apt systems it first installs build-essential and the liblzma, liblzo2 and zlib development packages with sudo.
Input is a SquashFS image or firmware file the user supplies; the repository commits no firmware images. Its only files are the README, build.sh and the 1.1 MB patch, which adds bundled LZMA SDK decoder copies under their LGPL/CPL texts and, in the lzmalt decoder, a 289-line VxWorks type header (vxTypesOld.h) marked Copyright 1984-1997 Wind River Systems with no license notice.
The repository has no license file. squashfs-tools is GPL-licensed; bundled LZMA decoder code has LGPL/CPL terms, and the included VxWorks type header has a copyright notice without a license.

Cite

BibTeX

@misc{sasquatch,
  title = {{sasquatch}},
  howpublished = {\url{https://github.com/devttys0/sasquatch}},
  url = {https://github.com/devttys0/sasquatch},
  urldate = {2026-10-27},
  note = {Awesome REA entry: \url{https://awesomerea.org/resources/sasquatch/}}
}

Plain text

sasquatch. https://github.com/devttys0/sasquatch (accessed 2026-10-27). Awesome REA entry: https://awesomerea.org/resources/sasquatch/

Useful? Star Awesome REA on GitHub2.4k

About this entry

The description was reviewed against primary sources.

Report an outdated entry Suggest a translation fix

Primary sources

README.md GitHub · devttys0/sasquatch · Revision bd864a1
build.sh GitHub · devttys0/sasquatch · Revision bd864a1
patches/README.md GitHub · devttys0/sasquatch · Revision bd864a1
patches/patch0.txt GitHub · devttys0/sasquatch · Revision bd864a1
https://github.com/devttys0/sasquatch/pull/34
https://github.com/devttys0/sasquatch/issues/36
docs/installation.md GitHub · onekey-sec/unblob · Revision 0f40c3c