2010-03-19 19:28:19 +01:00
• *`/away`* `[-all] [messaggio]`::
........................................
attiva/disattiva lo stato di assenza
-all: attiva/disattiva lo stato di assenza su tutti i server connessi
messaggio: messaggio di assenza (se non specificato, lo stato di assenza viene rimosso)
........................................
2009-12-04 12:11:12 +01:00
• *`/bar`* `[add nome_barra tipo[,cond1,cond2,...] posizione dimensione separatore elemento1,elemento2,...] | [default] | [del nome_barra|-all] | [set nome_barra opzione valore] | [hide|show|toggle nome_barra] | [scroll nome_barra buffer scroll_value] | [list] | [listfull] | [listitems]`::
........................................
gestione barre
add: aggiungi una nuova barra
nome_barra: nome della barra (deve essere unico)
tipo: root: fuori dalle finestre,
window: all'interno delle finestre, con opzioni condizionali (a seguire)
cond1,...: condizione(i) per la visualizzazione della barra (solo per quelle di tipo "window"):
active: sulla finestra attiva
inactive: sulle finestre inattive
nicklist: sulle finestre con le liste nick
senza condizioni, la barra viene sempre visualizzata
posizione: bottom (basso), top (alto), left (sinistra) or right (destra)
dimensione: dimensione della barra (in caratteri)
separatore: 1 per utilizzare un separatore (riga), 0 o nessun valore corrisponde a nessun separatore
elemento1,...: elementi per questa barra (possono essere separati da virgole (spazio tra gli elementi) or "+" (elementi incollati))
default: crea barre predefinite
del: elimina una barra (o tutte le barre con -all)
set: imposta un valore per una proprietà della barra
opzione: opzione da modificare (per un elenco di opzioni, consultare /set weechat.bar.<nome_barra>.*)
valore: nuovo valore per l'opzione
hide: nasconde una barra
show: mostra una barra nascosta
toggle: nasconde/mostra una barra
scroll: scorre la barra in alto/basso
buffer: nome del buffer da scorrere ('*' sta per buffer corrente, è consigliato utilizzare '*' per le barre root)
scroll_value: valore per lo scorrimento: 'x' o 'y', seguito da '+', '-', 'b' (inizio) o 'e' (fine), valore (per +/-), e un opzionale %% (per scorrere di %% di larghezza/altezza, altrimenti il valore è un numero di caratteri)
list: elenca tutte le barre
listfull: elenca tutte le barre (dettagliato)
listitems: elenca tutti gli elementi barra
Esempi:
crea una barra con l'ora, il numero del buffer + nome, e completamento:
/bar add miabarra root bottom 1 0 [time],buffer_number+:+buffer_name,completion
nasconde una barra:
/bar hide mibarra
scorre lista nick di 10 linee in basso sul buffer corrente:
/bar scroll nicklist * y+10
scorre la lista nick una pagina in su sul buffer #weechat:
/bar scroll nicklist #weechat y-100%
scorre fino alla fine della lista nick sul buffer corrente:
/bar scroll nicklist * ye
........................................
2010-04-08 10:24:05 +02:00
• *`/buffer`* `[clear [numero | -merged | -all] | move numero | merge numero | unmerge [numero] | close [n1[-n2]] | list | notify livello | localvar | set proprietà valore | get proprietà |numero | nome]`::
2009-12-04 12:11:12 +01:00
........................................
gestione buffer
2010-04-08 10:24:05 +02:00
clear: pulisce il contenuto del buffer (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 si alterna tra i buffer uniti)
unmerge: stacca il buffer da altri buffer 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 gli eventi
message: per i messaggi da tutti gli utenti + eventi
all: tutti i messaggi
reset: ripristina il valore predefinito (tutto)
localvar: visualizza la variabile locale per il buffer corrente
set: imposta una proprietà per il buffer corrente
get: visualizza una proprietà del buffer corrente
number: passa al buffer di numero in numero:
'+': passo relativo, aggiunge il numero a quello corrente
'-': passo relativo, sottrae il numero da quello corrente
'*': passa al numero, utilizzando l'opzione "weechat.look.jump_current_to_previous_buffer"
nome: passa al buffer di nome (parziale)
2009-12-04 12:11:12 +01:00
2010-04-08 10:24:05 +02:00
Esempi:
pulisci buffer corrente:
2010-03-23 09:42:37 +01:00
/buffer clear
2010-04-08 10:24:05 +02:00
sposta buffer al numero 5:
2010-03-23 09:42:37 +01:00
/buffer move 5
2010-04-08 10:24:05 +02:00
unisci al buffer core:
2010-03-23 09:42:37 +01:00
/buffer merge 1
2010-04-08 10:24:05 +02:00
stacca buffer:
2010-03-23 09:42:37 +01:00
/buffer unmerge
2010-04-08 10:24:05 +02:00
chiudi buffer corrente:
2010-03-23 09:42:37 +01:00
/buffer close
2010-04-08 10:24:05 +02:00
chiudi buffer da 5 a 7:
2010-03-23 09:42:37 +01:00
/buffer close 5-7
2010-04-08 10:24:05 +02:00
salta a #weechat:
2010-03-23 09:42:37 +01:00
/buffer #weechat
2010-04-08 10:24:05 +02:00
salta al buffer successivo:
2010-03-23 09:42:37 +01:00
/buffer +1
2009-12-04 12:11:12 +01:00
........................................
• *`/command`* `plugin comando`::
........................................
esegui comando o plugin di WeeChat esplicito
plugin: nome plugin ('weechat' per il comando interno di WeeChat)
comando: comando da eseguire (una '/' viene aggiunta automaticamente se non trovata all'inizio del comando)
........................................
2010-09-22 21:44:07 +02:00
• *`/debug`* `[list | set plugin livello | dump [plugin] | buffer | windows | term]`::
2009-12-04 12:11:12 +01:00
........................................
attiva debug per core/plugin
2009-12-17 08:32:04 +01:00
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
2009-12-04 12:11:12 +01:00
........................................
• *`/filter`* `[list] | [enable|disable|toggle [nome]] | [add nome plugin.buffer tag regex] | [del nome|-all]`::
........................................
filtra messaggi nei buffer, per nascondere/mostrare in base a tag o regexp
2010-10-01 08:05:38 +02:00
list: list all filters
enable: enable filters (filters are enabled by default)
disable: disable filters
toggle: toggle filters
name: filter name
add: add a filter
del: delete a filter
-all: delete all filters
plugin.buffer: plugin and buffer where filter is active ("*" for all buffers)
tags: comma separated list of tags, for example: "irc_join,irc_part,irc_quit"
regex: regular expression to search in line
- use '\t' to separate prefix from message, special chars like '|' must be escaped: '\|'
- if regex starts with '!', then matching result is reversed (use '\!' to start with '!')
note: two regex are created: one for prefix and one for message
2009-12-04 12:11:12 +01:00
2010-10-01 08:05:38 +02:00
The default key alt+'=' toggles filtering on/off.
2009-12-04 12:11:12 +01:00
2010-10-01 08:05:38 +02:00
Tags most commonly used:
no_filter, no_highlight, no_log, log0..log9 (log level),
2010-03-22 20:26:24 +01:00
notify_message, notify_private, notify_highlight,
2010-10-10 17:39:15 +02:00
nick_xxx (xxx is nick in message),
irc_xxx (xxx is command name or number, see /server raw),
irc_numeric, irc_error, irc_action, irc_ctcp, irc_ctcp_reply, irc_smart_filter, away_info.
2010-03-22 20:26:24 +01:00
2010-10-01 08:05:38 +02:00
Examples:
use IRC smart filter for join/part/quit messages:
/filter add irc_smart * irc_smart_filter *
filter all IRC join/part/quit messages:
/filter add joinquit * irc_join,irc_part,irc_quit *
filter nicks displayed when joining channels or with /names:
2010-03-22 20:26:24 +01:00
/filter add nicks * irc_366 *
2010-10-01 08:05:38 +02:00
filter nick "toto" on IRC channel #weechat:
/filter add toto irc.freenode.#weechat * toto\t
keep only nick "titi" on IRC channel #test:
/filter add titi irc.freenode.#test * !titi\t
filter lines containing word "spam":
2010-03-22 20:26:24 +01:00
/filter add filterspam * * spam
2010-10-01 08:05:38 +02:00
filter lines containing "weechat sucks" on IRC channel #weechat:
/filter add sucks irc.freenode.#weechat * weechat sucks
2009-12-04 12:11:12 +01:00
........................................
• *`/help`* `[comando | opzione]`::
........................................
visualizza l'aiuto su comandi e opzioni
comando: nome comando
opzione: nome opzione (utilizza /set per vedere l'elenco)
........................................
• *`/history`* `[clear | valore]`::
........................................
mostra la cronologia dei comandi del buffer
clear: pulisci cronologia
valore: numero delle voci nella cronologia da mostrare
........................................
2010-04-28 23:24:32 +02:00
• *`/input`* `return | complete_next | complete_previous | search_next | delete_previous_char | delete_next_char | delete_previous_word | delete_next_word | delete_beginning_of_line | delete_end_of_line | delete_line | clipboard_paste | transpose_chars | undo | redo | move_beginning_of_line | move_end_of_line | move_previous_char | move_next_char | move_previous_word | move_next_word | history_previous | history_next | history_global_previous | history_global_next | jump_smart | jump_last_buffer | jump_previously_visited_buffer | jump_next_visited_buffer | hotlist_clear | grab_key | grab_key_command | scroll_unread | set_unread | set_unread_current_buffer | switch_active_buffer | switch_active_buffer_previous | insert [args]`::
2009-12-04 12:11:12 +01:00
........................................
funzioni per la riga di comando
Questo comando è utilizzato da combinazioni di tasti o plugin.
........................................
2010-04-08 10:24:05 +02:00
• *`/key`* `[list | listdefault | listdiff] | [bind tasto [comando [args]]] | [unbind tasto] | [reset tasto] | [resetall -yes] | [missing]`::
2009-12-04 12:11:12 +01:00
........................................
associa/disassocia tasti
2010-04-08 10:24:05 +02:00
list: elenca tutti i tasti correnti (senza argomento, viene visualizzata questa lista)
listdefault: elenca i tasti predefiniti
listdiff: elenca le differenze tra tasti attuali e predefiniti (tasti aggiunti, ridefiniti o eliminati)
bind: associa un comando ad un tasto o visualizza il comando associato al tasto
unbind: rimuove una associazione di tasti
reset: ripristina un tasto all'assegnazione predefinita
resetall: ripristina le associazioni ai valori predefiniti ed elimina TUTTE le associazioni personalizzate (usare con cautela!)
missing: aggiunge tasti mancanti (utilizzando le associazioni predefinite), utile dopo l'installazione di una nuova versione di WeeChat
2009-12-04 12:11:12 +01:00
2010-04-08 10:24:05 +02:00
Al momento di associare un comando ad un tasto si raccomanda di utilizzare il tasto alt+k (oppure Esc e k), e digitare il tasto da associare: il codice tasto verrà inserito nella riga di comando.
2010-03-24 19:54:31 +01:00
2010-04-08 10:24:05 +02:00
Esempi:
il tasto alt-x per alternare la barra della nicklist:
2010-03-24 19:54:31 +01:00
/key bind meta-x /bar toggle nicklist
2010-04-08 10:24:05 +02:00
il tasto alt-r per passare al canale IRC #weechat:
2010-03-24 19:54:31 +01:00
/key bind meta-r /buffer #weechat
2010-04-08 10:24:05 +02:00
ripristinare l'associazione predefinita per il tasto alt-r:
2010-03-24 19:54:31 +01:00
/key reset meta-r
2009-12-04 12:11:12 +01:00
........................................
• *`/layout`* `[[save | apply | reset] [buffers | windows]]`::
........................................
2010-04-15 11:39:57 +02:00
salva/applica/ripristina il layout per i buffer e le finestre
2009-12-04 12:11:12 +01:00
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.
........................................
2010-03-24 19:54:31 +01:00
• *`/mute`* `[-current | -buffer nome | -all] comando`::
2010-02-09 13:21:05 +01:00
........................................
2010-03-24 19:54:31 +01:00
esegue un comando in silenzio
2010-02-09 13:21:05 +01:00
2010-03-24 19:54:31 +01:00
-current: nessun output sul buffer corrente
-buffer: nessun output sul buffer specificato
nome: nome completo del buffer (esempi: "irc.server.freenode", "irc.freenode.#weechat")
-all: nessun output su TUTTI i buffer
command: comando da eseguire in silenzio (una '/' viene aggiunta automaticamente all'inizio del comando se non trovata)
2010-02-09 13:21:05 +01:00
2010-03-24 19:54:31 +01:00
Se non viene specificata una destinazione (-current, -buffer o -all), la destinazione predefinita è il buffer core di WeeChat.
2010-02-09 13:21:05 +01:00
2010-03-24 19:54:31 +01:00
Esempi:
salva la configurazione:
2010-03-23 09:42:37 +01:00
/mute save
2010-03-24 19:54:31 +01:00
messaggio sul canale IRC corrente:
/mute -current msg * ciao!
messaggio sul canale #weechat:
/mute -buffer irc.freenode.#weechat msg #weechat ciao!
2010-02-09 13:21:05 +01:00
........................................
2009-12-04 12:11:12 +01:00
• *`/plugin`* `[list [nome]] | [listfull [nome]] | [load file] | [autoload] | [reload [nome]] | [unload [nome]]`::
........................................
elenca/attiva/disattiva plugin
list: elenca i plugin attivi
listfull: elenca i plugin attivi (dettagliato)
load: carica un plugin
autoload: attiva automaticamente i plugin nella cartella utente o di sistema
reload: riattiva un plugin (se non specificato, disattiva i plugin e liriattiva automaticamente)
unload: disattiva uno o tutti i plugin
Senza argomenti, questo comando elenca i plugin attivati.
........................................
• *`/proxy`* `[add nome_proxy tipo indirizzo porta [nome [password]]] | [del nome_proxy|-all] | [set nome_proxy opzione valore] | [list]`::
........................................
gestione proxy
add: aggiungi un nuovo proxy
nome_proxy: nome del proxy (deve essere unico)
tipo: http, socks4 o socks5
indirizzo: IP o nome host
port: porta
utente: nome utente (opzionale)
password: password (opzionale)
del: elimina un proxy (o tutti i proxy con -all)
set: imposta un valore per una proprietà del proxy
opzione: opzione da modificare (per un elenco di opzioni, consultare /set weechat.proxy.<nome_proxy>.*)
valore: nuovo valore per l'opzione
list: elenca tutti i proxy
Esempi:
crea un proxy http, in esecuzione su host locale, porta 8888:
/proxy add locale http 127.0.0.1 8888
crea un proxy http utilizzando il protocollo IPv6:
/proxy add locale http 127.0.0.1 8888
/proxy set locale ipv6 on
crea un proxy socks5 con utente/password:
/proxy add mioproxy socks5 esempio.host.org 3128 mioutente miapassword
elimina un proxy:
/proxy del mioproxy
........................................
2010-06-14 10:23:59 +02:00
• *`/quit`* `[-yes] [argomenti]`::
2009-12-04 12:11:12 +01:00
........................................
2010-04-15 11:39:57 +02:00
esce da WeeChat
2009-12-18 19:38:42 +01:00
2010-06-14 10:23:59 +02:00
-yes: richiesto se l'opzione option weechat.look.confirm_quit è abilitata
argomenti: testo inviato con il segnale "quit"
(ad esempio il plugin irc usa questo testo per inviare il messaggio di uscita al server)
2009-12-04 12:11:12 +01:00
........................................
• *`/reload`* `[file [file....]]`::
........................................
ricarica i file di configurazione da disco
file: file di configurazione da ricaricare
Senza argomento, tutti i file (WeeChat e plugin) vengono ricaricati.
........................................
• *`/save`* `[file [file....]]`::
........................................
salva i file di configurazione su disco
file: file di configurazione da salvare
Senza argomento, tutti i file (WeeChat e plugin) verranno salvati.
........................................
• *`/set`* `[opzione [valore]]`::
........................................
imposta le opzioni di configurazione
opzione: nome dell'opzione
valore: nuovo valore per l'opzione
Il nuovo valore può essere, in base al tipo di variabile:
bool: on, off oppure alterna
intero: numero, ++numero o --numero
stringa: qualsiasi stringa ("" per le stringhe vuote)
colore: nome colore, ++numero o --numero
Per tutti i tipi, è possibile utilizzare un valore nullo per eliminare il valore dell'opzione (non definito). Funziona solo per alcune variabili speciali dei plugin.
........................................
• *`/unset`* `[opzione]`::
........................................
2010-04-15 11:39:57 +02:00
annulla/ripristina opzione
2009-12-04 12:11:12 +01:00
2010-04-15 11:39:57 +02:00
opzione: nome di un'opzione (può cominciare o finire con "*" per il ripristino di più opzioni, attenzione!)
2009-12-04 12:11:12 +01:00
2010-04-15 11:39:57 +02:00
A seconda dell'opzione, essa viene ripristinata (per le opzioni standard) o rimossa (per le impostazioni opzionali, come i valori del server)
2009-12-04 12:11:12 +01:00
........................................
• *`/upgrade`* `[percorso_del_binario]`::
........................................
aggiorna WeeChat senza disconnettere dai server
2010-09-22 21:44:07 +02:00
percorso_del_binario: percorso del binario di WeeChat (quello corrente è il predefinito)
2010-08-14 12:04:58 +02:00
2010-09-22 21:44:07 +02:00
Questo comando esegue nuovamente un binario WeeChat, perciò deve essere stato compilato o installato con un gestore di pacchetti prima di eseguire questo comando.
2010-10-11 16:34:01 +02:00
2010-09-22 21:44:07 +02:00
Il processo di aggiornamento è diviso in 4 fasi:
1. salvataggio della sessione in file per il core e i plugin (buffer, cronologia, ..)
2. disattivazione di tutti i plugin (salvataggio delle configurazioni .conf)
3. salvataggio della configurazione di WeeChat (weechat.conf)
4. esecuzione del nuovo binario di WeeChat.
2009-12-04 12:11:12 +01:00
........................................
2010-02-09 17:19:14 +01:00
• *`/uptime`* `[-o | -ol]`::
2009-12-04 12:11:12 +01:00
........................................
mostra l'uptime di WeeChat
2010-03-24 19:54:31 +01:00
-o: invia l'uptime al buffer corrente come input (stringa in inglese)
-ol: invia l'uptime al buffer corrente come input (stringa tradotta)
2009-12-04 12:11:12 +01:00
........................................
2010-02-09 17:19:14 +01:00
• *`/version`* `[-o | -ol]`::
2009-12-04 12:11:12 +01:00
........................................
mostra la versione e la data di compilazione di WeeChat
2010-03-24 19:54:31 +01:00
-o: invia la versione al buffer corrente come input (stringa inglese)
-ol: invia la versione al buffer corrente come input (stringa tradotta)
2009-12-04 12:11:12 +01:00
........................................
• *`/wait`* `numero[unità] comando`::
........................................
pianifica l'esecuzione di un comando
2010-03-24 19:54:31 +01:00
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 '/')
2009-12-04 12:11:12 +01:00
2010-03-24 19:54:31 +01:00
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)
2009-12-04 12:11:12 +01:00
2010-03-24 19:54:31 +01:00
Esempi:
entra nel canale tra 10 secondi:
2010-03-23 09:42:37 +01:00
/wait 10 /join #test
2010-03-24 19:54:31 +01:00
imposta assenza tra 15 minuti:
/wait 15m /away -all Sono assente
scrive ciao tra 2 minuti:
/wait 2m ciao
2009-12-04 12:11:12 +01:00
........................................
• *`/window`* `[list | -1 | +1 | b# | up | down | left | right | splith [pct] | splitv [pct] | resize pct | merge [all] | page_up | page_down | refresh | scroll | scroll_up | scroll_down | scroll_top | scroll_bottom | scroll_previous_highlight | scroll_next_highlight | zoom]`::
........................................
gestione finestre
2010-04-08 10:24:05 +02:00
list: elenca le finestre aperte (senza argomento, questa lista viene visualizzata)
-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'evento precedente
scroll_next_highlight: passa all'evento successivo
zoom: ingrandimento sulla finestra
2009-12-04 12:11:12 +01:00
2010-04-08 10:24:05 +02:00
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
2009-12-04 12:11:12 +01:00
2010-04-08 10:24:05 +02:00
Esempi:
salta alla finestra che visualizza il buffer #1:
2010-03-23 09:42:37 +01:00
/window b1
2010-04-08 10:24:05 +02:00
scorre di due righe in alto:
2010-03-23 09:42:37 +01:00
/window scroll -2
2010-04-08 10:24:05 +02:00
scorre all'indietro di due giorni:
2010-03-23 09:42:37 +01:00
/window scroll -2d
2010-04-08 10:24:05 +02:00
scorre all'inizio del giorno attuale:
/window scroll -d
2009-12-04 12:11:12 +01:00
........................................