Skip to content
Snippets Groups Projects
README.md 4.43 KiB
Newer Older
Andrea Schaefer's avatar
Andrea Schaefer committed
# Chatty

A libpurple messaging client
Andrea Schaefer's avatar
Andrea Schaefer committed


## Build and install

### Install dependencies

On a Debian based system run

Andrea Schaefer's avatar
Andrea Schaefer committed
``` bash
    sudo apt-get -y install build-essential
    sudo apt-get -y build-dep .
Andrea Schaefer's avatar
Andrea Schaefer committed
```

For an explicit list of dependencies check the Build-Depends entry in the
[debian/control](https://source.puri.sm/Librem5/chatty/blob/master/debian/control#5)
file.

Libhandy (libhandy-1-dev) is available in [PureOS][0] and  Debian's
[experimental distribution][1].  If you don't want to fetch it from there you
can [build it from souce][2].

### Build and install the 'carbons' plugin
Message synchronization between devices according to XEP-0280

``` bash
git clone https://github.com/gkdr/carbons.git
cd carbons
make
make install
```

### Build and install the 'lurch' plugin
Please go to the git page where you'll find information on how to build and use the
[lurch OMEMO plugin](https://github.com/gkdr/lurch)
This can be skipped if encrypted messaging is not needed.


### Build and install the 'purple-telegram' plugin
Please go to the git page where you'll find information on how to build and install the
[Telegram messenger plugin](https://github.com/majn/telegram-purple)

This can be skipped if Telegram messaging is not needed.
### Build and install mmsd-tng
Please go to the git page where you'll find information on how to build and install the
[mmsd-tng](https://gitlab.com/kop316/mmsd)

This can be skipped if MMS is not needed.
### Build and install 'libfeedback'
Please go to the git page where you'll find information on how to build and use
[Feedbackd and libfeedback](https://source.puri.sm/Librem5/feedbackd)


Andrea Schaefer's avatar
Andrea Schaefer committed
``` bash
meson build
ninja -C build
```
### Enabling Matrix support (optional)
To enable matrix support, run the following:
```bash
gsettings set sm.puri.Chatty experimental-features true
```

## Running from the source tree
To run Chatty from source tree (without installing) do:

``` bash
build/run
```

To start Chatty under `gdb` set `CHATTY_GDB=1` for the run script.

## Running over ssh

```sh
ssh -X purism@ip
# kill chatty twice to kill existing instance
killall chatty; killall chatty
build/run -vvv --display=$DISPLAY
```

When running over ssh, if you run into polkit permission issues
like the following:

```sh
Error sending message:
GDBus.Error:org.freedesktop.ModemManager1.Error.Core.Unauthorized:
PolicyKit authorization failed: not authorized for
'org.freedesktop.ModemManager1.Messaging'
```

you can work around the permission issue by running chatty
on device, but displaying the window on appropriate display:

```sh
ssh -X purism@ip
# kill chatty twice to kill existing instance
killall chatty; killall chatty
echo $DISPLAY # Use the value you get here in next step
```

and on the device, open some terminal and do so so that the window
will be shown in a different display:
```sh
# Replace XXX with the value you got in the previous step
build/run -vvvv --display=XXX
```
## Commands

In a messaging conversation (except SMS conversations) the following commands can be used:

### lurch plugin

- '/lurch help': Displays a list with available commands.
- '/lurch uninstall': Uninstalls this device from OMEMO by removing its device ID from the devicelist.
- '/lurch blacklist add': Adds conversation partner to blacklist.
- '/lurch blacklist remove': Removes conversation partner from blacklist.
- '/lurch show id own': Displays this device's ID.
- '/lurch show id list': Displays this account's devicelist.
- '/lurch show fp own': Displays this device's key fingerprint.
- '/lurch show fp conv': Displays the fingerprints of all participating devices.
- '/lurch remove id <id>': Removes a device ID from the own devicelist.


## XMPP account

If you don't have an XMPP account yet and want to subscribe to a service then please make sure that the server supports the following XEPs:

- XEP-0237: Roster Versioning
- XEP-0198: Stream Management
- XEP-0280: Message Carbons
- XEP-0352: Client State Indication
- XEP-0313: Message Archive Management
- XEP-0363: HTTP File Upload

- chatty crashes in OMEMO encrypted chats.  This is due to a symbol conflict between
  libolm3 and libaxc. A work around is done in [PureOS][3].  A proper fix would
  be to not export those symbols from libolm at all.
[0]: http://software.pureos.net/search_pkg?term=libhandy-1-dev
[1]: https://packages.debian.org/search?keywords=libhandy-1-dev
[2]: https://source.puri.sm/Librem5/libhandy
[3]: https://source.puri.sm/Librem5/debs/olm/-/merge_requests/2