Desktop Qt based XMPP messenger https://macaw.me
Go to file
Blue acd60eaba2
Fixing build without omemo, release preparation, unnecessary inheritance removed, info widget fix
2024-02-04 09:44:19 -03:00
.gitea/workflows Fixing build without omemo, release preparation, unnecessary inheritance removed, info widget fix 2024-02-04 09:44:19 -03:00
cmake refactorng 2023-11-14 20:23:39 -03:00
core Fixing build without omemo, release preparation, unnecessary inheritance removed, info widget fix 2024-02-04 09:44:19 -03:00
external fixes for bundled LMDBAL build 2024-02-01 13:10:52 -03:00
main some debug, fix a crash removing a currently selected contact 2023-11-12 19:55:32 -03:00
packaging Fixing build without omemo, release preparation, unnecessary inheritance removed, info widget fix 2024-02-04 09:44:19 -03:00
plugins testing, solved unhandled exception, conditions to restrict old message to be edited, license un some files that used to miss them 2022-04-01 00:32:22 +03:00
resources encrypted messages now are displayed in the feed 2023-11-06 20:57:08 -03:00
shared Fixing build without omemo, release preparation, unnecessary inheritance removed, info widget fix 2024-02-04 09:44:19 -03:00
translations Refactoring, account destruction fix, some thoughts about where to store contact settings (omemo enable status for instance) 2023-03-16 22:38:05 +03:00
ui Fixing build without omemo, release preparation, unnecessary inheritance removed, info widget fix 2024-02-04 09:44:19 -03:00
.gitmodules transition to LMDBAL 2023-03-27 21:45:29 +03:00
.uncrustify.cfg trying linter settings 2023-11-17 21:52:33 -03:00
CHANGELOG.md Fixing build without omemo, release preparation, unnecessary inheritance removed, info widget fix 2024-02-04 09:44:19 -03:00
CMakeLists.txt Fixing build without omemo, release preparation, unnecessary inheritance removed, info widget fix 2024-02-04 09:44:19 -03:00
LICENSE.md License is now can be viewed locally, some organization name packaging issies 2022-04-05 22:00:56 +03:00
README.md transition to LMDBAL 2023-03-27 21:45:29 +03:00
appveyor.yml fix ci macos matrix item 2021-10-06 18:50:00 +08:00

README.md

Squawk - a compact XMPP desktop messenger

AUR license AUR version Liberapay patrons

Squawk screenshot

Prerequisites

  • QT 5.12 (lower versions might work but it wasn't tested)
  • CMake 3.4 or higher
  • qxmpp 1.1.0 or higher
  • LMDBAL (my own library around lmdb)
  • KDE Frameworks: kwallet (optional)
  • KDE Frameworks: KIO (optional)
  • KDE Frameworks: KConfig (optional)
  • KDE Frameworks: KConfigWidgets (optional)
  • Boost (just one little hpp from there)
  • Imagemagick (for compilation, to rasterize an SVG logo)

Getting

The easiest way to get the Squawk is to install it from AUR (if you use Archlinux like distribution)

Here is the link for the AUR package

You can also install it from console if you use some AUR wrapper. Here what it's going to look like with pacaur

$ pacaur -S squawk

Building

You can also clone the repo and build it from source

Squawk requires Qt with SSL enabled. It uses CMake as build system.

Please check the prerequisites and install them before installation.

For Windows (Mingw-w64) build

You need Qt for mingw64 (MinGW 64-bit) platform when installing Qt.

The best way to acquire library lmdb and boost is through Msys2.

First install Msys2, and then install mingw-w64-x86_64-lmdb and mingw-w64-x86_64-boost by pacman.

Then you need to provide the cmake cache entry when calling cmake for configuration:

cmake .. -D LMDB_ROOT_DIR:PATH=<Msys2 Mingw64 Root Directory> -D BOOST_ROOT:PATH=<Msys2 Mingw64 Root Directory>

<Msys2 Mingw64 Root Directory>: e.g. C:/msys64/mingw64.


There are two ways to build, it depends whether you have qxmpp installed in your system

Building with system qxmpp

Here is what you do

$ git clone https://git.macaw.me/blue/squawk
$ cd squawk
$ mkdir build
$ cd build
$ cmake .. [-D LMDB_ROOT_DIR:PATH=...] [-D BOOST_ROOT:PATH=...]
$ cmake --build .

Building with bundled qxmpp

Here is what you do

$ git clone --recurse-submodules https://git.macaw.me/blue/squawk
$ cd squawk
$ mkdir build
$ cd build
$ cmake .. -D SYSTEM_QXMPP=False [-D LMDB_ROOT_DIR:PATH=...] [-D BOOST_ROOT:PATH=...]
$ cmake --build .

You can always refer to appveyor.yml to see how AppVeyor build squawk.

List of keys

Here is the list of keys you can pass to configuration phase of cmake ...

  • CMAKE_BUILD_TYPE - Debug just builds showing all warnings, Release builds with no warnings and applies optimizations (default is Debug)
  • SYSTEM_QXMPP - True tries to link against qxmpp installed in the system, False builds bundled qxmpp library (default is True)
  • SYSTEM_LMDBAL - True tries to link against LMDABL installed in the system, False builds bundled LMDBAL library (default is True)
  • WITH_KWALLET - True builds the KWallet capability module if KWallet is installed and if not goes to False. False disables KWallet support (default is True)
  • WITH_KIO - True builds the KIO capability module if KIO is installed and if not goes to False. False disables KIO support (default is True)
  • WITH_KCONFIG - True builds the KConfig and KConfigWidgets capability module if such packages are installed and if not goes to False. False disables KConfig and KConfigWidgets support (default is True)
  • WITH_OMEMO - True builds the OMEMO encryption, requires qxmpp of version >= 1.5.0 built with OMEMO support. False disables OMEMO support (default is True)

License

This project is licensed under the GPLv3 License - see the LICENSE.md file for details