ICEBOX_EXPLAIN(1)

📦
version 1.1 · 6 versions
, in ubuntu stonking

💖 ICEBOX_EXPLAIN 💖

okay bestie, so you know how this whole thing lives in section 1 of the manual? yeah. icebox-explain is the moment. let me tell you everything ✨

✨ NAME ✨

icebox-explain — explain content of bitstream file in readable .txt format 🦋

🌸 SYNOPSIS 🌸

icebox-explain [options] [bitmap.txt]

like, that's it. that's the whole vibe. [options] if you wanna be fancy, [bitmap.txt] if you have a file to point at 💅

🎀 DESCRIPTION 🎀

so literally what this tool does: it helps you actually understand what's inside a .txt file. and where does that .txt file come from?? glad you asked 🫶 — it's a file that got converted from a binary bitstream by iceunpack. so the pipeline is giving convert-then-explain, and this is the explain part. main character energy, truly. 👑

🔥 OPTIONS 🔥

  • -b — prints config bit names for each config statement. so every time there's a config statement, you also get the names of the bits. very "show your work" of it 💜
  • -m — prints tile config bitmaps. the actual bitmaps. iconic 🎀
  • -A — don't skip uninteresting tiles. yes bestie, this one un-skips the boring ones. all tiles, no filter ✨
  • -t '<x-coordinate> <y-coordinate>' — print only the specified tile. you hand it an x and a y, it gives you that one tile and nothing else. targeted. laser focus. periodt 💅
ngl the -t value goes in single quotes as '<x-coordinate> <y-coordinate>' — space between the two numbers, both inside the quotes. don't come for me, that's just how it is 🫶

🌈 SEE ALSO 🌈

iceunpack(1) — the other half of this whole situation, go read it too bestie 💖

👑 AUTHOR 👑

This manual page was written by Ruben Undheim <ruben.undheim@gmail.com> for the Debian project (and may be used by others). absolute legend, no cap 🙌

that's the page!! go forth and explain some bitstreams 🦋✨

— with love, dated 28 February 2026, from your girl ICEBOX_EXPLAIN(1) 💖🧚🌸

📦 where this page comes from