1. Général

1.1. Pourquoi choisir WeeChat ? X-Chat et Irssi sont si bien…

Parce que WeeChat est très léger et a de nouvelles fonctionnalités. Quelques fonctionnalités (version > = 0.3.x) :

Plus d’infos sur cette page : http://www.weechat.org/features

2. Compilation / installation

2.1. J’ai entendu parler de plusieurs interfaces pour WeeChat. Comment puis-je les compiler/utiliser ?

Aujourd’hui seule l’interface Curses est disponible.

D’autres interfaces seront disponibles en mode distant (actuellement en développement).

2.2. Je ne peux pas compiler WeeChat après avoir cloné la base git, pourquoi ?

La méthode recommandée pour compiler WeeChat est d’utiliser cmake.

Si vous compilez avec les autotools (et non cmake), vérifiez que vous avez bien la dernière version d’autoconf et automake (WeeChat est développé avec autoconf 2.61 et automake 1.10.1).

Une autre façon de faire est de compiler le "paquet devel", qui nécessite moins de dépendences. Ce paquet est construit quasiment tous les jours à partir de la base git. Notez que ce paquet peut ne pas correspondre exactement à la base git et qu’il est moins pratique que de cloner la base git pour installer des mises à jour.

3. Utilisation de WeeChat

3.1. J’ai lancé WeeChat, mais je suis perdu, que puis-je faire ?

Pour obtenir de l’aide tapez /help. Pour de l’aide sur une commande, tapez /help commande. Les touches et commandes sont listées dans la documentation.

Il est recommandé pour les nouveaux utilisateurs de lire le guide de démarrage rapide (voir la page de doc sur le site).

3.2. J’ai entendu parler de "buffer" et "window", quelle est la différence ?

Un tampon (buffer) est composé d’un numéro, un nom, des lignes affichées (ainsi que d’autres données).

Une fenêtre (window) est une zone de l'écran affichant un tampon. Il est possible de découper l'écran horizontaleent ou verticalement en plusieurs fenêtres.

Chaque fenêtre affiche un tampon. Un tampon peut être caché (affiché par aucune fenêtre) ou affiché par une ou plusieurs fenêtres.

3.3. Je ne vois pas bien certains accents dans WeeChat, que faire ?

C’est un problème courant, merci de lire attentivement et vérifier TOUS les points ci-dessous.

Pour les versions < 0.2.3, merci d’installer la dernière version stable.

Pour les versions > = 0.2.3 :

Note
La locale UTF-8 est recommandée pour WeeChat. Si vous utilisez ISO ou une autre locale, assurez-vous que tout soit configuré en ISO (terminal, screen, …) et pas en UTF-8.

3.4. Des barres telles que le titre et le statut ne sont pas remplies, la couleur de fond s’arrête après le texte, pourquoi ?

Cela peut être du à la variable TERM qui n’a pas la bonne valeur (regardez la sortie de echo $TERM dans votre terminal).

Selon la façon de lancer WeeChat, vous devriez avoir :

Si besoin, corrigez la variable TERM : export TERM="xxx".

3.5. Quand j’utilise weechat sous screen, j’ai des caractères bizarres et aléatoires, comment corriger ça ?

Cela peut être du à la variable TERM qui n’a pas la bonne valeur (regardez la sortie de echo $TERM dans votre terminal).

Par exemple xterm-color provoque ce genre de problèmes, utilisez xterm qui est ok (comme plein d’autres valeurs).

Si besoin, corrigez la variable TERM : export TERM="xxx".

3.6. Comment puis-je configurer les raccourcis clavier ?

Les raccourcis clavier sont modifiables avec la commande /key.

La touche par défaut Meta-k (souvent Alt-k) permet de capturer le code d’une touche et de l’inclure dans la ligne de commande.

3.7. J’utilise OpenBSD et WeeChat ne charge aucune extension, pourquoi ?

Sous OpenBSD, le nom des extensions se termine par ".so.0.0" (".so" sous Linux).

Vous devez configurer ça :

Puis: /plugin autoload.

3.8. Comment puis-je charger des scripts Perl/Python/Ruby/Lua/Tcl ? Les scripts sont-ils compatibles avec d’autres clients IRC ?

Les commandes /perl, /python, /ruby, /lua et /tcl permettent de charger les scripts (le chemin par défaut est ~/.weechat/<langage>/).

Les scripts ne sont pas compatibles avec d’autres clients IRC.

Notes :

3.9. Je souhaite changer la langue des messages affichés par WeeChat, mais sans quitter WeeChat, est-ce possible ?

Oui, il faut utiliser le script python shell.py (disponible sur le site de WeeChat) et taper ces commandes une fois le script chargé :

/shell setenv LANG=fr_FR.UTF-8
/upgrade

Pour avoir des messages anglais avec encodage UTF-8 pour le terminal, pour les utilisateurs en ISO, vous pouvez taper : /shell setenv LANG=fr_FR.

3.10. Avec l’interface Curses, comment puis-je copier/coller du texte sans coller la liste des pseudos ?

Vous pouvez utiliser un terminal qui propose la sélection rectangulaire (comme rxvt-unicode, konsole, gnome-terminal, etc…). La touche est habituellement ctrl + alt + sélection à la souris.

Une autre solution est de déplacer la liste des pseudos en haut ou en bas, par exemple :

3.11. Comment être averti lorsque quelqu’un prononce mon pseudo sur un canal ?

Selon la version de WeeChat :

De nombreux autres scripts de notification existent, merci de consulter la liste des extensions/scripts : http://www.weechat.org/plugins

3.12. Comment puis-je filter les messages join/part/quit sur les canaux IRC ?

Selon la version de WeeChat :

3.13. Quelle est la différence entre les commandes /ignore et /filter ?

La commande /ignore est une commande IRC, donc elle s’applique uniquement aux tampons IRC (serveurs et canaux). Elle permet d’ignorer des pseudos ou nom d’hôtes pour un serveur ou un canal (la commande ne s’applique pas au contenu des messages). Les messages corespondants sont supprimés par l’extension IRC avant affichage (donc vous ne les verrez jamais).

La commande /filter est une commande "core", donc elle s’applique à n"importe quel tampon. Elle permet de filtrer des lignes dans les tampons à l’aide de tags ou d’expression régulière pour le préfixe et contenu de la ligne. Les lignes filtrées sont simplement cachées, pas supprimées, et il est possible de les voir en désactivant les filtres (par défaut, la touche alt + "=" active/désactive les filtres).

4. Développement

4.1. Comment puis-je reporter un bug, demander une nouvelle fonctionnalité ou envoyer un patch ?

Il y a 3 possibilités :

  1. vous pouvez nous joindre sur IRC : irc.freenode.net, canal #weechat

  2. vous pouvez utiliser le site savannah :

  3. vous pouvez envoyer un mail aux développeurs, consultez la page support pour les mails des développeurs : http://www.weechat.org/about (vous pouvez souscrire et envoyer à la liste de diffusion nommée "support")

4.2. Quelle est la liste des plate-formes supportées par WeeChat ? Sera-t-il porté sur d’autres systèmes d’exploitation ?

La liste complète est sur cette page : http://www.weechat.org/download

Nous faisons le maximum pour supporter le plus de plate-formes possible. Toute aide est la bienvenue pour les systèmes que nous n’avons pas, pous y tester WeeChat.

4.3. Je souhaiterai aider les développeurs WeeChat. Que puis-je faire ?

Il y a plusieurs choses à faire (test, code, documentation, etc…)

Merci de prendre contact avec nous par IRC ou mail, consultez la page support : http://www.weechat.org/about

Vous pouvez donner de l’argent pour aider le développement. Plus de détails sur http://www.weechat.org/donate