WeeChat Quick Start Guide

Es recomendable una terminal emulada para X (pero no indispensable) rxvt-unicode: tiene un buen soporte para UTF-8, y no da problemas con los atajas de teclados predeterminados.

Run from your shell:

WeeChat tiene ayuda para todos los comandos, solo teclee:

Para obtener ayuda específicamente de un comando, teclee:

Help is available for options as well:

(donde config es el nombre de la configuración del núcleo o del plugin que desea configurar, section, la sección de esa configuración y option el nombre de la opción).

Para configurar una opción, use:

WeeChat usará inmediatamente el nuevo valor asignado (no es necesario reiniciar WeeChat después de aplicar cambios a la configuración).

Todas las opciones se salvarán de manera automática cuando cierre WeeChat o usando el comando /save para forzar la forzar a WeeChat a guardar todos los archivos de configuración.

The plugin fset allows you to easily browse options and change them.

For example to display WeeChat options:

IRC options:

The /fset command has completion on part of option names, so for example if you type /fset hot and press Tab this is completed as /fset hotlist. If you press Enter, options about the hotlist are displayed.

For more information about /fset command and keys, see /help fset.

Llamaremos "Núcleo de WeeChat" a la aplicación que solo se usa para mostrar información en pantalla e interactuar con el usuario, eso es lo único que hace el núcleo de WeeChat sin no tiene plugins. (para los fieles seguidores: IRC fue parte del núcleo para las versiones ≤ 0.2.6).

Todos los protocolos de red como IRC, provienen en plugins separados.

Use el comando /plugin para ver una lista de los plugins cargados, seguramente vera irc y otros.

You can add an IRC server with /server command, for example:

In this command, freenode is the internal server name used by WeeChat: you’ll be able to connect with /connect freenode and the server options are irc.server.freenode.xxx.

La ayuda está disponible; si te pierdes:

WeeChat usa las opciones por defecto para todos los servidores ("predeterminado") si no le especifica un valor individual a un servidor en específico. Esas opciones por defectos son las que se muestran en "irc.server_default.*"

Para cada opción de "server", WeeChat usa estos valores previamente asignados siempre y cuando no sean Nulos. Si no hay nada asignado, WeeChat usara los valores predeterminados ("irc.server_default.xxx")

Por ejemplo, tenemos el nick por defecto (que se basa en su login) pero usted puedes sobreescribirlo para el servidor identificado como freenode de la siguiente manera:

También para configurar el nombre de usuario y el nombre real:

Para que el servidor se conecte cuando WeeChat inicie:

To connect with SSL:

If SASL is available on server, you can use it for authentication (you will be identified before you join channels):

To run a command after connection to server, for example to authenticate with nickserv (only if you don’t use SASL for authentication):

If you want to protect your password in configuration files, you can use secured data.

First setup a passphrase:

Then add a secured data with your freenode password:

Then you can use ${sec.data.freenode_password} instead of your password in IRC options mentioned above, for example:

Para unirse automáticamente a canales cuando el servidor se conecte:

Para eliminar un valor asignado a una opción de servidor y usar los valores por defecto en su lugar, por ejemplo, usar el nick por defecto (irc.server_default.nicks):

Otras opciones: pude configurar otras opciones con el siguiente comando, donde "xxx" es el nombre de la opción.

With this command, WeeChat connects to the freenode server and auto-joins the channels configured in the "autojoin" server option.

Por defecto, todos los buffers del servidor están junto al buffer de núcleo. Para cambiar entre el buffer del núcleo y el buffer de los servidores use Ctrl+x.

Es posible deshabilitar esta manera de tener todos los buffer de servidores juntos para tenerlos de manera independiente:

Se une a un canal llamado "#canal":

Sale de un canal (mantiene el buffer abierto):

Close a server, channel or private buffer (/close is an alias for /buffer close):

Disconnect from server, on the server buffer:

Open a buffer and send a message to another user (nick foo):

Close the private buffer:

Un buffer, es un componente vinculado a un plugin con un número, una categoría y un nombre. El buffer contiene los datos que se muestran en la pantalla.

Una ventana es una vista de un buffer. Por defecto, una sola ventana muestra un solo buffer. Si divide la pantalla, podrá ver muchas ventanas conteniendo varios buffer al mismo tiempo.

Comandos para manipular buffer y ventana:

Por ejemplo, para dividir la pantalla una pequeña ventana (1/3) junto a otras mas grande (2/3) use el comando

To remove the split:

WeeChat usa muchas teclas por defecto. Las mismas, están bien explicadas en la documentación pero debe conocer al menos la mas importantes.

De acuerdo con su teclado y/o sus necesidades, puede asignar teclas a un comando usando el comando /key. Una combinación de teclas muy valiosa es Alt+k para hallar el código de alguna tecla.

Por ejemplo, para asignar la combinación Alt+! al comando /buffer close:

El comando se vera mas o menos así:

Para eliminar una combinación:

En algunas distribuciones como Debian, los plugins están disponibles en un paquete separado (como weechat-plugin). Los plugins se cargan de manera automática cuando son encontrados por WeeChat (por favor, refierase a la documentación de WeeChat para ver como cargar/descargar plugins y scripts).

Many external scripts (from contributors) are available for WeeChat, you can download and install scripts from the repository with the /script command, for example:

See /help script for more info.

A list of scripts is available in WeeChat with /script or at this URL: https://weechat.org/scripts

Ahora puede usar WeeChat y leer las FAQ/documentación para cada pregunta en: https://weechat.org/doc

Disfrute de WeeChat!