Home

Awesome

<p align="center"><img src="https://brotli.org/brotli.svg" alt="Brotli" width="64"></p>

Introduction

Brotli is a generic-purpose lossless compression algorithm that compresses data using a combination of a modern variant of the LZ77 algorithm, Huffman coding and 2nd order context modeling, with a compression ratio comparable to the best currently available general-purpose compression methods. It is similar in speed with deflate but offers more dense compression.

The specification of the Brotli Compressed Data Format is defined in RFC 7932.

Brotli is open-sourced under the MIT License, see the LICENSE file.

Brotli mailing list: https://groups.google.com/forum/#!forum/brotli

TravisCI Build Status AppVeyor Build Status Fuzzing Status

Build instructions

Esp32 fork

Just compile the cpp example provided in /tests folder in a ESP32 board. Only tested for decompression, only tested in ESP32 microchips but I think should work in a 8266 board too. There is a platformio.ini ready with this library repository in lib_deps. For decompression examples and time measurements please open the /tests directory and check the Readme. There are the easy build instructions and some statistics. There is a platformio.ini file in this directory so to build just run in the terminal:

pio run 

// To flash the FS data folder:
pio run --target uploadfs

// To flash the micro:
pio run --target upload

Note: The decompression is working but so far could not make run successfully the BrotliEncoderCompress method. Have fun with it and if you make further tests I will appreciate if you send me a short message to my twitter @martinfasani or here on github. Please add an Issue if you need more examples and fork this to provide your own.

Autotools-style CMake

configure-cmake is an autotools-style configure script for CMake-based projects (not supported on Windows).

The basic commands to build, test and install brotli are:

$ mkdir out && cd out
$ ../configure-cmake
$ make
$ make test
$ make install

By default, debug binaries are built. To generate "release" Makefile specify --disable-debug option to configure-cmake.

Bazel

See Bazel

CMake

The basic commands to build and install brotli are:

$ mkdir out && cd out
$ cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=./installed ..
$ cmake --build . --config Release --target install

You can use other CMake configuration.

Premake5

See Premake5

Python

To install the latest release of the Python module, run the following:

$ pip install brotli

To install the tip-of-the-tree version, run:

$ pip install --upgrade git+https://github.com/google/brotli

See the Python readme for more details on installing from source, development, and testing.

Benchmarks

Related projects

Disclaimer: Brotli authors take no responsibility for the third party projects mentioned in this section.

Independent decoder implementation by Mark Adler, based entirely on format specification.

JavaScript port of brotli decoder. Could be used directly via npm install brotli

Hand ported decoder / encoder in haxe by Dominik Homberger. Output source code: JavaScript, PHP, Python, Java and C#

7Zip plugin

Dart native bindings