README.md

HTML Meets ZIP Meets PNG: When Files Have More Layers Than an Onion

Introduction

Imagine a digital chameleon: a file that combines ZIP, HTML, and PNG into one versatile format. It can be displayed as a web page, unzipped to obtain all the page's resources, or viewed as an image.

Discover an innovative approach to sharing and storing web content, and learn how to create these polyglot files in JavaScript!

Presentation

You can view the web presentation in:

• english (download)
• french (download) (video)

Press F1 during the presentation to see the keyboard shortcuts.

TL;DR

Resulting File

Download demo.png.zip.html.

File Compatibility

This file and the presentation files are compatible with:

• HTML (displays the extracted page in no-quirks mode)
• ZIP (contains the displayed page and its resources) - rename the file to .zip and view it with ZIP Manager
• PNG - rename the file to .png and view it with PNG file chunk inpector

If you are intrigued or more curious, you can also view it with HexEd.it.

The presentation explains how to generate this file and the technical challenges involved.

Fun Fact

The image displayed at the center of the page demo.png.zip.html is the page itself, but interpreted as a PNG file (cf. the <img src="#" ...> tag).

Viewing the Presentation in Chromium (and WebKit) Browsers

You should install the extension from the zip file located in util/web-extension in order to add the support of file:// URIs in the Fetch API, and run the first examples from the presentation.

Alternatively, you can view the examples via an HTTP server.

This issue is addressed in the subsequent examples of the presentation.

Creation of Polyglot Files with single-file

Install single-file-cli from NPM and run single-file as shown below.

npm install single-file-cli
npx single-file \
  --compress-content \
  --self-extracting-archive \
  --embedded-image=./image.png \
  --dump-content \
  https://www.example.com > output.png.zip.html

Known Issues

• A bug in "Archive Utility" on macOS prevents it from decompressing the resulting file. You can use unzip to get around this issue.
• The HTML page cannot be viewed on iOS from the filesystem because it is displayed by default in a viewer which does not support JavaScript.
• Depending on the browser you're using, the presentation may be a little slow.

Thank You

This presentation is dedicated to my biggest supporter on this project. Many thanks @ljonathanl, we miss your enthusiasm and creativity.