... | ... | @@ -3,14 +3,16 @@ |
|
|
This page describes how to manually set up Kaidan on Debian-based systems (i.e. Ubuntu, KDE Neon, Linux Mint, etc.).
|
|
|
It is also meant as a description for setting up Kaidan on other Linux distributions.
|
|
|
|
|
|
## Non-debian based distributions
|
|
|
In this guide, **replace `$HOME` with the path of the directory that will contain all development data**.
|
|
|
|
|
|
## Non Debian-based Systems
|
|
|
|
|
|
If you are running a distribution that is not based on debian, you can still follow this guide, by running debian in [distrobox](https://distrobox.privatedns.org/). Of course Kaidan also compiles on other distributions, but we do not want to collect the package names for every distribution out there here.
|
|
|
```
|
|
|
distrobox create --image docker.io/debian:testing
|
|
|
```
|
|
|
|
|
|
## Install *dependencies*
|
|
|
## Install *Dependencies*
|
|
|
|
|
|
Make sure that your distribution provides at least the minimum versions of [Kaidan's dependencies](https://invent.kde.org/network/kaidan#dependencies).
|
|
|
|
... | ... | @@ -25,7 +27,7 @@ sudo apt install git cmake extra-cmake-modules build-essential \ |
|
|
libqca-qt5-2-dev libqca-qt5-2-plugins libkf5kio-dev kio-extras
|
|
|
```
|
|
|
|
|
|
## Set up *desktop style* for desktop systems without a Qt integration (optional)
|
|
|
## Set Up *Desktop Style* for Desktop Systems without a Qt Integration (Optional)
|
|
|
|
|
|
If your system has no Qt integration (e.g., on systems with GNOME such as the regular Ubuntu), you can set up the correct desktop style.
|
|
|
For KDE Plasma, you do not need that since it has such an integration.
|
... | ... | @@ -41,7 +43,7 @@ echo "export QT_QUICK_CONTROLS_STYLE=org.kde.desktop" >> ~/.profile |
|
|
source ~/.profile
|
|
|
```
|
|
|
|
|
|
## Set up theming for desktop environments other than KDE Plasma (e.g., GNOME)
|
|
|
## Set Up Theming for Desktop Environments other than KDE Plasma (e.g., GNOME)
|
|
|
|
|
|
To get a more appropriate look of Kaidan, you can use a configuration tool (`qt5ct` for Qt5 apps such as *Kaidan* and `qt6ct` for Qt6 apps such as *QtCreator*).
|
|
|
|
... | ... | @@ -58,12 +60,13 @@ After opening the configuration tools, set the settings you want for each of the |
|
|
For example with GNOME on Ubuntu, you might want to set the widget theme to *Adwaita*, the standard dialogs to *GTK3* (for the file dialog) and the icon theme to *Breeze*.
|
|
|
Furthermore, you can adjust the font to *Ubuntu Regular* with size *11* and *Ubuntu Mono Regular* with size *13*.
|
|
|
|
|
|
## Set up OMEMO library *libomemo-c*
|
|
|
## Set Up OMEMO Library *libomemo-c*
|
|
|
|
|
|
There is currently (as of 2022-09-18) no Debian package for *libomemo-c*.
|
|
|
Thus, it has to be built manually.
|
|
|
|
|
|
```bash
|
|
|
cd $HOME
|
|
|
git clone https://github.com/dino/libomemo-c.git
|
|
|
mkdir libomemo-c/build && cd libomemo-c/build
|
|
|
cmake -DBUILD_SHARED_LIBS=ON ..
|
... | ... | @@ -71,7 +74,7 @@ make -j$(nproc) |
|
|
sudo make install
|
|
|
```
|
|
|
|
|
|
## Set up the XMPP library *QXmpp*
|
|
|
## Set Up XMPP Library *QXmpp*
|
|
|
|
|
|
QXmpp can either be used via a Debian package or by building it manually.
|
|
|
|
... | ... | @@ -79,6 +82,7 @@ If the version packaged in Debian is too old, QXmpp has to be built manually. |
|
|
That is currently (as of 2022-09-18) the case.
|
|
|
|
|
|
```bash
|
|
|
cd $HOME
|
|
|
git clone https://github.com/qxmpp-project/qxmpp.git
|
|
|
mkdir qxmpp/build && cd qxmpp/build
|
|
|
cmake -DBUILD_OMEMO=ON -DBUILD_TESTS=OFF -DBUILD_EXAMPLES=OFF ..
|
... | ... | @@ -93,11 +97,12 @@ But remember that recent features in Kaidan often also need a more recent versio |
|
|
sudo apt install libqxmpp-dev
|
|
|
```
|
|
|
|
|
|
## Set up *Kaidan*
|
|
|
## Set Up *Kaidan*
|
|
|
|
|
|
### Get the source code
|
|
|
### Get the Source Code
|
|
|
|
|
|
```bash
|
|
|
cd $HOME
|
|
|
git clone https://invent.kde.org/network/kaidan.git
|
|
|
```
|
|
|
|
... | ... | @@ -121,7 +126,7 @@ If you get the error *kaidan: error while loading shared libraries: libomemo-c.s |
|
|
sudo ldconfig
|
|
|
```
|
|
|
|
|
|
### Install (optional)
|
|
|
### Install (Optional)
|
|
|
|
|
|
```bash
|
|
|
sudo make install
|
... | ... | @@ -133,7 +138,7 @@ Once you installed Kaidan, you can run it from anywhere. |
|
|
kaidan
|
|
|
```
|
|
|
|
|
|
### Uninstall (optional)
|
|
|
### Uninstall (Optional)
|
|
|
|
|
|
Remove compiled files.
|
|
|
|
... | ... | |