Kiwix end-products dedicated build solutions
Python Shell

Build status : Build Status

Kiwix is an offline reader for Web content. It's especially thought to make Wikipedia available offline. This is done by reading the content of the project stored in a file format ZIM, a high compressed open format with additional meta-data.

This repository contains a set of tools to help development or usage of kiwix.


Most of the compilation steps are handled by the script.

This script has been tested of Fedora 23 and Ubuntu 16.10

Take care, the paragraphs are about the target platforms. If you want to build Kiwix for Android on a GNU/Linux system, you should follow the instructions of the "Android" paragraph.


Install pre-requisties in your distro, eg, in Debian based:

sudo apt install git cmake meson python3-virtualenv virtualenvwrapper zlib1g-dev libicu-dev aria2 libtool


Pretty simple once all dependencies are installed :

The archives and sources will be copied in your current working dir so I recommend you to create a working directory:

$ mkdir <MY_WORKING_DIR>

Once ready, just run the script with the install dir as argument:

$ <right/path/to/> <INSTALL_DIR>

The script will download and install all the needed dependencies and kiwix related repository.

At the end of the script you will found the binaries in /bin.

As it is a dynamic linked binary, you will need to add the lib directory to LD_LIBRARY_PATH :



To build a static binary simply add the --build_static option to the script :

$ --build_static <INSTALL_DIR>

Notes: You cannot use the same working directory to build a dynamic and static.

Notes: At the end of the script, meson may raise a error when it install the kiwix-server binary. This is a meson bug and it has been fixed here ( but your meson version may not include this fix. However, the kiwix-server binary is valid and ready to use.

Mac OSX Universal

The script has not been tested on Mac OSX.

Please, if you have a Mac OSX, try to run the kiwix-build script and report errors or, better, fixes :)

Android and Windows

Cross compilation and strange stuff are to come.

If you wich to help, you're welcome.



IRC: #kiwix on
(I'm hidding myself under the starmad pseudo)

You can use IRC web interface on



Read 'COPYING' file