$ mkdir build $ cd build $ cmake .. $ make % make install (come root)
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
WeeChat (Wee Enhanced Environment for Chat) è un client di chat libero, veloce e leggero, realizzato per diversi sistemi operativi.
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/
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
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.
WeeChat può essere compilato con cmake oppure autotools (tuttavia si raccomanda 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
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
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]).
Argomenti a riga di comando:
Disabilita la connessione automatica ai server all’avvio di WeeChat
Imposta una cartella come home per WeeChat (utilizzata per i file di configurazione, log, plugin e script dell’utente), il valore predefinito è ~/.weechat
Visualizza l’aiuto
Visualizza i tasti predefiniti di WeeChat
Visualizza la licenza di WeeChat
Disabilita il caricamento automatico dei plugin
Visualizza la versione di WeeChat
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]).
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 |
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 |
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 |
Tasti | Descrizione e comando |
---|---|
Alt + H |
Pulisce hotlist (notifica di attività su altri buffer) |
Alt + = |
Attiva/disattiva filtri |
La riga di comando di WeeChat (nella parte inferiore della finestra) consente di inserire i comandi o di inviare del testo sul buffer.
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
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):
testo in grassetto
colore del testo xx (consultare la lista di colori che segue)
colore del testo xx e di sfondo yy (consultare la lista di colori che segue)
disabilita colori ed attributi
video inverso (inverte il colore del testo con quello di sfondo)
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!
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 |
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
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
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)
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
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
visualizza l'aiuto su comandi e opzioni comando: nome comando opzione: nome opzione (utilizza /set per vedere l'elenco)
mostra la cronologia dei comandi del buffer clear: pulisci cronologia valore: numero delle voci nella cronologia da mostrare
funzioni per la riga di comando Questo comando è utilizzato da combinazioni di tasti o plugin.
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.
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.
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.
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
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)
ricarica i file di configurazione da disco file: file di configurazione da ricaricare Senza argomento, tutti i file (WeeChat e plugin) vengono ricaricati.
salva i file di configurazione su disco file: file di configurazione da salvare Senza argomento, tutti i file (WeeChat e plugin) verranno salvati.
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.
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)
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.
mostra l'uptime di WeeChat -o: invia l'uptime al buffer corrente come input
mostra la versione e la data di compilazione di WeeChat -o: invia versione al buffer corrente come input
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
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
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.
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 |
Il plugin Alias consente di creare alias per i comandi (da WeeChat o altri plugin).
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
Il plugin Aspell consente di verificare l’ortografia nella riga di comando. È possibile utilizzare più lingue per buffer.
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)
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.
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
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: "")
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
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.*
Per qualunque problema con i set caratteri, per favore consultare le Domande Frequenti di WeeChat.
È 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'
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]).
È 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
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: "")
informazioni sull'amministratore del server destinazione: server
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
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
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)
banna nick oppure host canale: canale per il ban nick: utente o host da bannare
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
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
lascia e rienta in un canale canale: nome canale per il ciclo messaggio: messaggio di uscita (mostrato agli altri utenti)
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)
rimuovi lo stato di half-op da uno (o più) nick
rimuove lo stato di operatore da uno (o più) nick
rimuove voice da uno (o più) nick
arresta il server
disconnette da uno o più server IRC -all: disconnetti da tutti i server nome_server: nome del server da cui disconnettersi
concedi lo stato di halfop ad uno (o più) nick
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
ottieni informazioni sul server destinazione: nome server
invita un nick su un canale nick: nick da invitare canale: canale su cui invitare
verifica se un nick è collegato su IRC nick: nick
entra in un canale canale: nome del canale in cui entrare chiave: chiave per entrare nel canale
caccia forzatamente un utente da un canale canale: canale dove si trova l'utente nick: nick da cacciare commento: commento per il kick
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".
chiude connessione client-server nick: nick commento: commento per il kill
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
elenca i canali ed i loro argomenti canale: canale da elencare (è consentita un'espressione regolare) server: nome del server
ottiene statistiche sulla dimensione del network IRC mask: server corrispondenti alla mask destinazione: server per redirigere la richiesta
invia un'azione CTCP al canale corrente messaggio: messaggio da inviare
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
riceve il "Messaggio Del Giorno" destinazione: nome server
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
elenca i nick sul canale canale: nome canale
modifica il nick corrente -all: imposta nuovo nick per tutti i server connessi nick: nuovo nick
invia messaggio di notifica all'utente server: invia a questo server (nome interno) nick: utente a cui inviare la notifica testo: testo da inviare
concedi lo stato di operatore del canale al(ai) nick
ottieni i privilegi di operatore utente/password: utilizzata per ottenere i privilegi sul server IRC corrente
lascia un canale canale: nome del canale da lasciare messaggio_uscita: messaggio di uscita (mostrato agli altri utenti)
invia ping al server server1: server su cui effettuare il ping server2: invia ping a questo server
risponde ad un messaggio ping demone: demone che ha risposto al messaggio di Ping demone2: invia messaggio a questo demone
invia un messaggio privato ad un nick server: invia a questo server (nome interno) nick: nick per la conversazione privata testo: testo da inviare
invia dati grezzi al server senza analisi server: invia a questo server (nome interno) dati: dati grezzi da inviare
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
chiede al server di ricaricare il proprio file di configurazione opzione: opzione extra, per alcuni server
chiede al server di riavviarsi
forza un utente ad entrare su uno o più canali nick: nick canale: nome del canale
cambia modalità sul canale, senza avere lo status di operatore canale: nome del canale modalità: modalità per il canale
forza un utente ad utilizzare un altro nick nick: nick nuovo_nick: nuovo nick
forza un utente a lasciare uno o più canali nick: nick canale: nome del canale
forza un utente ad uscire dal server senza un motivo nick: nick motivo: motivo
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
registra un nuovo servizio distrubuzione: visibilità del servizio tipo: riservato per un utilizzo futuro
elenca servizi attualmente connessi al network mask: elenca solo i servizi che corrispondono a questa mask tipo: elenca solo i servizi di questo tipo
invia un messaggio ad un servizio servizio: nome del servizio testo: testo da inviare
disconnette collegamenti al server server: nome server commento: commento per l'uscita
richiede statistiche sul server query: c/h/i/k/l/m/o/y/u (per info RFC1459) server: nome server
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
richiede l'ora locale dal server destinazione: richiede l'ora dal server specificato
legge/modifica argomento del canale canale: nome canale argomento: nuovo argomento per il canale (se l'argomento è "-delete" allora viene eliminato)
trova il percorso del server specifico destinazione: server
rimuove il ban da nick o host canale: canale da cui rimuovere il ban nick: utente o host a cui rimuovere il ban
stampa una lista informativa sui nick nick: nick
lista di utenti autenticati sul server destinazione: server
riceve informazioni di versione del nick o del server (corrente o specificato) server: nome server nick: nick
concedi il voice ad uno (o più) utenti
invia un messaggio a tutti gli utenti attualmente connessi che hanno impostato la modalità 'w' testo da inviare
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
richiedi informazioni su uno (o più) utenti server: nome server nick: nick (può essere una mask)
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
È 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) |
È 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:
buffer attivo (se è il buffer IRC, oppure sul buffer del server, come predefinito)
buffer privato per il nick, o il buffer corrente se non trovato (in base all’opzione irc.look.msgbuffer_fallback)
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
Il plugin Logger consente di salvare il contenuto dei buffer su file, con opzioni a proposito su cosa e come viene salvato.
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)
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
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
È 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
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
elenca/attiva/disattiva script nome_file: file script da attivare nome: il nome dello script Senza argomenti, il comando elenca tutti gli script caricati
elenca/attiva/disattiva script nome_file: file script da attivare nome: il nome dello script Senza argomenti, il comando elenca tutti gli script caricati
elenca/attiva/disattiva script nome_file: file script da attivare nome: il nome dello script Senza argomenti, il comando elenca tutti gli script caricati
elenca/attiva/disattiva script nome_file: file script da attivare nome: il nome dello script Senza argomenti, il comando elenca tutti gli script caricati
elenca/attiva/disattiva script nome_file: file script da attivare nome: il nome dello script Senza argomenti, il comando elenca tutti gli script caricati
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
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)
invia un'azione CTCP all'host remoto messaggio: messaggio da inviare
controllo xfer list: lista xfer listfull: lista xfer (dettagliata) Senza argomenti, il comando apre il buffer con la lista xfer.
sviluppatore principale
packager debian
packager debian precedente
traduzione in ceco, patch
traduzione in polacco
traduzione in tedesco
traduzione in russo
traduzione in spagnolo
traduzione in ungherese
traduzione in italiano
plugin tcl
patch
SuSE RPM
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