mirror of
https://github.com/kiwix/kiwix-desktop.git
synced 2025-09-25 22:06:16 -04:00
120 lines
3.8 KiB
Markdown
120 lines
3.8 KiB
Markdown
<a href="https://flathub.org/apps/details/org.kiwix.desktop">
|
|
<img width="100" alt="Download on Flathub" src="https://flathub.org/assets/badges/flathub-badge-en.png" />
|
|
</a>
|
|
|
|
Kiwix Desktop
|
|
=============
|
|
|
|
The Kiwix Desktop is a viewer/manager of ZIM files for GNU/Linux and
|
|
Microsoft Windows OSes.
|
|
|
|
[](https://github.com/kiwix/kiwix-desktop/wiki/Repology)
|
|
[](https://github.com/kiwix/kiwix-desktop/actions?query=branch%3Amaster)
|
|
[](https://www.codefactor.io/repository/github/kiwix/kiwix-desktop)
|
|
[](https://www.gnu.org/licenses/gpl-3.0)
|
|
|
|
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](https://github.com/kiwix/kiwix-build).
|
|
|
|
Dependencies
|
|
------------
|
|
|
|
The Kiwix Desktop application relies on many third parts software libraries.
|
|
Following libraries need to be available:
|
|
|
|
* [libkiwix](https://github.com/kiwix/libkiwix/)
|
|
* [Qt](https://www.qt.io/)
|
|
* [aria2](https://aria2.github.io/)
|
|
|
|
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.
|
|
|
|
Libkiwix has to be compiled dynamically, the best way to have it is
|
|
to use [kiwix-build](https://github.com/kiwix/kiwix-build).
|
|
|
|
Install needed packages (on Ubuntu 18.04+):
|
|
|
|
```bash
|
|
sudo apt-get install libqt5gui5 qtbase5-dev qtwebengine5-dev \
|
|
libqt5svg5-dev qt5-image-formats-plugins aria2 \
|
|
qttools5-dev-tools qtchooser qt5-qmake \
|
|
qtbase5-dev-tools
|
|
```
|
|
|
|
Compilation
|
|
-----------
|
|
|
|
Once all dependencies are installed, you can compile Kiwix Desktop:
|
|
|
|
```bash
|
|
qmake .
|
|
make
|
|
```
|
|
|
|
`qmake` will use pkg-config to locate libraries. Depending of where
|
|
you've installed libkiwix (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:
|
|
|
|
```bash
|
|
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:
|
|
```bash
|
|
sudo make install
|
|
```
|
|
|
|
Run
|
|
---
|
|
|
|
To run Kiwix Desktop
|
|
```bash
|
|
kiwix-desktop
|
|
```
|
|
|
|
You might have to refresh the `ld` database before:
|
|
```bash
|
|
sudo ldconfig
|
|
```
|
|
|
|
If you face problems such as `library not found...`, add the following
|
|
environment variable:
|
|
|
|
```bash
|
|
LD_LIBRARY_PATH="<...>/BUILD_native_dyn/INSTALL/lib/x86_64-linux-gnu"
|
|
```
|
|
|
|
## Communication
|
|
|
|
Available communication channels:
|
|
* [Web Public Chat channel](https://chat.kiwix.org)
|
|
* [Email](mailto:contact+android@kiwix.org)
|
|
* [Mailing list](mailto:kiwix-developer@lists.sourceforge.net)
|
|
* [Slack](https://kiwixoffline.slack.com): #android channel [Get an invite](https://join.slack.com/t/kiwixoffline/shared_invite/enQtOTUyMTg4NzMxMTM4LTU0MzYyZDliYjdmMDYzYWMzNDA0MDc4MWE5OGM0ODFhYjAxNWIxMjVjZTU4MTkyODJlZWFkMmQ2YTZkYTUzZDY)
|
|
* IRC: #kiwix on irc.freenode.net
|
|
|
|
For more information, please refer to
|
|
[https://wiki.kiwix.org/wiki/Communication](https://wiki.kiwix.org/wiki/Communication).
|
|
|
|
License
|
|
-------
|
|
|
|
[GPLv3](https://www.gnu.org/licenses/gpl-3.0) or later, see
|
|
[LICENSE](LICENSE) for more details.
|