From 5918357a6c3f33595d38a42859685d9795c5a54f Mon Sep 17 00:00:00 2001 From: Bernard Date: Sun, 13 Oct 2019 20:35:03 +0100 Subject: [PATCH] Updating XMPP (_en) docs to make explicit how to use XMPP account. --- XMPP.md | 57 +++++++++++++++++++++++++++++++++------------------------ 1 file changed, 33 insertions(+), 24 deletions(-) diff --git a/XMPP.md b/XMPP.md index 85a30665..fdff0d24 100644 --- a/XMPP.md +++ b/XMPP.md @@ -1,53 +1,62 @@ # Chat, VoIP and social network with -YunoHost comes installed with an instant messaging server Metronome which implements the [XMPP protocol](https://en.wikipedia.org/wiki/Extensible_Messaging_and_Presence_Protocol). +YunoHost comes installed with an instant messaging server Metronome which implements the [XMPP protocol](https://en.wikipedia.org/wiki/Extensible_Messaging_and_Presence_Protocol)(previously known as Jabber), by default. -XMPP is an open and extensible protocol which allows to create chatrooms, to share status and data, to give calls in VoIP and videoconferences. +This protocol is already used by millions of people around the world - it is an open protocol. All applications based on XMPP are compatible with each other: when using an XMPP client, you can interact with anybody who has an XMPP account. -All applications based on XMPP are compatible with each other : when using an XMPP client, you can interact with anybody who has an XMPP/Jabber account. This protocol is already used by millions of people around the world. +XMPP is an extensible protocol - this means users can configure "extensions" to chatrooms, to share messages and files, and to make voice and video calls using XMPP. -### XMPP/Jabber account +## XMPP account -An XMPP/Jabber account is based on an identifier with the structure `user@domain.tld`, and a password. +To use an XMPP account you need a username, which takes the format: `user@domain.tld`, and a password. -In YunoHost, this identifier simply corresponds to the main email address of a user, with his regular password. +With YunoHost, an XMPP account is created for a registered account automatically. The XMPP account can be used with the main email address and her YunoHost password. -### Connecting to XMPP +## Connecting to your YunoHost XMPP account -There are several web client built with social network features : +You can connect to your YunoHost XMPP account in different ways. + +### Web clients + +There are several XMPP web clients: - [Movim](https://pod.movim.eu) - [Libervia/Salut à Toi](http://salut-a-toi.org/). + +### Desktop clients + You can also use a desktop client such as : -- [Pidgin](http://pidgin.im/) (multiplatform), +- [Pidgin](http://pidgin.im/) (multiplatform), - [Gajim](http://gajim.org/) (Linux, Windows), - [Dino](https://dino.im) (Linux), -- [Thunderbird](https://www.thundebird.net/) (multiplatform), -- [Jitsi](http://jitsi.org/) (multiplatform) +- [Thunderbird](https://www.thundebird.net/) (multiplatform), +- [Jitsi](http://jitsi.org/) (multiplatform) - [Adium](https://adium.im/) (Mac OS). -... or a mobile client -* [Xabber](http://xabber.com) (Android) -* [Conversations](https://conversations.im/) (Android) -* [Movim under Android](https://movim.eu) -* [Monal](https://itunes.apple.com/us/app/monal-free-xmpp-chat/id317711500?mt=8) (iOS) +### Mobile clients + +Or a mobile client such as: +- [Xabber](http://xabber.com) (Android) +- [Conversations](https://conversations.im/) (Android) +- [Movim under Android](https://movim.eu) +- [Monal](https://itunes.apple.com/us/app/monal-free-xmpp-chat/id317711500?mt=8) (iOS) Here is an exhaustive list of XMPP clients : https://en.wikipedia.org/wiki/Comparison_of_XMPP_clients -### Encrypt conversations with OMEMO +## Encrypt conversations with OMEMO -XMPP chats can be encrypted with the help of [OMEMO](https://xmpp.org/extensions/xep-0384.html), for instance using Gajim : -* Install `gajim` and the plugin `gajim-omemo` -* Enable the plugin in `Tools > Plugins` -* Enable it -* Enable the encryption in the chat with somebody who also has OMEMO +XMPP chats can be made secure and private using [OMEMO] encryption (https://xmpp.org/extensions/xep-0384.html), for instance using Gajim: +- Install `gajim` and the plugin `gajim-omemo` +- Enable the plugin in `Tools > Plugins` +- Enable it +- Enable the encryption in the chat with somebody who also has OMEMO -### Chatrooms +## Chatrooms To create a chatroom (multi-user chat) on your YunoHost server, use the identifier `chatroomname@muc.yourdomain.tld`. For this to work you need to [add the corresponding `muc.` DNS record](dns_config_fr) in the DNS configuration. -### VoIP and videoconferences +## VoIP and videoconferences A practical tool to call an XMPP client, either with voice or voice+video, is to use the client [Jitsi](http://jitsi.org/).