FAQ di WeeChat (Domande Frequenti)

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

Because WeeChat is very light and brings innovating features.

More info on the WeeChat features page ^↗.

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

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.

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

You can install WeeChat with this command:

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 ^↗.

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

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.

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:

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

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.

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

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

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.

The plugin buflist ^↗ is loaded and enabled by default.

To limit size of bar:

To move bar to 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.

You can browse all buflist options with the command:

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

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.

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

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

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:

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

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.

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:

Dimensione massima a 2:

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:

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:

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.

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

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

To make opening URLs easier, you can:

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

Una soluzione alternativa è usare uno script:

Sure it is possible:

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:

In WeeChat, the new value is immediately used:

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

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

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

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.

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.

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

Important:

To send the code when WeeChat is starting:

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

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

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:

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:

Terminal 80x25, with default configuration:

Terminal 80x25, after changes:

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

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.

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.

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:

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

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.

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:

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:

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

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

Esempio:

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

Per prima cosa provare ad abilitare il mouse:

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:

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

Per disabilitare il mouse nel terminale:

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.

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

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

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

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

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

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:

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

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

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

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

For all servers:

For a single server:

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

Or another channel:

There are also scripts:

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

See User’s guide / IRC smart filter ^↗.

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.

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:

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

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

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

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:

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

Per launcher.pl, bisogna impostare il comando:

Altri script correlati:

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:

For all channels on server "libera":

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

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

Si deve impostare in questo modo:

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.

First check questions about TLS connection in this FAQ.

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

And update scripts again in WeeChat:

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

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:

You have to reload the spell plugin:

You can, but this is NOT recommended.

Command /set in WeeChat is recommended:

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

Esistono diversi trucchi per ottimizzare l’uso della memoria:

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

Disable IRC part and quit messages:

Disable answers to all CTCP queries:

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

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

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:

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.

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.

Steps:

See this page ^↗.

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

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

WeeChat runs fine on most Linux/BSD distributions, GNU/Hurd, Mac OS 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.

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

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

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