1 <p align="center"><img src="https://brotli.org/brotli.svg" alt="Brotli" width="64"></p> 2 3 ### Introduction 4 5 Brotli is a generic-purpose lossless compression algorithm that compresses data 6 using a combination of a modern variant of the LZ77 algorithm, Huffman coding 7 and 2nd order context modeling, with a compression ratio comparable to the best 8 currently available general-purpose compression methods. It is similar in speed 9 with deflate but offers more dense compression. 10 11 The specification of the Brotli Compressed Data Format is defined in [RFC 7932](https://tools.ietf.org/html/rfc7932). 12 13 Brotli is open-sourced under the MIT License, see the LICENSE file. 14 15 Brotli mailing list: 16 https://groups.google.com/forum/#!forum/brotli 17 18 [![TravisCI Build Status](https://travis-ci.org/google/brotli.svg?branch=master)](https://travis-ci.org/google/brotli) 19 [![AppVeyor Build Status](https://ci.appveyor.com/api/projects/status/github/google/brotli?branch=master&svg=true)](https://ci.appveyor.com/project/szabadka/brotli) 20 21 ### Build instructions 22 23 #### Autotools-style CMake 24 25 [configure-cmake](https://github.com/nemequ/configure-cmake) is an 26 autotools-style configure script for CMake-based projects (not supported on Windows). 27 28 The basic commands to build, test and install brotli are: 29 30 $ mkdir out && cd out 31 $ ../configure-cmake 32 $ make 33 $ make test 34 $ make install 35 36 By default, debug binaries are built. To generate "release" `Makefile` specify `--disable-debug` option to `configure-cmake`. 37 38 #### Bazel 39 40 See [Bazel](http://www.bazel.build/) 41 42 #### CMake 43 44 The basic commands to build and install brotli are: 45 46 $ mkdir out && cd out 47 $ cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=./installed .. 48 $ cmake --build . --config Release --target install 49 50 You can use other [CMake](https://cmake.org/) configuration. 51 52 #### Premake5 53 54 See [Premake5](https://premake.github.io/) 55 56 #### Python 57 58 To install the latest release of the Python module, run the following: 59 60 $ pip install brotli 61 62 To install the tip-of-the-tree version, run: 63 64 $ pip install --upgrade git+https://github.com/google/brotli 65 66 See the [Python readme](python/README.md) for more details on installing 67 from source, development, and testing. 68 69 ### Benchmarks 70 * [Squash Compression Benchmark](https://quixdb.github.io/squash-benchmark/) / [Unstable Squash Compression Benchmark](https://quixdb.github.io/squash-benchmark/unstable/) 71 * [Large Text Compression Benchmark](http://mattmahoney.net/dc/text.html) 72 * [Lzturbo Benchmark](https://sites.google.com/site/powturbo/home/benchmark) 73 74 ### Related projects 75 > **Disclaimer:** Brotli authors take no responsibility for the third party projects mentioned in this section. 76 77 Independent [decoder](https://github.com/madler/brotli) implementation by Mark Adler, based entirely on format specification. 78 79 JavaScript port of brotli [decoder](https://github.com/devongovett/brotli.js). Could be used directly via `npm install brotli` 80 81 Hand ported [decoder / encoder](https://github.com/dominikhlbg/BrotliHaxe) in haxe by Dominik Homberger. Output source code: JavaScript, PHP, Python, Java and C# 82 83 7Zip [plugin](https://github.com/mcmilk/7-Zip-Zstd) 84