$ mkdir build $ cd build $ cmake .. $ make % make install (en root)
Ce manuel documente le client de messagerie instantanée WeeChat, il fait partie de WeeChat.
La dernière version de ce document peut être téléchargée sur cette page : http://www.weechat.org/doc
WeeChat (Wee Enhanced Environment for Chat) est un client de discussion libre, rapide et léger, conçu pour différents systèmes d’exploitation.
Ses principales fonctionnalités sont les suivantes :
multi-protocoles (IRC et bientôt d’autres)
connexion multi-serveurs (avec SSL, IPv6, proxy)
plusieurs interfaces : Curses (wxWidgets, Gtk et Qt en développement)
petit, rapide et léger
paramétrable et extensible avec des extensions et des scripts
multi plates-formes (GNU/Linux, *BSD, MacOS X, Windows et d’autres systèmes)
100% GPL, logiciel libre
La page d’accueil de WeeChat est ici : http://www.weechat.org/
Pour installer WeeChat, vous devez avoir :
un système GNU/Linux (avec le compilateur et les outils associés pour le paquet des sources), ou un système compatible
droits "root" (pour installer WeeChat dans un répertoire système)
la bibliothèque ncurses
Les paquets binaires sont disponibles pour beaucoup de distributions, dont :
Debian (ou toute distribution compatible Debian) : apt-get install weechat
Mandriva/RedHat (ou toute distribution compatible avec les RPM) : rpm -i /path/to/weechat-x.y.z-1.i386.rpm
Gentoo : emerge weechat
Des paquets additionnels peuvent être utiles également, comme weechat-plugins.
Pour les autres distributions supportées, merci de vous référer au manuel de la distribution pour la méthode d’installation.
WeeChat peut être compilé avec cmake ou les autotools (cmake est la méthode recommandée).
Installation dans les répertoires systèmes (nécessite les droits root) :
$ mkdir build $ cd build $ cmake .. $ make % make install (en root)
Installation dans un répertoire spécifique :
$ mkdir build $ cd build $ cmake .. -DPREFIX=/chemin/vers/repertoire $ make $ make install
Installation dans les répertoires systèmes (nécessite les droits root) :
$ ./configure $ make % make install (en root)
Installation dans un répertoire spécifique :
$ ./configure --prefix=/chemin/vers/repertoire $ make $ make install
Attention : les sources GIT sont réservés aux utilisateurs avancés : il se peut que WeeChat ne compile pas et qu’il soit très instable. Vous êtes prévenus !
Pour récupérer les sources GIT, tapez cette commande :
$ git clone git://git.sv.gnu.org/weechat.git
Si vous utilisez les autotools (et non cmake), exécutez ce script :
$ ./autogen.sh
Suivez alors les instructions du paquet source (voir [source_package]).
Paramètres de ligne de commande :
Supprimer la connexion automatique aux serveurs lors du démarrage
Définir le répertoire comme étant la base de WeeChat (utilisé pour les fichiers de configuration, logs, extensions et scripts de l’utilisateur), la valeur par défaut est ~/.weechat (note : le répertoire est créé s’il n’est pas trouvé par WeeChat)
Afficher l’aide
Afficher les touches par défaut de WeeChat
Afficher la licence de WeeChat
Supprimer le chargement automatique des extensions au démarrage
Afficher la version de WeeChat
Option pour l’extension (voir la documentation de chaque extension)
Pour lancer WeeChat, tapez cette commande :
$ weechat-curses
Lorsque vous lancez WeeChat pour la première fois, un fichier de configuration par défaut est créé, avec les options par défaut. Le fichier de configuration par défaut est : ~/.weechat/weechat.conf.
Vous pouvez éditer ce fichier pour configurer WeeChat à votre convenance ou vous pouvez modifier les paramètres dans WeeChat avec la commande /set (voir [weechat_commands]).
Exemple de terminal avec WeeChat :
┌─────────────────────────────────────────────────────────────────────────────────────────┐ │Bienvenue sur #test, canal de test │ │12:52:27 --> | flashy (n=flashcod@hellix.flashtux.org) a rejoint #test │@ChanServ │ │12:52:27 -- | Pseudos #test: [@ChanServ @flashy +_FlashB0t joe mike] │@flashy │ │12:52:27 -- | Canal #test: 5 pseudos (2 ops, 0 halfop, 1 voice, 2 normal) │+_FlashB0t│ │12:52:27 -- | Canal créé le Tue Jan 27 06:30:17 2009 │joe │ │12:54:15 flashy | bonjour ! │mike │ │12:55:01 joe | salut flashy ! │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │[12:55] [4] [irc/freenode] 3:#test(+n){5}* [Act: 4,2] │ │[flashy] salut joe !█ │ └─────────────────────────────────────────────────────────────────────────────────────────┘
L'écran est composé des zones suivantes :
zone de discussion (milieu de l'écran) avec les lignes de discussion, et pour chaque ligne :
heure
préfixe (avant "|")
message (après "|")
barres autour de la zone de discussion, les barres par défaut sont :
barre title, au dessus de la zone de discussion
barre status, sous la zone de discussion
barre input, sous la barre de statut
barre nicklist, sur la droite
La barre status contient les objets (items) suivants par défaut :
Objet (item) | Exemple | Description |
---|---|---|
time |
[12:55] |
heure |
buffer_count |
[4] |
nombre de tampons ouverts |
buffer_plugin |
[irc/freenode] |
extension du tampon courant (l’extension irc peut afficher le nom du serveur IRC auquel est rattaché ce tampon) |
buffer_number |
3 |
numéro du tampon courant |
buffer_name |
freenode/#test(+n) |
nom du tampon courant |
buffer_nicklist_count |
{5} |
nombre de pseudos dans la liste des pseudos |
buffer_filter |
* |
indicateur de filtrage : * signifie que des lignes sont filtrées (cachées), une valeur vide signifie que toutes les lignes sont affichées |
lag |
[Lag: 2.5] |
indicateur de "lag" (ralentissements réseau), en secondes (caché si le lag est faible) |
hotlist |
[Act: 4,2] |
liste des tampons où il y a de l’activité (messages non lus) |
completion |
abc(2) def(5) |
liste des mots pour la complétion, avec le nombre de complétions possibles pour chaque mot |
scroll |
-PLUS(50)- |
indicateur de scroll, avec le nombre de lignes sous la dernière ligne affichée |
La barre input contient les objets (items) suivants par défaut :
Objet (item) | Exemple | Description |
---|---|---|
input_paste |
[Coller 7 lignes ? [ctrl-Y] Oui [ctrl-N] Non] |
question à l’utilisateur pour coller des lignes |
input_prompt |
[pseudo] |
prompt (pseudo pour l’extension irc) |
away |
(absent) |
indicateur d’absence |
input_search |
[Recherche texte] |
indicateur de recherche de texte |
input_text |
bla bla... |
texte entré |
Touches | Description et commande |
---|---|
Flèche gauche |
Aller au caractère précédent sur la ligne de commande |
Flèche droite |
Aller au caractère suivant sur la ligne de commande |
Ctrl + flèche gauche |
Aller au mot précédent sur la ligne de commande |
Ctrl + flèche droite |
Aller au mot suivant sur la ligne de commande |
Home |
Aller au début de la ligne de commande |
End |
Aller à la fin de la ligne de commande |
Ctrl + C puis B |
Insérer le code pour mettre le texte en gras |
Ctrl + C puis C |
Insérer le code pour écrire en couleur |
Ctrl + C puis I |
Insérer le code pour mettre le texte en italique |
Ctrl + C puis O |
Insérer le code pour réinitaliser la couleur |
Ctrl + C puis R |
Insérer le code pour écrire en couleur inversée |
Ctrl + C puis U |
Insérer le code pour écrire en souligné |
Delete |
Effacer le caractère suivant sur la ligne de commande |
Backspace |
Effacer le caractère précédent sur la ligne de commande |
Ctrl + K |
Effacer du curseur jusqu'à la fin de la ligne de commande (la chaîne
supprimée est copiée dans le presse-papiers) |
Ctrl + R |
Chercher du texte dans l’historique du tampon (deux appuis successifs pour
rechercher du texte exact) |
Ctrl + T |
Inverser deux caractères |
Ctrl + U |
Effacer du curseur jusqu’au début de la ligne de commande (la chaîne
supprimée est copiée dans le presse-papiers) |
Ctrl + W |
Effacer le mot précédent sur la ligne de commande (la chaîne supprimée est
copiée dans le presse-papiers) |
Ctrl + Y |
Coller le contenu du presse-papiers |
Tab |
Compléter la commande ou le pseudo (Tab de nouveau : trouver la complétion
suivante) |
Shift + Tab |
Sans complétion, effectue une complétion partielle. Avec une complétion en
cours, complète avec la complétion précédente |
Tout caractère |
Insérer le caractère à la position du curseur sur la ligne de commande |
Enter |
Exécuter la commande ou envoyer le message (en mode recherche : arrêter la
recherche) |
Flèche haut |
Rappeler la commande précédente (en mode recherche : chercher plus haut) |
Flèche bas |
Rappeler la commande suivante (en mode recherche : chercher plus bas) |
Ctrl + flèche haut |
Rappeler la commande précédente dans l’historique global (commun à tous les
tampons) |
Ctrl + flèche bas |
Rappeler la commande suivante dans l’historique global (commun à tous les
tampons) |
Alt + D |
Effacer le mot suivant (la chaîne supprimée est copiée dans le
presse-papiers) |
Alt + K |
Capturer une touche et insérer son code sur la ligne de commande |
Alt + R |
Effacer entièrement la ligne de commande |
Touches | Description et commande |
---|---|
Ctrl + L |
Réafficher toute la fenêtre |
Ctrl + S puis Ctrl + U |
Positionner le marqueur de données non lues sur tous les tampons |
Ctrl + X |
Changer de tampon courant si plusieurs tampons sont attachés avec le même
numéro |
Page haut |
Monter d’une page dans l’historique du tampon |
Page bas |
Descendre d’une page dans l’historique du tampon |
Alt + Page haut |
Monter de quelques lignes dans l’historique du tampon |
Alt + Page bas |
Descendre de quelques lignes dans l’historique du tampon |
Alt + Home |
Aller au début du tampon |
Alt + End |
Aller à la fin du tampon |
Alt + flèche gauche |
Aller au tampon précédent |
Alt + flèche droite |
Aller au tampon suivant |
F7 |
Aller à la fenêtre précédente |
F8 |
Aller à la fenêtre suivante |
F9 |
Faire défiler le titre du tampon vers la gauche |
F10 |
Faire défiler le titre du tampon vers la droite |
F11 |
Monter d’une page dans la liste des pseudos |
F12 |
Descendre d’une page dans la liste des pseudos |
Alt + F11 |
Aller au début de la liste des pseudos |
Alt + F12 |
Aller à la fin de la liste des pseudos |
Alt + A |
Sauter au prochain tampon avec activité (avec priorité : highlight, message,
autre) |
Alt + J puis Alt + L |
Sauter au dernier tampon |
Alt + J puis Alt + R |
Sauter au tampon IRC de données brutes |
Alt + J puis Alt + S |
Sauter au tampon IRC du serveur |
Alt + chiffre (0-9) |
Sauter au tampon qui porte ce numéro (0 = 10) |
Alt + J puis nombre (01-99) |
Sauter au tampon qui porte ce numéro |
Alt + N |
Se positionner sur le highlight suivant |
Alt + P |
Se positionner sur le highlight précédent |
Alt + U |
Se positionner sur la première ligne non lue du tampon |
Alt + W puis Alt + flèche |
Sauter à une fenêtre avec une direction |
Alt + Z |
Zoom sur la fenêtre courante (Alt + Z de nouveau : restaurer l'état initial
des fenêtres, avant le zoom) |
Alt + < |
Sauter au tampon précédent dans la liste des tampons visités |
Alt + > |
Sauter au tampon suivant dans la liste des tampons visités |
Touches | Description et commande |
---|---|
Alt + H |
Vider la hotlist (notification d’activité sur les autres tampons) |
Alt + = |
Active/désactive les filtres |
La ligne de commande WeeChat (située en bas de la fenêtre) permet d’exécuter des commandes ou d’envoyer du texte vers le tampon.
Les commandes débutent par un caractère "/", suivi du nom de la commande. Par exemple pour afficher la liste de toutes les options :
/set
Le texte envoyé à un tampon est tout texte ne commençant pas par le caractère "/", par exemple pour envoyer bonjour sur le tampon courant :
bonjour
Il est cependant possible de faire débuter un texte par "/" en le doublant. Par exemple pour envoyer le texte /set sur le tampon courant :
//set
Pour certaines extensions comme IRC, il est possible d’utiliser des codes couleur et attributs comme suit (appuyer sur Ctrl-C puis sur la lettre qui suit et éventuellement une valeur) :
texte gras
couleur du texte xx (voir la liste des couleurs ci-dessous)
couleur du texte xx et du fond yy (voir la liste des couleurs ci-dessous)
désactiver la couleur et tous les attributs
vidéo inverse (inversion de la couleur d'écriture et du fond)
texte souligné
Note
|
Le même code (sans le numéro pour ^Cc) peut être utilisé pour stopper l’attribut défini. |
Les codes couleur pour ^Cc sont :
00 |
blanc |
01 |
noir |
02 |
bleu foncé |
03 |
vert foncé |
04 |
rouge clair |
05 |
rouge foncé |
06 |
violet |
07 |
orange |
08 |
jaune |
09 |
vert clair |
10 |
cyan |
11 |
cyan clair |
12 |
bleu clair |
13 |
violet clair |
14 |
gris |
15 |
gris clair (blanc) |
Exemple : affichage de "bonjour tout le monde !" avec "bonjour" en bleu clair gras, et "tout le monde" en rouge clair souligné :
^Cc12^Cbbonjour^Cb^Cc04^Cu tout le monde^Cu^Cc!
weechat.color.bar_more
description: couleur du texte pour les + lors du défilement des barres
type: couleur
valeurs: un nom de couleur (valeur par défaut: lightmagenta)
weechat.color.chat
description: couleur du texte pour la discussion
type: couleur
valeurs: un nom de couleur (valeur par défaut: default)
weechat.color.chat_bg
description: couleur du fond pour la discussion
type: couleur
valeurs: un nom de couleur (valeur par défaut: default)
weechat.color.chat_buffer
description: couleur du texte pour le nom des tampons
type: couleur
valeurs: un nom de couleur (valeur par défaut: white)
weechat.color.chat_channel
description: couleur du texte pour le nom des canaux
type: couleur
valeurs: un nom de couleur (valeur par défaut: white)
weechat.color.chat_delimiters
description: couleur du texte pour les délimiteurs
type: couleur
valeurs: un nom de couleur (valeur par défaut: green)
weechat.color.chat_highlight
description: couleur du texte pour le préfixe surligné (highlight)
type: couleur
valeurs: un nom de couleur (valeur par défaut: yellow)
weechat.color.chat_highlight_bg
description: couleur du fond pour le préfixe surligné (highlight)
type: couleur
valeurs: un nom de couleur (valeur par défaut: magenta)
weechat.color.chat_host
description: couleur du texte pour les noms d’hôtes
type: couleur
valeurs: un nom de couleur (valeur par défaut: cyan)
weechat.color.chat_nick
description: couleur du texte pour l’heure dans la fenêtre de discussion
type: couleur
valeurs: un nom de couleur (valeur par défaut: lightcyan)
weechat.color.chat_nick_color01
description: couleur du texte n°1 pour le pseudo
type: couleur
valeurs: un nom de couleur (valeur par défaut: cyan)
weechat.color.chat_nick_color02
description: couleur du texte n°2 pour le pseudo
type: couleur
valeurs: un nom de couleur (valeur par défaut: magenta)
weechat.color.chat_nick_color03
description: couleur du texte n°3 pour le pseudo
type: couleur
valeurs: un nom de couleur (valeur par défaut: green)
weechat.color.chat_nick_color04
description: couleur du texte n°4 le pseudo
type: couleur
valeurs: un nom de couleur (valeur par défaut: brown)
weechat.color.chat_nick_color05
description: couleur du texte n°5 pour le pseudo
type: couleur
valeurs: un nom de couleur (valeur par défaut: lightblue)
weechat.color.chat_nick_color06
description: couleur du texte n°6 pour le pseudo
type: couleur
valeurs: un nom de couleur (valeur par défaut: default)
weechat.color.chat_nick_color07
description: couleur du texte n°7 pour le pseudo
type: couleur
valeurs: un nom de couleur (valeur par défaut: lightcyan)
weechat.color.chat_nick_color08
description: couleur du texte n°8 pour le pseudo
type: couleur
valeurs: un nom de couleur (valeur par défaut: lightmagenta)
weechat.color.chat_nick_color09
description: couleur du texte n°9 pour le pseudo
type: couleur
valeurs: un nom de couleur (valeur par défaut: lightgreen)
weechat.color.chat_nick_color10
description: couleur du texte n°10 pour le pseudo
type: couleur
valeurs: un nom de couleur (valeur par défaut: blue)
weechat.color.chat_nick_other
description: couleur du texte pour l’autre pseudo dans le tampon privée
type: couleur
valeurs: un nom de couleur (valeur par défaut: cyan)
weechat.color.chat_nick_self
description: couleur du texte pour le pseudo local dans la fenêtre de discussion
type: couleur
valeurs: un nom de couleur (valeur par défaut: white)
weechat.color.chat_prefix_action
description: couleur du texte pour le préfixe d’action
type: couleur
valeurs: un nom de couleur (valeur par défaut: white)
weechat.color.chat_prefix_buffer
description: couleur du texte pour le nom du tampon (avant le préfixe, quand plusieurs tampons sont mélangés avec le numéro)
type: couleur
valeurs: un nom de couleur (valeur par défaut: brown)
weechat.color.chat_prefix_error
description: couleur du texte pour le préfixe d’erreur
type: couleur
valeurs: un nom de couleur (valeur par défaut: yellow)
weechat.color.chat_prefix_join
description: couleur du texte pour le préfixe d’arrivée
type: couleur
valeurs: un nom de couleur (valeur par défaut: lightgreen)
weechat.color.chat_prefix_more
description: couleur du texte pour les + lorsque le préfixe est trop long
type: couleur
valeurs: un nom de couleur (valeur par défaut: lightmagenta)
weechat.color.chat_prefix_network
description: couleur du texte pour le préfixe réseau
type: couleur
valeurs: un nom de couleur (valeur par défaut: magenta)
weechat.color.chat_prefix_quit
description: couleur du texte pour le préfixe de départ
type: couleur
valeurs: un nom de couleur (valeur par défaut: lightred)
weechat.color.chat_prefix_suffix
description: couleur du texte pour le suffixe (après le préfixe)
type: couleur
valeurs: un nom de couleur (valeur par défaut: green)
weechat.color.chat_read_marker
description: couleur du texte pour le marqueur de données non lues
type: couleur
valeurs: un nom de couleur (valeur par défaut: magenta)
weechat.color.chat_read_marker_bg
description: couleur du fond pour le marqueur de données non lues
type: couleur
valeurs: un nom de couleur (valeur par défaut: default)
weechat.color.chat_server
description: couleur du texte pour le nom des serveurs
type: couleur
valeurs: un nom de couleur (valeur par défaut: brown)
weechat.color.chat_text_found
description: couleur du texte pour le marqueur sur les lignes où le texte demandé est trouvé
type: couleur
valeurs: un nom de couleur (valeur par défaut: yellow)
weechat.color.chat_text_found_bg
description: couleur du fond pour le marqueur sur les lignes où le texte demandé est trouvé
type: couleur
valeurs: un nom de couleur (valeur par défaut: lightmagenta)
weechat.color.chat_time
description: couleur du texte pour l’heure dans la fenêtre de discussion
type: couleur
valeurs: un nom de couleur (valeur par défaut: default)
weechat.color.chat_time_delimiters
description: couleur du texte pour les délimiteurs de l’heure
type: couleur
valeurs: un nom de couleur (valeur par défaut: brown)
weechat.color.chat_value
description: couleur du texte pour les valeurs
type: couleur
valeurs: un nom de couleur (valeur par défaut: cyan)
weechat.color.input_actions
description: couleur du texte pour les actions dans la ligne de saisie
type: couleur
valeurs: un nom de couleur (valeur par défaut: lightgreen)
weechat.color.input_text_not_found
description: couleur du texte pour la recherche infructueuse de texte dans la ligne de saisie
type: couleur
valeurs: un nom de couleur (valeur par défaut: red)
weechat.color.nicklist_away
description: couleur du texte pour les pseudos absents
type: couleur
valeurs: un nom de couleur (valeur par défaut: cyan)
weechat.color.nicklist_group
description: couleur du texte pour les groupes dans la liste des pseudos
type: couleur
valeurs: un nom de couleur (valeur par défaut: green)
weechat.color.nicklist_more
description: couleur du texte pour les + lors du défilement des pseudos dans la liste des pseudos
type: couleur
valeurs: un nom de couleur (valeur par défaut: lightmagenta)
weechat.color.nicklist_prefix1
description: couleur du texte pour le préfixe n°1 de la liste des pseudos
type: couleur
valeurs: un nom de couleur (valeur par défaut: lightgreen)
weechat.color.nicklist_prefix2
description: couleur du texte pour le préfixe n°2 de la liste des pseudos
type: couleur
valeurs: un nom de couleur (valeur par défaut: lightmagenta)
weechat.color.nicklist_prefix3
description: couleur du texte pour le préfixe n°3 de la liste des pseudos
type: couleur
valeurs: un nom de couleur (valeur par défaut: yellow)
weechat.color.nicklist_prefix4
description: couleur du texte pour le préfixe n°4 de la liste des pseudos
type: couleur
valeurs: un nom de couleur (valeur par défaut: blue)
weechat.color.nicklist_prefix5
description: couleur du texte pour le préfixe n°5 de la liste des pseudos
type: couleur
valeurs: un nom de couleur (valeur par défaut: brown)
weechat.color.separator
description: couleur du fond pour les séparateurs de fenêtres (quand divisé)
type: couleur
valeurs: un nom de couleur (valeur par défaut: blue)
weechat.color.status_data_highlight
description: couleur du texte pour un tampon avec un highlight (barre de statut)
type: couleur
valeurs: un nom de couleur (valeur par défaut: lightmagenta)
weechat.color.status_data_msg
description: couleur du texte pour un tampon avec de nouveaux messages (barre de statut)
type: couleur
valeurs: un nom de couleur (valeur par défaut: yellow)
weechat.color.status_data_other
description: couleur du texte pour un tampon avec des nouvelles données (pas des messages) (barre de statut)
type: couleur
valeurs: un nom de couleur (valeur par défaut: default)
weechat.color.status_data_private
description: couleur du texte pour un tampon avec un message privé (barre de statut)
type: couleur
valeurs: un nom de couleur (valeur par défaut: lightgreen)
weechat.color.status_filter
description: couleur du texte pour l’indicateur de filtrage dans la barre de statut
type: couleur
valeurs: un nom de couleur (valeur par défaut: green)
weechat.color.status_more
description: couleur du texte pour un tampon avec des nouvelles données (barre de statut)
type: couleur
valeurs: un nom de couleur (valeur par défaut: yellow)
weechat.color.status_name
description: couleur du texte pour le nom du tampon courant dans la barre de statut
type: couleur
valeurs: un nom de couleur (valeur par défaut: white)
weechat.color.status_number
description: couleur du texte pour le numéro du tampon courant dans la barre de statut
type: couleur
valeurs: un nom de couleur (valeur par défaut: yellow)
weechat.completion.default_template
description: modèle de complétion par défaut (merci de consulter la documentation pour les codes et valeurs du modèle)
type: chaîne
valeurs: toute chaîne (valeur par défaut: "%(nicks)|%(irc_channels)")
weechat.completion.nick_add_space
description: ajouter un espace après la complétion du pseudo (quand le pseudo n’est pas le premier mot sur la ligne de commande)
type: booléen
valeurs: on, off (valeur par défaut: on)
weechat.completion.nick_completer
description: chaîne affichée après la complétion des pseudos
type: chaîne
valeurs: toute chaîne (valeur par défaut: ":")
weechat.completion.nick_first_only
description: compléter seulement avec le premier pseudo trouvé
type: booléen
valeurs: on, off (valeur par défaut: off)
weechat.completion.nick_ignore_chars
description: caractères à ignorer pour la complétion des pseudos
type: chaîne
valeurs: toute chaîne (valeur par défaut: "[]-^")
weechat.completion.partial_completion_alert
description: alterte l’utilisateur lorsqu’une complétion partielle survient
type: booléen
valeurs: on, off (valeur par défaut: on)
weechat.completion.partial_completion_command
description: complète partiellement les noms de commandes (stoppe quand plusieurs commandes trouvées commencent par les mêmes lettres)
type: booléen
valeurs: on, off (valeur par défaut: off)
weechat.completion.partial_completion_command_arg
description: complète partiellement les paramètres de commande (stoppe quand plusieurs paramètres trouvés commencent par les mêmes lettres)
type: booléen
valeurs: on, off (valeur par défaut: off)
weechat.completion.partial_completion_count
description: afficher le compteur pour chaque complétion partielle dans l’objet de barre
type: booléen
valeurs: on, off (valeur par défaut: on)
weechat.completion.partial_completion_other
description: complète partiellement en dehors des commandes (stoppe quand plusieurs mots trouvés commencent par les mêmes lettres)
type: booléen
valeurs: on, off (valeur par défaut: off)
weechat.history.display_default
description: nombre maximum de commandes à afficher par défaut dans le listing d’historique (0 = sans limite)
type: entier
valeurs: 0 .. 2147483647 (valeur par défaut: 5)
weechat.history.max_commands
description: nombre maximum de commandes utilisateur dans l’historique (0 = sans limite)
type: entier
valeurs: 0 .. 2147483647 (valeur par défaut: 100)
weechat.history.max_lines
description: nombre maximum de lignes dans l’historique (0 = sans limite)
type: entier
valeurs: 0 .. 2147483647 (valeur par défaut: 4096)
weechat.history.max_visited_buffers
description: nombre maximum de tampons visités à garder en mémoire
type: entier
valeurs: 0 .. 1000 (valeur par défaut: 50)
weechat.look.buffer_notify_default
description: niveau de notification par défaut pour les tampons (utilisé pour dire à WeeChat si le tampon doit être affiché dans la hotlist ou non, selon l’importance du message)
type: entier
valeurs: none, highlight, message, all (valeur par défaut: all)
weechat.look.buffer_time_format
description: format de date/heure pour les tampons
type: chaîne
valeurs: toute chaîne (valeur par défaut: "%H:%M:%S")
weechat.look.color_nicks_number
description: nombre de couleurs à utiliser pour les couleurs des pseudos
type: entier
valeurs: 1 .. 10 (valeur par défaut: 10)
weechat.look.color_real_white
description: si activé, utilise la vraie couleur blanche, désactivé par défaut pour les terminaux avec un fond blanc (si vous n’utilisez jamais de fond blanc, vous devriez activer cette option pour voir du vrai blanc au lieu de la couleur d’avant plan par défaut du terminal)
type: booléen
valeurs: on, off (valeur par défaut: off)
weechat.look.day_change
description: affiche un message quand le jour change
type: booléen
valeurs: on, off (valeur par défaut: on)
weechat.look.day_change_time_format
description: format de date pour la date affichée quand le jour a changé
type: chaîne
valeurs: toute chaîne (valeur par défaut: "%a, %d %b %Y")
weechat.look.highlight
description: liste des mots pour la notification (séparés par des virgules, la comparaison ne tient pas compte de la casse, les mots peuvent commencer ou se terminer par "*" pour une comparaison partielle)
type: chaîne
valeurs: toute chaîne (valeur par défaut: "")
weechat.look.hotlist_names_count
description: nombre maximum de noms dans la liste d’activité (0 = pas de nom affiché, seulement les numéros de tampons)
type: entier
valeurs: 0 .. 32 (valeur par défaut: 3)
weechat.look.hotlist_names_length
description: nombre maximum des noms dans la liste d’activité (0 = pas de limite)
type: entier
valeurs: 0 .. 32 (valeur par défaut: 0)
weechat.look.hotlist_names_level
description: niveau pour l’affichage des noms dans la liste d’activité (combinaison de: 1=join/part, 2=message, 4=privé, 8=highlight, par exemple: 12=privé+highlight)
type: entier
valeurs: 1 .. 15 (valeur par défaut: 12)
weechat.look.hotlist_names_merged_buffers
description: si défini, force l’affichage des noms dans la hotlist pour les tampons mélangés
type: booléen
valeurs: on, off (valeur par défaut: off)
weechat.look.hotlist_short_names
description: si défini, utilie des noms courts pour afficher les noms de tampons dans la hotlist (commence après le premier . dans le nom)
type: booléen
valeurs: on, off (valeur par défaut: on)
weechat.look.hotlist_sort
description: type de tri pour la liste d’activité (group_time_asc (par défaut), group_time_desc, group_number_asc, group_number_desc, number_asc, number_desc)
type: entier
valeurs: group_time_asc, group_time_desc, group_number_asc, group_number_desc, number_asc, number_desc (valeur par défaut: group_time_asc)
weechat.look.item_time_format
description: format de date/heure pour l’objet de barre "time"
type: chaîne
valeurs: toute chaîne (valeur par défaut: "%H:%M")
weechat.look.jump_current_to_previous_buffer
description: sauter au tampon affiché précédemment lors du saut vers le numéro de tampon courant avec /buffer *N (où N est un numéro de tampon), pour facilement basculer à un autre tampon, puis revenir au tampon courant
type: booléen
valeurs: on, off (valeur par défaut: on)
weechat.look.jump_previous_buffer_when_closing
description: sauter au tampon précédemment visité lors de la fermeture d’un tampon (si désactivé, alors le saut se fait vers le numéro de tampon - 1)
type: booléen
valeurs: on, off (valeur par défaut: on)
weechat.look.nickmode
description: afficher le mode du pseudo ((half)op/voice) devant chaque utilisateur
type: booléen
valeurs: on, off (valeur par défaut: on)
weechat.look.nickmode_empty
description: afficher un espace si le mode du pseudo n’est pas (half)op/voice
type: booléen
valeurs: on, off (valeur par défaut: off)
weechat.look.paste_max_lines
description: nombre maximum de lignes pour la détection de collage sans demander à l’utilisateur (0 = désactiver cette fonctionnalité)
type: entier
valeurs: 0 .. 2147483647 (valeur par défaut: 3)
weechat.look.prefix_action
description: préfixe pour les messages d’action
type: chaîne
valeurs: toute chaîne (valeur par défaut: " *")
weechat.look.prefix_align
description: alignement de préfixe (none, left, right (par défaut))
type: entier
valeurs: none, left, right (valeur par défaut: right)
weechat.look.prefix_align_max
description: taille maximum pour le préfixe (0 = pas de taille maximum)
type: entier
valeurs: 0 .. 128 (valeur par défaut: 0)
weechat.look.prefix_align_more
description: afficher + si le préfixe est tronqué
type: booléen
valeurs: on, off (valeur par défaut: on)
weechat.look.prefix_buffer_align
description: alignement de préfixe pour le nom du tampon, quand plusieurs tampons sont mélangés avec le même numéro (none, left, right (par défaut))
type: entier
valeurs: none, left, right (valeur par défaut: right)
weechat.look.prefix_buffer_align_max
description: taille maximum pour le nom du tampon, quand plusieurs tampons sont mélangés avec le même numéro (0 = pas de taille maximum)
type: entier
valeurs: 0 .. 128 (valeur par défaut: 0)
weechat.look.prefix_buffer_align_more
description: afficher + si le nom du tampon est tronqué (quand plusieurs tampons sont mélangés avec le même numéro)
type: booléen
valeurs: on, off (valeur par défaut: on)
weechat.look.prefix_error
description: préfixe pour les messages d’erreur
type: chaîne
valeurs: toute chaîne (valeur par défaut: "=!=")
weechat.look.prefix_join
description: préfixe pour les messages d’arrivée
type: chaîne
valeurs: toute chaîne (valeur par défaut: "-→")
weechat.look.prefix_network
description: préfixe pour les messages réseau
type: chaîne
valeurs: toute chaîne (valeur par défaut: "--")
weechat.look.prefix_quit
description: préfixe pour les messages de départ
type: chaîne
valeurs: toute chaîne (valeur par défaut: "←-")
weechat.look.prefix_suffix
description: chaîne affichée après le préfixe
type: chaîne
valeurs: toute chaîne (valeur par défaut: "|")
weechat.look.read_marker
description: utiliser un marqueur (ligne ou caractère) sur les tampons pour montrer la première ligne non lue
type: entier
valeurs: none, line, dotted-line, char (valeur par défaut: dotted-line)
weechat.look.save_config_on_exit
description: sauvegarder la configuration en quittant
type: booléen
valeurs: on, off (valeur par défaut: on)
weechat.look.save_layout_on_exit
description: sauve la disposition en quittant (tampons, fenêtres, ou les deux)
type: entier
valeurs: none, buffers, windows, all (valeur par défaut: none)
weechat.look.scroll_amount
description: nombre de lignes pour le défilement avec scroll_up et scroll_down
type: entier
valeurs: 1 .. 2147483647 (valeur par défaut: 3)
weechat.look.scroll_page_percent
description: pourcentage de l'écran à faire défiler lors du défilement avec page précédente ou suivante (par exemple 100 signifie une page, 50 une demi-page)
type: entier
valeurs: 1 .. 100 (valeur par défaut: 100)
weechat.look.search_text_not_found_alert
description: alterte l’utilisateur lorsque le texte cherché n’est pas trouvé dans le tampon
type: booléen
valeurs: on, off (valeur par défaut: on)
weechat.look.set_title
description: définit le titre de la fenêtre (terminal pour l’interface Curses) avec le nom et la version
type: booléen
valeurs: on, off (valeur par défaut: on)
weechat.network.gnutls_dh_prime_bitsmax_lines
description: taille minimum en bits pour la poignée de main (handshake) utilisant un échange de clé Diffie Hellman
type: entier
valeurs: 0 .. 2147483647 (valeur par défaut: 512)
weechat.plugin.autoload
description: liste des extensions à charger automatiquement au démarrage, "*" signifie toutes (séparées par des virgules, les noms peuvent être partiels, par exemple "perl" est ok pour "perl.so")
type: chaîne
valeurs: toute chaîne (valeur par défaut: "*")
weechat.plugin.debug
description: active les messages de debug par défaut pour toutes les extensions (option désactivée par défaut, ce qui est hautement recommandé)
type: booléen
valeurs: on, off (valeur par défaut: off)
weechat.plugin.extension
description: extension par défaut des extensions (par example ".so" sous Linux ou ".dll" sous Microsoft Windows)
type: chaîne
valeurs: toute chaîne (valeur par défaut: ".so")
weechat.plugin.path
description: chemin de recherche des extensions ("%h" sera remplacé par le répertoire de base WeeChat, par défaut: "~/.weechat")
type: chaîne
valeurs: toute chaîne (valeur par défaut: "%h/plugins")
weechat.plugin.save_config_on_unload
description: sauvegarder les fichiers de configuration lors du déchargement des extensions
type: booléen
valeurs: on, off (valeur par défaut: on)
weechat.startup.command_after_plugins
description: commande exécutée quand WeeChat démarre, après le chargement des extensions
type: chaîne
valeurs: toute chaîne (valeur par défaut: "")
weechat.startup.command_before_plugins
description: commande exécutée quand WeeChat démarre, avant le chargement des extensions
type: chaîne
valeurs: toute chaîne (valeur par défaut: "")
weechat.startup.display_logo
description: afficher le logo WeeChat au démarrage
type: booléen
valeurs: on, off (valeur par défaut: on)
weechat.startup.display_version
description: afficher la version de WeeChat au démarrage
type: booléen
valeurs: on, off (valeur par défaut: on)
weechat.startup.weechat_slogan
description: slogan WeeChat (si vide, le slogan ne sera pas utilisé)
type: chaîne
valeurs: toute chaîne (valeur par défaut: "le client de discussion le plus geek !")
Les couleurs pour l’interface Curses sont :
default |
couleur par défaut du terminal (transparent pour le fond) |
black |
noir |
red |
rouge foncé |
lightred |
rouge clair |
green |
vert foncé |
lightgreen |
vert clair |
brown |
marron |
yellow |
jaune |
blue |
bleu foncé |
lightblue |
bleu clair |
magenta |
violet foncé |
lightmagenta |
violet clair |
cyan |
cyan foncé |
lightcyan |
cyan clair |
white |
white |
gestion des barres add: ajoute une nouvelle barre nombarre: nom de la barre (doit être unique) type: root: en dehors des fenêtres window: dans les fenêtres, avec condition(s) optionnelle(s) (voir ci-dessous) cond1,...: condition(s) pour afficher cette barre (seulement pour le type "window"): active: sur la fenêtre active inactive: sur les fenêtres inactives nicklist: sue les fenêtres avec liste de pseudos sans condition, la barre est toujours affichée position: bottom (bas), top (haut), left (gauche) ou right (droite) taille: taille de la barre (en caractères) séparateur: 1 pour utiliser un séparateur (ligne), 0 ou rien signifie sans séparateur objet1,...: objets pour cette barre (les objets peuvent être séparés par une virgule (espace entre les objets) ou "+" (objets collés)) default: créer les barres par défaut del: supprime une barre (ou toutes les barres avec -all) set: change la valeur d'une propriété de la barre option: option à modifier (pour la liste des options, voir /set weechat.bar.<nombarre>.* valeur: nouvelle valeur pour l'option hide: cache la barre show: montre une barre cachée toggle: cache/montre une barre scroll: défilement de la barre vers le haut/bas tampon: catégorie et nom du tampon ('*' signifie le tampon courant, vous devez utiliser '*' pour les barres de type root) valeur_scroll: valeur pour le défilement: 'x' ou 'y', suivi par '+', '-', 'b' (début) ou 'e' (fin), valeur (pour +/-), et un %% optionnel (pour faire défiler par %% de la largeur/hauteur, sinon la valeur est un nombre de caractères) list: liste toutes les barres listfull: liste toutes les barres (verbeux) listitems: liste tous les objets de barre Exemples: créer une barre avec l'heure, numéro + nom de tampon, et la complétion: /bar add mabarre root bottom 1 0 [time],buffer_number+:+buffer_name,completion cacher une barre: /bar hide mabarre faire défiler la liste des pseudos de 10 lignes vers le bas sur le tampon courant: /bar scroll nicklist * y+10 faire défiler la liste des pseudos d'une page vers le haut sur le tampon #weechat: /bar scroll nicklist #weechat y-100% faire défiler la liste des pseudos à la fin sur le tampon courant: /bar scroll nicklist * ye
gestion des tampons clear: efface le contenu du tampon (un numéro pour un tampon, -merged pour les tampons mélangés, -all pour tous les tampons, ou rien pour le tampon courant) move: déplace le tampon dans la liste (peut être relatif, par exemple -1) merge: mélange le tampon courant avec un autre tampon (la zone de discussion sera un mélange des deux tampons) (par défaut ctrl-x bascule entre les tampons mélangés) unmerge: détache le tampon courant des autres tampons portant le même numéro close: ferme le tampon (nombre/intervalle optionnel) list: liste les tampons ouverts (pas de paramètre affiche cette liste) notify: définit le niveau de notification pour le tampon courant: ce niveau détermine si le buffer doit être ajouté à la hotlist ou pas: none: jamais highlight: pour les highlights seulement message: pour les messages d'utilisateurs + highlights all: pout tous les messages reset: réinitialise à valeur par défaut (all) localvar: affiche la liste des variables locales pour le tampon courant set: modifier une propriété du tampon courant nombre: saute au tampon qui a ce numéro, préfixe possible: '+': saut relatif, ajoute le numéro au courant, '-': saut relatif, soustrait le numéro au courant, '*': saut au numéro en utilisant l'option "jump_current_to_previous_buffer" nom: saute au tampon par nom (partiel) Exemples: effacer le tampon courant: /buffer clear effacer tous les tampons: /buffer clear -all déplacer le tampon: /buffer move 5 mélanger avec le tampon core: /buffer merge 1 détacher le tampon: /buffer unmerge fermer le tampon courant: /buffer close fermer les tampons 5 à 7: /buffer close 5-7 aller sur #weechat: /buffer #weechat aller au tampon suivant: /buffer +1
lancer explicitement une commande WeeChat ou d'une extension extension: nom de l'extension ('weechat' pour une commande interne WeeChat) commande: commande à exécuter (un '/' est automatiquement ajouté s'il n'est pas trouvé au début de la commande)
contrôle du debug pour le coeur/les extensions extension: nom de l'extension ("core" pour le coeur de WeeChat) niveau: niveau de debug pour l'extension dump: affiche les variables mémoire WeeChat dans le fichier log (les mêmes messages sont affichés lorsque WeeChat plante) buffer: affiche le contenu du tampon en valeurs hexadécimales dans le fichier log windows: affiche l'arbre des fenêtres< texte: envoie le signal "debug" avec "texte" comme paramètre
filtre les messages dans les tampons, pour les cacher/afficher selon des tags ou expressions régulières list: liste tous les filtres enable: active les filtres (par défaut les filtres sont activés) disable: désactive les filtres toggle: active/désactive les filtres nom: nom de filtre add: ajoute un filtre del: supprime un filtre -all: supprime tous les filtres extension.tampon: extension et tampon où le filtre est actif ("*" pour tous les tampons) tags: liste de tags, séparés par des virgules, par exemple: "irc_join,irc_part,irc_quit" regex: expressoin régulière à rechercher dans la ligne (utiliser \t pour séparer le préfixe du message, les caractères spéciaux comme '|' doivent être échappés: '\|') La touche par défaut alt+'=' active/désactive le filtrage. Exemples: utiliser le filtre intelligent IRC pour les messages join/part/quit: /filter add irc_smart * irc_smart_filter * filtrer tous les messages IRC join/part/quit: /filter add joinquit * irc_join,irc_part,irc_quit * filtrer le pseudo "toto" sur le canal IRC #weechat: /filter add toto irc.freenode.#weechat * toto\t filtrer les lignes contenant le mot "spam": /filter add filtrespam * * spam filtrer les lignes contenant "weechat sucks" sur le canal IRC #weechat: /filter add sucks irc.freenode.#weechat * weechat sucks
afficher l'aide sur les commandes et les options commande: nom d'une commande option: nom d'une option (utilisez /set pour voir la liste)
affiche l'historique des commandes du tampon clear: effacer l'historique valeur: nombre d'entrées dans l'historique à afficher
fonctions pour la ligne de commande Cette commande est utilisée par les associations de touches ou les extensions.
associer/libérer des touches bind: associer une commande à une touche ou afficher la commande associée à la touche unbind: supprimer l'association à une touche reset: restaure les touches aux valeurs par défaut et supprime TOUTES les touches personnelles (utiliser avec précaution !) missing: ajoute les touches manquantes (en utilisant les touches par défaut) Lors de l'association d'une commande à une touche, il est recommandé d'utiliser la touche alt+k (ou Echap puis k), et puis de presser la touche à associer: cela insère le code de la touche dans la ligne de commande.
sauve/applique/réinitialise la disposition des tampons et fenêtres save: sauve la disposition courante apply: applique la disposition sauvegardée reset: supprime la disposition sauvegardée buffers: sauve/applique seulement pour les tampons (ordre des tampons) windows: sauve/applique seulement pour les fenêtres (le tampon affiché par chaque fenêtre) Sans paramètre, cette commande affiche la disposition sauvegardée.
liste/charge/décharge des extensions list: lister les extensions chargées listfull: lister les extensions chargées (verbeux) load: charger une extension autoload: charger automatiquement les extensions dans un répertoire système ou utilisateur reload: recharger une extension (si pas de nom donné, décharger toutes les extensions, puis puis recharger automatiquement les extensions) unload: décharger une ou plusieurs exteneions Sans paramètre, cette commande liste les extensions chargées.
gestion des proxies add: ajoute un nouveau proxy nomproxy: nom du proxy (doit être unique) type: http, socks4 ou socks5 addresse: IP ou nom de machine port: port utilisateur: nom d'utilisateur (optionnel) motdepasse: mot de passe (optionnel) del: supprime un proxy (ou tous les proxies avec -all) set: change la valeur d'une propriété d'un proxy option: option à modifier (pour la liste des options, voir /set weechat.proxy.<proxyname>.*) valeur: nouvelle valeur pour l'option list: liste de tous les proxies Exemples: créer un proxy http, tournant en local, port 8888: /proxy add local http 127.0.0.1 8888 créer un proxy http en utilisant le protocole IPv6: /proxy add local http 127.0.0.1 8888 /proxy set local ipv6 on créer un proxy socks5 avec un utilisateur/mot de passe: /proxy add myproxy socks5 sample.host.org 3128 myuser mypass supprimer un proxy: /proxy del myproxy
quitter WeeChat
recharger les fichiers de configuration depuis le disque fichier: fichier de configuration à recharger Sans paramètre, tous les fichiers (WeeChat et extensions) sont rechargés.
sauvegarder les fichiers de configuration sur disque fichier: fichier de configuration à sauvegarder Sans paramètre, tous les fichiers (WeeChat et extensions) sont sauvegardés.
modifier des options de configuration option: nom d'une option valeur: nouvelle valeur pour l'option La nouvelle valeur peut être, selon le type de l'option: booléen: on, off ou toggle entier : nombre, ++nombre ou --nombre chaîne : toute chaîne ("" pour une chaîne vide) couleur: nom de couleur, ++nombre ou --nombre Pour tous les types, vous pouvez utiliser null pour supprimer la valeur de l'option (valeur non définie). Cela ne fonctionne qu'avec certaines options spéciales des extensions.
supprimer/réinitialiser des options de configuration option: nom d'une option (peut commencer ou se terminer par "*" pour réinitialiser plusieurs options, à utiliser avec prudence !) Selon l'option, elle est réinitialisée (pour les options standards) ou supprimée (pour les options facultatives, comme les valeurs pour les serveurs).
mettre à jour WeeChat sans se déconnecter des serveurs chemin_vers_binaire: chemin vers le binaire WeeChat (par défaut le binaire courant) Cette commande lance à nouveau un binaire WeeChat, il doit donc avoir été compilé ou installé via un gestionnaire de paquet avant de lancer cette commande.
montrer l'uptime de WeeChat -o: envoyer l'uptime sur le tampon courant comme entrée
afficher la version de WeeChat et la date de compilation -o: envoyer la version sur le tampon courant comme entrée
planifie l'exécution d'une commande dans le futur nombre: temps à attendre (nombre entier) unité: optionnelle, valeurs possibles: ms: millisecondes s: secondes (par défaut) m: minutes h: heures commande: commande à exécuter (ou texte à envoyer au tampon si la commande ne commence pas par '/') Note: la commande est exécutée sur le tampon où /wait a été exécuté (si le tampon n'est pas trouvé, alors la commande est exécutée sur le tampon WeeChat principal). Exemples: rejoindre le canal dans 10 sec: /wait 10 /join #test passer absent dans 15 min: /wait 15m /away -all I'm away dire 'bonjour' dans 2 min: /wait 2m bonjour
gestion des fenêtres list: liste les fenêtres ouvertes (pas de paramètre affiche cette liste) -1: saute à la fenêtre précédente +1: saute à la fenêtre suivante b#: saute à la fenêtre affichant le tampon # up: saute à la fenêtre au dessus down: saute à la fenêtre au dessous left: saute à la fenêtre à gauche right: saute à la fenêtre à droite splith: éclate la fenêtre en deux horizontalement splitv: éclate la fenêtre en deux verticalement resize: redimensionne une fenêtre, la nouvelle taille est <pct> pourcentage de la fenêtre parent merge: fusionne la fenêtre avec une autre page_up: défilement d'une page vers le haut page_down: défilement d'une page vers le bas refresh: redessine l'écran scroll: défilement d'un nombre de lignes (+/-N) ou avec du temps: s=secondes, m=minutes, h=heures, d=jours, M=mois, y=année scroll_up: défilement de quelques lignes vers le haut scroll_down: défilement de quelques lignes vers le bas scroll_top: défilement jusqu'au début du tampon scroll_bottom: défilement jusqu'au bas du tampon scroll_previous_highlight: défilement jusqu'au highlight précédent scroll_next_highlight: défilement jusqu'au highlight suivant zoom: zoom sur la fenêtre Pour splith et splitv, pct est un pourcentage qui représente la taille de la nouvelle fenêtre, calculée par rapport à la taille de la fenêtre courante. Par exemple 25 signifie créer une fenêtre qui a pour taille: taille_courante / 4 Exemples: sauter à la fenêtre affichant le tampon 1: /window b1 défilement de 2 lignes vers le haut: /window scroll -2 défilement de 2 jours vers le haut: /window scroll -2d défilement jusqu'au début du jour courant: /window scroll -d
Pour en apprendre plus sur le développement d’extension ou de script (via l’API), merci de consulter la Référence API Extension WeeChat ou Le Guide pour Scripts WeeChat.
Une extension est une bibliothèque dynamique, écrite en C et compilée, qui est chargée par WeeChat. Sous GNU/Linux, ce fichier a une extension ".so", et ".dll" sous Windows.
Les extensions trouvées sont automatiquement chargées par WeeChat lorsqu’il démarre, et il est possible de charger et décharger des extensions pendant que WeeChat tourne.
Il est important de bien faire la différence entre une extension et un script : une extension est un fichier binaire compilé et chargé avec la commande /plugin, tandis qu’un script est un fichier texte chargé par une extension comme perl par la commande perl.
Vous pouvez utiliser la commande /plugin pour charger/décharger une extension, ou afficher les extensions chargées. Quand une extension est déchargée, tous les tampons créés par cette extension sont automatiquement fermés.
Exemples pour charger, décharger et afficher les extensions :
/plugin load irc /plugin unload irc /plugin list
Les extensions par défaut sont :
Extension | Description |
---|---|
alias |
Définir des alias pour les commandes |
aspell |
Vérification orthographique de la ligne de commande |
charset |
Encodage/encodage avec jeu de caractère sur les tampons |
demo |
Extension de démonstration (non compilée par défaut) |
fifo |
Tube FIFO pour envoyer des commandes à distance vers WeeChat |
irc |
Discussion avec le protocole IRC |
logger |
Enregistrement des tampons dans des fichiers |
perl |
Interface (API) pour scripts Perl |
python |
Interface (API) pour scripts Python |
ruby |
Interface (API) pour scripts Ruby |
lua |
Interface (API) pour scripts Lua |
tcl |
Interface (API) pour scripts Tcl |
xfer |
Transfert de fichier et discussion directe |
L’extension Alias permet de définir des alias pour des commandes (WeeChat ou d’autres extensions).
créer un alias pour une commande nom_alias: nom de l'alias commande: nom de la commande (plusieurs commandes peuvent être séparées par des point-virgules) paramètres: paramètres pour la commande Sans paramètre, cette commande liste tous les alias définis. Note: dans la commande, les variables spéciales $1, $2,..,$9 sont remplacés par les paramètres donnés par l'utilisateur, et $* est remplacé par tous les paramètres. Les variables $nick, $channel et $server sont remplacées par le pseudo/canal/serveur courant.
L’extension Aspell permet de vérifier l’orthographe de la ligne de commande. Il est possible d’utiliser plusieurs langages par tampon.
aspell.check.commands
description: liste de commandes (séparées par des virgules) pour lesquelles la vérification orthographique est activée (la vérification est désactivée pour toutes les autres commandes)
type: chaîne
valeurs: toute chaîne (valeur par défaut: "ame,amsg,away,command,cycle,kick,kickban,me,msg,notice,part,query,quit,topic")
aspell.check.default_dict
description: dictionnaire par défaut (ou liste de dictionnaires séparés par une virgule) à utiliser quand le tampon courant n’a pas de dictionnaire défini (laissez blanc pour désactiver aspell sur les tampons pour lesquels vous ne l’avez pas explicitement activé)
type: chaîne
valeurs: toute chaîne (valeur par défaut: "")
aspell.check.during_search
description: vérifier les mots pendant la recherche de texte dans le tampon
type: booléen
valeurs: on, off (valeur par défaut: off)
aspell.check.real_time
description: vérification orthographique des mots en temps réel (plus lent, désactivé par défaut: les mots sont vérifiés seulement s’il y a un délimiteur après)
type: booléen
valeurs: on, off (valeur par défaut: off)
aspell.check.word_min_length
description: longueur minimum d’un mot pour que l’otrhographe soit vérifiée (utilisez 0 pour vérifier tous les mots)
type: entier
valeurs: 0 .. 2147483647 (valeur par défaut: 2)
aspell.look.color
description: couleur utilisée pour les mots mal orthographiés
type: couleur
valeurs: un nom de couleur (valeur par défaut: lightred)
configuration de l'extension aspell dictlist: afficher les dictionnaires installés enable: active aspell sur le tampon courant disable: désactive aspell sur le tampon courant addword: ajoute un mot dans le dictionnaire personnel aspell Les lignes d'entrée commençant par '/' ne sont pas vérifiées, sauf pour certaines commandes.
L’extension Charset vous permet de décoder et encoder les données en utilisant un jeu de caractères.
Il y a un jeu de caractère par défaut pour le décodage/encodage, et un spécifique pour les tampons (ou groupes de tampons).
Cette extension est facultative, mais recommandée : si elle n’est pas chargée, WeeChat pourra uniquement lire/écrire des données UTF-8.
L’extension Charset devrait être automatiquement chargée par WeeChat au démarrage. Pour s’assurer que l’extension est bien chargée, essayez :
/charset
Si la commande n’est pas trouvée, alors chargez l’extension avec la commande :
/plugin load charset
Si l’extension n’est pas trouvée, alors vous devriez recompiler WeeChat avec les extensions et le support de Charset.
Lorsque l’extension Charset démarre, elle affiche le jeu de caractères du terminal et l’interne. Le jeu de caractères du terminal dépend de votre locale, et l’interne est UTF-8.
Par exemple :
charset: terminal: ISO-8859-15, interne: UTF-8
charset.default.decode
description: charset de décodage global
type: chaîne
valeurs: toute chaîne (valeur par défaut: "iso-8859-1")
charset.default.encode
description: charset d’encodage global
type: chaîne
valeurs: toute chaîne (valeur par défaut: "")
changer le charset pour le tampon courant decode: changer le charset de décodage encode: changer le charset d'encodage charset: nouveau charset pour le tampon courant reset: réinitialiser les charsets pour le tampon courant
Pour modifier les jeux de caractères de décodage et d’encodage globaux, utilisez la commande /set.
Par exemple :
/set charset.default.decode ISO-8859-15 /set charset.default.encode ISO-8859-15
Si le jeu de caractères de décodage global n’est pas renseigné (par exemple pendant le premier chargement de Charset), il sera renseigné automatiquement avec le jeu de caractères du terminal (s’il est différent de UTF-8) ou par défaut à ISO-8859-1.
La valeur d’encodage par défaut est vide, donc WeeChat envoie par défaut avec le jeu de caractères interne (UTF-8).
Pour modifier le jeu de caractères d’un serveur IRC, utilisez la commande /charset sur le tampon serveur. Si vous donnez seulement le jeu de caractères, alors vous modifiez en même temps les valeurs de décodage et d’encodage.
Par exemple :
/charset ISO-8859-15
Ce qui est équivalent à :
/charset decode ISO-8859-15 /charset encode ISO-8859-15
Pour modifier le jeu de caractères d’un canal IRC (ou d’une conversation privée), utilisez la même commande que pour le serveur, mais sur le tampon du canal (ou du privé).
Pour voir tous les jeux de caractères utilisés, utilisez la commande suivante :
/set charset.*
Pour tout problème avec les jeux de caractères, merci de consulter la FAQ WeeChat.
Vous pouvez contrôler WeeChat à distance, en envoyant des commandes ou du texte dans un tube FIFO (si l’option plugins.var.fifo.fifo est activée, elle l’est par défaut).
Le tube FIFO est dans le répertoire ~/.weechat/ et s’appelle weechat_fifo_xxxx (où xxxx est l’ID du processus (PID) du WeeChat qui tourne).
La syntaxe pour envoyer des commandes ou du texte dans le tube FIFO est une des suivantes :
plugin.buffer *texte ou commande ici *texte ou commande ici
Quelques exemples :
changement du pseudo sur freenode en "autrepseudo" :
$ echo 'irc.server.freenode */nick autrepseudo' >~/.weechat/weechat_fifo_12345
affichage de texte sur le canal IRC #weechat :
$ echo 'irc.freenode.#weechat *bonjour !' >~/.weechat/weechat_fifo_12345
affichage de texte sur le tampon courant :
$ echo '*bonjour !' >~/.weechat/weechat_fifo_12345
envoyer deux commandes pour décharger/recharger les scripts Perl (vous devez les séparer par "\n") :
$ echo -e '*/perl unload\n*/perl autoload' >~/.weechat/weechat_fifo_12345
Vous pouvez écrire un script qui envoie les commandes à tous les WeeChat qui tournent en même temps, par exemple :
#!/bin/sh if [ $# -eq 1 ]; then for fifo in ~/.weechat/weechat_fifo_* do echo -e "$1" >$fifo done fi
Si le script s’appelle "auto_weechat_command", vous pouvez le lancer ainsi :
$ ./auto_weechat_command 'irc.freenode.#weechat *bonjour'
L’extension IRC permet de dialoguer avec d’autres personnes via le protocole IRC.
Elle est multi-serveurs, et offre toutes les commandes IRC supportées, y compris la discussion directe (DCC chat) and le transfert de fichier DCC (via l’extension xfer, voir [xfer_plugin]).
Il est possible de passer une URL pour un ou plusieurs serveurs, comme suit :
irc[6][s]://[pseudo[:mot_passe]@]irc.example.org[:port][/channel][,channel[...]
Exemple pour rejoindre #weechat et #toto sur le serveur irc.freenode.net, port par défaut (6667), avec le pseudo nono :
$ weechat-curses irc://nono@irc.freenode.net/#weechat,#toto
irc.color.input_nick
description: couleur du pseudo dans la barre de saisie
type: couleur
valeurs: un nom de couleur (valeur par défaut: lightcyan)
irc.color.item_away
description: couleur pour l’objet away
type: couleur
valeurs: un nom de couleur (valeur par défaut: yellow)
irc.color.item_channel_modes
description: couleur pour les modes du canal, à côté du nom du canal
type: couleur
valeurs: un nom de couleur (valeur par défaut: default)
irc.color.message_join
description: couleur pour le texte dans les messages join
type: couleur
valeurs: un nom de couleur (valeur par défaut: green)
irc.color.message_quit
description: couleur pour le texte dans les messages part/quit
type: couleur
valeurs: un nom de couleur (valeur par défaut: red)
irc.color.notice
description: couleur pour le texte "Notice" dans les notices
type: couleur
valeurs: un nom de couleur (valeur par défaut: green)
irc.look.color_nicks_in_server_messages
description: utiliser la couleur du pseudo dans les messages du serveur
type: booléen
valeurs: on, off (valeur par défaut: on)
irc.look.display_away
description: affiche un message pour l’absence/le retour
type: entier
valeurs: off, local, channel (valeur par défaut: local)
irc.look.display_channel_modes
description: affiche les modes du canal dans l’objet de barre "buffer_name"
type: booléen
valeurs: on, off (valeur par défaut: on)
irc.look.display_nick_modes
description: affiche les modes du pseudo dans l’objet de barre "input_prompt"
type: booléen
valeurs: on, off (valeur par défaut: on)
irc.look.display_old_topic
description: afficher l’ancien titre lorsque le titre du canal est changé
type: booléen
valeurs: on, off (valeur par défaut: on)
irc.look.hide_nickserv_pwd
description: masquer le mot de passe affiché par nickserv
type: booléen
valeurs: on, off (valeur par défaut: on)
irc.look.highlight_tags
description: liste des tags pour les messages qui peuvent produire un highlight (séparés par des virgules, typiquement tout message venant d’un autre utilisateur, pas les messages du serveur, …)
type: chaîne
valeurs: toute chaîne (valeur par défaut: "irc_privmsg,irc_notice")
irc.look.item_display_server
description: nom de l’objet de barre où est affiché le serveur IRC (pour la barre de statut)
type: entier
valeurs: buffer_plugin, buffer_name (valeur par défaut: buffer_plugin)
irc.look.nick_completion_smart
description: complétion intelligente pour les pseudos (complète d’abord avec les personnes qui ont parlé récemment)
type: entier
valeurs: off, speakers, speakers_highlights (valeur par défaut: speakers)
irc.look.nick_prefix
description: texte à afficher avant le pseudo dans la fenêtre de discussion
type: chaîne
valeurs: toute chaîne (valeur par défaut: "")
irc.look.nick_suffix
description: texte à afficher après le pseudo dans la fenêtre de discussion
type: chaîne
valeurs: toute chaîne (valeur par défaut: "")
irc.look.notice_as_pv
description: afficher les notices comme des messages privés (si auto, utilise le tampon privé s’il est trouvé)
type: entier
valeurs: auto, never, always (valeur par défaut: auto)
irc.look.open_channel_near_server
description: ouvrir les nouveaux canaux près du serveur
type: booléen
valeurs: on, off (valeur par défaut: off)
irc.look.open_pv_near_server
description: ouvrir les nouveaux privés près du serveur
type: booléen
valeurs: on, off (valeur par défaut: off)
irc.look.raw_messages
description: nombre de messages IRC bruts à sauvegarder en mémoire lorsque le tampon des données brutes est fermé (ces messages seront affichés lors de l’ouverture du tampon des données brutes)
type: entier
valeurs: 0 .. 65535 (valeur par défaut: 256)
irc.look.server_buffer
description: mélange des tampons de serveur
type: entier
valeurs: merge_with_core, merge_without_core, independent (valeur par défaut: merge_with_core)
irc.look.show_away_once
description: voir le message d’absence distant une seule fois en privé
type: booléen
valeurs: on, off (valeur par défaut: on)
irc.look.smart_filter
description: filtrer les messages join/part/quit pour un pseudo s’il n’a pas parlé pendant quelques minutes sur le canal (vous devez créer un filtre sur le tag "irc_smart_filter")
type: booléen
valeurs: on, off (valeur par défaut: off)
irc.look.smart_filter_delay
description: délai pour filtrer les messages join/part/quit (en minutes)
type: entier
valeurs: 1 .. 10080 (valeur par défaut: 5)
irc.look.topic_strip_colors
description: supprimer les couleurs dans le titre (utilisé seulement lors de l’affichage du titre du tampon)
type: booléen
valeurs: on, off (valeur par défaut: off)
irc.network.anti_flood
description: anti-flood: nombre de secondes entre deux messages utilisateur (0 = pas d’anti-flood)
type: entier
valeurs: 0 .. 5 (valeur par défaut: 2)
irc.network.away_check
description: intervalle entre deux vérifications des absences (en minutes, 0 = ne jamais vérifier)
type: entier
valeurs: 0 .. 2147483647 (valeur par défaut: 0)
irc.network.away_check_max_nicks
description: ne pas vérifier les pseudos absents lorsqu’il y a un nombre important de pseudos (0 = pas de limite)
type: entier
valeurs: 0 .. 2147483647 (valeur par défaut: 0)
irc.network.colors_receive
description: si désactivé, les codes couleurs des messages entrants sont ignorés
type: booléen
valeurs: on, off (valeur par défaut: on)
irc.network.colors_send
description: autorise l’utilisateur à envoyer des couleurs avec des codes spéciaux (ctrl-c + un code et une couleur optionnelle: b=gras, cxx=couleur, cxx,yy=couleur+fond, u=souligné, r=inversé)
type: booléen
valeurs: on, off (valeur par défaut: on)
irc.network.default_msg_part
description: message par défaut pour le part (en quittant un canal) ("%v" sera remplacé par la version de WeeChat dans la chaîne)
type: chaîne
valeurs: toute chaîne (valeur par défaut: "WeeChat %v")
irc.network.default_msg_quit
description: message de fin par défaut (lors de la déconnexion du serveur) ("%v" sera remplacé par la version de WeeChat dans la chaîne)
type: chaîne
valeurs: toute chaîne (valeur par défaut: "WeeChat %v")
irc.network.lag_check
description: intervalle entre deux vérifications des absences (en secondes, 0 = ne jamais vérifier)
type: entier
valeurs: 0 .. 2147483647 (valeur par défaut: 60)
irc.network.lag_disconnect
description: déconnexion après un lag important (en minutes, 0 = ne jamais se déconnecter)
type: entier
valeurs: 0 .. 2147483647 (valeur par défaut: 0)
irc.network.lag_min_show
description: lag minimum à afficher (en secondes)
type: entier
valeurs: 0 .. 2147483647 (valeur par défaut: 1)
irc.network.send_unknown_commands
description: envoie les commandes inconnues au serveur
type: booléen
valeurs: on, off (valeur par défaut: off)
irc.server_default.addresses
description: liste de nom/port ou IP/port pour le serveur (séparés par des virgules)
type: chaîne
valeurs: toute chaîne (valeur par défaut: "")
irc.server_default.autoconnect
description: connexion automatique au serveur quand WeeChat démarre
type: booléen
valeurs: on, off (valeur par défaut: off)
irc.server_default.autojoin
description: liste des canaux (séparés par des virgules) à rejoindre lorsque connecté au serveur (exemple: "#chan1,#chan2,#chan3 key1,key2")
type: chaîne
valeurs: toute chaîne (valeur par défaut: "")
irc.server_default.autoreconnect
description: reconnexion automatique au serveur après une déconnexion
type: booléen
valeurs: on, off (valeur par défaut: on)
irc.server_default.autoreconnect_delay
description: délai (en secondes) avant de tenter une reconnexion au serveur
type: entier
valeurs: 0 .. 65535 (valeur par défaut: 30)
irc.server_default.autorejoin
description: rejoindre automatiquement les canaux quand mis dehors
type: booléen
valeurs: on, off (valeur par défaut: off)
irc.server_default.command
description: commande(s) à exécuter lorsque connecté au serveur (plusieurs commandes doivent être séparées par ";", utilisez "\;" pour un point-virgule, les variables spéciales $nick, $channel et $server sont remplacées par leur valeur)
type: chaîne
valeurs: toute chaîne (valeur par défaut: "")
irc.server_default.command_delay
description: délai (en secondes) après exécution de la commande (exemple: donner du temps pour l’authentification)
type: entier
valeurs: 0 .. 3600 (valeur par défaut: 0)
irc.server_default.ipv6
description: utiliser le protocole IPv6 pour la communication avec le serveur
type: booléen
valeurs: on, off (valeur par défaut: off)
irc.server_default.local_hostname
description: nom local de machine/IP personnalisé pour le serveur (optionnel, si non renseigné, le nom de machine local est utilisé)
type: chaîne
valeurs: toute chaîne (valeur par défaut: "")
irc.server_default.nicks
description: pseudos à utiliser sur le serveur (séparés par des virgules)
type: chaîne
valeurs: toute chaîne (valeur par défaut: "")
irc.server_default.password
description: mot de passe pour le serveur
type: chaîne
valeurs: toute chaîne (valeur par défaut: "")
irc.server_default.proxy
description: proxy utilisé pour ce serveur (optionnel)
type: chaîne
valeurs: toute chaîne (valeur par défaut: "")
irc.server_default.realname
description: nom réel pour le serveur
type: chaîne
valeurs: toute chaîne (valeur par défaut: "")
irc.server_default.ssl
description: utiliser SSL pour la communication avec le serveur
type: booléen
valeurs: on, off (valeur par défaut: off)
irc.server_default.username
description: nom d’utilisateur pour le serveur
type: chaîne
valeurs: toute chaîne (valeur par défaut: "")
trouver les informations sur l'administrateur du serveur cible: serveur
envoyer une action CTCP à tous les canaux de tous les serveurs connectés message: message à envoyer
envoyer un message à tous les canaux de tous les serveurs connectés texte: texte à envoyer
basculer le statut absent -all: basculer le statut absent sur tous les serveurs connectés message: message pour l'absence (si pas de message donné, le statut d'absence est supprimé)
bannit des pseudos ou hôtes canal: nom du canal pour le bannissement pseudo: pseudo ou hôte pour le bannissement
se connecter à un/plusieurs serveur(s) IRC -all: se reconnecter à tous les serveurs nom_serveur: nom du serveur pour se connecter -nojoin: ne rejoindre aucun canal (même si l'autojoin est activé pour le serveur) nom/IP: nom/IP pour se connecter port: port pour le serveur (nombre entier, 6667 par défaut) ipv6: utiliser le protocole IPv6 ssl: utiliser le protocole SSL
envoyer un message CTCP (Client-To-Client Protocol) cible: pseudo à qui envoyer le CTCP type: type de CTCP (exemples: "version", "ping", etc...) arguments: arguments pour le CTCP
quitter et rejoindre un canal canal: canal pour le cycle message_de_fin: message de fin (affiché aux autres utilisateurs)
démarre le DCC (fichier ou discussion) action: 'send' (envoi de fichier) ou 'chat' (discussion) pseudo: pseudo pour envoyer le fichier ou discuter fichier: nom du fichier (sur la machine locale)
retire le statut de demi-opérateur du canal à/aux pseudo(s)
retire le statut d'opérateur du canal à/aux pseudo(s)
retire la voix du/des pseudo(s)
arrêter le serveur
se déconnecter d'un/plusieurs serveur(s) IRC -all: se déconnecter de tous les serveurs nom_serveur: nom du serveur pour se déconnecter
donner le statut de demi-opérateur à un/des pseudo(s)
ignore des pseudos/hôtes de serveurs ou canaux list: liste tous les ignores add: ajoute un ignore del: supprime un ignore numéro: numéro du ignore à supprimer (voir la liste des ignore pour le trouver) -all: supprime tous les ignores pseudo/hôte: pseudo ou hôte à ignorer: la syntaxe est "re:regex" ou "masque" (un masque est une chaîne avec des "*" pour remplacer un ou plusieurs caractères) serveur: nom de serveur interne où le ignore fonctionnera canal: canal où le ignore fonctionnera Exemples: ignorer le pseudo "toto" partout: /ignore add toto ignorer le hôte "toto@domain.com" sur le serveur freenode: /ignore add toto@domain.com freenode ignorer le hôte "toto*@*.domain.com" sur freenode/#weechat: /ignore add toto*@*.domain.com freenode #weechat
voir les informations décrivant le serveur cible: nom du serveur
inviter un pseudo sur un canal pseudo: pseudo à inviter canal: canal pour l'invitation
vérifier si un pseudo est actuellement sur IRC pseudo: pseudo
joindre un canal canal: nom du canal à rejoindre clé: clé pour rejoindre le canal
retirer par la force un utilisateur d'un canal canal: canal où l'utilisateur se trouve pseudo: pseudo à éliminer commentaire: commentaire pour l'élimination
retirer par la force un pseudo d'un canal et le bannir canal: canal où l'utilisateur se trouve pseudo: pseudo à éliminer et bannir commentaire: commentaire pour l'élimination
fermer la connexion client-serveur pseudo: pseudo commentaire: commentaire pour la mort
lister tous les noms de serveurs connus du serveur qui répondent à la requête serveur: ce serveur doit répondre à la requête masque_serveur: liste des serveurs correspondant au masque
lister les canaux et leur titre canal: canal à lister (une expression régulière est acceptée) serveur: nom du serveur
obtenir des statistiques sur la taille du réseau IRC masque: serveurs qui correspondent au masque seulement cible: serveur pour faire suivre la requête
envoyer une action CTCP au canal courant message: message à envoyer
changer le mode du canal ou de l'utilisateur modes de canaux: canal: nom du canal à modifier (par défaut le canal courant) o: donner/reprendre le statut privilégié d'opérateur p: indicateur de canal privé s: indicateur de canal secret i: indicateur de canal avec invitation seulement t: le titre est modifiable seulement par un opérateur du canal n: aucun message au canal depuis l'extérieur m: canal modéré l: fixer la limite d'utilisateurs pour le canal b: paramétrer un masque de banissement pour garder des utilisateurs dehors e: paramétrer un masque d'exception v: donner/reprendre la possibilité de parler sur un canal modéré k: définir une clé (mot de passe) pour accéder au canal modes utilisateur: pseudo: pseudo à modifier i: marquer un utilisateur comme invisible s: marquer un utilisateur pour recevoir les notices du serveur w: l'utilisateur reçoit les wallops o: drapeau opérateur
obtenir le message du jour cible: nom du serveur
envoyer un message à un pseudo ou canal serveur: envoyer à ce serveur (nom interne) cible: pseudo ou canal (peut-être un masque, '*' = canal courant) texte: texte à envoyer
lister les pseudos sur des canaux canal: nom du canal
changer le pseudo courant -all: définir le nouveau pseudo sur tous les serveurs connectés pseudo: nouveau pseudo
envoyer un message notice à un utilisateur serveur: envoyer à ce serveur (nom interne) pseudo: pseudo cible pour la notice texte: texte à envoyer
donner le statut opérateur à un/des pseudo(s)
obtenir le statut d'opérateur utilisateur/mot_de_passe: utilisé pour obtenir les privilèges sur le serveur IRC courant
quitter un canal canal: canal à quitter message_de_fin: message de fin (affiché aux autres utilisateurs)
pinguer un serveur serveur1: serveur à pinguer serveur2: faire suivre le ping à ce serveur
répondre à un message ping démon: démon qui a répondu au message Ping démon2: faire suivre le message à ce démon
envoyer un message privé à un pseudo serveur: envoyer à ce serveur (nom interne) pseudo: pseudo pour la conversation privée texte: texte à envoyer
envoyer des données brutes au serveur sans analyse serveur: envoyer à ce serveur (nom interne) données: données brutes à envoyer
se reconnecter à un/plusieurs serveur(s) -all: se reconnecter à tous les serveurs nom_serveur: nom du serveur pour se reconnecter -nojoin: ne rejoindre aucun canal (même si l'autojoin est activé pour le serveur)
demander au serveur de recharger son fichier de configuration
demander au serveur de redémarrer
liste, ajoute ou retire des serveurs IRC list: afficher les serveurs (pas de paramètre implique cette liste) listfull: afficher les serveurs avec de l'info détaillée pour chaque add: créer un nouveau serveur nom_serveur: nom du serveur, pour usage interne et affichage nom: nom ou adresse IP du serveur avec port en option (defaut: 6667) auto: se connecter automatiquement au serveur quand WeeChat démarre noauto: ne pas se connecter au serveur quand WeeChat démarre (par défaut) ipv6: utiliser le protocole IPv6 ssl: utiliser le protocole SSL copy: dupliquer un serveur rename: renommer un serveur keep: garder le serveur dans le fichier de configuration (pour les serveurs temporaires seulement) del: supprimer un serveur deloutq: supprimer la file d'attente des messages sortants pour tous les serveurs (tous les messages que WeeChat est actuellement en train d'envoyer) jump: sauter au tampon du serveur raw: ouvre le tampon avec les données brutes IRC Exemples: /server listfull /server add oftc irc.oftc.net/6697 -ssl /server add oftc6 irc6.oftc.net/6697 -ipv6 -ssl /server add freenode2 chat.eu.freenode.net/6667,chat.us.freenode.net/6667 /server copy oftc oftcbis /server rename oftc newoftc /server del freenode /server deloutq
enregister un nouveau service distribution: visibilité du service type: réservé pour une utilisation future
lister les services actuellement connectés au réseau masque: lister seulement les services qui correspondent à ce masque type: lister seulement les services de ce type
envoyer un message à un service service: nom du service texte: texte à envoyer
déconnecter les liens vers un serveur serveur: nom du serveur commentaire: commentaire pour quitter
demander des statistiques sur le serveur requête: c/h/i/k/l/m/o/y/u (voir la RFC1459) serveur: nom du serveur
envoyer aux utilisateurs d'un serveur IRC un message leur demandant de rejoindre IRC utilisateur: nom d'utilisateur cible: nom du serveur canal: nom du canal
demander l'heure locale de serveur cible: demander l'heure de ce serveur
recevoir/définir le titre du canal canal: nom du canal titre: nouveau titre pour le canal (si le titre est "-delete" alors le titre est supprimé)
trouver le chemin jusqu'à un serveur spécifique cible: serveur
supprime le bannissement sur des pseudos ou hôtes canal: nom du canal pour supprimer le bannissement pseudo: pseudo ou hôte pour supprimer le bannissement
retourne une liste d'informations sur des pseudos pseudo: pseudo
liste des utilisateurs connectés au serveur cible: serveur
retourne la version du pseudo ou du serveur (courant ou spécifié) serveur: nom du serveur pseudo: pseudo
donne la voix à/aux pseudo(s)
envoyer un message à tous les utilisateurs connectés qui ont activé le mode utilisateur 'w' pour eux-mêmes texte à envoyer
génère une requête qui retourne une liste d'information masque: information qui correspond à ce masque uniquement o: seul les opérateurs sont retournés correspondant au masque fourni
demande les informations sur le(s) utilisateur(s) serveur: nom du serveur pseudo: pseudo (peut être un masque)
demander de l'information sur un pseudo qui n'existe plus pseudo: pseudo à chercher nombre: nombre de réponses à retourner (recherche complète si nombre négatif) cible: la réponse doit correspondre à ce masque
L’extension Logger permet de sauvegarder le contenu des tampons dans des fichiers, avec des options sur comment et quoi sauvegarder.
logger.file.auto_log
description: sauve automatiquement le contenu des tampons dans des fichiers (sauf si un tampon désactive le log)
type: booléen
valeurs: on, off (valeur par défaut: on)
logger.file.info_lines
description: écrire une ligne d’information dans le fichier log quand le log démarre ou se termine pour un tampon
type: booléen
valeurs: on, off (valeur par défaut: off)
logger.file.mask
description: masque de fichier par défaut pour les fichiers de log (le format est "repertoire/vers/fichier" ou "fichier", sans le premier "/" car l’option "path" est utilisée pour construire le chemin complet vers le fichier); les variables locales du tampon sont permises
type: chaîne
valeurs: toute chaîne (valeur par défaut: "$plugin.$name.weechatlog")
logger.file.name_lower_case
description: utiliser seulement des minuscules dans le nom des fichiers de log
type: booléen
valeurs: on, off (valeur par défaut: on)
logger.file.path
description: chemin pour les fichiers de log WeeChat ("%h" sera remplacé par le répertoire de base WeeChat, par défaut: "~/.weechat")
type: chaîne
valeurs: toute chaîne (valeur par défaut: "%h/logs/")
logger.file.replacement_char
description: caractère de remplacement dans le nom de fichier construit avec le masque (comme le délimiteur de répertoire)
type: chaîne
valeurs: toute chaîne (valeur par défaut: "_")
logger.file.time_format
description: format de date/heure utilisé dans les fichiers log (voir strftime(3) pour le format de date/heure)
type: chaîne
valeurs: toute chaîne (valeur par défaut: "%Y-%m-%d %H:%M:%S")
logger.look.backlog
description: nombre maximum de lignes à afficher du fichier de log lors de l’ouverture du tampon (0 = ne rien afficher)
type: entier
valeurs: 0 .. 2147483647 (valeur par défaut: 20)
configuration de l'extension logger list: afficher le statut d'enregistrement pour les tampons ouverts set: définir le niveau d'enregistrement pour le tampon courant niveau: niveau pour les messages à enregistrer (0 = pas d'enregistrement, 1 = quelques messages (les plus importants) .. 9 = tous les messages) disable: désactiver l'enregistrement pour le tampon courant (définir le niveau à 0) Les options "logger.level.*" et "logger.mask.*" peuvent être utilisées pour définir le niveau ou le masque de nom de fichier pour un tampon, ou plusieurs tampons commençant par un nom. Exemples: définir le niveau d'enregistrement à 5 pour le tampon courant: /logger set 5 désactiver l'enregistrement pour le tampon courant: /logger disable définir le niveau à 3 pour les tampons IRC: /set logger.level.irc 3 désactiver l'enregistrement pour le tampon principal de WeeChat: /set logger.level.core.weechat 0 utiliser un répertoire par serveur IRC et un fichier par canal dedans: /set logger.mask.irc "$server/$channel.weechatlog" Niveaux de log utilisés par l'extension IRC: 1: message d'utilisateur, notice, privé 2: changement de pseudo 3: message du serveur 4: join/part/quit 9: tous les autres messages
L’enregistrement est fait selon un niveau pour chaque tampon. Le niveau par défaut est 9 (enregistrer tous les messages affichés dans le tampon). Vous pouvez changer ce niveau pour un tampon, ou un groupe de tampons.
Les niveaux possibles vont de 0 à 9. Zéro signifie "ne rien enregistrer" et 9 signifie "enregistrer tous les messages".
Les extensions utilisent différent niveaux pour les messages affichés. L’extension IRC utilise les niveaux suivants :
niveau 1 : message d’un utilisateur (sur un canal ou en privé)
niveau 2 : changement de pseudo (vous ou quelqu’un d’autre)
niveau 3 : tout message du serveur (sauf join/part/quit)
niveau 4 : message join/part/quit du serveur
Donc si vous affectez le niveau 3 pour un canal IRC, WeeChat enregistrera tous les messages sauf les join/part/quit.
Quelques exemples :
affecter le niveau 3 pour le canal IRC #weechat :
/set logger.level.irc.freenode.#weechat 3
affecter le niveau 3 pour le tampon serveur freenode :
/set logger.level.irc.server.freenode 3
affecter le niveau 3 pour tous les canaux sur le serveur freenode :
/set logger.level.irc.freenode 3
affecter le niveau 2 pour tous les tampons IRC :
/set logger.level.irc 2
Il est possible de définir un masque de nom de fichier pour chaque tampon, et d’utiliser les variables locales du tampon pour construire le nom de fichier. Pour voir les variables du tampon courant :
/buffer localvar
Par exemple, si vous voulez un répertoire par serveur IRC et un fichier par canal dedans :
/set logger.mask.irc "irc/$server/$channel.weechatlog"
Vous obtiendrez les fichiers suivants :
~/.weechat/ |--- logs/ |--- irc/ |--- freenode/ | freenode.weechatlog | #weechat.weechatlog | #mychan.weechatlog |--- oftc/ | oftc.weechatlog | #chan1.weechatlog | #chan2.weechatlog
WeeChat fournit 5 extensions pour scripts : Perl, Python, Ruby, Lua and Tcl. Ces extensions peuvent charger, exécuter et décharger des scripts pour ces langages.
Pour plus d’informations sur comment écrire des scripts, ou sur l’API WeeChat pour les scripts, merci de lire le Le Guide pour Scripts WeeChat.
Vous pouvez trouver des scripts pour WeeChat ici : http://www.weechat.org/plugins
liste/charge/décharge des scripts fichier: script (fichier) à charger nom: un nom de script Sans argument, cette commande liste tous les scripts chargés.
liste/charge/décharge des scripts fichier: script (fichier) à charger nom: un nom de script Sans argument, cette commande liste tous les scripts chargés.
liste/charge/décharge des scripts fichier: script (fichier) à charger nom: un nom de script Sans argument, cette commande liste tous les scripts chargés.
liste/charge/décharge des scripts fichier: script (fichier) à charger nom: un nom de script Sans argument, cette commande liste tous les scripts chargés.
liste/charge/décharge des scripts fichier: script (fichier) à charger nom: un nom de script Sans argument, cette commande liste tous les scripts chargés.
L’extension Xfer permet :
la discussion directe (entre deux machines, sans serveur), par exemple le "DCC Chat" via l’extension IRC
le transfert de fichiers, par exemple le "DCC" via l’extension IRC
xfer.color.status_aborted
description: couleur du texte pour le statut "interrompu"
type: couleur
valeurs: un nom de couleur (valeur par défaut: lightred)
xfer.color.status_active
description: couleur du texte pour le statut "actif"
type: couleur
valeurs: un nom de couleur (valeur par défaut: lightblue)
xfer.color.status_connecting
description: couleur du texte pour le statut "connexion"
type: couleur
valeurs: un nom de couleur (valeur par défaut: yellow)
xfer.color.status_done
description: couleur du texte pour le statut "terminé"
type: couleur
valeurs: un nom de couleur (valeur par défaut: lightgreen)
xfer.color.status_failed
description: couleur du texte pour le statut "échoué"
type: couleur
valeurs: un nom de couleur (valeur par défaut: lightred)
xfer.color.status_waiting
description: couleur du texte pour le statut "en attente"
type: couleur
valeurs: un nom de couleur (valeur par défaut: lightcyan)
xfer.color.text
description: couleur du texte
type: couleur
valeurs: un nom de couleur (valeur par défaut: default)
xfer.color.text_bg
description: couleur du fond
type: couleur
valeurs: un nom de couleur (valeur par défaut: default)
xfer.color.text_selected
description: couleur du texte pour la ligne xfer sélectionnée
type: couleur
valeurs: un nom de couleur (valeur par défaut: white)
xfer.file.auto_accept_chats
description: accepte automatiquement les demandes de discussion (à utiliser avec précaution !)
type: booléen
valeurs: on, off (valeur par défaut: off)
xfer.file.auto_accept_files
description: accepte automatiquement les demandes d’envoi de fichiers (à utiliser avec précaution !)
type: booléen
valeurs: on, off (valeur par défaut: off)
xfer.file.auto_rename
description: renommer les fichiers reçus s’ils existent déjà (ajoute ".1", ".2", …)
type: booléen
valeurs: on, off (valeur par défaut: on)
xfer.file.auto_resume
description: continuer automatiquement les transferts de fichiers si la connexion avec l’hôte a été perdue
type: booléen
valeurs: on, off (valeur par défaut: on)
xfer.file.convert_spaces
description: convertir les espaces en underscores lors d’envoi de fichiers
type: booléen
valeurs: on, off (valeur par défaut: on)
xfer.file.download_path
description: chemin où écrire les fichiers reçus
type: chaîne
valeurs: toute chaîne (valeur par défaut: "%h/xfer")
xfer.file.upload_path
description: chemin pour lire les fichiers envoyés (quand aucun chemin n’est spécifié par l’utilisateur)
type: chaîne
valeurs: toute chaîne (valeur par défaut: "~")
xfer.file.use_nick_in_filename
description: utiliser le pseudo distant comme préfixe dans le nom de fichier local lors de la réception d’un fichier
type: booléen
valeurs: on, off (valeur par défaut: on)
xfer.look.auto_open_buffer
description: ouvrir automatiquement le tampon xfer lorsqu’un nouveau xfer est ajouté à la liste
type: booléen
valeurs: on, off (valeur par défaut: on)
xfer.look.progress_bar_size
description: taille de la barre de progression, en caractères (si 0, la barre de progression est désactivée)
type: entier
valeurs: 0 .. 256 (valeur par défaut: 20)
xfer.network.blocksize
description: taille de bloc pour les paquets envoyés, en octets
type: entier
valeurs: 1024 .. 102400 (valeur par défaut: 65536)
xfer.network.fast_send
description: n’attend pas les accusés de réception lors de l’envoi de fichier
type: booléen
valeurs: on, off (valeur par défaut: on)
xfer.network.own_ip
description: adresse IP ou DNS utilisée pour envoyer les fichiers/discussions (si non renseigné, l’interface IP locale est utilisée)
type: chaîne
valeurs: toute chaîne (valeur par défaut: "")
xfer.network.port_range
description: restreint les fichiers/discussions sortants à utiliser des ports dans l’intervalle donné (pratique pour le NAT) (syntaxe: un port simple, par exemple 5000, un intervalle de ports, par exemple 5000-5015, si non renseigné tout port peut être utilisé, il est recommandé d’utiliser des ports supérieurs à 1024, car seul root peut utiliser les ports en dessous de 1024)
type: chaîne
valeurs: toute chaîne (valeur par défaut: "")
xfer.network.speed_limit
description: limitation de vitesse pour l’envoi des fichiers, en kilo-octets par seconde (0 signifie pas de limite)
type: entier
valeurs: 0 .. 2147483647 (valeur par défaut: 0)
xfer.network.timeout
description: délai d’attente pour la requête xfer (en secondes)
type: entier
valeurs: 5 .. 2147483647 (valeur par défaut: 300)
contrôle xfer list: liste les xfer listfull: liste les xfer (verbeux) Sans paramètre, cette commande ouvre le tampon avec la liste des xfer.
développeur principal
empaqueteur debian
ancien empaqueteur debian
traduction en tchèque, patchs
traduction en polonais
traduction en allemand
traduction en russe
traduction en espagnol
traduction en hongrois
patchs
patchs
RPM pour SuSE
patchs
patchs
Avant de faire appel au support, merci de lire la documentation et la FAQ de WeeChat (la documentation est le document que vous êtes en train de lire, si vous n’avez pas tout lu jusqu’ici, il est encore temps de recommencer !).
Moyens d’obtenir du support :
IRC : serveur irc.freenode.net, canaux #weechat (anglais) et #weechat-fr (français)
Forum WeeChat : http://forums.flashtux.org/
Liste de diffusion :
inscription : http://mail.nongnu.org/mailman/listinfo/weechat-support
envoi d’un mail à weechat-support@nongnu.org
archives : http://mail.nongnu.org/archive/html/weechat-support