PYSQUASHFS(1)

📦 version 0.9.0, in ubuntu stonking

💖 PYSQUASHFS(1) — the manual, but make it cute 💖

okay bestie, gather round, because this is pysquashfs(1) and it's literally the moment. this little icon is a command-line tool for reading SquashFS 4.0 little-endian images, and honestly? she ate. 🍓

✨ NAME ✨

pysquashfs — peek inside SquashFS 4.0 images and pull stuff out of them. no cap.

🦋 SYNOPSIS 🦋

pysquashfs list [options] file
pysquashfs extract [options] file
pysquashfs scan [options] file
pysquashfs -V | --version

🌸 DESCRIPTION 🌸

so pysquashfs is that girl: a cli tool for reading SquashFS 4.0 little-endian images. that's the whole vibe. 💅

she's got three subcommands, and each one is a different main character:

  • list — lists what's inside a filesystem image. window shopping, basically. 👀
  • extract — pulls files or directories out of an image. she's not just looking, she's taking. 💅
  • scan — searches through a file hunting for SquashFS 4.0 superblocks. detective mode, no cap. 🔍

🔥 OPTIONS 🔥

  • -V, --version — shows you the program version and dips out. that's it, that's the whole job. ✨

🎀 list

  • -o, --offset OFFSET — the absolute position where the filesystem starts. default is 0.
  • --utc — shows times in UTC. timezone-neutral, iconic behavior. 🌍
  • --showtz — shows the UTC offset when it's displaying time. so you know where in the world you're at.
  • -p, --path PATH — the absolute path of a directory or file to list. default is /.
  • -r, --recursive — lists recursively. goes all the way down. 🕳️
  • -t, --type TYPE... — filters entries by file type. valid values are one or more of fdlpsbc. (yes, it's a little alphabet soup, but she's valid, leave her alone 🫶)

💜 extract

  • -o, --offset OFFSET — the absolute position where the filesystem starts. default is 0.
  • -d, --dest DIR — the destination directory for the extracted files. default is the current directory.
  • -p, --path PATH — the absolute path of the directory or file to extract. default is /.
  • -f, --force — overwrites files that already exist. she said move. 😤
  • -q, --quiet — does not print extraction status. silent but deadly, we love a low-profile queen. 🤫

🌈 scan

  • --utc — displays times in UTC.
  • --showtz — shows the UTC offset when displaying time.

🌟 ARGUMENTS 🌟

  • file — the path to the SquashFS image, or the input file, that you want to inspect. the star of the show, fr fr. ⭐

👑 EXIT STATUS 👑

0 on success, non-zero on error. so if you get a big fat zero, you slayed. anything else? we don't talk about it. 😭

🧚 EXAMPLES 🧚

list the root of an image:

pysquashfs list image.squashfs

extract a directory:

pysquashfs extract -p /etc image.squashfs

scan a file for superblocks:

pysquashfs scan image.bin

💫 SEE ALSO 💫

ok so this is where the original page has the sign-off vibe — pysquashfs(1) comes to you courtesy of PySquashfsImage, dated March 2026. mwah. go read some images, bestie. 🫶💖✨

📦 where this page comes from