Questo manuale documenta il client di chat WeeChat, ed è parte del programma stesso.
È possibile trovare l’ultima versione di questo documento qui: http://www.weechat.org/doc
1. Introduzione
WeeChat (Wee Enhanced Environment for Chat) è un client di chat libero, veloce e leggero, realizzato per diversi sistemi operativi.
1.1. Caratteristiche
Le caratteristiche principali:
-
multi-protocollo (IRC ed altri presto in arrivo)
-
connessione a server multipli (con SSL, IPv6, proxy)
-
molte interfacce: Curses (wxWidgets, Gtk e Qt in fase di sviluppo)
-
piccolo, veloce e leggero
-
personalizzabile ed estensibile con plugin e script
-
multi-piattaforma (GNU/Linux, *BSD, MacOS X, Windows ed altre)
-
100% GPL, software libero
La home page di WeeChat si trova qui: http://www.weechat.org/
1.2. Requisiti
Per poter installare WeeChat, è necessario:
-
un sistema GNU/Linux in esecuzione (con gli strumenti di compilazione per i sorgenti), oppure OS compatibile
-
privilegi di root (per installare WeeChat in una cartella di sistema)
-
librerie ncurses
2. Installazione
2.1. Pacchetti binari
I pacchetti binari sono disponibili per molte distribuzioni, incluse:
-
Debian (o qualsiasi distribuzione compatibile): apt-get install weechat
-
Mandriva/RedHat (o qualsiasi distribuzione compatibile con gli RPM): rpm -i /percorso/per/weechat-x.y.z-1.i386.rpm
-
Gentoo: emerge weechat
Potrebbero risultare utili alcuni pacchetti addizionali, come weechat-plugins.
Per altre distribuzioni, consultare il manuale per le istruzioni di installazione.
2.2. Sorgenti
WeeChat può essere compilato con cmake oppure autotools (tuttavia si raccomanda cmake).
2.2.1. Con cmake
-
Installazione nelle cartelle di sistema (richiede privilegi di root):
$ mkdir build $ cd build $ cmake .. $ make % make install (come root)
-
Installazione in una cartella personalizzata:
$ mkdir build $ cd build $ cmake .. -DPREFIX=/percorso/della/cartella $ make $ make install
2.2.2. Con autotools
-
Installazione nelle cartelle di sistema (richiede privilegi di root):
$ ./configure $ make % make install (come root)
-
Installazione in una cartella personalizzata:
$ ./configure --prefix=/path/to/directory $ make $ make install
2.3. Sorgenti git
Attenzione: i sorgenti GIT sono per gli utenti avanzati: potrebbero non compilare o essere instabili. Siete avvisati!
Per ottenere i sorgenti GIT, dare il comando:
$ git clone git://git.sv.gnu.org/weechat.git
Se si usano gli autotools (e non cmake), eseguire questo script:
$ ./autogen.sh
Poi seguire le istruzioni per i sorgenti (consultare [source_package]).
3. Utilizzo
3.1. Esecuzione di WeeChat
Argomenti a riga di comando:
- -a, --no-connect
-
Disabilita la connessione automatica ai server all’avvio di WeeChat
- -d, --dir path
-
Imposta una cartella come home per WeeChat (utilizzata per i file di configurazione, log, plugin e script dell’utente), il valore predefinito è ~/.weechat
- -h, --help
-
Visualizza l’aiuto
- -k, --keys
-
Visualizza i tasti predefiniti di WeeChat
- -l, --license
-
Visualizza la licenza di WeeChat
- -p, --no-plugin
-
Disabilita il caricamento automatico dei plugin
- -v, --version
-
Visualizza la versione di WeeChat
- plugin:option
-
Opzione per il plugin (consultare la documentazione per ogni plugin)
Per avviare WeeChat, digitare questo comando:
$ weechat-curses
Alla prima esecuzione di WeeChat, viene creato un file di configurazione predefinito. Il file di configurazione viene creato nella cartella: ~/.weechat/weechat.conf.
È possibile modificare questo file per configurare WeeChat a seconda delle proprie esigenze, oppure impostando i parametri con il comando /set all’interno di WeeChat (consultare [weechat_commands]).
3.2. Layout dello schermo
Esempio di terminale con WeeChat:
┌─────────────────────────────────────────────────────────────────────────────────────────┐
│Benvenuti in #test, questo è un canale di test │
│12:52:27 --> | flashy (n=flashcod@hellix.flashtux.org) è entrato in #test │@ChanServ │
│12:52:27 -- | Nick #test: [@ChanServ @flashy +_FlashB0t joe mike] │@flashy │
│12:52:27 -- | Canale #test: 5 nick (2 ops, 0 halfop, 1 voce, 2 normale) │+_FlashB0t│
│12:52:27 -- | Canale creato il Tue Jan 27 06:30:17 2009 │joe │
│12:54:15 flashy | ehi! │mike │
│12:55:01 joe | ciao flashy! │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│[12:55] [4] [irc/freenode] 3:#test(+n){5}* [Attività: 4,2] │ │
│[flashy] ciao joe!█ │ │
└─────────────────────────────────────────────────────────────────────────────────────────┘
Lo schermo è composto dalle seguenti aree:
-
area di chat (centro dello schermo) con le righe di chat, e per ogni riga:
-
ora
-
prefisso (prima di "|")
-
messaggio (dopo di "|")
-
-
barre che circondano l’area di chat, quelle predefinite sono:
-
barra titolo, in alto rispetto all’area di chat
-
barra stato, in basso rispetto all’area di chat
-
barra input, in basso rispetto alla barra di stato
-
barra nicklist, sulla destra
-
La barra stato ha i seguenti elementi predefiniti:
| Elemento | Esempio | Descrizione |
|---|---|---|
time |
[12:55] |
ora |
buffer_count |
[4] |
numero di buffer aperti |
buffer_plugin |
[irc/freenode] |
plugin del buffer attivo (il plugin irc può aggiungere il nome del server irc usato dal buffer) |
buffer_number |
3 |
numero del buffer corrente |
buffer_name |
#test(+n) |
nome del buffer attivo |
buffer_nicklist_count |
{5} |
numero di nick nella lista nick |
buffer_filter |
* |
indicatore filtraggio: * significa che alcune righe sono filtrate (nascoste), valori vuoti indicano che tutte le righe sono visualizzate |
lag |
[Ritardo: 2.5] |
indicatore ritardo, in secondi (nascosto se il ritardo è basso) |
hotlist |
[Attività: 4,2] |
elenco dei buffer con attività (messaggi non letti) |
completion |
abc(2) def(5) |
elenco di parole per il completamento, con il numero di completamenti possibili per ogni parola |
scroll |
-ANCORA(50)- |
indicatore di scorrimento, con il numero di righe sotto l’ultima riga visualizzata |
La barra input ha i seguenti elementi predefiniti:
| Elemento | Esempio | Descrizione |
|---|---|---|
input_paste |
[Incollare 7 righe ? [ctrl-Y] Sì [ctrl-N] No] |
chiede all’utente se incollare le righe |
input_prompt |
[nick] |
prompt per l’input (nick per il plugin irc) |
away |
(assente) |
indicatore di assenza |
input_search |
[Ricerca testo] |
indicatore di ricerca testo |
input_text |
bla bla... |
testo in input |
3.3. Associazione tasti predefinita
3.3.1. Tasti per la riga di comando
| Tasti | Descrizione e comando |
|---|---|
Freccia sinistra |
Passa al carattere precedente nella riga di comando |
Freccia destra |
Passa al carattere successivo nella riga di comando |
Ctrl + freccia sinistra |
Passa alla parola precedente nella riga di comando |
Ctrl + freccia destra |
Passa alla parola successiva nella riga di comando |
Home |
Si sposta all’inizio della riga di comando |
Fine |
Si sposta alla fine della riga di comando |
Ctrl + C poi B |
Inserisce il codice per il testo in grassetto |
Ctrl + C poi C |
Inserisce il codice per il testo colorato |
Ctrl + C poi I |
Inserisce il codice per il testo in corsivo |
Ctrl + C poi O |
Inserisce il codice per il reset dei colori |
Ctrl + C then R |
Inserisce il codice per l’inversione dei colori |
Ctrl + C poi U |
Inserisce il codice per il testo sottolineato |
Canc |
Elimina il carattere successivo nella riga di comando |
Backspace |
Elimina il carattere precedente nella riga di comando |
Ctrl + K |
Elimina dal cursore fino alla fine della riga di comando (la stringa eliminata
viene copiata negli appunti) |
Ctrl + R |
Cerca il testo nella cronologia del buffer (due volte: cerca testo esatto) |
Ctrl + T |
Inverti caratteri |
Ctrl + U |
Elimina dal cursore fino all’inizio della riga di comando (la stringa eliminata
viene copiata negli appunti) |
Ctrl + W |
Elimina la parola precedente nella riga di comando (la stringa eliminata viene
copiata negli appunti) |
Ctrl + Y |
Incolla il contenuto degli appunti |
Tab |
Completa comando o nick (Tab di nuovo: trova prossimo completamento) |
Shift + Tab |
Senza completamento: effettua un completamento parziale, con
completamento in sospeso: completa con il completamento precedente |
Qualsiasi carattere |
Inserisce carattere alla posizione del cursore nella riga di comando |
Invio |
Esegue comando o invia messaggio (in modalità ricerca: ferma ricerca) |
Freccia in alto |
Chiama comando/messaggio precedente (in modalità ricerca: cerca in alto) |
Freccia giù |
Chiama comando/messaggio precedente (in modalità ricerca: cerca in basso) |
Ctrl + freccia su |
Chiama il comando/messaggio precedente nella cronologia globale (identico
per tutti i buffer) |
Ctrl + freccia giù |
Chiama il comando/messaggio successivo nella cronologia globale (identico
per tutti i buffer) |
Alt + D |
Elimina la parola successiva nella riga di comando (la stringa eliminata viene
copiata negli appunti) |
Alt + K |
Cattura un tasto ed inserisce il suo codice (e il comando associato se il tasto
esiste) nella riga di comando |
Alt + R |
Elimina l’intera riga di comando |
3.3.2. Tasti per buffer / finestre
| Tasti | Descrizione e comando |
|---|---|
Ctrl + L |
Ridisegna l’intera finestra |
Ctrl + S poi Ctrl + U |
Imposta l’evidenziatore dei messaggi non letti su tutti i buffer |
Ctrl + X |
Passa al buffer attivo se i buffer sono collegati con lo stesso numero |
Pagina su |
Scorre in alto di una pagina nella cronologia del buffer |
Pagina giù |
Scorre di una pagina in basso nella cronologia del buffer |
Alt + Pagina su |
Scorre di qualche riga in alto nella cronologia del buffer |
Alt + Pagina giù |
Scorre di qualche riga in basso nella cronologia del buffer |
Alt + Home |
Scorre in cima al buffer |
Alt + Fine |
Scorre alla fine del del buffer |
Alt + freccia sinistra |
Passa al buffer precedente |
Alt + freccia destra |
Passa al buffer successivo |
F7 |
Passa alla finestra precedente |
F8 |
Passa alla finestra successiva |
F9 |
Scorre il titolo del buffer sulla sinistra |
F10 |
Scorre il titolo del buffer sulla destra |
F11 |
Scorre di una pagina in alto nella lista nick |
F12 |
Scorre di una pagina in basso nella lista nick |
Alt + F11 |
Sposta all’inizio della lista nick |
Alt + F12 |
Sposta alla fine della lista nick |
Alt + A |
Passa al buffer successivo con attività (con priorità: evento, messaggio,
altro) |
Alt + J poi Alt + L |
Passa all’ultimo buffer |
Alt + J poi Alt + R |
Passa al buffer raw IRC |
Alt + J poi Alt + S |
Passa al buffer server IRC |
Alt + num (0-9) |
Passa al buffer numero (0 = 10) |
Alt + J poi numero (01-99) |
Passa al buffer numero |
Alt + N |
Scorre fino all’evento successivo |
Alt + P |
Scorre fino all’evento precedente |
Alt + U |
Scorre fino alla prima riga non letta nel buffer |
Alt + W poi Alt + freccia |
Passa alla finestra con direzione |
Alt + Z |
Ingrandimento sulla finestra attiva (Alt + Z di nuovo: ripristina lo stato iniziale
della finestra, prima dell’ingrandimento) |
Alt + < |
Passa al buffer precedente nella lista dei buffer visitati |
Alt + > |
Passa al buffer successivo nella lista dei buffer visitati |
3.3.3. Altri tasti
| Tasti | Descrizione e comando |
|---|---|
Alt + H |
Pulisce hotlist (notifica di attività su altri buffer) |
Alt + = |
Attiva/disattiva filtri |
3.4. Riga di comando
La riga di comando di WeeChat (nella parte inferiore della finestra) consente di inserire i comandi o di inviare del testo sul buffer.
3.4.1. Sintassi
I comandi iniziano con il carattere "/", seguito dal nome del comando. Ad esempio, per consultare un elenco di opzioni:
/set
Il testo inviato ad un buffer è qualsiasi testo che non comincia con il carattere "/". Per esempio, per inviare il testo ciao sul buffer attivo:
ciao
Ad ogni modo, è possibile iniziare con il carattere "/", aggiungendone poi un altro. Ad esempio, per inviare il testo /set sul buffer attivo:
//set
3.4.2. Colori
Per alcuni plugin come IRC, è possibile usare codici colori ed attributi, come segue (digitare Ctrl-C poi la lettera che segue, con il valore opzionale):
- ^Cb
-
testo in grassetto
- ^Ccxx
-
colore del testo xx (consultare la lista di colori che segue)
- ^Ccxx,yy
-
colore del testo xx e di sfondo yy (consultare la lista di colori che segue)
- ^Co
-
disabilita colori ed attributi
- ^Cr
-
video inverso (inverte il colore del testo con quello di sfondo)
- ^Cu
-
testo sottolineato
|
Note
|
Lo stesso codice (senza numero per ^Cc) può essere usato per terminare l’attributo. |
I codici colore per ^Cc sono:
00 |
bianco |
01 |
nero |
02 |
blu scuro |
03 |
verde scuro |
04 |
rosso chiaro |
05 |
rosso scuro |
06 |
rosa scuro |
07 |
arancione |
08 |
giallo |
09 |
verde chiaro |
10 |
azzurro scuro |
11 |
azzurro chiaro |
12 |
blu chiaro |
13 |
rosa chiaro |
14 |
grigio |
15 |
grigio chiaro (bianco) |
Esempio: visualizza "ciao a tutti!" con "ciao" scritto in blu chiaro grassetto e "a tutti" in rosso chiaro sottolineato:
^Cc12^Cbciao^Cb^Cc04^Cu a tutti^Cu^Cc!
3.5. Opzioni di WeeChat (weechat.conf)
-
weechat.color.bar_more
-
descrizione: colore del testo + allo scorrimento delle barre
-
tipo: colore
-
valori: un nome colore (valore predefinito: lightmagenta)
-
-
weechat.color.chat
-
descrizione: colore del testo per la chat
-
tipo: colore
-
valori: un nome colore (valore predefinito: default)
-
-
weechat.color.chat_bg
-
descrizione: colore di sfondo per la chat
-
tipo: colore
-
valori: un nome colore (valore predefinito: default)
-
-
weechat.color.chat_buffer
-
descrizione: colore del testo per i nomi dei buffer
-
tipo: colore
-
valori: un nome colore (valore predefinito: white)
-
-
weechat.color.chat_channel
-
descrizione: colore del testo per i nomi dei canali
-
tipo: colore
-
valori: un nome colore (valore predefinito: white)
-
-
weechat.color.chat_delimiters
-
descrizione: colore del testo per i delimitatori
-
tipo: colore
-
valori: un nome colore (valore predefinito: green)
-
-
weechat.color.chat_highlight
-
descrizione: colore del testo per il prefisso evidenziato
-
tipo: colore
-
valori: un nome colore (valore predefinito: yellow)
-
-
weechat.color.chat_highlight_bg
-
descrizione: colore di sfondo per il prefisso evidenziato
-
tipo: colore
-
valori: un nome colore (valore predefinito: magenta)
-
-
weechat.color.chat_host
-
descrizione: colore del testo per i nomi host
-
tipo: colore
-
valori: un nome colore (valore predefinito: cyan)
-
-
weechat.color.chat_nick
-
descrizione: colore del testo per i nick nella finestra di chat
-
tipo: colore
-
valori: un nome colore (valore predefinito: lightcyan)
-
-
weechat.color.chat_nick_color01
-
descrizione: colore del testo #1 per il nick
-
tipo: colore
-
valori: un nome colore (valore predefinito: cyan)
-
-
weechat.color.chat_nick_color02
-
descrizione: colore del testo #2 per il nick
-
tipo: colore
-
valori: un nome colore (valore predefinito: magenta)
-
-
weechat.color.chat_nick_color03
-
descrizione: colore del testo #3 per il nick
-
tipo: colore
-
valori: un nome colore (valore predefinito: green)
-
-
weechat.color.chat_nick_color04
-
descrizione: colore del testo #4 per il nick
-
tipo: colore
-
valori: un nome colore (valore predefinito: brown)
-
-
weechat.color.chat_nick_color05
-
descrizione: colore del testo #5 per il nick
-
tipo: colore
-
valori: un nome colore (valore predefinito: lightblue)
-
-
weechat.color.chat_nick_color06
-
descrizione: colore del testo #6 per il nick
-
tipo: colore
-
valori: un nome colore (valore predefinito: default)
-
-
weechat.color.chat_nick_color07
-
descrizione: colore del testo #7 per il nick<
-
tipo: colore
-
valori: un nome colore (valore predefinito: lightcyan)
-
-
weechat.color.chat_nick_color08
-
descrizione: colore del testo #8 per il nick<
-
tipo: colore
-
valori: un nome colore (valore predefinito: lightmagenta)
-
-
weechat.color.chat_nick_color09
-
descrizione: colore del testo #9 per il nick<
-
tipo: colore
-
valori: un nome colore (valore predefinito: lightgreen)
-
-
weechat.color.chat_nick_color10
-
descrizione: colore del testo #10 per il nick<
-
tipo: colore
-
valori: un nome colore (valore predefinito: blue)
-
-
weechat.color.chat_nick_other
-
descrizione: colore del testo per gli altri nick nel buffer privato
-
tipo: colore
-
valori: un nome colore (valore predefinito: cyan)
-
-
weechat.color.chat_nick_self
-
descrizione: colore del testo per il nick locale nella finestra di chat
-
tipo: colore
-
valori: un nome colore (valore predefinito: white)
-
-
weechat.color.chat_prefix_action
-
descrizione: colore del testo per il prefisso di azione
-
tipo: colore
-
valori: un nome colore (valore predefinito: white)
-
-
weechat.color.chat_prefix_buffer
-
descrizione: colore del testo per il nome del buffer (prima del prefisso, quando più buffer sono uniti con lo stesso nome)
-
tipo: colore
-
valori: un nome colore (valore predefinito: brown)
-
-
weechat.color.chat_prefix_error
-
descrizione: colore del testo per il prefisso di errore
-
tipo: colore
-
valori: un nome colore (valore predefinito: yellow)
-
-
weechat.color.chat_prefix_join
-
descrizione: colore del testo per il prefisso di entrata<
-
tipo: colore
-
valori: un nome colore (valore predefinito: lightgreen)
-
-
weechat.color.chat_prefix_more
-
descrizione: colore del testo per + quando il prefisso è troppo lungo
-
tipo: colore
-
valori: un nome colore (valore predefinito: lightmagenta)
-
-
weechat.color.chat_prefix_network
-
descrizione: colore del testo per il prefisso di rete
-
tipo: colore
-
valori: un nome colore (valore predefinito: magenta)
-
-
weechat.color.chat_prefix_quit
-
descrizione: colore del testo per il prefisso di uscita
-
tipo: colore
-
valori: un nome colore (valore predefinito: lightred)
-
-
weechat.color.chat_prefix_suffix
-
descrizione: colore del testo per il suffisso (dopo il prefisso)
-
tipo: colore
-
valori: un nome colore (valore predefinito: green)
-
-
weechat.color.chat_read_marker
-
descrizione: colore del testo per l’evidenziatore di dati non letti
-
tipo: colore
-
valori: un nome colore (valore predefinito: magenta)
-
-
weechat.color.chat_read_marker_bg
-
descrizione: colore di sfondo per l’evidenziatore di dati non letti
-
tipo: colore
-
valori: un nome colore (valore predefinito: default)
-
-
weechat.color.chat_server
-
descrizione: colore del testo per i nomi dei server
-
tipo: colore
-
valori: un nome colore (valore predefinito: brown)
-
-
weechat.color.chat_text_found
-
descrizione: colore del testo per l’evidenziatore sulle righe per il testo trovato
-
tipo: colore
-
valori: un nome colore (valore predefinito: yellow)
-
-
weechat.color.chat_text_found_bg
-
descrizione: colore di sfondo per l’evidenziatore sulle righe per il testo trovato
-
tipo: colore
-
valori: un nome colore (valore predefinito: lightmagenta)
-
-
weechat.color.chat_time
-
descrizione: colore del testo per l’orario nella finestra di chat
-
tipo: colore
-
valori: un nome colore (valore predefinito: default)
-
-
weechat.color.chat_time_delimiters
-
descrizione: colore del testo per i delimitator dell’orario
-
tipo: colore
-
valori: un nome colore (valore predefinito: brown)
-
-
weechat.color.chat_value
-
descrizione: colore del testo per i valori
-
tipo: colore
-
valori: un nome colore (valore predefinito: cyan)
-
-
weechat.color.input_actions
-
descrizione: colore del testo per le azioni sulla riga di input
-
tipo: colore
-
valori: un nome colore (valore predefinito: lightgreen)
-
-
weechat.color.input_text_not_found
-
descrizione: colore del testo per la ricerca del testo fallita sulla riga di input
-
tipo: colore
-
valori: un nome colore (valore predefinito: red)
-
-
weechat.color.nicklist_away
-
descrizione: colore del testo per i nick assenti
-
tipo: colore
-
valori: un nome colore (valore predefinito: cyan)
-
-
weechat.color.nicklist_group
-
descrizione: colore del testo per i gruppi nella lista nick
-
tipo: colore
-
valori: un nome colore (valore predefinito: green)
-
-
weechat.color.nicklist_more
-
descrizione: colore del testo per + allo scorrimento dei nick nella lista nick
-
tipo: colore
-
valori: un nome colore (valore predefinito: lightmagenta)
-
-
weechat.color.nicklist_prefix1
-
descrizione: colore del testo per il prefisso #1 nella nicklist
-
tipo: colore
-
valori: un nome colore (valore predefinito: lightgreen)
-
-
weechat.color.nicklist_prefix2
-
descrizione: colore del testo per il prefisso #2 nella nicklist
-
tipo: colore
-
valori: un nome colore (valore predefinito: lightmagenta)
-
-
weechat.color.nicklist_prefix3
-
descrizione: colore del testo per il prefisso #3 nella nicklist
-
tipo: colore
-
valori: un nome colore (valore predefinito: yellow)
-
-
weechat.color.nicklist_prefix4
-
descrizione: colore del testo per il prefisso #4 nella nicklist
-
tipo: colore
-
valori: un nome colore (valore predefinito: blue)
-
-
weechat.color.nicklist_prefix5
-
descrizione: colore del testo per il prefisso #5 nella nicklist
-
tipo: colore
-
valori: un nome colore (valore predefinito: brown)
-
-
weechat.color.separator
-
descrizione: colore di sfondo per i separatori delle finestre (quando divise)
-
tipo: colore
-
valori: un nome colore (valore predefinito: blue)
-
-
weechat.color.status_data_highlight
-
descrizione: colore del testo per il buffer con evidenziazione (barra di stato)
-
tipo: colore
-
valori: un nome colore (valore predefinito: lightmagenta)
-
-
weechat.color.status_data_msg
-
descrizione: colore del testo per il buffer con nuovi messaggi (barra di stato)
-
tipo: colore
-
valori: un nome colore (valore predefinito: yellow)
-
-
weechat.color.status_data_other
-
descrizione: colore del testo per il buffer con nuovi dati (non messaggi) (barra di stato)
-
tipo: colore
-
valori: un nome colore (valore predefinito: default)
-
-
weechat.color.status_data_private
-
descrizione: colore del testo per il buffer con un messaggio privato (barra di stato)
-
tipo: colore
-
valori: un nome colore (valore predefinito: lightgreen)
-
-
weechat.color.status_filter
-
descrizione: colore del testo per l’indicatore di filtro nella barra di stato
-
tipo: colore
-
valori: un nome colore (valore predefinito: green)
-
-
weechat.color.status_more
-
descrizione: colore del testo per il buffer con nuovi dati (barra di stato)
-
tipo: colore
-
valori: un nome colore (valore predefinito: yellow)
-
-
weechat.color.status_name
-
descrizione: colore del testo per il nome del buffer corrente nella barra di stato
-
tipo: colore
-
valori: un nome colore (valore predefinito: white)
-
-
weechat.color.status_number
-
descrizione: colore del testo per il numero del buffer corrente nella barra di stato
-
tipo: colore
-
valori: un nome colore (valore predefinito: yellow)
-
-
weechat.color.status_time
-
descrizione: colore del testo per l’ora (barra di stato)
-
tipo: colore
-
valori: un nome colore (valore predefinito: default)
-
-
weechat.completion.default_template
-
descrizione: modello di completamento predefinito (consulta la documentazione per codici e valori del template)
-
tipo: stringa
-
valori: qualsiasi stringa (valore predefinito: "%(nicks)|%(irc_channels)")
-
-
weechat.completion.nick_add_space
-
descrizione: aggiungi uno spazio al completamento del nick (quando non è la prima parola sulla riga di comando)
-
tipo: bool
-
valori: on, off (valore predefinito: on)
-
-
weechat.completion.nick_completer
-
descrizione: stringa inserita dopo il completamento del nick
-
tipo: stringa
-
valori: qualsiasi stringa (valore predefinito: ":")
-
-
weechat.completion.nick_first_only
-
descrizione: completa solo con il primo nick trovato
-
tipo: bool
-
valori: on, off (valore predefinito: off)
-
-
weechat.completion.nick_ignore_chars
-
descrizione: caratteri ignorati per il completamento dei nick
-
tipo: stringa
-
valori: qualsiasi stringa (valore predefinito: "[]-^")
-
-
weechat.completion.partial_completion_alert
-
descrizione: avvisa l’utente quando si verifica un completamento parziale
-
tipo: bool
-
valori: on, off (valore predefinito: on)
-
-
weechat.completion.partial_completion_command
-
descrizione: completa parzialmente i nomi dei comandi (arresta quando vengono trovati più comandi con le stesse lettere)
-
tipo: bool
-
valori: on, off (valore predefinito: off)
-
-
weechat.completion.partial_completion_command_arg
-
descrizione: completa parzialmente gli argomenti dei comandi (arresta quando vengono trovati più argomenti con lo stesso prefisso)
-
tipo: bool
-
valori: on, off (valore predefinito: off)
-
-
weechat.completion.partial_completion_count
-
descrizione: visualizza contatore per ogni completamento parziale nella barra degli oggetti
-
tipo: bool
-
valori: on, off (valore predefinito: on)
-
-
weechat.completion.partial_completion_other
-
descrizione: completa parzialmente comandi esterni (arresta quando vengono trovate più parole che iniziano con le stesse lettere)
-
tipo: bool
-
valori: on, off (valore predefinito: off)
-
-
weechat.history.display_default
-
descrizione: numero massimo predefinito di comandi da visualizzare nella cronologia (0 = nessun limite)
-
tipo: intero
-
valori: 0 .. 2147483647 (valore predefinito: 5)
-
-
weechat.history.max_commands
-
descrizione: numero massimo di comandi utente nella cronologia (0 = nessun limite)
-
tipo: intero
-
valori: 0 .. 2147483647 (valore predefinito: 100)
-
-
weechat.history.max_lines
-
descrizione: numero massimo di righe nella cronologia per buffer (0 = nessun limite)
-
tipo: intero
-
valori: 0 .. 2147483647 (valore predefinito: 4096)
-
-
weechat.history.max_visited_buffers
-
descrizione: numero massimo di buffer visitati da memorizzare
-
tipo: intero
-
valori: 0 .. 1000 (valore predefinito: 50)
-
-
weechat.look.buffer_notify_default
-
descrizione: livello predefinito di notifica per i buffer (utilizzato per comunicare a WeeChat se il buffer deve essere visualizzato nella hotlist oppure no, a seconda dell’importanza del messaggio)
-
tipo: intero
-
valori: none, highlight, message, all (valore predefinito: all)
-
-
weechat.look.buffer_time_format
-
descrizione: formato dell’ora per i buffer
-
tipo: stringa
-
valori: qualsiasi stringa (valore predefinito: "%H:%M:%S")
-
-
weechat.look.color_nicks_number
-
descrizione: numero di colori da utilizzare per i colori dei nick
-
tipo: intero
-
valori: 1 .. 10 (valore predefinito: 10)
-
-
weechat.look.color_real_white
-
descrizione: se impostato, utilizza il colore bianco reale, disabilitato sui terminali con lo sfondo bianco (se non utilizzato, l’opzione dovrebbe essere attivata per visualizzare il bianco reale invece del colore di primo piano predefinito del terminale)
-
tipo: bool
-
valori: on, off (valore predefinito: off)
-
-
weechat.look.day_change
-
descrizione: mostra un messaggio speciale al cambio di data
-
tipo: bool
-
valori: on, off (valore predefinito: on)
-
-
weechat.look.day_change_time_format
-
descrizione: formato dell’ora visualizzato al cambio di data
-
tipo: stringa
-
valori: qualsiasi stringa (valore predefinito: "%a, %d %b %Y")
-
-
weechat.look.highlight
-
descrizione: elenco separato da virgole di finestre da evidenziare (maiuscole/minuscole, le parole potrebbero cominciare o terminare con "*" per un riscontro parziale)
-
tipo: stringa
-
valori: qualsiasi stringa (valore predefinito: "")
-
-
weechat.look.hline_char
-
descrizione: carattere utilizzato per disegnare le righe orizzontali; notare che un valore vuoto disegnerà una vera riga con ncurses, ma può causare errori con la selezione dell’URL in alcuni terminali
-
tipo: stringa
-
valori: qualsiasi stringa (valore predefinito: "-")
-
-
weechat.look.hotlist_names_count
-
descrizione: numero massimo di nomi nella hotlist (0 = nessun nome visualizzato, solo numeri dei buffer)
-
tipo: intero
-
valori: 0 .. 32 (valore predefinito: 3)
-
-
weechat.look.hotlist_names_length
-
descrizione: lunghezza massima dei nomi nella hotlist (0 = nessun limite)
-
tipo: intero
-
valori: 0 .. 32 (valore predefinito: 0)
-
-
weechat.look.hotlist_names_level
-
descrizione: livello per la visualizzazione dei nomi nella hotlist (combinazione di: 1=entrata/uscita, 2=messaggio, 4=privato, 8=evidenziato, per esempio: 12=privato+evidenziato)
-
tipo: intero
-
valori: 1 .. 15 (valore predefinito: 12)
-
-
weechat.look.hotlist_names_merged_buffers
-
descrizione: se impostato, forza la visualizzazione dei nomi nella hotlist per i buffer uniti
-
tipo: bool
-
valori: on, off (valore predefinito: off)
-
-
weechat.look.hotlist_short_names
-
descrizione: se impostato, usa i nomi brevi per visualizzare i nomi dei buffer nella hotlist (inizia dopo il primo . nel nome)
-
tipo: bool
-
valori: on, off (valore predefinito: on)
-
-
weechat.look.hotlist_sort
-
descrizione: tipo di ordinamento della hotlist (group_time_asc (predefinito), group_time_desc, group_number_asc, group_number_desc, number_asc, number_desc)
-
tipo: intero
-
valori: group_time_asc, group_time_desc, group_number_asc, group_number_desc, number_asc, number_desc (valore predefinito: group_time_asc)
-
-
weechat.look.item_time_format
-
descrizione: formato dell’ora per l’elemento della barra "tempo"
-
tipo: stringa
-
valori: qualsiasi stringa (valore predefinito: "%H:%M")
-
-
weechat.look.jump_current_to_previous_buffer
-
descrizione: passa al buffer visualizzato in precedenza al passaggio del numero di buffer corrente con /buffer *N (dove N è un numero di buffer), per passare facilmente ad un altro buffer, e poi tornare a quello attuale
-
tipo: bool
-
valori: on, off (valore predefinito: on)
-
-
weechat.look.jump_previous_buffer_when_closing
-
descrizione: passa al buffer visitato in precedenza alla chiusura di un buffer (se disabilitato, allora passa al buffer numero -1)
-
tipo: bool
-
valori: on, off (valore predefinito: on)
-
-
weechat.look.nickmode
-
descrizione: mostra modalità nick ((half)op/voice) prima di ogni nick
-
tipo: bool
-
valori: on, off (valore predefinito: on)
-
-
weechat.look.nickmode_empty
-
descrizione: mostra spazio se il nick non è in modalità (half)op/voice
-
tipo: bool
-
valori: on, off (valore predefinito: off)
-
-
weechat.look.paste_max_lines
-
descrizione: numero massimo di righe da incollare senza conferma dell’utente (0 = disabilita questa caratteristica)
-
tipo: intero
-
valori: 0 .. 2147483647 (valore predefinito: 3)
-
-
weechat.look.prefix_action
-
descrizione: prefisso per i messaggi di azione
-
tipo: stringa
-
valori: qualsiasi stringa (valore predefinito: " *")
-
-
weechat.look.prefix_align
-
descrizione: allineamento prefisso (none, left, right (predefinito))
-
tipo: intero
-
valori: none, left, right (valore predefinito: right)
-
-
weechat.look.prefix_align_max
-
descrizione: dimensione massima prefisso (0 = nessuna dimensione massima)
-
tipo: intero
-
valori: 0 .. 128 (valore predefinito: 0)
-
-
weechat.look.prefix_align_more
-
descrizione: mostra + se il prefisso è troncato
-
tipo: bool
-
valori: on, off (valore predefinito: on)
-
-
weechat.look.prefix_buffer_align
-
descrizione: prefisso di allineamento per il nome del buffer, quando più buffer vengono uniti con lo stesso numero (none (nessuno), left(sinistra), right(destra - predefinito)
-
tipo: intero
-
valori: none, left, right (valore predefinito: right)
-
-
weechat.look.prefix_buffer_align_max
-
descrizione: allineamento del prefisso per nome buffer, quando più buffer sono uniti con lo stesso numero (0 = nessuna dimensione massima)
-
tipo: intero
-
valori: 0 .. 128 (valore predefinito: 0)
-
-
weechat.look.prefix_buffer_align_more
-
descrizione: visualizza + se il nome del buffer è troncato (quando più buffer sono uniti con lo stesso numero)
-
tipo: bool
-
valori: on, off (valore predefinito: on)
-
-
weechat.look.prefix_error
-
descrizione: prefisso per i messaggi di errore
-
tipo: stringa
-
valori: qualsiasi stringa (valore predefinito: "=!=")
-
-
weechat.look.prefix_join
-
descrizione: prefisso per i messaggi di entrata
-
tipo: stringa
-
valori: qualsiasi stringa (valore predefinito: "-→")
-
-
weechat.look.prefix_network
-
descrizione: prefisso per i messaggi di rete
-
tipo: stringa
-
valori: qualsiasi stringa (valore predefinito: "--")
-
-
weechat.look.prefix_quit
-
descrizione: prefisso per i messaggi di uscita
-
tipo: stringa
-
valori: qualsiasi stringa (valore predefinito: "←-")
-
-
weechat.look.prefix_suffix
-
descrizione: stringa visualizzata dopo il prefisso
-
tipo: stringa
-
valori: qualsiasi stringa (valore predefinito: "|")
-
-
weechat.look.read_marker
-
descrizione: usa un evidenziatore (riga o carattere) sui buffer per mostrare la prima riga non letta
-
tipo: intero
-
valori: none, line, dotted-line, char (valore predefinito: dotted-line)
-
-
weechat.look.save_config_on_exit
-
descrizione: salva file di configurazione all’uscita
-
tipo: bool
-
valori: on, off (valore predefinito: on)
-
-
weechat.look.save_layout_on_exit
-
descrizione: salva layout all’uscita (buffer, finestre, o entrambi)
-
tipo: intero
-
valori: none, buffers, windows, all (valore predefinito: none)
-
-
weechat.look.scroll_amount
-
descrizione: le righe da scorrere con scroll_up e scroll_down
-
tipo: intero
-
valori: 1 .. 2147483647 (valore predefinito: 3)
-
-
weechat.look.scroll_page_percent
-
descrizione: percentuale della schermata da scorrere in alto o in basso (per esempio 100 indica una pagina intera, 50 metà)
-
tipo: intero
-
valori: 1 .. 100 (valore predefinito: 100)
-
-
weechat.look.search_text_not_found_alert
-
descrizione: avvisa l’utente quando il testo cercato non viene trovato nel buffer
-
tipo: bool
-
valori: on, off (valore predefinito: on)
-
-
weechat.look.set_title
-
descrizione: imposta titolo per la finestra (terminale per interfacce Curses) con nome e versione
-
tipo: bool
-
valori: on, off (valore predefinito: on)
-
-
weechat.network.gnutls_ca_file
-
descrizione: file contenente le autorità dei certificati
-
tipo: stringa
-
valori: qualsiasi stringa (valore predefinito: "%h/ssl/CAs.pem")
-
-
weechat.plugin.autoload
-
descrizione: elenco separato da virgole di plugin da caricare automaticamente all’avvio, "*" per tutti i plugin trovati (nomi possono essere parziali, per esempio "perl" va bene per "perl.so")
-
tipo: stringa
-
valori: qualsiasi stringa (valore predefinito: "*")
-
-
weechat.plugin.debug
-
descrizione: abilita come predefinito il debug per tutti i plugin (opzione disabilita di predefinito, caldamente raccomandato)
-
tipo: bool
-
valori: on, off (valore predefinito: off)
-
-
weechat.plugin.extension
-
descrizione: estensione standard dei plugin nei nomi file (per esempio ".so" sotto Linux oppure ".dll" sotto Microsoft Windows)
-
tipo: stringa
-
valori: qualsiasi stringa (valore predefinito: ".so")
-
-
weechat.plugin.path
-
descrizione: percorso per la ricerca dei plugin ("%h" sarà sostituito dalla home di WeeChat, "~/.weechat come predefinita)
-
tipo: stringa
-
valori: qualsiasi stringa (valore predefinito: "%h/plugins")
-
-
weechat.plugin.save_config_on_unload
-
descrizione: salva i file di configurazione alla disattivazione dei plugin
-
tipo: bool
-
valori: on, off (valore predefinito: on)
-
-
weechat.startup.command_after_plugins
-
descrizione: comando eseguito all’avvio di WeeChat, dopo il caricamento dei plugin
-
tipo: stringa
-
valori: qualsiasi stringa (valore predefinito: "")
-
-
weechat.startup.command_before_plugins
-
descrizione: comando eseguito all’avvio di WeeChat, prima del caricamento dei plugin
-
tipo: stringa
-
valori: qualsiasi stringa (valore predefinito: "")
-
-
weechat.startup.display_logo
-
descrizione: visualizza il logo di WeeChat all’avvio
-
tipo: bool
-
valori: on, off (valore predefinito: on)
-
-
weechat.startup.display_version
-
descrizione: visualizza la versione di WeeChat all’avvio
-
tipo: bool
-
valori: on, off (valore predefinito: on)
-
-
weechat.startup.weechat_slogan
-
descrizione: Slogan WeeChat (se è vuoto, non viene utilizzato)
-
tipo: stringa
-
valori: qualsiasi stringa (valore predefinito: "le client de discussion le plus geek !")
-
I colori per l’interfaccia Curses sono:
default |
colore predefinito del terminale (trasparente per lo sfondo) |
black |
nero |
darkgray |
grigio scuro |
red |
rosso scuro |
lightred |
rosso chiaro |
green |
verde scuro |
lightgreen |
verde chiaro |
brown |
marrone |
yellow |
giallo |
blue |
blu scuro |
lightblue |
blu chiaro |
magenta |
rosa scuro |
lightmagenta |
rosa chiaro |
cyan |
azzurro scuro |
lightcyan |
azzurro chiaro |
white |
bianco |
3.6. Comandi di WeeChat
- • /bar [add nome_barra tipo[,cond1,cond2,...] posizione dimensione separatore elemento1,elemento2,...] | [default] | [del nome_barra|-all] | [set nome_barra opzione valore] | [hide|show|toggle nome_barra] | [scroll nome_barra buffer scroll_value] | [list] | [listfull] | [listitems]
gestione barre
add: aggiungi una nuova barra
nome_barra: nome della barra (deve essere unico)
tipo: root: fuori dalle finestre,
window: all'interno delle finestre, con opzioni condizionali (a seguire)
cond1,...: condizione(i) per la visualizzazione della barra (solo per quelle di tipo "window"):
active: sulla finestra attiva
inactive: sulle finestre inattive
nicklist: sulle finestre con le liste nick
senza condizioni, la barra viene sempre visualizzata
posizione: bottom (basso), top (alto), left (sinistra) or right (destra)
dimensione: dimensione della barra (in caratteri)
separatore: 1 per utilizzare un separatore (riga), 0 o nessun valore corrisponde a nessun separatore
elemento1,...: elementi per questa barra (possono essere separati da virgole (spazio tra gli elementi) or "+" (elementi incollati))
default: crea barre predefinite
del: elimina una barra (o tutte le barre con -all)
set: imposta un valore per una proprietà della barra
opzione: opzione da modificare (per un elenco di opzioni, consultare /set weechat.bar.<nome_barra>.*)
valore: nuovo valore per l'opzione
hide: nasconde una barra
show: mostra una barra nascosta
toggle: nasconde/mostra una barra
scroll: scorre la barra in alto/basso
buffer: nome del buffer da scorrere ('*' sta per buffer corrente, è consigliato utilizzare '*' per le barre root)
scroll_value: valore per lo scorrimento: 'x' o 'y', seguito da '+', '-', 'b' (inizio) o 'e' (fine), valore (per +/-), e un opzionale %% (per scorrere di %% di larghezza/altezza, altrimenti il valore è un numero di caratteri)
list: elenca tutte le barre
listfull: elenca tutte le barre (dettagliato)
listitems: elenca tutti gli elementi barra
Esempi:
crea una barra con l'ora, il numero del buffer + nome, e completamento:
/bar add miabarra root bottom 1 0 [time],buffer_number+:+buffer_name,completion
nasconde una barra:
/bar hide mibarra
scorre lista nick di 10 linee in basso sul buffer corrente:
/bar scroll nicklist * y+10
scorre la lista nick una pagina in su sul buffer #weechat:
/bar scroll nicklist #weechat y-100%
scorre fino alla fine della lista nick sul buffer corrente:
/bar scroll nicklist * ye
- • /buffer [clear [numero | -merged | -all] | move numero | merge numero | unmerge [numero] | close [n1[-n2]] | list | notify livello | localvar | set proprietà valore | numero | nome]
gestione buffer
clear: pulisce il contenuto del buffero (numero per un buffer, -merged per i buffer uniti, -all per tutti i buffer, o nulla per quello corrente)
move: sposta buffer nella lista (può essere relativo, ad esempio -1)
merge: unisce il buffer corrente ad un altro (l'area di chat sarà un mix di entrambi)
(con ctrl-x alterna i buffer uniti)
unmerge: stacca il buffer da quelli con lo stesso numero
close: chiudi buffer (numero/range opzionale)
list: elenca i buffer (nessun parametro implica questa lista)
notify: imposta il livello di notifica per il buffer corrente: questo livello determina se il buffer verrà aggiunto alla hotlist oppure no:
none: mai
highlight: solo per le evidenziazioni
message: per i messaggi da tutti gli utenti + evidenziazioni
all: tutti i messaggi
reset: ripristina il valore predefinito (all (tutti attivi))
localvar: visualizza la variabile locale per il buffer corrente
set: imposta una proprietà per il buffer corrente
number: passa al buffer di numero in numero:
'+': passo relativo, aggiunge il numero a quello corrente
'-': passo relativo, sottrae il numero a quello corrente
'*': passa al numero, utilizzando l'opzione "weechat.look.jump_current_to_previous_buffer"
nome: passa al buffer di nome (parziale)
Esempi:
pulisci buffer corrente: /buffer clear
pulisci tutti i buffer: /buffer clear -all
sposta buffer: /buffer move 5
unisci al buffer core: /buffer merge 1
stacca buffer: /buffer unmerge
chiudi buffer corrente: /buffer close
chiudi buffer da 5 a 7: /buffer close 5-7
passa a #weechat: /buffer #weechat
passa al buffer successivo: /buffer +1
- • /command plugin comando
esegui comando o plugin di WeeChat esplicito
plugin: nome plugin ('weechat' per il comando interno di WeeChat)
comando: comando da eseguire (una '/' viene aggiunta automaticamente se non trovata all'inizio del comando)
- • /debug [list | set plugin livello | dump | buffer | windows | term]
attiva debug per core/plugin
set: imposta il livello di log per il plugin
plugin: nome del plugin ("core" per il core di WeeChat)
livello: livello di debug per il plugin (0 = disabilita debug)
dump: salva il dump della memoria nel file di log di Weechat (lo stesso dump viene salvato quando WeeChat va in crash)
buffer: esegue il dump del contenuto con valori esadecimali nel file di log
windows: visualizza l'albero delle finestre
term: visualizza informazioni sul terminale e i colori disponibili
- • /filter [list] | [enable|disable|toggle [nome]] | [add nome plugin.buffer tag regex] | [del nome|-all]
filtra messaggi nei buffer, per nascondere/mostrare in base a tag o regexp
list: elenca tutti i filtri
enable: abilita filtri (i filtri sono abilitati di default)
disable: disabilita filtri
toggle: abilita/disabilita filtri
nome: nome del filtro
add: aggiungi un filtro
del: elimina un filtro
-all: elimina tutti i filtri
plugin.buffer: plugin e buffer in cui il filtro è attivo ("*" per tutti i buffer)
tag: elenco di tag separati da virgole, per esempio: "irc_join,irc_part,irc_quit"
regex: espressione regolare da cercare nella riga (utilizzare \t per separare il prefisso dal messaggio, caratteri speciali come "|" devono essere preceduti dal carattere escape: '\|')
Il tasto predefinito alt+'=' abilita/disabilita il filtraggio.
Esempi:
usa il filtro intelligente IRC per i messaggi di entrata/uscita/abbandono:
/filter add irc_smart * irc_smart_filter *
filtra tutti i messaggi entrata/uscita/abbandono di IRC:
/filter add joinquit * irc_join,irc_part,irc_quit *
filtra il nick "tizio" sul canale IRC #weechat
/filter add tizio irc.freenode.#esempio * tizio\t
filtra le righe contententi la parola "spam":
/filter add filterspam ** spam
filtra le righe contententi "weechat fa schifo" sul canale irc #weechat:
/filter add schifo irc.freenode.#weechat * weechat fa schifo
- • /help [comando | opzione]
visualizza l'aiuto su comandi e opzioni comando: nome comando opzione: nome opzione (utilizza /set per vedere l'elenco)
- • /history [clear | valore]
mostra la cronologia dei comandi del buffer clear: pulisci cronologia valore: numero delle voci nella cronologia da mostrare
- • /input return | complete_next | complete_previous | search_next | delete_previous_char | delete_next_char | delete_previous_word | delete_next_word | delete_beginning_of_line | delete_end_of_line | delete_line | clipboard_paste | transpose_chars | move_beginning_of_line | move_end_of_line | move_previous_char | move_next_char | move_previous_word | move_next_word | history_previous | history_next | history_global_previous | history_global_next | jump_smart | jump_last_buffer | jump_previously_visited_buffer | jump_next_visited_buffer | hotlist_clear | grab_key | grab_key_command | scroll_unread | set_unread | set_unread_current_buffer | insert [args]
funzioni per la riga di comando Questo comando è utilizzato da combinazioni di tasti o plugin.
- • /key [bind tasto [comando [argomenti]]] | [unbind tasto] | [reset -yes] | [missing]
associa/disassocia tasti
bind: associa un comando ad un tasto o visualizza il comando associato al tasto
unbind: elimina l'associazione di un tasto
reset: ripristina le associazioni ai valori predefiniti ed elimina TUTTE le associazioni personalizzate (attenzione!)
missing: aggiunge i tasti mancanti (utilizzando le associazioni predefinite)
Quando viene associato un comando ad una chiave, è consigliato utilizzare il tasto alt+k (oppure Esc e k), e poi premere il tasto da associare: il codice tasto verrà inserito nella riga di comando.
- • /layout [[save | apply | reset] [buffers | windows]]
salva/applica/resetta il layout per i buffer e le finestre
save: salva il layout corrente
apply: applica il layout salvato
reset: elimina il layout salvato
buffers: salva/applica modifiche solo ai buffer (ordine dei buffer)
windows: salva/applica modifiche solo alle finestre (buffer visualizzato da ogni finestra)
Senza argomenti, il comando visualizza il layout salvato.
- • /plugin [list [nome]] | [listfull [nome]] | [load file] | [autoload] | [reload [nome]] | [unload [nome]]
elenca/attiva/disattiva plugin
list: elenca i plugin attivi
listfull: elenca i plugin attivi (dettagliato)
load: carica un plugin
autoload: attiva automaticamente i plugin nella cartella utente o di sistema
reload: riattiva un plugin (se non specificato, disattiva i plugin e liriattiva automaticamente)
unload: disattiva uno o tutti i plugin
Senza argomenti, questo comando elenca i plugin attivati.
- • /proxy [add nome_proxy tipo indirizzo porta [nome [password]]] | [del nome_proxy|-all] | [set nome_proxy opzione valore] | [list]
gestione proxy
add: aggiungi un nuovo proxy
nome_proxy: nome del proxy (deve essere unico)
tipo: http, socks4 o socks5
indirizzo: IP o nome host
port: porta
utente: nome utente (opzionale)
password: password (opzionale)
del: elimina un proxy (o tutti i proxy con -all)
set: imposta un valore per una proprietà del proxy
opzione: opzione da modificare (per un elenco di opzioni, consultare /set weechat.proxy.<nome_proxy>.*)
valore: nuovo valore per l'opzione
list: elenca tutti i proxy
Esempi:
crea un proxy http, in esecuzione su host locale, porta 8888:
/proxy add locale http 127.0.0.1 8888
crea un proxy http utilizzando il protocollo IPv6:
/proxy add locale http 127.0.0.1 8888
/proxy set locale ipv6 on
crea un proxy socks5 con utente/password:
/proxy add mioproxy socks5 esempio.host.org 3128 mioutente miapassword
elimina un proxy:
/proxy del mioproxy
- • /quit [argomenti]
esci da WeeChat
argomenti: testo inviato con il segnale "quit"
(ad esempio il plugin irc usa questo testo per inviare il messaggio di uscita al server)
- • /reload [file [file....]]
ricarica i file di configurazione da disco file: file di configurazione da ricaricare Senza argomento, tutti i file (WeeChat e plugin) vengono ricaricati.
- • /save [file [file....]]
salva i file di configurazione su disco file: file di configurazione da salvare Senza argomento, tutti i file (WeeChat e plugin) verranno salvati.
- • /set [opzione [valore]]
imposta le opzioni di configurazione
opzione: nome dell'opzione
valore: nuovo valore per l'opzione
Il nuovo valore può essere, in base al tipo di variabile:
bool: on, off oppure alterna
intero: numero, ++numero o --numero
stringa: qualsiasi stringa ("" per le stringhe vuote)
colore: nome colore, ++numero o --numero
Per tutti i tipi, è possibile utilizzare un valore nullo per eliminare il valore dell'opzione (non definito). Funziona solo per alcune variabili speciali dei plugin.
- • /unset [opzione]
annulla/resetta opzione opzione: nome di un'opzione (può cominciare o finire con "*" per il reset di più opzioni, attenzione!) A seconda dell'opzione, viene resettata (per le opzioni standard) o rimossa (per le impostazioni opzionali, come i valori del server)
- • /upgrade [percorso_del_binario]
aggiorna WeeChat senza disconnettere dai server percorso_del_binario: percorso del binario di WeeChat (quello corrente è il predefinito) Questo comando esegue nuovamente un binario WeeChat, perciò deve essere stato compilato o installato con un gestore di pacchetti prima di eseguire questo comando.
- • /uptime [-o]
mostra l'uptime di WeeChat -o: invia l'uptime al buffer corrente come input
- • /version [-o]
mostra la versione e la data di compilazione di WeeChat -o: invia versione al buffer corrente come input
- • /wait numero[unità] comando
pianifica l'esecuzione di un comando
numero: tempo di attesa (numero intero)
unità: valori opzionali sono:
ms: millisecondi
s: secondi (predefinito)
m: minuti
h: ore
comando: comando da eseguire (o testo da inviare al buffer se il comando non inizia con '/')
Nota: il comando è eseguito sui buffer dove /wait è stato eseguito (se il buffer non viene trovato (per esempio se è stato chiuso prima dell'esecuzione), allora il comando verrà eseguito sul buffer core di WeeChat)
Esempi:
entra nel canale tra 10 secondi: /wait 10 /join #test
imposta assenza in 15 minuti: /wait 15m /away -all Sono via
dì ciao in 2 minuti: /wait 2m ciao
- • /window [list | -1 | +1 | b# | up | down | left | right | splith [pct] | splitv [pct] | resize pct | merge [all] | page_up | page_down | refresh | scroll | scroll_up | scroll_down | scroll_top | scroll_bottom | scroll_previous_highlight | scroll_next_highlight | zoom]
gestione finestre
list: elenca le finestre aperte (nessun parametro implica questa lista)
-1: salta alla finestra precedente
+1: salta alla finestra successiva
b#: salta alla finestra successiva che visualizza il buffer numero #
up: passa alla finestra superiore a quella corrente
down: passa alla finestra inferiore a quella attiva
left: passa alla finestra a sinistra
right: passa alla finestra a destra
splith: divide la finestra attiva orizzontalmente
splitv: divide la finestra attiva verticalmente
resize: ridimensiona finestra, la nuova dimensione è <pct> percentuale della finestra genitore
merge: unisce la finestra con un'altra (all = mantiente una sola finestra)
page_up: scorre di una pagina in alto
page_down: scorre di una pagina in basso
refresh: aggiorna lo schermo
scroll: scorre di un numero di righe (+/-N) o in base al tempo: s=secondi, m=minuti, h=ore, d=giorni, M=mesi, y=anni
scroll_up: scorre di alcune righe in alto
scroll_down: scorre di alcune righe in basso
scroll_top: scorre fino all'inizio del buffer
scroll_bottom: scorre fino alla fine del buffer buffer
scroll_previous_highlight: passa all'evidenziazione precedente
scroll_next_highlight: passa all'evidenziazione successiva
zoom: ingrandimento sulla finestra
Per splith e splitv, pct è una percentuale che rappresenta la dimensione della nuova finestra, calcolata con la finestra attiva come riferimento per la dimensione. Per esempio 25 vuol dire creare una finestra di dimensione = dimensione_attuale / 4
Esempi:
salta alla finestra che visualizza il buffer #1: /window b1
scorre di due righe in alto: /window scroll -2
scorre all'indietro di due giorni: /window scroll -2d
scorre all'inizio del giorno attuale: /window scroll -d
4. Plugin
Per saperne di più riguardo lo sviluppo di plugin o script (tramite le API), per favore consultare Riferimento API dei Plugin per WeeChat oppure Guida allo Scripting di WeeChat.
4.1. Plugin in WeeChat
Un plugin è una libreria dinamica, scritta in C e compilata, che viene caricata da WeeChat. In GNU/Linux, il file ha estensione ".so", ".dll" in Windows.
I plugin trovati vengono caricati automaticamente all’avvio di WeeChat, ed è possibile attivare o disattivare i plugin durante l’esecuzione del programma.
È importante evidenziare la differenza tra un plugin ed uno script: un plugin è un file binario compilato e caricato con il comando /plugin, mentre uno script è un file di testo caricato con un plugin come perl con il comando /perl.
È possibile utilizzare il comando /plugin per attivare/disattivare un plugin, oppure elencare tutti i plugin attivi. Quando un plugin viene disattivato, tutti i buffer creati da questo plugin sono chiusi automaticamente.
Esempi per attivare, disattivare oppure elencare i plugin:
/plugin load irc /plugin unload irc /plugin list
I plugin predefiniti sono:
| Plugin | Descrizione |
|---|---|
alias |
Definisce gli alias per i comandi |
aspell |
Controllo ortografico per la riga di comando |
charset |
Set di caratteri per la codifica/decodifica nei buffer |
demo |
Plugin Demo (non viene compilato per default) |
fifo |
pipe FIFO utilizzata per inviare comandi da remoto su WeeChat |
irc |
protocollo chat per IRC |
logger |
Registra i buffer su file |
perl |
API per lo scripting in Perl |
python |
API per lo scripting in Python |
ruby |
API per lo scripting in Ruby |
lua |
API per lo scripting in Lua |
tcl |
API per lo scripting in TCL |
xfer |
Trasferimento file e chat diretta |
4.2. Plugin Alias
Il plugin Alias consente di creare alias per i comandi (da WeeChat o altri plugin).
4.2.1. Comandi
- • /alias [nome_alias [comando [argomenti]]]
crea un alias per un comando
nome_alias: nome di un alias (può iniziare o terminare con "*" per un elenco di alias)
comando: nome comando (più comandi possono essere separati da punto e virgola)
argomenti: argomenti per un comando
Senza argomanto, questo comando elenca tutti gli alias definiti.
Nota: nel comando, le variabii speciali vengono sostituite:
$n: argomento 'n' (tra 1 e 9)
$-m: argomenti da 1 a 'm'
$n-: argomenti da 'n' alla fine
$n-m: argomenti da 'n' a 'm'
$*: tutti gli argomenti
$~: ultimo argomento
$nick: nick corrente
$channel: canale corrente
$server: server corrente
4.3. Plugin Aspell
Il plugin Aspell consente di verificare l’ortografia nella riga di comando. È possibile utilizzare più lingue per buffer.
4.3.1. Opzioni (aspell.conf)
-
aspell.check.commands
-
descrizione: elenco separato da virgole di comandi per cui il controllo ortografico è abilitato (il controllo ortografico è disabilitato per tutti gli altri comandi)
-
tipo: stringa
-
valori: qualsiasi stringa (valore predefinito: "ame,amsg,away,command,cycle,kick,kickban,me,msg,notice,part,query,quit,topic")
-
-
aspell.check.default_dict
-
descrizione: dizionario predefinito (o elenco separato da virgole di dizionari) da utilizzare quando il buffer non ha alcun dizionario definito (vuoto per disabilitare il controllo ortografico sui buffer in cui non è stato esplicitamente abilitato)
-
tipo: stringa
-
valori: qualsiasi stringa (valore predefinito: "")
-
-
aspell.check.during_search
-
descrizione: controlla le parole durante la ricerca del testo nel buffer
-
tipo: bool
-
valori: on, off (valore predefinito: off)
-
-
aspell.check.real_time
-
descrizione: controllo ortografico in tempo reale (più lento, disabilitato per default: le parole vengono controllate solo se seguite da un delimitatore)
-
tipo: bool
-
valori: on, off (valore predefinito: off)
-
-
aspell.check.word_min_length
-
descrizione: lunghezza minima per una parola da controllare (0 per controllarle tutte)
-
tipo: intero
-
valori: 0 .. 2147483647 (valore predefinito: 2)
-
-
aspell.look.color
-
descrizione: colore utilizzato per le parole non corrette
-
tipo: colore
-
valori: un nome colore (valore predefinito: lightred)
-
4.3.2. Comandi
- • /aspell dictlist | enable lingua | disable | addword [lingua] parola
configurazione del plugin aspell
dictlist: mostra i dizionari installati
enable: abilita aspell sul buffer corrente
disable: disabilita aspell sul buffer corrente
addword: aggiunge una parola nel dizionario personale aspell
La riga di input che comincia con '/' non viene controllata, tranne che per alcuni comandi.
4.4. Plugin Charset
Il plugin Charset consente di decodificare o codificare dati utilizzando i set caratteri.
Esiste un set caratteri predefinito per la codifica/decodifica, e set caratteri specifici per i buffer (o gruppi di buffer).
Questo plugin è opzionale, ma raccomandato: se non attivato, WeeChat può leggere/scrivere soltanto dati UTF-8.
Il plugin Charset dovrebbe essere caricato automaticamente da WeeChat. Per essere sicuri che sia caricato, provare con:
/charset
Se non trovato, allora si deve caricare il plugin con il comando:
/plugin load charset
Se il plugin non viene trovato, allora è necessario ricompilare WeeChat con il supporto ai plugin e a Charset.
Quando viene avviato il plugin Charset, mostra i set caratteri del terminale e quello interno. Il set caratteri dipende dal proprio locale, mentre quello interno è UTF-8.
Per esempio:
set caratteri: terminale: ISO-8859-15, interno: UTF-8
4.4.1. Opzioni (charset.conf)
-
charset.default.decode
-
descrizione: set di caratteri per la decodifica globale
-
tipo: stringa
-
valori: qualsiasi stringa (valore predefinito: "iso-8859-1")
-
-
charset.default.encode
-
descrizione: set di caratter per la codifica globale
-
tipo: stringa
-
valori: qualsiasi stringa (valore predefinito: "")
-
4.4.2. Comandi
- • /charset [[decode | encode | set_caratteri:] | [reset]
modifica il set di caratteri per il buffer corrente
decode: modifica il set di caratteri per la decodifica
encode: modifica il set di caratteri per la codifica
set_caratteri: nuovo set di caratteri per il buffer corrente
reset: resetta il set di caratteri per il buffer corrente
4.4.3. Impostare il set caratteri
Per impostare il set caratteri globale per la codifica e la decodifica, utilizzare il comando /set.
Per esempio:
/set charset.default.decode ISO-8859-15 /set charset.default.encode ISO-8859-15
Se il set caratteri globale per la decodifica non è impostato (ad esempio durante il primo caricamento del plugin Charset), verrà impostato automaticamente sul set caratteri del terminale (se diverso da UTF-8), oppure su ISO-8859-1.
Il valore di codifica predefinito è vuoto, perciò il testo viene inviato per default con il set caratteri interno (UTF-8).
Per impostare il set caratteri del server IRC, utilizzare il comando charset sul buffer del server. Se viene immesso solo il set caratteri, allora i valori di codifica e decodifica saranno gli stessi.
Ad esempio:
/charset ISO-8859-15
È l’equivalente di:
/charset decode ISO-8859-15 /charset encode ISO-8859-15
Per impostare il set caratteri per il canale IRC (o il privato), utilizzare gli stessi comandi per il server, ma sul buffer del canale (o quello privato).
Per visualizzare tutti i set caratteri utilizzati, utilizzare il comando seguente:
/set charset.*
4.4.4. Risoluzione problemi
Per qualunque problema con i set caratteri, per favore consultare le Domande Frequenti di WeeChat.
4.5. Plugin Fifo
È possibile controllare da remoto WeeChat, inviando comandi o del testo ad una pipe FIFO (se l’opzione "plugins.var.fifo.fifo" è abilitata, e lo è per default).
La pipe FIFO si trova in ~/.weechat/ ed è chiamata weechat_fifo_xxxx (dove xxxx è l’ID del processo (PID) dell’istanza di WeeChat in esecuzione).
La sintassi per i comandi/testo della pipe FIFO è una delle seguenti:
plugin.buffer *testo o comando qui *testo o comando qui
Alcuni esempi:
-
cambiare il nick sul server IRC freenode in "nuovonick":
$ echo 'irc.server.freenode */nick nuovonick' >~/.weechat/weechat_fifo_12345
-
visualizazre del testo sul canale IRC #weechat:
$ echo 'irc.freenode.#weechat *hello!' >~/.weechat/weechat_fifo_12345
-
visualizzare del testo sul buffer attivo:
$ echo '*hello!' >~/.weechat/weechat_fifo_12345
-
inviare due comandi per disattivare/caricare gli script Perl (è necessario separarli con "\n"):
$ echo -e '*/perl unload\n*/perl autoload' >~/.weechat/weechat_fifo_12345
È possibile realizzare uno script per inviare un comando a tutte le istanze di WeeChat in esecuzione, per esempio:
#!/bin/sh if [ $# -eq 1 ]; then for fifo in ~/.weechat/weechat_fifo_* do echo -e "$1" >$fifo done fi
Se lo script viene chiamato "auto_weechat_command", può essere eseguito con:
$ ./auto_weechat_command 'irc.freenode.#weechat *ciao'
4.6. Plugin IRC
Il plugin IRC è realizzato per chattare tramite protocollo IRC con altre persone.
È multi-server, ed offre tutti i comandi IRC supportati inclusi la chat DCC ed il trasferimento file (tramite plugin xfer, consultare [xfer_plugin]).
4.6.1. Opzioni a riga di comando
È possibile fornire un URL per uno o più server IRC, come segue:
[irc][6][s]://[nick[:password]@]irc.esempio.org[/porta][//#canale1][,#canale2[...]]
Esempio per entrare in #weechat e #tizio sul server irc.freenode.net, porta predefinita (6667), con il nick caio:
$ weechat-curses irc://caio@irc.freenode.net/#weechat,#tizio
4.6.2. Opzioni (irc.conf)
-
irc.color.input_nick
-
descrizione: colore per il nick nella riga di input
-
tipo: colore
-
valori: un nome colore (valore predefinito: lightcyan)
-
-
irc.color.item_away
-
descrizione: colore per l’elemento assenza
-
tipo: colore
-
valori: un nome colore (valore predefinito: yellow)
-
-
irc.color.item_channel_modes
-
descrizione: colore per le modalità dei canali, vicino ai nomi dei canali
-
tipo: colore
-
valori: un nome colore (valore predefinito: default)
-
-
irc.color.message_join
-
descrizione: colore per il testo nei messaggi di entrata
-
tipo: colore
-
valori: un nome colore (valore predefinito: green)
-
-
irc.color.message_quit
-
descrizione: colore per il testo nei messaggi di uscita/abbandono
-
tipo: colore
-
valori: un nome colore (valore predefinito: red)
-
-
irc.color.notice
-
descrizione: colore per il testo "Notifica" nelle notifiche
-
tipo: colore
-
valori: un nome colore (valore predefinito: green)
-
-
irc.look.color_nicks_in_server_messages
-
descrizione: utilizza i colori dei nick nei messaggi dal server
-
tipo: bool
-
valori: on, off (valore predefinito: on)
-
-
irc.look.color_pv_nick_like_channel
-
descrizione: usa lo stesso colore del nick per canale e privato
-
tipo: bool
-
valori: on, off (valore predefinito: on)
-
-
irc.look.display_away
-
descrizione: visualizza messaggio al cambio dello stato di assenza
-
tipo: intero
-
valori: off, local, channel (valore predefinito: local)
-
-
irc.look.display_channel_modes
-
descrizione: visualizza le modalità canale nell’elemento barra "buffer_name"
-
tipo: bool
-
valori: on, off (valore predefinito: on)
-
-
irc.look.display_ctcp_blocked
-
descrizione: visualizza messaggio CTCP anche se bloccato
-
tipo: bool
-
valori: on, off (valore predefinito: on)
-
-
irc.look.display_ctcp_reply
-
descrizione: visualizza risposta CTCP inviata da WeeChat
-
tipo: bool
-
valori: on, off (valore predefinito: on)
-
-
irc.look.display_ctcp_unknown
-
descrizione: visualizza messaggio CTCP anche se è CTCP sconosciuto
-
tipo: bool
-
valori: on, off (valore predefinito: on)
-
-
irc.look.display_nick_modes
-
descrizione: visualizza le modalità nick nell’elemento barra "input_prompt"
-
tipo: bool
-
valori: on, off (valore predefinito: on)
-
-
irc.look.display_old_topic
-
descrizione: visualizza l’argomento del canale precedente quando viene cambiato
-
tipo: bool
-
valori: on, off (valore predefinito: on)
-
-
irc.look.hide_nickserv_pwd
-
descrizione: nascondi password visualizzata da nickserv
-
tipo: bool
-
valori: on, off (valore predefinito: on)
-
-
irc.look.highlight_tags
-
descrizione: elenco separato da liste di tag per i messaggi che potrebbero generare evidenziazioni (di solito qualsiasi messaggio da altri utenti, non quelli dal server,…)
-
tipo: stringa
-
valori: qualsiasi stringa (valore predefinito: "irc_privmsg,irc_notice")
-
-
irc.look.item_display_server
-
descrizione: nome dell’elemento barra dov'è visualizzato il server IRC (per la barra di stato)
-
tipo: intero
-
valori: buffer_plugin, buffer_name (valore predefinito: buffer_plugin)
-
-
irc.look.msgbuffer_fallback
-
descrizione: buffer di destinazione predefinito per le opzioni di msgbuffer quando la destinazione è privata ed il buffer privato non viene trovato
-
tipo: intero
-
valori: current, server (valore predefinito: current)
-
-
irc.look.nick_completion_smart
-
descrizione: completamento intelligente per i nick (usando prima chi ha parlato per ultimo)
-
tipo: intero
-
valori: off, speakers, speakers_highlights (valore predefinito: speakers)
-
-
irc.look.nick_prefix
-
descrizione: testo da visualizzare prima del nick nella finestra di chat
-
tipo: stringa
-
valori: qualsiasi stringa (valore predefinito: "")
-
-
irc.look.nick_suffix
-
descrizione: testo da visualizzare dopo il nick nella finestra di chat
-
tipo: stringa
-
valori: qualsiasi stringa (valore predefinito: "")
-
-
irc.look.notice_as_pv
-
descrizione: visualizza notifiche come messaggi privati (se automatico, utilizza il buffer privato se viene trovato)
-
tipo: intero
-
valori: auto, never, always (valore predefinito: auto)
-
-
irc.look.open_channel_near_server
-
descrizione: apri nuovi canali vicino al server
-
tipo: bool
-
valori: on, off (valore predefinito: off)
-
-
irc.look.open_pv_near_server
-
descrizione: apri nuovi privati vicino al server
-
tipo: bool
-
valori: on, off (valore predefinito: off)
-
-
irc.look.raw_messages
-
descrizione: numero di messaggi grezzi IRC da salvare quando il buffer dei dati grezzi chiuso (i messaggi verranno visualizzati all’apertura del buffer dei dati grezzi)
-
tipo: intero
-
valori: 0 .. 65535 (valore predefinito: 256)
-
-
irc.look.server_buffer
-
descrizione: unisci i buffer dei server
-
tipo: intero
-
valori: merge_with_core, merge_without_core, independent (valore predefinito: merge_with_core)
-
-
irc.look.show_away_once
-
descrizione: mostra il messaggio di assenza remoto solo una volta in privato
-
tipo: bool
-
valori: on, off (valore predefinito: on)
-
-
irc.look.smart_filter
-
descrizione: filtra i messaggi di entrata/uscita/abbandono per un nick se inattivo per alcuni minuti sul canale (è necessario creare un filtro sul tag "irc_smart_filter")
-
tipo: bool
-
valori: on, off (valore predefinito: off)
-
-
irc.look.smart_filter_delay
-
descrizione: ritardo per il filtraggio dei messaggi di entrata/uscita/abbandono (in minuti)
-
tipo: intero
-
valori: 1 .. 10080 (valore predefinito: 5)
-
-
irc.look.topic_strip_colors
-
descrizione: elimina colori nell’argomento (utilizzato solo quando viene visualizzato il titolo del buffer)
-
tipo: bool
-
valori: on, off (valore predefinito: off)
-
-
irc.network.anti_flood_prio_high
-
descrizione: anti-flood per coda ad alta priorità: numero di secondi tra due messaggi utente o comandi inviati al server IRC (0 = nessun anti-flood)
-
tipo: intero
-
valori: 0 .. 60 (valore predefinito: 2)
-
-
irc.network.anti_flood_prio_low
-
descrizione: anti-flood per coda a bassa priorità: numero di secondi tra due messaggi inviati al server IRC (messaggi come risposte CTCP automatiche) (0 = nessun anti-flood)
-
tipo: intero
-
valori: 0 .. 60 (valore predefinito: 2)
-
-
irc.network.away_check
-
descrizione: intervallo tra le due verifiche per l’assenza (in minuti, 0 = nessun check)
-
tipo: intero
-
valori: 0 .. 2147483647 (valore predefinito: 0)
-
-
irc.network.away_check_max_nicks
-
descrizione: non verificare l’assenza su canali con un elevato numero di nick (0 = illimitato)
-
tipo: intero
-
valori: 0 .. 2147483647 (valore predefinito: 25)
-
-
irc.network.colors_receive
-
descrizione: se disabilitato, i codici colori vengono ignorati nei messaggi in entrata
-
tipo: bool
-
valori: on, off (valore predefinito: on)
-
-
irc.network.colors_send
-
descrizione: consente all’utente di inviare i colori con dei codici speciali (ctrl-c + un codice ed un colore opzionale: b=grassetto, cxx.yy=colore+sfondo, u=sottolineato, r=inverso)
-
tipo: bool
-
valori: on, off (valore predefinito: on)
-
-
irc.network.default_msg_part
-
descrizione: messaggio di uscita predefinito (in uscita dal canale) ("%v" verrà sostituito dalla versione di WeeChat)
-
tipo: stringa
-
valori: qualsiasi stringa (valore predefinito: "WeeChat %v")
-
-
irc.network.default_msg_quit
-
descrizione: messaggio di abbandono predefinito (disconnessione dal server) ("%v" verrà sostituito dalla versione di WeeChat)
-
tipo: stringa
-
valori: qualsiasi stringa (valore predefinito: "WeeChat %v")
-
-
irc.network.lag_check
-
descrizione: intervallo tra due controlli per il ritardo (in secondi, 0 = nessun controllo)
-
tipo: intero
-
valori: 0 .. 2147483647 (valore predefinito: 60)
-
-
irc.network.lag_disconnect
-
descrizione: disconnetti dopo un ritardo eccessivo (in minuti, 0 = nessuna disconnessione)
-
tipo: intero
-
valori: 0 .. 2147483647 (valore predefinito: 0)
-
-
irc.network.lag_min_show
-
descrizione: ritardo minimo da visualizzare (in secondi)
-
tipo: intero
-
valori: 0 .. 2147483647 (valore predefinito: 1)
-
-
irc.network.send_unknown_commands
-
descrizione: invia comandi sconosciuti al server
-
tipo: bool
-
valori: on, off (valore predefinito: off)
-
-
irc.server_default.addresses
-
descrizione: elenco di host/porte o IP/porte per il server (separati da virgole)
-
tipo: stringa
-
valori: qualsiasi stringa (valore predefinito: "")
-
-
irc.server_default.autoconnect
-
descrizione: connette automaticamente ai server all’avvio di WeeChat
-
tipo: bool
-
valori: on, off (valore predefinito: off)
-
-
irc.server_default.autojoin
-
descrizione: elenco separato da virgole di canali in cui entrare quando si è connessi al server (esempio: "#canale1", #canale2, #canale3 chiave1,chiave2")
-
tipo: stringa
-
valori: qualsiasi stringa (valore predefinito: "")
-
-
irc.server_default.autoreconnect
-
descrizione: riconnette automaticamente al server alla disconnessione
-
tipo: bool
-
valori: on, off (valore predefinito: on)
-
-
irc.server_default.autoreconnect_delay
-
descrizione: ritardo (in secondi) prima di effettuare una nuova connessione al server
-
tipo: intero
-
valori: 0 .. 65535 (valore predefinito: 30)
-
-
irc.server_default.autorejoin
-
descrizione: rientra automaticamente nei canali dopo il kick
-
tipo: bool
-
valori: on, off (valore predefinito: off)
-
-
irc.server_default.autorejoin_delay
-
descrizione: ritardo (in secondi) prima di rientrare automaticamente (dopo il kick)
-
tipo: intero
-
valori: 0 .. 86400 (valore predefinito: 30)
-
-
irc.server_default.command
-
descrizione: comando(i) da eseguire quando si è connessi al server (più comandi vanno separati da ":", utilizzare ";" per un punto e virgola, le variabili speciali $nick, $canale e $server vengono sostituite dai loro valori)
-
tipo: stringa
-
valori: qualsiasi stringa (valore predefinito: "")
-
-
irc.server_default.command_delay
-
descrizione: ritardo (in secondi) dopo l’esecuzione del programma (esempio: fornire il tempo per l’autenticazione)
-
tipo: intero
-
valori: 0 .. 3600 (valore predefinito: 0)
-
-
irc.server_default.ipv6
-
descrizione: utilizza il protocollo IPv6 per le comunicazioni col server
-
tipo: bool
-
valori: on, off (valore predefinito: off)
-
-
irc.server_default.local_hostname
-
descrizione: nome host/IP locale definito per il server (opzionale, se vuoto viene utilizzato il nome host locale)
-
tipo: stringa
-
valori: qualsiasi stringa (valore predefinito: "")
-
-
irc.server_default.nicks
-
descrizione: nick da utilizzare sul server (separati da virgole)
-
tipo: stringa
-
valori: qualsiasi stringa (valore predefinito: "")
-
-
irc.server_default.password
-
descrizione: password per il server
-
tipo: stringa
-
valori: qualsiasi stringa (valore predefinito: "")
-
-
irc.server_default.proxy
-
descrizione: proxy utilizzato per il server (opzionale)
-
tipo: stringa
-
valori: qualsiasi stringa (valore predefinito: "")
-
-
irc.server_default.realname
-
descrizione: nome reale da utilizzare sul server
-
tipo: stringa
-
valori: qualsiasi stringa (valore predefinito: "")
-
-
irc.server_default.ssl
-
descrizione: utilizza SSL per le comunicazioni col server
-
tipo: bool
-
valori: on, off (valore predefinito: off)
-
-
irc.server_default.ssl_cert
-
descrizione: certificato ssl utilizzato per identificare automaticamente il proprio nick
-
tipo: stringa
-
valori: qualsiasi stringa (valore predefinito: "")
-
-
irc.server_default.ssl_dhkey_size
-
descrizione: dimensione della chiave utilizzata durante lo Scambio Chiavi Diffie-Hellman
-
tipo: intero
-
valori: 0 .. 2147483647 (valore predefinito: 2048)
-
-
irc.server_default.ssl_verify
-
descrizione: verifica che la connessione ssl sia totalmente fidata
-
tipo: bool
-
valori: on, off (valore predefinito: on)
-
-
irc.server_default.username
-
descrizione: nome utente da utilizzare sul server
-
tipo: stringa
-
valori: qualsiasi stringa (valore predefinito: "")
-
4.6.3. Comandi
- • /admin [obiettivo]
informazioni sull'amministratore del server destinazione: server
- • /allchan [-current] [-exclude=canale,[,canale...]] comando [argomenti]
esegue un comando su tutti i canali di tutti i server connessi
-current: esegue il comando solo per i canali del server corrente
-exclude: esclude alcunu canali ('*' è consentito all'inizio o alla fine del nome del canale, per escludere più canali)
comando: comando da eseguire
argomenti: argomenti per il comando
Esempi:
esegue '/me sta testando' su tutti i canali:
/allchan me is testing
dice 'ciao' dovunque tranne che su #weechat:
/allchan -exclude=#weechat msg * ciao
dice 'ciao' dovunque tranne che su #weechat e i canali che iniziano con #linux:
/allchan -exclude=#weechat,#linux* msg * ciao
- • /allserv [-exclude=server[,server...]] comando [argomenti]
esegue un comando su tutti i server connessi
-exclude: esclude alcuni server ('*' è consentito all'inizio o alla fine del nome server, per escludere più server)
comando: comando da eseguire
argomenti: argomenti per il comando
Esempli:
cambia nick su tutti i server:
/allserv nick nuovonick
imposta l'assenza su tutti i server:
/allserv away sono assente
- • /away [-all] [messaggio]
attiva/disattiva lo stato di assenza
-all: attiva/disattiva lo stato di assenza su tutti i server connessi
messaggio: messaggio di assenza (se non specificato, lo stato di assenza viene rimosso)
- • /ban [canale] [nick [nick ...]]
banna nick oppure host
canale: canale per il ban
nick: utente o host da bannare
- • /connect [-all [-nojoin] | nome_server [nome_server ...] [-nojoin] | nome_host[/porta] [-opzione[=valore]] [-nooption]
connette ad uno o più server IRC
-all: connette a tutti i server
nome_server: nome interno del server a cui connettersi (il server deve essere stato creato con /server add)
-nojoin: non entrare in nessun canale (anche se l'ingresso automatico è attivo sul server)
nome_host: nome host (oppure IP) del server
porta: porta per il server (6667 è la predefinita)
opzione: imposta opzione per il server (per le opzioni bool, il valore può essere omesso)
nooption: imposta il valore bool dell'opzione su off (per esempio: -nossl)
Esempi:
/connect freenode
/connect irc.oftc.net/6667
/connect irc6.oftc.net/6667 -ipv6
/connect irc6.oftc.net/6697 -ipv6 -ssl
/connect mio.server.org/6697 -ssl -password=test
- • /ctcp destinatario tipo [argomenti]
invia un messaggio CTCP (Protocollo Client-A-Client)
destinatario: nick o canale a cui inviare il CTCP
tipo: tipo CTCP (esempi: "version", "ping", ..)
argomenti: argomenti per il CTCP
- • /cycle [canale[,canale]] [messaggio]
lascia e rienta in un canale
canale: nome canale per il ciclo
messaggio: messaggio di uscita (mostrato agli altri utenti)
- • /dcc azione [nick] [file]]
avvia DCC (file o chat)
azione: 'send' (invia file) o 'chat'
nick: nick a cui inviare il file o aprire la chat
file: nome file (sull'host locale)
- • /dehalfop [nick [nick]]
rimuovi lo stato di half-op da uno (o più) nick
- • /deop [nick [nick]]
rimuove lo stato di operatore da uno (o più) nick
- • /devoice [nick [nick]]
rimuove voice da uno (o più) nick
- • /die
arresta il server
- • /disconnect [-all | nome_server [nome_server ...]]
disconnette da uno o più server IRC
-all: disconnetti da tutti i server
nome_server: nome del server da cui disconnettersi
- • /halfop [nick [nick]]
concedi lo stato di halfop ad uno (o più) nick
- • /ignore [list] | [add [re:]nick/host [server [canale]]] | [del numero|-all]
ignora nick/host dai server o dai canali
list: elenca tutti gli ignore
add: aggiungi un ignore
del: elimina un ignore
numero: numero di ignore da eliminare (nella lista)
all: elimina tutti gli ignore
nick/host: nick o host da ignorare: la sintassi è "re:regex" o "mask" (una mask è una stringa con alcuni "*" per sostituire uno o più caratteri)
server: nome interno del server dove l'ignore è attivo
canale: nome del canale dove l'ignore è attivo
Esempi:
ignora nick "tizio" su tutti gli host/canali:
/ignore add tizio
ignora l'host "tizio@dominio.com" sul server freenode:
/ignore add tizio@dominio.com freenode
ignora l'host "tizio*@*.dominio.com" su freenode/#weechat:
/ignore add tizio*@*.dominio.com freenode #weechat
- • /info [obiettivo]
ottieni informazioni sul server destinazione: nome server
- • /invite nick canale
invita un nick su un canale
nick: nick da invitare
canale: canale su cui invitare
- • /ison [nick [nick ...]]
verifica se un nick è collegato su IRC nick: nick
- • /join [canale[,canale ] [chiave[,chiave]]]
entra in un canale canale: nome del canale in cui entrare chiave: chiave per entrare nel canale
- • /kick [canale] nick [commento]
caccia forzatamente un utente da un canale
canale: canale dove si trova l'utente
nick: nick da cacciare
commento: commento per il kick
- • /kickban [canale] nick [commento]
caccia e banna un nick da un canale
canale: canale in cui si trova l'utente
nick: nick da cacciare e bannare
commento: commento per la cacciata
È possibile cacciare/bannare con una mask, il nick verrà estratto dalla mask e sostituito da "*", per esempio:
/kickban tizio!*@host.com
banna "*!*@host.com" e poi caccia "tizio".
- • /kill nick commento
chiude connessione client-server
nick: nick
commento: commento per il kill
- • /links [[server] mask_server]
elenca tutti i nomi server conosciuti dal server che risponde alla richiesta
server: questo server dovrebbe rispondere alla richiesta
mask_server: elenco dei server devono corrispondere a questa mask
- • /list [canale[,canale] [server]
elenca i canali ed i loro argomenti canale: canale da elencare (è consentita un'espressione regolare) server: nome del server
- • /lusers [mask [destinazione]]
ottiene statistiche sulla dimensione del network IRC mask: server corrispondenti alla mask destinazione: server per redirigere la richiesta
- • /me messaggio
invia un'azione CTCP al canale corrente messaggio: messaggio da inviare
- • /mode { [canale] {[+|-]|o|p|s|i|t|n|b|v} [limit] [utente] [ban mask] } | { nick {[+|-]|i|w|s|o} }
cambia modalità canale o utente
modalità canale:
canale: nome canale da modificare (predefinito è quello attivo)
o: concedi/ottieni privilegi di operatore del canale
p: canale privato
s: canale segreto
i: canale a solo-invito
t: argomento modificabile solo dall'operatore del canale
n: nessun messaggio al canale da client esterni
m: canale moderato
l: imposta il limite massimo di utenti sul canale
b: imposta un mask ban per tenere alla larga agli utenti
e: imposta mask di eccezione
v: concedi/ottieni la possibilità di parlare su un canale moderato
k: imposta una chiave per il canale (password)
modalità utente:
nick: nick da modificare
i: marca un utente come invisibile
s: marca un utente per la ricezione dei messaggi dal server
w: l'utente riceve wallops
o: flag operatore
- • /motd [obiettivo]
riceve il "Messaggio Del Giorno" destinazione: nome server
- • /msg [-server server] [destinatario[,destinatario] testo
invia un messaggio ad un nick o a un canale
server: invia a questo server (nome interno)
destinatario: nick o canale (può essere una mask, '*' = canale corrente)
testo: testo da inviare
- • /names [canale[,canale]]
elenca i nick sul canale canale: nome canale
- • /nick [-all] nick
modifica il nick corrente
-all: imposta nuovo nick per tutti i server connessi
nick: nuovo nick
- • /notice [-server server] nick testo
invia messaggio di notifica all'utente
server: invia a questo server (nome interno)
nick: utente a cui inviare la notifica
testo: testo da inviare
- • /op nick [nick]
concedi lo stato di operatore del canale al(ai) nick
- • /oper utente password
ottieni i privilegi di operatore utente/password: utilizzata per ottenere i privilegi sul server IRC corrente
- • /part [canale[,canale]] [messaggio]
lascia un canale
canale: nome del canale da lasciare
messaggio_uscita: messaggio di uscita (mostrato agli altri utenti)
- • /ping server1 [server2]
invia ping al server server1: server su cui effettuare il ping server2: invia ping a questo server
- • /pong demone [demone2]
risponde ad un messaggio ping
demone: demone che ha risposto al messaggio di Ping
demone2: invia messaggio a questo demone
- • /query [-server server] nick [testo]
invia un messaggio privato ad un nick
server: invia a questo server (nome interno)
nick: nick per la conversazione privata
testo: testo da inviare
- • /quote [-server server] dati
invia dati grezzi al server senza analisi
server: invia a questo server (nome interno)
dati: dati grezzi da inviare
- • /reconnect [-all [-nojoin] | nome_server [nome_server ...] [-nojoin]]
riconnetti a uno (o più) server
-all: riconnetti a tutti i server
nome_server: nome del server a cui riconnettersi
nojoin: non entrare in nessun canale (anche se l'ingresso automatico è abilitato sul server
- • /rehash [opzione]
chiede al server di ricaricare il proprio file di configurazione opzione: opzione extra, per alcuni server
- • /restart
chiede al server di riavviarsi
- • /sajoin nick canale[,canale]
forza un utente ad entrare su uno o più canali
nick: nick
canale: nome del canale
- • /samode `canale modalità`
cambia modalità sul canale, senza avere lo status di operatore canale: nome del canale modalità: modalità per il canale
- • /sanick nick nuovo_nick
forza un utente ad utilizzare un altro nick
nick: nick
nuovo_nick: nuovo nick
- • /sapart nick canale[,canale]
forza un utente a lasciare uno o più canali
nick: nick
canale: nome del canale
- • /saquit nick motivo
forza un utente ad uscire dal server senza un motivo
nick: nick
motivo: motivo
- • /server [list [nome_server]] | [listfull [nome_server]] | [add nome_server host[/porta] [-temp | -opzione[=valore]] [-nooption] | [copy nome_server nuovo_nome_server] | [rename nome_server nuovo_nome_server] | [keep nome_server] | [del nome_server ] | [deloutq] | [jump] | [raw]
elenca, aggiunge o rimuove server IRC
list: elenca tutti i server (nessun parametro necessario)
listfull: elenca tutti i server con tutte le informazioni
add: crea un nuovo server
nome_server: nome server, per il solo uso interno
nome_host: nome o indirizzo IP del server, con porta opzionale (predefinita: 6667)
temp: crea server temporaneo (non salvato)
option: imposta opzione per il server (per opzioni bool, il valorepuò essere omesso)
nooption: imposta l'opzione bool su 'off' (per esempio: -nossl)
copy: duplica un server
rename: rinomina un server
keep: salva server nel file di configurazione (solo per server temporanei)
del: elimina un server
deloutq: elimina i messaggi fuori coda per tutti i server (tutti i messaggi che WeeChat sta inviando)
jump: passa al buffer del server
raw: apri buffer con dati grezzi IRC
Esempi:
/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
- • /service nick distribuzione riservata tipo info riservata
registra un nuovo servizio
distrubuzione: visibilità del servizio
tipo: riservato per un utilizzo futuro
- • /servlist [mask [tipo]]
elenca servizi attualmente connessi al network
mask: elenca solo i servizi che corrispondono a questa mask
tipo: elenca solo i servizi di questo tipo
- • /squery servizio testo
invia un messaggio ad un servizio
servizio: nome del servizio
testo: testo da inviare
- • /squit server commento
disconnette collegamenti al server
server: nome server
commento: commento per l'uscita
- • /stats [query [server]]
richiede statistiche sul server query: c/h/i/k/l/m/o/y/u (per info RFC1459) server: nome server
- • /summon utente [destinazione [canale]]
invia agli utenti connessi ad un host con un server IRC in esecuzione un messaggio per invitarli ad entrare su IRC utente: nome utente destinazione: nome server canale: nome canale
- • /time [obiettivo]
richiede l'ora locale dal server destinazione: richiede l'ora dal server specificato
- • /topic [canale] [argomento]
legge/modifica argomento del canale canale: nome canale argomento: nuovo argomento per il canale (se l'argomento è "-delete" allora viene eliminato)
- • /trace [obiettivo]
trova il percorso del server specifico destinazione: server
- • /unban [canale] nick [nick ...]
rimuove il ban da nick o host
canale: canale da cui rimuovere il ban
nick: utente o host a cui rimuovere il ban
- • /userhost [nick [nick ...]]
stampa una lista informativa sui nick nick: nick
- • /users [obiettivo]
lista di utenti autenticati sul server destinazione: server
- • /version [server | nick]
riceve informazioni di versione del nick o del server (corrente o specificato)
server: nome server
nick: nick
- • /voice [nick [nick]]
concedi il voice ad uno (o più) utenti
- • /wallops testo
invia un messaggio a tutti gli utenti attualmente connessi che hanno impostato la modalità 'w' testo da inviare
- • /who [mask ["o"]]
genera una richiesta per ottenere una lista di informazioni
mask: solo le informazioni corrispondenti al mask
o: sono visualizzati solo gli operatori in base alla mask fornita
- • /whois [server] nick[,nick]
richiedi informazioni su uno (o più) utenti
server: nome server
nick: nick (può essere una mask)
- • /whowas nick [,nick [,nick ...]] [count [destinazione]]
richiede informazioni su un nick non più esistente
nick: nick da cercare
count: numero di risultati da visualizzare (ricerca completa se il numero è negativo)
destinazione: la risposta dovrebbe coincidere con la mask
4.6.4. Risposte CTCP
È possibile personalizzare le risposte CTCP, o bloccare alcune richieste CTCP (non rispondere).
Ad esempio, per personalizzare la richiesta CTCP "VERSIONE", utilizzare il seguente comando:
/set irc.ctcp.version "Uso WeeChat $version, fico!"
Se si desidera bloccare CTCP "VERSIONE" (non rispondere ad una query), allora basta impostare una stringa vuota:
/set irc.ctcp.version ""
Anche un CTCP sconosciuto può essere personalizzato, per esempio si può rispondere "BLABLA":
/set irc.ctcp.blabla "Questa è la mia risposta a CTCP BLABLA"
È possibile personalizzare CTCP per un solo server, utilizzando il suo nome interno prima del nome CTCP:
/set irc.ctcp.freenode.version "WeeChat $version (per freenode)"
Se si desidera ripristinare la risposta CTCP standard, allora disabilitare l’opzione:
/unset irc.ctcp.version
I codici seguenti possono essere utilizzati nelle stringhe e vengono estese automaticamente da WeeChat quando si risponde alle CTCP
| Codice | Descrizione | Valore/esempio |
|---|---|---|
$clientinfo |
elenco di CTCP supportate |
ACTION DCC CLIENTINFO FINGER PING SOURCE TIME USERINFO VERSION |
$version |
versione di WeeChat |
0.3.0 |
$compilation |
data di compilazione di WeeChat |
Sep 13 2009 |
$osinfo |
informazioni sull’OS |
Linux 2.6.31 / i686 |
$site |
sito di WeeChat |
http://www.weechat.org |
$download |
sito di WeeChat, pagina di download |
http://www.weechat.org/download |
$time |
data/ora correnti |
Sun Sep 13 15:48:31 2009 |
$username |
nome utente sul server IRC |
nick |
$realname |
nome reale sul server IRC |
Mio nome |
Se le opzioni CTCP non sono definite (comportamento predefinito), le risposte CTCP sono:
| CTCP | Formato risposta | Esempio |
|---|---|---|
CLIENTINFO |
$clientinfo |
ACTION DCC CLIENTINFO FINGER PING SOURCE TIME USERINFO VERSION |
FINGER |
WeeChat $version |
WeeChat 0.3.0 |
SOURCE |
$download |
http://www.weechat.org/download |
TIME |
$time |
Sun Sep 13 15:48:31 2009 |
USERINFO |
$username ($realname) |
nick (Mio nome) |
VERSION |
WeeChat $version ($compilation) |
WeeChat 0.3.0 (Sep 13 2009) |
4.6.5. Buffer di destinazione per i messaggi IRC
È possibile personalizzare il buffer di destinazione per i messaggi IRC (buffer usato per visualizzare messaggi) con l’opzione irc.msgbuffer.*.
Per alcuni messaggi IRC (elenco in basso), si possono usare i seguenti valori:
- current
-
buffer attivo (se è il buffer IRC, oppure sul buffer del server, come predefinito)
- private
-
buffer privato per il nick, o il buffer corrente se non trovato (in base all’opzione irc.look.msgbuffer_fallback)
- weechat
-
Il buffer "core" di WeeChat
Il buffer del server è la destinazione predefinita (quando l’opzione non è impostata).
Ecco una lista incompleta dei messaggi IRC o degli alias che è possibile personalizzare:
| messaggio | alias | descrizione |
|---|---|---|
invite |
invitato su un canale |
|
notice |
notifica |
|
wallops |
wallops |
|
221 |
stringa modalità utente |
|
275 |
whois |
whois (connessione sicura) |
303 |
ison |
|
305 |
unaway |
presente |
306 |
away |
assente |
307 |
whois |
whois (nick registrato) |
310 |
whois |
whois (modalità aiuto) |
311 |
whois |
whois (utente) |
312 |
whois |
whois (server) |
313 |
whois |
whois (operatore) |
314 |
whowas |
whowas |
315 |
who |
who (fine) |
317 |
whois |
whois (inattività) |
318 |
whois |
whois (fine) |
319 |
whois |
whois (canali) |
320 |
whois |
whois (utente identificato) |
321 |
list |
list (inizio) |
322 |
list |
list (canale) |
323 |
list |
list (fine) |
326 |
whois |
whois (con privilegi di operatore) |
327 |
whois |
whois (host) |
330 |
whois |
whois (loggato come) |
335 |
whois |
whois (è un bot su) |
338 |
whois |
whois (host) |
341 |
invito |
|
344 |
reop |
reop sul canale |
345 |
reop |
reop sul canale (fine) |
351 |
versione del server |
|
352 |
who |
who |
369 |
whowas |
whowas (fine) |
378 |
whois |
whois (connesso da) |
379 |
whois |
whois (usa le modalità) |
432 |
nick errato |
|
433 |
nick già utilizzato |
|
438 |
non autorizzato a cambiare nick |
|
671 |
whois |
whois (connessione sicura) |
901 |
ora si è loggati |
Anche altri comandi numerici possono essere personalizzati.
Il messaggio può essere preceduto dal nome del server per essere più precisi (ad esempio: freenode.whois).
Alcuni esempi:
-
visualizza il risultato di /whois su un buffer privato:
/set irc.msgbuffer.whois private
-
ripristina il buffer predefinito per il whois (buffer del server):
/unset irc.msgbuffer.whois
-
visualizza inviti sul buffer corrente, solo per il server "freenode":
/set irc.msgbuffer.freenode.invite current
-
visualizza messaggio "303" (ison) sul buffer "core" di WeeChat:
/set irc.msgbuffer.303 weechat
4.7. Plugin Logger
Il plugin Logger consente di salvare il contenuto dei buffer su file, con opzioni a proposito su cosa e come viene salvato.
4.7.1. Opzioni (logger.conf)
-
logger.file.auto_log
-
descrizione: salva automaticamente il contenuto dei buffer su file (a meno che un buffer disabiliti il log)
-
tipo: bool
-
valori: on, off (valore predefinito: on)
-
-
logger.file.info_lines
-
descrizione: scrivere riga di informazione nel file di log quando il log inizia o termina per un buffer
-
tipo: bool
-
valori: on, off (valore predefinito: off)
-
-
logger.file.mask
-
descrizione: mask del nome file predefinito per i file di log (il formato è "cartella/per/file" oppure "file", senza la prima "/" perché l’opzione "path" è utilizzata per costruire il percorso completo del file); sono ammesse le variabili dei buffer locali
-
tipo: stringa
-
valori: qualsiasi stringa (valore predefinito: "$plugin.$name.weechatlog")
-
-
logger.file.name_lower_case
-
descrizione: utilizzare solo lettere minuscole per i nomi dei file di log
-
tipo: bool
-
valori: on, off (valore predefinito: on)
-
-
logger.file.path
-
descrizione: percorso per i file di log di WeeChat ("%h" verrà sostituito dalla cartella home di WeeChat, predefinita è "~/.weechat)
-
tipo: stringa
-
valori: qualsiasi stringa (valore predefinito: "%h/logs/")
-
-
logger.file.replacement_char
-
descrizione: carattere di sostituzione per i caratteri speciali nei nomi dei file salvati con la mask (come il delimitatore di cartella)
-
tipo: stringa
-
valori: qualsiasi stringa (valore predefinito: "_")
-
-
logger.file.time_format
-
descrizione: data e ora utilizzati nei file di log (consultare man strftime per gli specificatori di data/ora)
-
tipo: stringa
-
valori: qualsiasi stringa (valore predefinito: "%Y-%m-%d %H:%M:%S")
-
-
logger.look.backlog
-
descrizione: numero massimo di righe da visualizzare dal file di log alla creazione di un nuovo buffer (0 = nessun backlog)
-
tipo: intero
-
valori: 0 .. 2147483647 (valore predefinito: 20)
-
4.7.2. Comandi
- • /logger [list | set livello | disable]
configurazione del plugin logger
list: mostra lo stato del logging per i buffer aperti
set: imposta il livello di logging per il buffer corrente
level: livello per i messaggi da loggare (0 = disabilitato, 1 = alcuni messaggi (più importanti) .. 9 = tutti i messaggi)
disable: disabilita il logging sul buffer corrente (imposta livello a 0)
Le opzioni "logger.level.*" e "logger.mask.*" possono essere utilizzate per impostare un livello o una mask per un buffer, o per i buffer che cominciano per nome.
Esempi:
imposta il livello 5 al buffer attivo:
/logger set 5
disabilita logging per il buffer attivo:
/logger disable
imposta il livello 3 per tutti i buffer IRC:
/set logger.level.irc 3
disabilita logging per il buffer principale di WeeChat:
/set logger.level.core.weechat 0
utilizza una cartella per il server IRC e un file per il canale al suo interno:
/set logger.mask.irc "$server/$channel.weechatlog"
Livelli di log utilizzati dal plugin IRC:
1: messaggio utente, notifica, privato
2: cambio di nick
3: messaggio del server
4: entrata/uscita/abbandono
9: tutti gli altri messaggi
4.7.3. Livelli di log
Il logging viene effettuato con un livello per ogni buffer. Il livello predefinito è il 9 (registra tutti i messaggi visualizzati sul buffer). È possibile cambiare il livello per un buffer, oppure per un gruppo di buffer.
I livelli possibili sono da 0 a 9. Zero vuol dire "non registrare nulla" mentre 9 "registra tutto".
I plugin utilizzano livelli diversi per i messaggi visualizzati. Il plugin IRC usa i seguenti livelli:
-
livello 1: messaggio da un utente (su canale o privato)
-
livello 2: cambio nick (proprio o di qualcun altro)
-
livello 3: ogni messaggio del server (esclui entrata/uscita/disconnessione)
-
livello 4: messaggio del server entrata/uscita/disconnessione
Se viene impostato il livello 3 per un canale IRC, WeeChat registrerà tutti i messaggi, ma non quelli di entrata/uscita/disconnessione.
Alcuni esempi:
-
imposta il livello 3 per il canale IRC #weechat:
/set logger.level.irc.freenode.#weechat 3
-
set level 3 for freenode server buffer:
/set logger.level.irc.server.freenode 3
-
imposta il livello 3 per tutti i canali sul server freenode:
/set logger.level.irc.freenode 3
-
imposta il livello 2 per tutti i buffer IRC:
/set logger.level.irc 2
4.7.4. Mask per il nome file
È possibile definire un mask per il nome del file di ogni buffer, ed utilizzare le variabili buffer locali per costruire il nome del file. Per visualizzare le variabili locali per il buffer corrente:
/buffer localvar
Per esempio, se si vuole una cartella per server IRC e un file per canale al suo interno:
/set logger.mask.irc "irc/$server/$channel.weechatlog"
Si avranno i seguenti file:
~/.weechat/
|--- logs/
|--- irc/
|--- freenode/
| freenode.weechatlog
| #weechat.weechatlog
| #miocanale.weechatlog
|--- oftc/
| oftc.weechatlog
| #canale1.weechatlog
| #canale2.weechatlog
4.8. Plugin per gli script
WeeChat fornisce 5 plugin per lo scripting: Perl, Python, Ruby, Lua, Tcl. Questi plugin possono caricare, eseguire e disattivare gli script per questi linguaggi.
Per maggiori informazioni su come scrivere gli script, o le API WeeChat per gli script, consultare la Guida allo Scripting di WeeChat.
È possibile trovare alcuni script qui: http://www.weechat.org/scripts
4.8.1. Comandi Perl
- • /perl [list [nome]] | [listfull [nome]] | [load nome_file] | [autoload] | [reload] | [unload [nome]]
elenca/attiva/disattiva script
nome_file: file script da attivare
nome: il nome dello script
Senza argomenti, il comando elenca tutti gli script caricati
4.8.2. Comandi Python
- • /python [list [nome]] | [listfull [nome]] | [load nome_file] | [autoload] | [reload] | [unload [nome]]
elenca/attiva/disattiva script
nome_file: file script da attivare
nome: il nome dello script
Senza argomenti, il comando elenca tutti gli script caricati
4.8.3. Comandi Ruby
- • /ruby [list [nome]] | [listfull [nome]] | [load nome_file] | [autoload] | [reload] | [unload [nome]]
elenca/attiva/disattiva script
nome_file: file script da attivare
nome: il nome dello script
Senza argomenti, il comando elenca tutti gli script caricati
4.8.4. Comandi Lua
- • /lua [list [nome]] | [listfull [nome]] | [load nome_file] | [autoload] | [reload] | [unload [nome]]
elenca/attiva/disattiva script
nome_file: file script da attivare
nome: il nome dello script
Senza argomenti, il comando elenca tutti gli script caricati
4.8.5. Comandi Tcl
- • /tcl [list [nome]] | [listfull [nome]] | [load nome_file] | [autoload] | [reload] | [unload [nome]]
elenca/attiva/disattiva script
nome_file: file script da attivare
nome: il nome dello script
Senza argomenti, il comando elenca tutti gli script caricati
4.9. Plugin xfer
Il plugin xfer fornisce:
-
chat diretta (tra due host, senza server): per esempio "DCC Chat" tramite plugin IRC
-
trasferimento file, per esempio "DCC" tramite il plugin IRC
4.9.1. Opzioni (xfer.conf)
-
xfer.color.status_aborted
-
descrizione: colore del testo per lo status "annullato"
-
tipo: colore
-
valori: un nome colore (valore predefinito: lightred)
-
-
xfer.color.status_active
-
descrizione: colore del testo per lo status "attivo"
-
tipo: colore
-
valori: un nome colore (valore predefinito: lightblue)
-
-
xfer.color.status_connecting
-
descrizione: colore del testo per lo status "connessione in corso"
-
tipo: colore
-
valori: un nome colore (valore predefinito: yellow)
-
-
xfer.color.status_done
-
descrizione: colore del testo per lo status "completato"
-
tipo: colore
-
valori: un nome colore (valore predefinito: lightgreen)
-
-
xfer.color.status_failed
-
descrizione: colore del testo per lo status "fallito"
-
tipo: colore
-
valori: un nome colore (valore predefinito: lightred)
-
-
xfer.color.status_waiting
-
descrizione: colore del testo per lo status "in attesa"
-
tipo: colore
-
valori: un nome colore (valore predefinito: lightcyan)
-
-
xfer.color.text
-
descrizione: colore del testo
-
tipo: colore
-
valori: un nome colore (valore predefinito: default)
-
-
xfer.color.text_bg
-
descrizione: colore di sfondo
-
tipo: colore
-
valori: un nome colore (valore predefinito: default)
-
-
xfer.color.text_selected
-
descrizione: colore del testo per la riga xfer selezionata
-
tipo: colore
-
valori: un nome colore (valore predefinito: white)
-
-
xfer.file.auto_accept_chats
-
descrizione: accetta automaticamente le richieste di chat (usare con cautela!)
-
tipo: bool
-
valori: on, off (valore predefinito: off)
-
-
xfer.file.auto_accept_files
-
descrizione: accetta automaticamente i file in arrivo (usare con cautela!)
-
tipo: bool
-
valori: on, off (valore predefinito: off)
-
-
xfer.file.auto_rename
-
descrizione: rinomina i file in ingresso se esistenti (aggiunge ".1", ".2", …)
-
tipo: bool
-
valori: on, off (valore predefinito: on)
-
-
xfer.file.auto_resume
-
descrizione: riprendi automaticamente il trasferimento file se la connessione all’host viene perduta
-
tipo: bool
-
valori: on, off (valore predefinito: on)
-
-
xfer.file.convert_spaces
-
descrizione: converti gli spazi in underscore all’invio dei file
-
tipo: bool
-
valori: on, off (valore predefinito: on)
-
-
xfer.file.download_path
-
descrizione: percorso per il salvataggio dei file locali
-
tipo: stringa
-
valori: qualsiasi stringa (valore predefinito: "%h/xfer")
-
-
xfer.file.upload_path
-
descrizione: percorso per la lettura dei file all’invio (se non specificato dall’utente)
-
tipo: stringa
-
valori: qualsiasi stringa (valore predefinito: "~")
-
-
xfer.file.use_nick_in_filename
-
descrizione: usa il nick remoto come prefisso nel nome del file locale alla ricezione
-
tipo: bool
-
valori: on, off (valore predefinito: on)
-
-
xfer.look.auto_open_buffer
-
descrizione: apre automaticamente il buffer xfer quando un nuovo xfer viene aggiunto alla lista
-
tipo: bool
-
valori: on, off (valore predefinito: on)
-
-
xfer.look.progress_bar_size
-
descrizione: dimensione barra di avanzamento, in caratteri (se 0, è disabilitata)
-
tipo: intero
-
valori: 0 .. 256 (valore predefinito: 20)
-
-
xfer.network.blocksize
-
descrizione: dimensione blocco per l’invio dei pacchetti, in byte
-
tipo: intero
-
valori: 1024 .. 102400 (valore predefinito: 65536)
-
-
xfer.network.fast_send
-
descrizione: non attendere ACK all’invio del file
-
tipo: bool
-
valori: on, off (valore predefinito: on)
-
-
xfer.network.own_ip
-
descrizione: Indirizzo IP o DNS per l’invio di file/chat (se vuoto, verrà utilizzata l’interfaccia IP locale)
-
tipo: stringa
-
valori: qualsiasi stringa (valore predefinito: "")
-
-
xfer.network.port_range
-
descrizione: forza i file in uscita/chat ad utilizzare solo le porte in una data serie (utile per il NAT) (sintassi: una singola porta, es. 5000 o un range di porte, es. 5000-5015. Un valore nullo significa qualsiasi porta, consigliato utilizzare porte maggiori di 1024, perché l’uso di porte inferiori possibile solo per root)
-
tipo: stringa
-
valori: qualsiasi stringa (valore predefinito: "")
-
-
xfer.network.speed_limit
-
descrizione: limite di velocità per l’invio dei file, in kb per secondo (0 vuol dire senza limite)
-
tipo: intero
-
valori: 0 .. 2147483647 (valore predefinito: 0)
-
-
xfer.network.timeout
-
descrizione: timeout per la richiesta xfer (in secondi)
-
tipo: intero
-
valori: 5 .. 2147483647 (valore predefinito: 300)
-
4.9.2. Comandi
- • /me messaggio
invia un'azione CTCP all'host remoto messaggio: messaggio da inviare
- • /xfer [list | listfull]
controllo xfer
list: lista xfer
listfull: lista xfer (dettagliata)
Senza argomenti, il comando apre il buffer con la lista xfer.
5. Autori
5.1. Sviluppatori
- FlashCode (Sébastien Helleu)
-
sviluppatore principale
5.2. Contributori
- Kolter (Emmanuel Bouthenot)
-
packager debian
- Ptitlouis
-
packager debian precedente
- Jiri Golembiovsky
-
traduzione in ceco, patch
- soltys
-
traduzione in polacco
- Nils Görs
- rettub
- Frank Zacharias
-
traduzione in tedesco
- Pavel Shevchuk
-
traduzione in russo
- m4v
-
traduzione in spagnolo
- Voroskoi
-
traduzione in ungherese
- Marco Paolone
-
traduzione in italiano
- Dmitry Kobylin
-
plugin tcl
- Rudolf Polzer
- Jim Ramsay
- Pistos
- Gwenn
- Dominik Honnef
-
patch
- Odin
-
SuSE RPM
6. Supporto
Prima di chieder supporto, assicurarsi di aver letto la documentazione e le FAQ fornite con WeeChat (la documentazione è questo documento, se non sono state lette tutte le righe prima di questa frase, è possibile ricominciare!).
Per ricevere supporto:
-
IRC: server irc.freenode.net, canali #weechat (inglese) e #weechat-fr (francese)
-
Forum di WeeChat: http://forums.flashtux.org/
-
Mailing list:
-
sottoscrizione: http://mail.nongnu.org/mailman/listinfo/weechat-support
-
inviare una mail a weechat-support@nongnu.org
-
archivi: http://mail.nongnu.org/archive/html/weechat-support
-