# Matrique

[![pipeline status](https://gitlab.com/b0/matrique/badges/master/pipeline.svg)](https://gitlab.com/b0/matrique/commits/master)
[![coverage report](https://gitlab.com/b0/matrique/badges/master/coverage.svg)](https://gitlab.com/b0/matrique/commits/master)

<a href='https://flathub.org/apps/details/org.eu.encom.matrique'><img width='240' alt='Get it on Flathub' src='https://flathub.org/assets/badges/flathub-badge-i-en.png'/></a>

> "Nobody can be told what the matrix is, you have to see it for yourself. "

Matrique is a glossy cross-platform client for Matrix, the decentralized communication protocol for instant messaging.

## Contact

You can reach the maintainer at #matrique:matrix.org, if you are already on Matrix.

Also, you can file an issue at this project if anything goes wrong.

## Download

You can fetch the release of Matrique on Flathub. The link is at the beginning of this README.

Alternatively, you can download the Flatpak nightly build bundle from here: ![Download Bundle](https://gitlab.com/b0/matrique/-/jobs/artifacts/dev/raw/flatpak/matrique.flatpak?job=build-flatpak)

Open the bundle using your preferred software center.

### Requirements

An operating system with Flatpak installed.
Fedora 28 is known to work, other GNU/Linux distributions should work as well if they have Flatpak installed.

*P.S. In case if you haven't figured it out, the instruction above only works on Master OS. 
No precompiled binary for MacOS and Microsoft Windows yet.*

## Run

If you install Matrique through Flatpak, you should already be able to run it from the app launcher.

If not, 

```bash
flatpak run org.eu.encom.matrique
```

## Compile from Source

You can compile Matrique from source if you want to.

The requirements are Qt, QMake, Qt Quick, Qt Quick Controls 2, Qt Multimedia, and several others.

* Fetch the code.

```bash
git clone --recursive https://gitlab.com/b0/matrique
```

* Open in Qt Creator using the default config.
* Run.

*Still prefer commands?*

```bash
mkdir build && cd build
qmake ..
make
sudo make install
```

## Acknowledgement

This program uses libqmatrixclient library and C++ models from Quaternion. 

![Quaternion](https://github.com/QMatrixClient/Quaternion)

![libqmatrixclient](https://github.com/QMatrixClient/libqmatrixclient)

## License

![GPLv3](https://www.gnu.org/graphics/gplv3-127x51.png)

This program is licensed undedr GNU General Public License, Version 3.