# Matrix - Client

:::tip
ARISE héberge un client Matrix sur <https://chat.iiens.net/> !

:::

### 

## Connexion

Le client web est déjà configuré pour fonctionner avec le serveur IIEns, il vous suffit de vous connecter avec vos identifiants Arise. Pour les client mobiles vous devez par contre indiquer le serveur Arise.


Il existe différent client matrix pour mobile : ElementClassic, ElementX,…



 ![riot_connexion.png](https://notes.iiens.net/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzL2U5ZDE0MjM4LWU2ZjctNGUwNi05ZDNhLTNhZWFhYTY1ZmU4My9jYWIzOTI1YS1mZWE0LTRlZGYtOTA5NC00ZWI0YzU5MjIzZjQvcmlvdF9jb25uZXhpb24ucG5nIiwidHlwZSI6ImF0dGFjaG1lbnQiLCJpYXQiOjE3OTIyMTU5MDAsImV4cCI6MTc5MjMwMjMwMH0.NGPkbU6t6xa-ZH5Mc1pvbsHGgq4AHY7pZrWA_gAo9rc)


## Room

Sur Matrix, un salon de discussion s'appelle une room. Les rooms peuvent être partagées entre différents serveurs si des utilisateurs de plusieurs serveurs la rejoignent.

Une room dispose d'un identifiant interne, ainsi que de zéro ou plusieurs alias. Une room ne peut être rejointe qu'à partir d'un de ses alias. Les alias sont de la forme *#nomdelaroom:nomduserveur*. Par exemple, [#arise:iiens.net](https://riot.iiens.net/#/room/#arise:iiens.net "https://riot.iiens.net/#/room/#arise:iiens.net") est un alias valide (et existant).

Pour rejoindre une room, cliquez sur le répertoire des salons sur le client web (en bas à gauche), ou sur le bouton + sur mobile, et entrez son nom complet.


 ![2017-09-04-225512_1920x1080_scrot.png](https://notes.iiens.net/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzL2U5ZDE0MjM4LWU2ZjctNGUwNi05ZDNhLTNhZWFhYTY1ZmU4My8zMjVlZDZhZi1lNmY4LTRhMjctYmNiZi05NTE4ZWViYTliYmQvMjAxNy0wOS0wNC0yMjU1MTJfMTkyMHgxMDgwX3Njcm90LnBuZyIsInR5cGUiOiJhdHRhY2htZW50IiwiaWF0IjoxNzkyMjE1OTAwLCJleHAiOjE3OTIzMDIzMDB9.VsQh6CK94F_szCIPmlZ74pSVNt0WP0HUXO3DiOvCXsQ)



 ![riot_join.png](https://notes.iiens.net/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzL2U5ZDE0MjM4LWU2ZjctNGUwNi05ZDNhLTNhZWFhYTY1ZmU4My81MGE4ZWVmNy0zMmIwLTQ5MTUtOTRlMC01OWViYTUxNWQyOGUvcmlvdF9qb2luLnBuZyIsInR5cGUiOiJhdHRhY2htZW50IiwiaWF0IjoxNzkyMjE1OTAwLCJleHAiOjE3OTIzMDIzMDB9.yos9fbxzwX6jnXsXru1ccPfmdcCv4nw0I-LZDtfcoDg)



 ![riot_join_2.png](https://notes.iiens.net/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzL2U5ZDE0MjM4LWU2ZjctNGUwNi05ZDNhLTNhZWFhYTY1ZmU4My8wYTlhMGI1Yy1mYzczLTRjNjAtYWIwYS1jZjcwNDYyNGQ3NjQvcmlvdF9qb2luXzIucG5nIiwidHlwZSI6ImF0dGFjaG1lbnQiLCJpYXQiOjE3OTIyMTU5MDAsImV4cCI6MTc5MjMwMjMwMH0.q54iJ2ownwTgNFwRdD5RJ0zZ1Nw6a1JBRywhUbgHCRE)


## Rejoindre un channel IRC

Un des avantages de Matrix est l'existence de bridges, notamment vers IRC. Cela permet de continuer à communiquer avec les gens présents sur IRC depuis Matrix.

Sur le serveur IIEns.net, toutes les rooms de la forme *##channel:iiens.net* sont bridgées avec le channel *#channel* correspondant. Par exemple, si vous voulez rejoindre le channel IRC *#ensiie*, il vous suffit de rejoindre la room *##ensiie:iiens.net*.

Si vous voulez créer un nouveau channel IRC, procédez de la même manière en rejoignant le channel comme s'il existait déjà.

## Nick sur IRC

Par défaut, vous aurez sur IRC le même nom que sur Matrix. Par exemple, si je m'appelle "Moise" sur Matrix, je m'appellerais aussi "Moise" sur IRC. En cas de collision, un autre nick sera utilisé (ici "Moise1"), comme le fait Irssi.

## Utiliser NickServ et ChanServ depuis Matrix

C'est facile, il suffit de leur parler normalement :


1. [NickServ](https://riot.iiens.net/#/user/@irc_NickServ:iiens.net?action=chat "https://riot.iiens.net/#/user/@irc_NickServ:iiens.net?action=chat")
2. [ChanServ](https://riot.iiens.net/#/user/@irc_ChanServ:iiens.net?action=chat "https://riot.iiens.net/#/user/@irc_ChanServ:iiens.net?action=chat")

Vous pouvez enregistrer votre mot de passe NickServer, pour être automatiquement authentifié en cas de reconnexion. Pour cela parlez au bot [_irc_bot](https://riot.iiens.net/#/user/@_irc_bot:iiens.net?action=chat "https://riot.iiens.net/#/user/@_irc_bot:iiens.net?action=chat") et utilisez la commande suivante:

```
!storepass password
```

Attention, votre mot de passe est stocké en clair (ou presque) sur le serveur faisant tourner le bridge. Utilisez un mot de passe unique pour NickServ.


### WeeChat

[/services_arise/weechat](/doc/db95b57b-ca29-49b6-84e9-2dbc5948b71b) est un client IRC en console comme irssi. Il est possible de l'utiliser en tant que client Matrix, parce que vous aimez la CLI, que c'est plus discret qu'un client web, que le client web consomme trop de ram, … Il faut pour cela utiliser [ce script](https://github.com/torhve/weechat-matrix-protocol-script "https://github.com/torhve/weechat-matrix-protocol-script").

**Attention**, ce script modifie les commandes *join*, *part*, entre autres. Une fois le script chargé, vous ne pouvez donc plus aller sur IRC.

Le script a besoin de *lua-cjson* qui n'est pas installé sur perso, mais on peut le faire très facilement avec *LuaRocks*.

```
wget https://luarocks.org/releases/luarocks-2.4.1.tar.gz
tar zxpf luarocks-2.4.1.tar.gz
cd luarocks-2.4.1
./configure --prefix=$HOME/.local
make build
make install
echo 'export PATH=$PATH":$HOME/.local/bin' >> $HOME/.bashrc
luarocks path >> $HOME/.bashrc
source ~/.bashrc
```

On peut maintenant installer le script :

```
luarocks install lua-cjson
git clone https://github.com/torhve/weechat-matrix-protocol-script
ln -s path/to/weechat-matrix-protocol-script/matrix.lua $HOME/.weechat/autoload/matrix.lua
```

Pour la configuration, dans weechat :

```
/set plugins.var.lua.matrix.user username
/set plugins.var.lua.matrix.password secret
```

Il existe plusieurs clients :


1. un client [web](https://riot.iiens.net "https://riot.iiens.net")
2. un client [android](https://play.google.com/store/apps/details?id=im.vector.alpha&hl=fr "https://play.google.com/store/apps/details?id=im.vector.alpha&hl=fr")
3. un client [iOS](https://itunes.apple.com/fr/app/riot-im-open-source-collaboration-via-matrix/id1083446067?mt=8 "https://itunes.apple.com/fr/app/riot-im-open-source-collaboration-via-matrix/id1083446067?mt=8")
4. un client [logiciel](https://riot.im/desktop.html "https://riot.im/desktop.html") (Windows 7+, MacOS, Debian-like)
5. mais aussi un script pour utiliser Matrix dans [weechat](https://github.com/torhve/weechat-matrix-protocol-script "https://github.com/torhve/weechat-matrix-protocol-script")
6. ainsi que d'autres [clients](https://matrix.org/docs/projects/try-matrix-now.html#clients "https://matrix.org/docs/projects/try-matrix-now.html#clients")

---

**Documents**

- [Salons ARISE](https://notes.iiens.net/s/publique/doc/salons-arise-ZetToDSLhm)