# FAQ di WeeChat (Domande Frequenti)

Sébastien Helleu
flashcode@flashtux.org
versione 4.7.1

## 1. Generale

### 1.1. Da dove viene il nome "WeeChat"?

"Wee" è un acronimo ricorsivo che sta per "Wee Enhanced Environment". Quindi il nome completo è "Wee Enhanced Envoronment for Chat."

"Wee" significa anche "molto piccolo" (e sì, c’è un altro significato, ma non c’entra con WeeChat!).

### 1.2. Perché scegliere WeeChat? X-Chat ed Irssi vanno così bene…​

Because WeeChat is very light and brings innovating features.

More info on the WeeChat features page ↗.

## 2. Compilazione / installazione

### 2.1. Ho sentito parlare di molte interfacce per WeeChat. Come si possono compilare/utilizzare?

Some remote GUIs are available, see the remote interfaces page ↗.

### 2.2. Non è possibile compilare WeeChat dopo aver clonato il repository git, perché?

WeeChat must be compiled with CMake.

Please follow build instructions ↗ and ensure all required dependencies are installed.

If you still have issues, please report them to the developers.

### 2.3. How can I install WeeChat on macOS?

It is recommended to use Homebrew ↗, you can get help with:

    brew info weechat

You can install WeeChat with this command:

    brew install weechat

### 2.4. Ho avviato WeeChat, ma mi sono perso, cosa posso fare?

Per l’aiuto digitare `/help`. Per l’aiuto su un comando, digitare `/help comando`. Keys ↗ and commands ↗ are listed in documentation.

It’s recommended for new users to read the Quickstart guide ↗.

## 3. Visualizzare

### 3.1. Non riesco a vedere alcuni caratteri con gli accenti, cosa posso fare?

It’s a common issue with a variety of causes, please read carefully and check ALL solutions below:

- verificare che weechat abbia un link con libncursesw (attenzione: necessario su molte distribuzioni ma non tutte): `ldd /path/di/weechat`

- verificare che il plugin "charset" sia caricato con il comando `plugin` (se non lo è, probabilmente è necessario il pacchetto "weechat-plugins")

- verificare l’output del comando `/charset` (sul buffer core). Dovrebbero essere visualizzati ISO-XXXXXX oppure UTF-8 per il set caratteri del terminale. Se invece compaiono ANSI_X3.4-1968 o altri valori, il locale probabilmente non è esatto.
  To fix your locale, check the installed locales with `locale -a` and set an appropriate value in $LANG, for example: `export LANG=en_US.UTF-8`.

- impostare il valore di decodifica globale, per esempio: `/set charset.default.decode = ISO-8859-15`

- se si usa la localizzazione UTF-8:

  - verificare che il proprio terminale sia compatibile con UTF-8 (quello raccomandato è rxvt-unicode)

  - se si sta utilizzando screen, verificare che sia in esecuzione in modalità UTF-8 ("`defutf8 on` nel file ~/.screenrc` oppure `screen -U` per avviare screen)

- check that option weechat.look.eat_newline_glitch ↗ is off (this option may cause display bugs)

Nota | Si raccomanda il locale UTF-8 per WeeChat. Se si utilizza ISO o un altro locale, per favore verificare che tutte le impostazioni (terminale, screen) siano ISO e non UTF-8.

### 3.2. Some unicode chars are displayed in terminal but not in WeeChat, why?

This may be caused by a libc bug in function wcwidth, which should be fixed in glibc 2.22 (maybe not yet available in your distribution).

There is a workaround to use the fixed wcwidth function: https://blog.nytsoi.net/2015/05/04/emoji-support-for-weechat ↗.

See this bug report ↗ for more information.

### 3.3. Barre come quella del titolo e di stato non sono complete, il colore di sfondo si ferma dopo il testo, perché?

Potrebbe essere causato da un valore errato della variabile TERM nella propria shell (consultare l’output di `echo $TERM` nel terminale).

A seconda di dove viene eseguito WeeChat, si dovrebbe avere:

- if WeeChat runs locally or on a remote machine without screen nor tmux, it depends on the terminal used: xterm, xterm-256color, rxvt-unicode, rxvt-256color, …​

- if WeeChat runs under screen, you should have screen or screen-256color,

- if WeeChat runs under tmux, you should have tmux, tmux-256color, screen or screen-256color.

Se necessario, correggere la variabile TERM: `export TERM="xxx"`.

### 3.4. Quando uso weechat con screen/tmux, appaiono dei caratteri strani, come posso risolvere il problema?

Potrebbe essere causato da un valore errato della variabile TERM nella propria shell (consultare l’output di `echo $TERM` nel terminale al di fuori di screen/tmux).
Per esempio, xterm-color potrebbe visualizzare questo tipo di caratteri strani, è meglio utilizzare xterm che funziona (come molti altri valori).
Se necessario, correggere la variabile TERM: `export TERM="xxx"`.

If you are using gnome-terminal, check that the option "Ambiguous-width characters" in menu Preferences/Profile/Compatibility is set to `narrow`.

### 3.5. Ho compilato WeeChat su macOS, e vedo "(null)" dovunque sullo schermo, cosa non va?

Se ncursesw è stato compilato manualmente, utilizzare ncurses standard (incluse col sistema).

Inoltre, su macOS, si raccomanda di installare WeeChat con il gestore pacchetti Homebrew.

### 3.6. Ho sentito parlare di "buffer" e "finestre", qual è la differenza?

Un buffer è composto da un numero, un nome, delle righe visualizzate (e qualche altro dato).

Una finestra (o window) è un’aread dello schermo in cui viene visualizzato un buffer. È possibile dividere lo schermo in più finestre.

Each window displays one buffer, or a set of merged buffers. A buffer can be hidden (not displayed by a window) or displayed by one or more windows.

### 3.7. Come si può visualizzare la lista dei buffer sulla sinistra?

The plugin buflist ↗ is loaded and enabled by default.

To limit size of bar:

    /set weechat.bar.buflist.size_max 15

To move bar to bottom:

    /set weechat.bar.buflist.position bottom

To scroll the bar: if mouse is enabled (key: `Alt`+`m`), you can scroll the bar with your mouse wheel.

Default keys to scroll buflist bar are `F1` (or `Ctrl`+`F1`), `F2` (or `Ctrl`+`F2`), `Alt`+`F1` and `Alt`+`F2`.

### 3.8. How can I customize the list of buffers list, like the color of the active buffer?

You can browse all buflist options with the command:

    /fset buflist

The background of the active buffer is blue by default, you can change it like this, for example to `red`:

    /set buflist.format.buffer_current "${color:,red}${format_buffer}"

Nota | There’s a comma before the color name "red" because it is used as the background, not the text color. You can also use any numeric color instead of `red`, like `237` for dark gray.

The buflist plugin provides lot of options that you can customize, please read the help on each option.

There’s also a wiki page ↗ with examples of advanced buflist configuration.

### 3.9. Come si può ridurre la lunghezza dei nick o rimuovere l’allineamento nella finestra di chat?

Per ridurre la lunghezza massima dei nick nell’area di chat:

    /set weechat.look.prefix_align_max 15

To remove nick alignment: Per rimuovere l’allineamento dei nick:

    /set weechat.look.prefix_align none

### 3.10. What does the [H: 3(1,8), 2(4)] in status bar mean?

This is called the "hotlist", a list of buffers with the number of unread messages, by order: highlights, private messages, messages, other messages (like join/part).
The number of "unread message" is the number of new messages displayed/received since you visited the buffer.

In the example `[H: 3(1,8), 2(4)]`, there are:

- 1 highlight and 8 unread messages on buffer #3,

- 4 unread messages on buffer #2.

The color of the buffer/counter depends on the type of message, default colors are:

- highlight: `lightmagenta` / `magenta`

- private message: `lightgreen` / `green`

- message: `yellow` / `brown`

- other message: `default` / `default` (color of text in terminal)

These colors can be changed with the options weechat.color.status_data_* (buffers) and weechat.color.status_count_* (counters).
Other hotlist options can be changed with the options weechat.look.hotlist_*.

See User’s guide / Screen layout ↗ for more info about the hotlist.

### 3.11. Come posso usare la riga di comando con più di una riga?

L’opzione size nella barra di input può essere impostata a un valore maggiore di uno (il valore predefinito per la dimensione fissa è 1) oppure 0 per la dimensione dinamica, e poi l’opzione size_max imposta la dimensione massima (0 = nessun limite).

Esempio con la dimensione dinamica:

    /set weechat.bar.input.size 0

Dimensione massima a 2:

    /set weechat.bar.input.size_max 2

### 3.12. È possibile mostrare solo una barra di input per tutte le finestre (dopo lo split)?

Sì, bisogna creare una barra con il tipo "root" (con un elemento per sapere in quale finestra ci si trova), poi eliminare la barra di input corrente.

Ad esempio:

    /bar add rootinput root bottom 1 0 [buffer_name]+[input_prompt]+(away),[input_search],[input_paste],input_text
    /bar del input

Se non si è soddisfatti del risultato, basta eliminare la nuova barra, WeeChat creerà automaticamente la barra predefinita "input" se l’elemento "input_text" non viene usato da un’altra barra:

    /bar del rootinput

### 3.13. Come posso copiare/incollare testo senza incollare la lista nick?

You can use the bare display (default key: `Alt`+`l` (`L`)), which shows just the contents of the currently selected window, without any formatting.

È possibile usare un terminale con la selezione rettangolare (come rxvt-unicode, konsole, gnome-terminal, …​). La combinazione tasti in generale è `Ctrl` + `Alt` + selezione mouse.

You can toggle nicklist and make it visible only when needed, with key `Alt`+`Shift`+`N`.

Un’altra soluzione è spostare la lista nick in alto o in basso, per esempio:

    /set weechat.bar.nicklist.position top
    /set weechat.bar.nicklist.size_max 8

### 3.14. Come posso cliccare su URL lunghi (più di una riga)?

You can use the bare display (default key: `Alt`+`l` (`L`)).

To make opening URLs easier, you can:

- toggle nicklist and make it visible only when needed, with key `Alt`+`Shift`+`N`

- move nicklist to top:

    /set weechat.bar.nicklist.position top
    /set weechat.bar.nicklist.size_max 8

- disable alignment for multiline words:

    /set weechat.look.align_multiline_words off

- or for all wrapped lines:

    /set weechat.look.align_end_of_lines time

You can enable option "eat_newline_glitch", so that new line char is not added at the end of each line displayed (it will not break URL selection):

    /set weechat.look.eat_newline_glitch on

Importante | Questa opzione può causare bug di visualizzazione. Se si dovessero verificare tali problemi, è necessario disabilitare questa opzione.

Una soluzione alternativa è usare uno script:

    /script search url

### 3.15. Voglio cambiare la lingua utilizzata da WeeChat per i messaggi, ma senza uscire da WeeChat, è possibile?

Sure it is possible:

    /set env LANG it_IT.UTF-8
    /upgrade

### 3.16. How can I change the timezone?

There is no option in WeeChat to change the timezone, the environment variable `TZ` must be set to the appropriate value.

In your shell initialization file or on command line, before starting WeeChat:

    export TZ=Europe/Rome

In WeeChat, the new value is immediately used:

    /set env TZ Europe/Rome

### 3.17. Come posso usare 256 colori in WeeChat?

Per prima cosa verificare che la variabile di ambiente TERM sia corretta, i valori raccomandati sono:

- con screen: screen-256color

- under tmux: screen-256color or tmux-256color

- outside screen/tmux: xterm-256color, rxvt-256color, putty-256color, …​

Nota | Potrebbe essere necessario installare il pacchetto "ncurses-term" per usare questi valori nella variabile TERM.

Se si sta utilizzando screen, è possibile aggiungere questa riga al proprio ~/.screenrc:

    term screen-256color

If your TERM variable has wrong value and that WeeChat is already running, you can change it with these two commands:

    /set env TERM screen-256color
    /upgrade

You can use any color number in options (optional: you can add color aliases with command `/color`).

Please read the User’s guide / Colors ↗ for more information about colors management.

### 3.18. Come posso cercare testo nel buffer (come /lastlog con irssi)?

Il tasto predefinito è `Ctrl`+`r` (il comando è: `/input search_text_here`). E per passare alle notifiche: `Alt`+`p` / `Alt`+`n`.

See User’s guide / Key bindings ↗ for more info about this feature.

### 3.19. How can I execute commands when terminal gets/loses focus?

You must enable the focus events with a special code sent to terminal.

Important:

- You must use a modern xterm-compatible terminal.

- Additionally, it seems to be important that your value of the TERM variable equals to xterm or xterm-256color.

- If you use tmux, you must additionally enable focus events by adding `set -g focus-events on` to your .tmux.conf file.

- This does not work under screen.

To send the code when WeeChat is starting:

    /set weechat.startup.command_after_plugins "/print -stdout \033[?1004h\n"

And then you bind two keys for the focus (replace the `/print` commands by the commands of your choice):

    /key bind meta-[I /print -core focus
    /key bind meta-[O /print -core unfocus

For example to mark buffers as read when the terminal loses the focus:

    /key bind meta-[O /allbuf /buffer set unread

### 3.20. When WeeChat is running in screen, pasting text in another screen window adds ~0 and ~1 around text, why?

This is caused by the bracketed paste option which is enabled by default, and not properly handled by screen in other windows.

You can just disable bracketed paste mode:

    /set weechat.look.paste_bracketed off

### 3.21. How can I customize display for very small terminal size (like 80x25), to not waste space?

You can remove side bars (buflist and nicklist), change time format to display only hours and minutes, disable alignment of messages and set a char for nick prefix/suffix:

    /set buflist.look.enabled off
    /bar hide nicklist
    /set weechat.look.buffer_time_format "%H:%M"
    /set weechat.look.prefix_align none
    /set weechat.look.align_end_of_lines prefix
    /set weechat.look.nick_suffix ">"
    /set weechat.look.nick_prefix "<"

Terminal 80x25, with default configuration:

    ┌────────────────────────────────────────────────────────────────────────────────┐
    │1.local     │Welcome on WeeChat channel!                                        │
    │  weechat   │16:27:16        --> | FlashCode (~flashcode@localhost)  │@FlashCode│
    │2.  #weechat│                    | has joined #weechat               │ bob      │
    │            │16:27:16         -- | Mode #weechat [+nt] by hades.arpa │          │
    │            │16:27:16         -- | Channel #weechat: 1 nick (1 op, 0 │          │
    │            │                    | voices, 0 normals)                │          │
    │            │16:27:18         -- | Channel created on Sun, 22 Mar    │          │
    │            │                    | 2020 16:27:16                     │          │
    │            │17:02:28        --> | bob (~bob_user@localhost) has     │          │
    │            │                    | joined #weechat                   │          │
    │            │17:03:12 @FlashCode | hi bob, you're the first user     │          │
    │            │                    | here, welcome on the WeeChat      │          │
    │            │                    | support channel!                  │          │
    │            │17:03:33        bob | hi FlashCode                      │          │
    │            │                                                        │          │
    │            │                                                        │          │
    │            │                                                        │          │
    │            │                                                        │          │
    │            │                                                        │          │
    │            │                                                        │          │
    │            │                                                        │          │
    │            │                                                        │          │
    │            │                                                        │          │
    │            │[17:04] [2] [irc/local] 2:#weechat(+nt){2}                         │
    │            │[@FlashCode(i)] █                                                  │
    └────────────────────────────────────────────────────────────────────────────────┘

Terminal 80x25, after changes:

    ┌────────────────────────────────────────────────────────────────────────────────┐
    │Welcome on WeeChat channel!                                                     │
    │16:27 --> FlashCode (~flashcode@localhost) has joined #weechat                  │
    │16:27 -- Mode #weechat [+nt] by hades.arpa                                      │
    │16:27 -- Channel #weechat: 1 nick (1 op, 0 voices, 0 normals)                   │
    │16:27 -- Channel created on Sun, 22 Mar 2020 16:27:16                           │
    │17:02 --> bob (~bob_user@localhost) has joined #weechat                         │
    │17:03 <@FlashCode> hi bob, you're the first user here, welcome on the WeeChat   │
    │      support channel!                                                          │
    │17:03 <bob> hi FlashCode                                                        │
    │                                                                                │
    │                                                                                │
    │                                                                                │
    │                                                                                │
    │                                                                                │
    │                                                                                │
    │                                                                                │
    │                                                                                │
    │                                                                                │
    │                                                                                │
    │                                                                                │
    │                                                                                │
    │                                                                                │
    │                                                                                │
    │[17:04] [2] [irc/local] 2:#weechat(+nt){2}                                      │
    │[@FlashCode(i)] █                                                               │
    └────────────────────────────────────────────────────────────────────────────────┘

## 4. Associazioni dei tasti

### 4.1. Alcuni tasti meta (alt + tasto) non funzionano, perché?

Se si utilizzano terminali come xterm o uxterm, alcuni tasti meta non funzionano per default. È possibile aggiungere una riga nel file ~/.Xresources:

- per xterm:

    XTerm*metaSendsEscape: true

- per uxterm:

    UXTerm*metaSendsEscape: true

Al termine, ricaricare la configurazione (`xrdb -override ~/.Xresources`) o riavviare X.

If you are using the macOS Terminal app, enable the option "Use option as meta key" in menu Settings/Keyboard. And then you can use the `Option` key as meta key.

### 4.2. Some keys including Enter are not working, why?

If you run a WeeChat < 4.0.0 with configuration files created by any version ≥ 4.0.0, the keys names become invalid and many keys won’t work at all.
To repair them, exit WeeChat, remove all sections `[key*]` from weechat.conf and start WeeChat again: all default keys will be created.

### 4.3. Key F11 maximizes the terminal window, how can I scroll up the nicklist?

The key `F11` is commonly used by terminals to maximize the window, and `F11`/`F12` are the default keys in WeeChat to scroll the nicklist.

You can bind other keys, for example `Shift`+`F11` and `Shift`+`F12`, with WeeChat ≥ 4.0.0:

    /key bind shift-f11 /bar scroll nicklist * -100%
    /key bind shift-f12 /bar scroll nicklist * +100%

Other solution is to enable mouse (key: `Alt`+`m`) and scroll with the mouse wheel (see also questions about mouse).

### 4.4. Come posso personalizzare le associazioni dei tasti?

Le associazioni dei tasti sono personalizzabili con il comando `/key`.

Il tasto predefinito `Alt`+`k` consente di registrare il codice tasto ed inserirlo nella riga di comando.

### 4.5. Qual è il tasto per passare al buffer 11 (o superiore)?

Il tasto è `Alt`+`j` seguito da due numeri, ad esempio `Alt`+`j`, `1`, `1` per passare al buffer 11.

È possibile associare un tasto, ad esempio:

    /key bind meta-q /buffer *11

List of default keys is in User’s guide / Key bindings ↗.

To jump to buffers with number ≥ 100, you could define a trigger and then use commands like `/123` to jump to buffer #123:

    /trigger add numberjump modifier "2000|input_text_for_buffer" "${tg_string} =~ ^/[0-9]+$" "=\/([0-9]+)=/buffer *${re:1}=" "" "" "none"

For an easy jump to buffers, you can also install the go.py script:

    /script install go.py

### 4.6. Come si può usare la cronologia globale (invece di quella del buffer) con i tasti su e giù?

È possibile associare i tasti su e giù alla cronologia globale (quelli predefiniti sono `Ctrl`+`↑` e `Ctrl`+`↓`).

Esempio:

    /key bind up /input history_global_previous
    /key bind down /input history_global_next

With WeeChat ≤ 3.8, you must use the raw key code (press `Alt`+`k` then key to display its code):

    /key bind meta2-A /input history_global_previous
    /key bind meta2-B /input history_global_next

## 5. Mouse

### 5.1. Il mouse non funziona affatto, cosa posso fare?

Per prima cosa provare ad abilitare il mouse:

    /mouse enable

Se il mouse ancora non funziona, verificare la variabile TERM nella propria shell (consultare l’output di `echo $TERM` nel terminale). In base al terminale usato, il mouse potrebbe non essere supportato.

È possibile testare il supporto al mouse nel terminale:

    printf '\033[?1002h'

E poi cliccare sul primo carattere del terminale (in alto a sinistra. Dovrebbe essere possibile vedere !!#!!".

Per disabilitare il mouse nel terminale:

    printf '\033[?1002l'

### 5.2. Il mouse non fa nulla per X o Y maggiori di 94 (o 222), perché?

Alcuni terminale inviano solo caratteri ISO per le coordinate del mouse, per cui non funziona per X/Y maggiori di 94 (o 222).

Bisogna utilizzare un terminale che supporti le coordinate UTF-8 per il mouse, come rxvt-unicode.

### 5.3. Come posso selezionare o incollare del testo nel terminale quando il mouse è abilitato in WeeChat?

Quando il mouse è abilitato in WeeChat, è possibile usare il modificatore `Shift` per selezionare o cliccare nel terminale, come se il mouse fosse disabilitato (in alcuni terminali come iTerm, bisogna usare `Alt` invece di `Shift`).

## 6. IRC

### 6.1. Ho dei problemi nella connessione al server con TLS, cosa posso fare?

If you are using macOS, you must install `openssl` from Homebrew. A CA file will be bootstrapped using certificates from the system keychain.

Se si verificano problemi con l’handshake gnutls, si può cercare di usare una chiave Diffie-Hellman più piccola (la predefinita è 2048):

    /set irc.server.example.tls_dhkey_size 1024

Se si verificano errori con i certificati, è possibile disabilitare "tls_verify" (attenzione, la connessione in questo modo sarà meno sicura):

    /set irc.server.example.tls_verify off

If the server has an invalid certificate and you know what the certificate should be, you can specify the fingerprint (SHA-512, SHA-256 or SHA-1):

    /set irc.server.example.tls_fingerprint 0c06e399d3c3597511dc8550848bfd2a502f0ce19883b728b73f6b7e8604243b

### 6.2. Alla connessione al server con TLS ottengo solo l’errore "handshake TLS fallito", cosa posso fare?

Provare una stringa di priorità diversa, sostituendo "xxx" con il nome del server:

    /set irc.server.xxx.tls_priorities "NORMAL:%COMPAT"

### 6.3. Come ci si può connettere al server libera via TLS?

Check that you have certificates installed on your system, this is commonly provided by the package "ca-certificates".

Impostare la porta del server, TLS, poi riconnettersi:

    /set irc.server.libera.addresses "irc.libera.chat/6697"
    /set irc.server.libera.tls on
    /connect libera

### 6.4. How to connect to a server that requires "oauth"?

Some servers like twitch require oauth to connect.

The oauth is simply a password with the value "oauth:XXXX".

You can add such server and connect with following commands (replace name and address by appropriate values):

    /server add name irc.server.org -password=oauth:XXXX
    /connect name

### 6.5. Come posso essere identificato prima di entrare in un canale?

Se il server supporta SASL, dovrebbe essere utilizzato invece di inviare il comando di autenticazione con nickserv, ad esempio:

    /set irc.server.libera.sasl_username "mynick"
    /set irc.server.libera.sasl_password "xxxxxxx"

Se il server non supporta SASL, è possibile aggiungere un ritardo (tra il comando e l’ingresso nei canali):

    /set irc.server.libera.command_delay 5

### 6.6. How can I add/remove channels from autojoin option?

With WeeChat ≥ 3.5, you can automatically record the channels you manually join and part in the "autojoin" server option.

For all servers:

    /set irc.server_default.autojoin_dynamic on

For a single server:

    /set irc.server.libera.autojoin_dynamic on

You can also add the current channel in the "autojoin" server option using the `/autojoin` command:

    /autojoin add

Or another channel:

    /autojoin add #test

There are also scripts:

    /script search autojoin

### 6.7. Qual è la differenza tra i comandi /ignore e /filter?

Il comando `/ignore` è un comando IRC, per cui è utile solo per i buffer IRC (server e canali). Consente di ignorare alcuni nick o nomi host di utenti per un server o per un canale (il comando non viene applicato sul contenuto dei messaggi). I messaggi corrispondenti vengono eliminati dal plugin IRC prima di essere visualizzati (so you’ll never see them, and can’t be recovered by removing the ignore).

The `/filter` command is a WeeChat core command, so it applies to any buffer. Esso consente di filtrare alcune righe nei buffer mediante tag o espressioni regolari per il prefisso ed il contenuto delle righe. Le righe filtrate vengono solo nascoste, non eliminate, ed è possibile visualizzarle se i filtri vengono disabilitati (il comando predefinito `Alt`+`=` abilita/disabilita i filtri).

### 6.8. How can I filter join/part/quit and other annoying messages on IRC channels?

See User’s guide / IRC smart filter ↗.

### 6.9. Come posso filtrare i messaggi visualizzati all’ingresso su un canale IRC?

You can choose which messages are displayed when joining a channel with the option irc.look.display_join_message (see `/help irc.look.display_join_message` for more info).

To hide messages (but keep them in buffer), you can filter them using the tag (for example irc_329 for channel creation date). See `/help filter` for help with filters.

### 6.10. Come posso filtrare i messaggi voice (ad esempio su server Bitlbee)?

Non è semplice filtrare i messaggi voice, perché la modalità voice può essere impostata in altri modi nello stesso messaggio IRC.

Se si vuole, è probabilmente perché Bitlbee utilizza il voice per visualizzare gli utenti assenti, e si viene tempestati di messaggi voice. Perciò, è possibile modificare questo comportamento e consentire a WeeChat di utilizzare un colore speciale per i nick assenti nella lista nick.

Per versioni di Bitlbee ≥ 3, sul canale &bitlbee digitare:

    channel set show_users online,away

Per versioni precedenti di Bitlbee, sul canale &bitlbee digitare:

    set away_devoice false

Per verificare i nick assenti in WeeChat, consultare la domanda relativa a nick assenti.

Se davvero di desidera filtrare i messaggi voice, è possibile usare questo comando, ma non funzionerà perfettamente (funziona se la prima modalità modificata è il voice):

    /filter add hidevoices * irc_mode (\+|\-)v

### 6.11. Come posso vedere i nick assenti nella lista nick?

È necessario impostare l’opzione irc.server_default.away_check su un valore positivo (minuti tra ogni controllo dei nick assenti).

L’opzione irc.server_default.away_check_max_nicks limita il controllo delle assenze solo sui canali più piccoli.

Ad esempio, per controllare ogni 5 minuti per i nick assenti, sui canali con massimo 25 nick:

    /set irc.server_default.away_check 5
    /set irc.server_default.away_check_max_nicks 25

### 6.12. Come posso essere avvisato quando qualcuno mi cerca in un canale?

There is a default trigger "beep" which sends a BEL to the terminal on a highlight or private message. Thus you can configure your terminal (or multiplexer like screen/tmux) to run a command or play a sound when a BEL occurs.

Or you can add a command in "beep" trigger:

    /set trigger.trigger.beep.command "/print -beep;/exec -bg /path/del/comando argomenti"

With an older WeeChat, you can use a script like beep.pl or launcher.pl.

Per launcher.pl, bisogna impostare il comando:

    /set plugins.var.perl.launcher.signal.weechat_highlight "/path/del/comando argomenti"

Altri script correlati:

    /script search notify

### 6.13. How can I disable highlights for specific nicks?

You can use the hotlist_max_level_nicks_add ↗ buffer property to set the max hotlist level for some nicks, per buffer, or per group of buffers (like IRC servers).

To only disable highlights, you’d have to set it to 2.

For the current buffer:

    /buffer setauto hotlist_max_level_nicks_add joe:2,mike:2

For all channels on server "libera":

    /set weechat.buffer.irc.libera.*.hotlist_max_level_nicks_add joe:2,mike:2

### 6.14. Come si può modificare il buffer destinazione per i comandi sui buffer uniti (come i buffer con i server)?

Il tasto predefinito è `Ctrl`+`x` (il comando è: `/buffer switch`).

## 7. Plugin / script

### 7.1. Uso OpenBSD e WeeChat non carica nessun plugin, cosa c’è che non va?

In OpenBSD, i nomi file dei plugin finiscono con ".so.0.0" (".so" in Linux).

Si deve impostare in questo modo:

    /set weechat.plugin.extension ".so.0.0"
    /plugin autoload

### 7.2. How can I install scripts? Are scripts compatible with other IRC clients?

You can use the command `/script` to install and manage scripts (see `/help script` for help).

Gli script non sono compatibili con altri client IRC.

### 7.3. The command "/script update" cannot read scripts, how to fix that?

First check questions about TLS connection in this FAQ.

If still not working, try to manually delete the scripts file (in your shell):

    rm ~/.cache/weechat/script/plugins.xml.gz

Nota | If you are not using the XDG directories, the path could be: ~/.weechat/script/plugins.xml.gz.

And update scripts again in WeeChat:

    /script update

If you still have an error, then you must disable the automatic update of file in WeeChat and download the file manually outside WeeChat (that means you’ll have to update manually the file yourself to get updates):

- in WeeChat:

    /set script.scripts.cache_expire -1

- in your shell, with curl installed:

    cd ~/.cache/weechat/script
    curl -O https://weechat.org/files/plugins.xml.gz

If you’re running macOS and the downloaded file has a size of 0 bytes, try to set this variable in your shell initialization file or on command line, before starting WeeChat:

    export OBJC_DISABLE_INITIALIZE_FORK_SAFETY=YES

### 7.4. I installed aspell dictionaries on my system, how can I use them without restarting WeeChat?

You have to reload the spell plugin:

    /plugin reload spell

## 8. Impostazioni

### 8.1. Can I edit configuration files (*.conf) by hand?

You can, but this is NOT recommended.

Command `/set` in WeeChat is recommended:

- You can complete the name and value of option with `Tab` key (or `Shift`+`Tab` for partial completion, useful for the name).

- the value is checked, a message is displayed in case of error

- the value is used immediately, you don’t need to restart anything

If you still want to edit files by hand, you should be careful:

- if you put an invalid value for an option, WeeChat will display an error on load and discard the value (the default value for option will be used)

- if WeeChat is running, you’ll have to issue the command `/reload`, and if some settings were changed but not saved with `/save`, you will lose them

### 8.2. Come posso ottimizzare WeeChat per poter utilizzare meno memoria?

Esistono diversi trucchi per ottimizzare l’uso della memoria:

- utilizzare l’ultima versione stabile (si suppone che abbia meno falle di memoria rispetto le versioni precedenti)

- non caricare alcuni plugin se non vengono utilizzati, ad esempio: buflist, fifo, logger, perl, python, ruby, lua, tcl, guile, javascript, php, spell, xfer (usato per DCC). See `/help weechat.plugin.autoload`.

- caricare solo gli script veramente necessari

- Do not load system certificates if TLS is NOT used: turn off this option: weechat.network.gnutls_ca_system.

- ridurre il valore dell’opzione weechat.history.max_buffer_lines_number oppure impostare il valore dell’opzione weechat.history.max_buffer_lines_minutes

- ridurre il valore dell’opzione weechat.history.max_commands

### 8.3. How can I tweak WeeChat to use less CPU?

You can follow same tips as for memory, and these ones:

- hide "nicklist" bar: `/bar hide nicklist` (key: `Alt`+`Shift`+`N`).

- Disable "buflist": `/buflist disable` (key: `Alt`+`Shift`+`B`).

- remove display of seconds in status bar time: `/set weechat.look.item_time_format "%H:%M"` (this is the default value)

- disable real time check of misspelled words in command line (if you enabled it): `/set spell.check.real_time off`

- set the TZ variable (for example: `export TZ="Europe/Paris"`), to prevent frequent access to file /etc/localtime

### 8.4. I am paranoid about security, which settings could I change to be even more secure?

Disable IRC part and quit messages:

    /set irc.server_default.msg_part ""
    /set irc.server_default.msg_quit ""

Disable answers to all CTCP queries:

    /set irc.ctcp.clientinfo ""
    /set irc.ctcp.source ""
    /set irc.ctcp.time ""
    /set irc.ctcp.version ""
    /set irc.ctcp.ping ""

With WeeChat < 4.1.0, other CTCP queries were replied by default and must be disabled as well:

    /set irc.ctcp.finger ""
    /set irc.ctcp.userinfo ""

Unload and disable auto-loading of "xfer" plugin (used for IRC DCC):

    /plugin unload xfer
    /set weechat.plugin.autoload "*,!xfer"

Define a passphrase and use secured data wherever you can for sensitive data like passwords: see `/help secure` and `/help` on options (if you can use secured data, it is written in the help). See also Guida per l’Utente / Secured data ↗.

For example:

    /secure passphrase xxxxxxxxxx
    /secure set libera_username username
    /secure set libera_password xxxxxxxx
    /set irc.server.libera.sasl_username "${sec.data.libera_username}"
    /set irc.server.libera.sasl_password "${sec.data.libera_password}"

### 8.5. I want to share my WeeChat configuration, what files should I share and what should I keep private?

You can share configuration files *.conf except the file sec.conf which contains your passwords ciphered with your passphrase.

Some other files may contain sensitive info like passwords (if they are not stored in sec.conf with the `/secure` command).

See the User’s guide / Files and directories ↗ for more information about configuration files.

### 8.6. I want to move my WeeChat to another device and keep my config, what should I copy?

First check directories used by WeeChat with this command: `/debug dirs`.
Directories home/config and home/data must be copied (all files and sub-directories).

For example if you’re using XDG directories (default with WeeChat ≥ 3.2), the directories should be `$HOME/.config/weechat` and `$HOME/.local/share/weechat`.
If you’re using a single directory (default with WeeChat < 3.2), the directory should be `$HOME/.weechat`.

Importante | The WeeChat version on the new device must be greater than or equal to the version on the initial device. Downgrading WeeChat configuration is NOT SUPPORTED and can break it, leading to unusable WeeChat.

Steps:

1. Quit Weechat: `/quit` (or `/upgrade -quit` if you want to resume the session, which includes content of all buffers).

2. Copy all directories, sub-directories and files to the new device, keeping same names and permissions.

3. Optional: copy any file outside these directories that you refer to in your configuration (it’s not recommended to use files outside WeeChat directories).

4. Start WeeChat on the new device: `weechat` (or `weechat --upgrade` if you saved the session).

## 9. Sviluppo

### 9.1. Come posso segnalare bug, richiedere nuove funzionalità o inviare patch?

See this page ↗.

### 9.2. Quando eseguo WeeChat in gdb, c’è un errore riguardo ai thread, cosa posso fare?

Quando viene eseguito WeeChat all’interno di gdb, potrebbe verificarsi questo errore:

    $ gdb /path/to/weechat
    (gdb) run
    [Thread debugging using libthread_db enabled]
    Cannot find new threads: generic error

Per correggerlo, è possibile eseguire gdb con questo comando (sostituire il path di libpthread e WeeChat con i path del proprio sistema):

    $ LD_PRELOAD=/lib/libpthread.so.0 gdb /path/to/weechat
    (gdb) run

### 9.3. Qual è la lista delle piattaforme supportate da WeeChat? Verrà effettuato il port su altri sistemi operativi?

WeeChat runs fine on most Linux/BSD distributions, GNU/Hurd, macOS and Windows (Cygwin and Windows Subsystem for Linux).

Facciamo del nostro meglio per portarlo su più piattaforme possibili. L’aiuto per gli OS che non abbiamo, e su cui testare WeeChat, è ben accetto.

### 9.4. Voglio aiutare gli sviluppatori di WeeChat. Cosa posso fare?

Ci sono molti compiti da fare (testing, scrittura del codice, documentazione, …​)

Please contact us via IRC or mail, look at support page ↗.

### 9.5. Posso donare denaro o altre cose agli sviluppatori di WeeChat?

You can give us money to help development. Details on donation page ↗.