Copyright 2015 Laurens Holst

Thanks go to Wouter Vermaelen, Louthrax and bore for support and contributions.

Project information

Extracts files compressed with the gzip (.gz) format.

By generating the Huffman decompression code, it performs very well compared to other compression tools.

Philips NMS 8245 MSX2 (openMSX) with Sunrise IDE:

Panasonic FS-A1GT turboR (openMSX) with Sunrise IDE:

The DEFLATE algorithm which powers gzip is also used by various other compressed file formats, such as zip, png and vgm. As such this implementation is also used by VGMPlay, which triggered its development, and PNGView.

Additionally Louthrax has used this code to implement SofaUnZip, and Prodatron used it to implement unzip in SymbOS.


See the release notes for what’s new.


Mock GZIP MSX logo image.

System requirements

Usage instructions

Run gunzip from MSX-DOS 2, specifying the gzipped file on the command line.


gunzip [options] <archive.gz> <outputfile>


If no output file is specified, the archive will be tested.

Development information

Gunzip is free and open source software. If you want to contribute to the project you are very welcome to. Please contact me at any one of the places mentioned in the project information section.

You are also free to re-use code for your own projects, provided you abide by the license terms.

Building the project is easy on all modern desktop platforms. On MacOS and Linux, simply invoke make to build the binary and symbol files into the bin directory:


Windows users can open the Makefile and build by pasting the line in the all target into the Windows command prompt.

To launch the build in openMSX after building, put a copy of MSXDOS2.SYS and COMMAND2.COM and some GZ files to test with in the bin directory, and then invoke the make run command.

Note that the glass assembler which is embedded in the project requires Java 8. To check your Java version, invoke the java -version command.

Additionally, Node.js is required. Download it from their website or install it through your favourite package manager.

Release notes

For the complete list of changes please refer to the revision history.