Guida Rapida a WeeChat

Un emulatore di terminale raccomandato per X (ma non obbligatorio) è rxvt-unicode: ha un buon supporto per UTF-8, e nessun problema con le scorciatoie da tastiera predefinite.

Avviare dalla propria shell:

WeeChat offre aiuto per tutti i comandi, basta digitare:

Per ricevere aiuto su un comando specifico, digitare:

Help is available for options as well:

(dove config è il nome della configurazione (weechat per il core, oppure un nome plugin), sezione la sezione di questa configurazione e opzione il nome dell’opzione).

Per impostare le opzioni, utilizzare:

WeeChat utilizza subito il nuovo valore (non c’è mai bisogno di riavviare WeeChat dopo aver cambiato la configurazione).

Tutte le impostazioni vengono salvato all’uscita di WeeChat (o con il comando /save per forzare il salvataggio di una o più opzioni).

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.

Il "core" di WeeChat è utilizzato solo per visualizzare i dati sullo schermo e interagire con l’utente; ciò vuol dire che il core di weechat senza i plugin è inutile (utenti più fedeli: IRC faceva parte del core per le versioni ≤ 0.2.6).

Tutti i protocolli di rete come IRC sono forniti in plugin separati.

Utilizzando il comando plugin per elencare i plugin caricati, è possibile vedere "irc" ed altri plugin nella lista.

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.

Come al solito, è disponibile l’aiuto se c’è qualche problema:

WeeChat usa valori predefiniti per tutti i server, se non si specifica un valore preciso per un’opzione del server. Questi valori predefiniti sono "irc.server_default.*"

Per ogni opzione del server, WeeChat usa il proprio valore se definito (non "nullo"). Altrimenti si utilizza il valore predefinito ("irc.server_default.xxx").

Per esempio ci sono dei nick predefiniti (basati sul proprio login un*x), ed è possibile sovrascriverli per il server freenode con il seguente comando:

Per impostare il nome utente ed il nome reale:

Per impostare la connessione automatica al server all’avvio:

To connect with SSL:

Se SASL è disponibile sul server, è possibile usarlo per l’autenticazione (l’autenticazione avviene prima dell’ingresso nei canali):

Per eseguire un comando dopo la connessione al server, ad esempio per autenticarsi con nickserv (solo se non viene usato SASL per l’autenticazione):

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:

Per entrare automaticamente in alcuni canali quando ci si connette al server:

Per eliminare il valore di un’opzione del server, e usare invece il valore predefinito, per esempio per utilizzare i nick predefiniti (irc.server_default.nicks):

Altre opzioni: è possibile impostare altre opzioni con il seguente comando ("xxx" è il nome dell’opzione):

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

I buffer dei server vengono uniti al buffer core di WeeChat in modo predefinito. Per passare tra buffer core e buffer server, si può digitare Ctrl+x.

È possibile disabilitare l’unione automatica dei server dei buffer per avere i buffer dei server indipendenti:

Entra in un canale:

Esce da un canale (mantenendo il buffer aperto):

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 è un componente collegato ad un plugin con un numero, una categoria e un nome. Un buffer contiene i dati visualizzati sullo schermo.

Una finestra è la vista di un buffer. Il comportamento predefinito prevede solo una finestra che visualizza un buffer. Se lo schermo viene diviso, sarà possibile vedere più finestre con molti buffer allo stesso tempo.

I comandi per gestire buffer e finestre:

Per esempio, per dividere verticalmente lo schermo in una finestra piccola (1/3 della larghezza) ed una grande (2/3), utilizzare il comando:

To remove the split:

WeeChat usa molti tasti. Essi sono tutti presenti nella documentazione, ma si dovrebbero conoscere almeno quelli vitali:

A seconda della propria tastiera e/o le proprie necessità, è possibile associare nuovamente qualsiasi tasto ad un comando tramite /key. Un tasto utile è Alt+k per trovare i codici tasti.

Ad esempio, per associare Alt+! al comando /buffer close:

Si otterrà una riga di comando simile a:

Per eliminare il tasto:

Su alcune distribuzioni come Debian, i plugin sono disponibili tramite un pacchetto separato (come weechat-plugins). I plugin vengono caricati automaticamente quando trovati (per favore consultare la documentazione per caricare/scaricare plugin o script).

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

È ora possibilie usare WeeChat e leggere FAQ/documentazione per ogni altra domanda: https://weechat.org/doc

Buon WeeChat!