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:

L’aiuto è anche disponibile per le opzioni:

(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).

Il plugin fset ti permette facilmente di navigare tra le opzioni e cambiarle.

Per esempio, per mostrare le opzioni di WeeChat:

Opzioni IRC:

Il comando /fset ha il completamento nei nomi delle opzioni, quindi se ad esempio scrivi /fset hot e premi Tab, questo viene completato come /fset hotlist. Se premi Enter, vengono mostrate le opzioni riguardo la hotlist.

Per più informazioni sul comando /fset e i suoi tasti, vedi /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.

Puoi aggiungere un server IRC con il comando /server, per esempio:

In questo comando, libera è il nome interno del server usato da WeeChat: sarai in grado di connetterti con /connect libera e le opzioni del server sono irc.server.libera.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 libera con il seguente comando:

Per impostare il nome utente ed il nome reale:

Per impostare la connessione automatica al server all’avvio:

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):

Se vuoi proteggere la tua password nei file di configurazione, puoi usare dati protetti.

Per prima cosa imposta una frase segreta (passphrase):

Ora aggiungi il dato protetto con la tua password di libera:

Puoi usare ${sec.data.libera_password} al posto della tua password nelle opzioni IRC menzionate sopra, per esempio:

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

Il comando /autojoin ti permette di configurare l’opzione autojoin facilmente (vedi /help autojoin).

Puoi anche configurare WeeChat per aggiornare automaticamente l’opzione autojoin quando entri o esci dai canali:

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):

Con questo comando, WeeChat si connette al server libera ed entra automaticamente nei canali configurati nell’opzione "autojoin" del server.

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):

Chiude un server, un canele o un buffer privato (/close è un sinonimo per /buffer close):

Disconnette dal server:

Apre un buffer e invia un messaggio a un altro utente (nome foo):

Chiude il buffer privato:

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:

Per rimuovere la divisione:

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).

Sono disponibili molti script esterni (da contributori) per WeeChat, puoi scaricare e installare script dal repository con il comando /script, per esempio:

Vedi /help script per più informazioni.

Una lista degli script è disponibile su WeeChat tramite /script o su questa pagina ^↗.

Ora sei in grado di usare WeeChat e leggere FAQ/documentazione ^↗ per qualsiasi altra domanda.

Buon WeeChat!