Table des matières
Installation
Archlinux / Manjaro
sudo pacman -Sy weechat
Alpine Linux
sudo apk add weechat
Debian Linux / Ubuntu / Mint
sudo apt install weechat
Configuration
Ajouter un serveur
/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
Connexion "à la volée"
Par défaut, cette option est désactivée.
/set irc.look.temporary_servers on /connect irc.serveur.net # Se connecter immédiatement sur irc.serveur.net /nick T0MuX # Choisir un nickname
Interface
# 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
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).
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.
# 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
Récupérer son token
Suivre la procédure officielle.
Configuration dans Weechat
# Saisir son token /discord token [TOKEN] # Connecter à discord /discord connect # Connecter discord au lancement de Weechat /discord autostart
Matrix Python Plugin
Sur Archlinux / Manjaro, s'installe via le paquet weechat-matrix.
yay -S weechat-matrix
Configuration dans Weechat
/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"
Matrix lua plugin
Pour commencer, assurez vous d'avoir lua et lua-cjson d'installés.
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/
Ensuite, dans Weechat
# 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
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 :
/script install go.py