1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
|
# Chatty
This is the projects of the "Chats" application:
A simple to use messaging app for 1:1 communication and small groups supporting
SMS/MMS using [ModemManager] and [mmsd-tng], matrix via [libcmatrix]
and optionally XMPP through [libpurple].
## Build and install
In case you want to disable the libpurple plugin support
have a look at [meson_options.txt](meson_options.txt)
### Getting the source
```sh
git clone https://gitlab.gnome.org/World/Chatty
cd Chatty/
```
### Install dependencies
On a Debian based system run
``` bash
sudo apt-get -y install build-essential
sudo apt-get -y build-dep .
```
For an explicit list of dependencies check the Build-Depends entry in the
[debian/control](https://gitlab.gnome.org/World/Chatty/blob/main/debian/control#5)
file.
Plugins are optional and can often be installed from your distribution sources.
Installation from source is required only if you want to debug the plugin itself,
or you have any reason to do so.
### Build and install mmsd-tng (Optional)
mmsd-tng provides MMS support. On Debian and derivatives you
can install `mmsd-tng` package.
To build from source see [mmsd-tng](https://gitlab.com/kop316/mmsd)
This can be skipped if MMS is not needed.
### Build Chatty
``` bash
meson setup build # From chatty source directory
meson compile -C build
```
## Running from the source tree
To run Chatty from source tree (without installing) do:
``` bash
build/run
# or
build/run -vvvv # To run with (verbose) logs
# or to start Chatty under `gdb`
CHATTY_GDB=1 build/run -vv
```
## 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
```
## Backup and Restore
Chatty stores data in the following locations:
- `~/.purple` - chat history and libpurple config
- `~/.purple/chatty/db/chatty-history.db` - XMPP, SMS and MMS chat history
- `~/.purple/chatty/db/matrix.db` - Matrix chat history and related data
- `~/.local/share/chatty/` - Downloaded files and avatars are stored here
- `~/.cache/chatty` - Cached data and temporary files are stored here
Also, Matrix account secrets are stored with `libsecret`, those details can
be retrieved using `GNOME Passwords`.
To backup, simply copy all of these locations. To restore, place all of the
contents back in those respective folders.
If you want to modify/delete any of the above data, you should first close
all running instance of chatty by running `killall chatty` multiple times
until it says `chatty: no process found`.
## Debugging
If you want to debug chatty, you should first close all running instance
of chatty by running `killall chatty` multiple times until it says
`chatty: no process found`.
To run chatty with verbose logs, you can run `chatty -vvvv`
(or `./run -vvvv` from the build directory). In case of crashes,
a `gdb` log is printed if `gdb` debugger is present on the system.
Please note that if you remove `~/.purple/chatty/db/matrix.db`,
your matrix account token will be renewed, resulting in your
account been seen as a new device for others.
To get better logs,
you should use debug symbols for chatty and related libraries.
You can do this either by setting `DEBUGINFOD_URLS=https://debuginfod.debian.net`
(adjust URL for your distribution)
which should result in `gdb` prompting you to download the symbols **or**
on Debian and derivates, [enable debug repo][0] and run:
```sh
sudo apt-get install chatty-dbgsym libglib2.0-0-dbgsym libgtk-4-1-dbgsym libsoup-3.0-0-dbgsym
```
See [GLib][1] and [Gtk][2] documentations to know more debugging details
related to `GLib` and `Gtk`.
## Translations
You can contribute translations via [GNOME Damned Lies](https://l10n.gnome.org/module/chatty/).
## Guidelines for Maintainers
We follow [Phosh's Guidelines for Maintainers](https://gitlab.gnome.org/World/Phosh/phosh/-/wikis/Guidelines-for-maintainers).
## XMPP
XMPP support is not actively developed anymore and might be dropped completely in the future.
If you would like to see that changed consider [stepping up](https://gitlab.gnome.org/World/Chatty/-/issues/842).
### Build and install the 'carbons' plugin (Optional)
Message synchronization between devices according to XEP-0280.
On Debian and derivates you can install the `purple-xmpp-carbons` package.
Alternativelly, to build from source, run:
``` bash
git clone https://github.com/gkdr/carbons.git
cd carbons
make
make install
```
### Build and install the 'lurch' plugin (Optional)
lurch plugin implements XEP-0384 (OMEMO Encryption).
On Debian and derivates you can install `purple-lurch` package.
To build from source see [lurch OMEMO plugin](https://github.com/gkdr/lurch)
### 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
[0]: https://wiki.debian.org/HowToGetABacktrace
[1]: https://docs.gtk.org/glib/running.html
[2]: https://docs.gtk.org/gtk4/running.html
### Experimental Features
Sometimes things are hidden behind experiemental features. Do not enable
unless you know what you are doing! To activate:
```bash
gsettings set sm.puri.Chatty experimental-features true
```
# Getting in Touch
* Issue tracker: https://gitlab.gnome.org/World/Chatty/issues
* Matrix: https://matrix.to/#/#chatty:talk.puri.sm
[ModemManager]: https://modemmanager.org/
[mmsd-tng]: https://gitlab.com/kop316/mmsd
[libcmatrix]: https://source.puri.sm/Librem5/libcmatrix
[libpurple]: https://developer.pidgin.im/wiki/WhatIsLibpurple
|
