# 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.

- Type: Tool
- Targets: Firmware
- Category: Firmware tools
- Relationship: Foundation tool
- Sources reviewed: 2026-10-27
- Added to the catalog: 2026-11-09
- Original resource: <https://github.com/devttys0/sasquatch>
- Primary source: <https://github.com/devttys0/sasquatch/blob/bd864a1b037bf57ca7d64a292a60ba0d6459611f/README.md>
- Catalog page: <https://awesomerea.org/resources/sasquatch/>
- Record JSON: <https://awesomerea.org/resources/sasquatch/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/sasquatch/index.md)

## 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.

## Primary sources

1. <https://github.com/devttys0/sasquatch/blob/bd864a1b037bf57ca7d64a292a60ba0d6459611f/README.md>
2. <https://github.com/devttys0/sasquatch/blob/bd864a1b037bf57ca7d64a292a60ba0d6459611f/build.sh>
3. <https://github.com/devttys0/sasquatch/blob/bd864a1b037bf57ca7d64a292a60ba0d6459611f/patches/README.md>
4. <https://github.com/devttys0/sasquatch/blob/bd864a1b037bf57ca7d64a292a60ba0d6459611f/patches/patch0.txt>
5. <https://github.com/devttys0/sasquatch/pull/34>
6. <https://github.com/devttys0/sasquatch/issues/36>
7. <https://github.com/onekey-sec/unblob/blob/0f40c3c6940fa2bcfd2945f519fe8caf99e31e44/docs/installation.md>

## More in Firmware and hardware

- [FIRMADYNE](https://awesomerea.org/resources/firmadyne/index.md) · Tool
- [flashrom](https://awesomerea.org/resources/flashrom/index.md) · Tool
- [InternalBlue](https://awesomerea.org/resources/internalblue/index.md) · Tool
- [MC Extractor](https://awesomerea.org/resources/mc-extractor/index.md) · Tool
- [MTKClient](https://awesomerea.org/resources/mtkclient/index.md) · Tool
- [BoschMe7x](https://awesomerea.org/resources/ida-bosch-me7x/index.md) · Tool

## About this entry

The description was reviewed against primary sources.
Original editorial content: MIT. Linked projects, papers and assets retain their own rights and licenses.