===== Installation =====

=== Archlinux / Manjaro ===

<code>
sudo pacman -Sy weechat
</code>

=== Alpine Linux ===

<code>
sudo apk add weechat
</code>

=== Debian Linux / Ubuntu / Mint ===

<code>
sudo apt install weechat
</code>

===== Configuration =====

==== Ajouter un serveur ====

<code>
/server add mon_serveur irc.server.net
/set irc.server.mon_serveur.username T0MuX
/set irc.server.mon_serveur.password mon_pass_qui_poutre
/set irc.server.mon_serveur.autoconnect on # Activer l'autoconnexion au lancement
/set irc.server.mon_serveur.autojoin "#canal1,#canal2,#canal3" # Activer l'autojoin sur les canaux entre guillemets
</code>

==== Connexion "à la volée" ====

Par défaut, cette option est désactivée.

<code>
/set irc.look.temporary_servers on
/connect irc.serveur.net # Se connecter immédiatement sur irc.serveur.net
/nick T0MuX # Choisir un nickname
</code>

==== Interface ====

<code>
# Les nicknames matrix peuvent être long, ainsi que le nom de certains salons on peut les raccourcir un peu :
/set weechat.look.prefix_align_max 15 # pseudo dans le tampon actuel
/set weechat.bar.nicklist.size 15 # liste de pseudo membres de la room
/set weechat.bar.buflist.size_max 20 # liste de rooms
</code>

===== Utilisation =====

==== Raccourcis clavier & commandes ====

^Fonction^Raccourci^Commande|
^Défilement|↑ Alt + PgUp - Alt + PgDn ↓|/window scroll_up - /window scroll_down|
^Changer de salon|← Ctrl+P - Ctrl+N →|/buffer [-1,+1]|
^Changer de fenêtre|← Ctrl+H / ↓ Ctrl+J / ↑ Ctrl+K / → Ctrl+L| |
^Fermer le buffer|?|/buffer close|
^Fenetre actuelle en plein écran|Ctrl+Z| |
^Chercher|Ctrl+R| |
^Arrêter chercher|Ctrl+J| |
^Sauter aux salons avec activité récente|Alt+A|/input jump_smart|

=== Modifier un bind ===

Il se peut que certains binds ne fonctionnent pas correctement, ou que vous vouliez tout simplement les changer. Par exemple sur mon laptop, le Alt+A ne fonctionne pas. Je suis obligé d'en mettre un autre. Alors j'édite le fichier **~/.weechat/weechat.conf** et je trouve **meta-a** pour le changer en ce que je veux (meta = alt). En **ctrl-a** par exemple, mais attention à ne pas avoir la même hotkey pour deux fonctions différentes… l'astuce est de commenter celle deja existante (donc de préférence, choisir une fonction dont on ne se sert pas).

[[https://web.archive.org/web/20200809135556/https://weechat.org/files/doc/devel/weechat_user.en.html#key_bindings|source]]

===== Plugins =====

==== Discord Plugin Rust ====

Sur Archlinux / Manjaro, s'installe via le paquet **weechat-discord-git**. Une fois installé, le plugin est automatiquement chargé par Weechat.

<code=bash>
# Installation sur Archlinux
yay -S weechat-discord-git

# Installation depuis github (il faut avoir rust et libclang)
git clone https://github.com/terminal-discord/weechat-discord
cd weechat-discord
make
make install # copie la librairie dans ~/.weechat/plugins
</code>

=== Récupérer son token ===

Suivre la [[https://web.archive.org/web/20200809135556/https://discordhelp.net/discord-token|procédure officielle]].

=== Configuration dans Weechat ===

<code>
# Saisir son token
/discord token [TOKEN]
# Connecter à discord
/discord connect
# Connecter discord au lancement de Weechat
/discord autostart
</code>

==== Matrix Python Plugin ====

Sur Archlinux / Manjaro, s'installe via le paquet **weechat-matrix**.

<code>
yay -S weechat-matrix
</code>

=== Configuration dans Weechat ===

<code>
/matrix server add mux mux.re
/set matrix.server.mux.username T0MuX
/set matrix.server.mux.password mon_pass_qui_tue
/set matrix.server.mux.autoconnect on # Activer la connexion auto au lancement
/matrix connect mux # Se connecter au serveur "mux"
</code>

==== Matrix lua plugin ====

Pour commencer, assurez vous d'avoir **lua** et **lua-cjson** d'installés.

<code>
git clone https://github.com/torhve/weechat-matrix-protocol-script
mkdir -p ~/.weechat/lua/autoload/
cp weechat-matrix-protocol-script/matrix.lua ~/.weechat/lua/
ln -s ~/.weechat/lua/matrix.lua ~/.weechat/lua/autoload/
</code>

Ensuite, dans Weechat

<code>
# Si vous n'avez pas mis matrix.lua dans autoload
/script load matrix.lua
# Configurez les identifiants. Regardez la doc WeeChat à propos de secdata si vous ne voulez pas stocker le mdp en clair (http://dev.weechat.org/post/2013/08/04/Secured-data en anglais)
/set plugins.var.lua.matrix.user utilisateur
/set plugins.var.lua.matrix.password mot_de_passe
/set plugins.var.lua.matrix.homeserver_url https://mux.re/ # ne surtout pas oublier "/" à la fin de l'url
/matrix connect

# Pour afficher tous les paramètres possibles pour matrix
/set plugins.var.lua.matrix.*
# pour voir une description de chaque commande
/help plugins.var.lua.matrix.local_echo

# Pour avoir "est entrain d'écrire" on peut rajouter "matrix_typing_notice" à la bar
/set weechat.bar.status.items [buffer_count],[buffer_plugin],buffer_number+:+buffer_name+{buffer_nicklist_count}+buffer_filter,[hotlist],completion,scroll,matrix_typing_notice
</code>

[[https://web.archive.org/web/20200809135556/https://github.com/torhve/weechat-matrix-protocol-script|source]]

===== Scripts =====

Weechat est doté d'une fonction qui peut vraiment apporté un plus à son utilisation : les scripts. On peut charger toutes sortes de scripts, dans plusieurs languages (python, lua, go, ruby…).

J'apprécie particulièrement go.py, qu'on installe de cette façon :

<code>
/script install go.py
</code>