Skip to content
master
Go to file
Code

Latest commit

The HTTP daemon is now started directly via libkiwix instead of 
using kiwix-serve as of bbfbf2b.

Also see the discussion on #477.
830e19b

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
src
 
 
ui
 
 
 
 
 
 
 
 
 
 
 
 

README.md

Kiwix Desktop

The Kiwix Desktop is a viewer/manager of ZIM files for GNU/Linux and Microsoft Windows OSes.

Build Status CodeFactor License: GPL v3

Distribution

Official binaries

Download on Flathub

Contribution binaries

Packaging status

Disclaimer

This document assumes you have a little knowledge about software compilation. If you experience difficulties with the dependencies or with the Kiwix libary compilation itself, we recommend to have a look to kiwix-build.

Dependencies

The Kiwix Desktop application relies on many third parts software libraries. Following libraries need to be available:

These dependencies may or may not be packaged by your operating system. They may also be packaged but only in an older version. The compilation script will tell you if one of them is missing or too old. In the worse case, you will have to download and compile bleeding edge version by hand.

kiwix-lib has to be compiled dynamically, the best way to have it is to use kiwix-build.

Install needed packages (on Ubuntu 18.04+):

sudo apt-get install libqt5gui5 qtbase5-dev qtwebengine5-dev \
     libqt5svg5-dev qt5-image-formats-plugins qt5-default aria2 \
     qttools5-dev-tools

Compilation

Once all dependencies are installed, you can compile Kiwix Desktop:

qmake .
make

qmake will use pkg-config to locate libraries. Depending of where you've installed kiwix-lib (and other libraries) you may have to update the env variable PKG_CONFIG_PATH. It can be set as follows, for example, for x86-64 native systems:

export PKG_CONFIG_PATH="<...>/BUILD_native_dyn/INSTALL/lib/x86_64-linux-gnu/pkgconfig"

You may want to simply open the kiwix-desktop project in QtCreator and then compile the project from there (don't forget to update PKG_CONFIG_PATH if necessary).

Installation

To install Kiwix Desktop on the system:

sudo make install

Run

To run Kiwix Desktop

kiwix-desktop

You might have to refresh the ld database before:

sudo ldconfig

If you face problems such as library not found..., add the following environment variable:

LD_LIBRARY_PATH="<...>/BUILD_native_dyn/INSTALL/lib/x86_64-linux-gnu"

License

GPLv3 or later, see LICENSE for more details.

You can’t perform that action at this time.