# Poradnik użytkownika WeeChat

Sébastien Helleu
flashcode@flashtux.org
wersja 4.8.1

Ten dokument opisuje klienta rozmów WeeChat, będącego częścią WeeChat.

Najnowszą wersję tego dokumentu można znaleźć na tej stronie ↗.

## 1. Wprowadzenie

WeeChat (Wee Enhanced Environment for Chat) to darmowy klient rozmów, szybki i lekki, przeznaczony dla wielu systemów operacyjnych.

### 1.1. Cechy

Główne cechy to:

- wsparcie dla wielu protokołów (mainly IRC)

- połączenie z wieloma serwerami (z TLS, IPv6, proxy)

- mały, szybki i lekki

- konfigurowalny i rozszerzalny dzięki wtyczką i skryptom

- zgodny z RFC dla IRC 1459 ↗, 2810 ↗, 2811 ↗, 2812 ↗, 2813 ↗ i 7194 ↗

- proxy IRC i pośrednik dla WeeChat i zdalnych interfejsów

- wielo-platformowy (GNU/Linux, *BSD, macOS, Windows i inne)

- 100% GPL, darmowe oprogramowanie

Listę wszystkich cech i możliwości można znaleźć na tej stronie ↗.

### 1.2. Wymagania

Żeby zainstalować WeeChat, potrzebujesz:

- działający system GNU/Linux (z narzędziami kompilatora dla kompilacji ze źródeł), lub kompatybilny system

- przywileje roota (do instalacji w katalogu systemowym)

- niektóre biblioteki (zobacz zależności).

## 2. Instalacja

### 2.1. Pakiety binarne

Pakiety binarne dostępne są dla wielu dystrybucji, wliczając:

- Arch Linuxa: `pacman -S weechat`

- Cygwin (Windows): wybierz pakiet WeeChat w setup.exe

- Debiana/Ubuntu (lub dowolna kompatybilna): `apt-get install weechat-curses weechat-plugins`
  Najnowsze wersje i nocne buildy można znaleźć na stonie: Repozytoria Debiana ↗

- Fedora Core: `dnf install weechat`

- FreeBSD: `pkg install weechat`

- Gentoo: `emerge weechat`

- Mandrive/RedHata (lub dowolna kompatybilna): `rpm -i /path/to/weechat-x.y.z-1.i386.rpm`

- openSUSE: `zypper in weechat`

- Sourcemage: `cast weechat`

- macOS (za pomocą Homebrew ↗): `brew install weechat` (w razie problemów: `brew info weechat`)

Niektóre dodatkowe pakiety mogą okazać się przydatne, jak weechat-plugins.

Dla innych dystrybucji, poszukaj w dokumentacji instrukcji na temat instalacji pakietów.

### 2.2. Kontenery

Kontenery z WeeChat mogą być zbudowane lub zainstalowane bezpośrednio z Docker Hub ↗.
Więcej informacji można znaleźć w pliku README w repozytorium weechat-container ↗.

### 2.3. Pakiety źródłowe

WeeChat musi być kompilowany przy użyciu CMake.

Notka | Na macOS możesz użyć Homebrew ↗: `brew install --build-from-source weechat`.

#### Zależności

Poniższa tabela pokazuje listę pakietów wymaganych do skompilowania WeeChat:

Pakiet (1) | Wersja | Funkcje
--- | --- | ---
kompilator C (gcc / clang) |  | Kompilacja źródeł C.
cmake | ≥ 3.0 | Kompilacja.
pkgconf / pkg-config |  | Wykrywa zainstalowane biblioteki.
libncurses-dev |  | Interfejs ncurses.
libcurl4-gnutls-dev |  | Transfer URL.
libgcrypt20-dev |  | Zabezpieczone dane, uwierzytelnianie IRC SASL.
libgnutls28-dev | ≥ 2.2.0 (2) | Wtyczka IRC: wsparcie dla połączeń TLS, autentykacja IRC SASL (ECDSA-NIST256P-CHALLENGE). Wtyczka relay: wsparcie dla połączeń TLS.
zlib1g-dev |  | Wtyczka logger: kompresja rotowanych plików z logami (gzip). Wtyczka relay: kompresja wiadomości (WeeChat → klient) za pomocą zlib ↗ (protokoły api i weechat). Wtyczka script: odczyt repozytorium ze skryptami (gzip).

Notka | (1) Nazwa pochodzi z repozytorium dystrybucji Debian GNU/Linux Bookworm distribution, wersja i nazwa mogą się różnić dla innych dystrybucji. (2) GnuTLS ≥ 3.0.21 jest wymagany dla uwierzytelnienia IRC SASL za pomocą mechanizmu ECDSA-NIST256P-CHALLENGE.

The following table shows the list of packages that are optional to compile WeeChat:

Pakiet (1) | Wersja | Funkcje
--- | --- | ---
kompilator C++ (g++ / clang++) |  | Kompilacja i uruchamianie testów, wtyczka JavaScript.
gettext |  | Internacjonalizacja (tłumaczenie wiadomości; język bazowy to Angielski).
ca-certificates |  | Certyfikaty dla połączeń TLS.
libcjson-dev |  | Wtyczka relay: protokół "api" (HTTP REST API).
libzstd-dev | ≥ 0.8.1 | Wtyczka logger: kompresja rotowanych plików z logami (zstandard). Wtyczka relay: kompresja wiadomości (WeeChat → klient) za pomocą Zstandard ↗ (protokoły api i weechat).
libaspell-dev / libenchant-dev |  | Wtyczka spell.
python3-dev | ≥ 3.0 | Wtyczka python.
libperl-dev |  | Wtyczka perl.
ruby3.1, ruby3.1-dev | ≥ 1.9.1 | Wtyczka ruby.
liblua5.4-dev |  | Wtyczka lua.
tcl-dev | ≥ 8.5 | Wtyczka tcl.
guile-3.0-dev | ≥ 2.0 | Wtyczka guile (scheme).
libv8-dev | ≤ 3.24.3 | Wtyczka javascript.
php-dev | ≥ 7.0 | Wtyczka PHP.
libphp-embed | ≥ 7.0 | Wtyczka PHP.
libxml2-dev |  | Wtyczka PHP.
libargon2-dev |  | Wtyczka PHP (jeśli PHP ≥ 7.2).
libsodium-dev |  | Wtyczka PHP (jeśli PHP ≥ 7.2).
asciidoctor | ≥ 1.5.4 | Tworzenie strony man i dokumentacji.
ruby-pygments.rb |  | Dokumentacja budowania.
libcpputest-dev | ≥ 3.4 | Kompilacja i uruchamianie testów.

Notka | (1) Nazwa pochodzi z repozytorium dystrybucji Debian GNU/Linux Bookworm distribution, wersja i nazwa mogą się różnić dla innych dystrybucji.

Jeśli używasz dystrybujci bazującej na Debianie/Ubuntu, oraz jeśli posiadasz wpisy "deb-src" w pliku /etc/apt/sources.list, możesz zainstalować wszytkie zależności za pomocą jednej komendy:

    sudo apt-get build-dep weechat

#### Kompilacja

- Instalacja w katalogach systemowych (wymaga uprawnień użytkownika root):

    mkdir build
    cd build
    cmake ..
    make
    sudo make install

- Instalacja w wybranym katalogu (na przykład w katalogu domowym):

    mkdir build
    cd build
    cmake .. -DCMAKE_INSTALL_PREFIX=/ścieżka/do/katalogu
    make
    make install

Opcje mogą zostać przekazane do CMake, format `-DOPCJA=WARTOŚĆ`.

Lista dostępnych opcji:

Opcja | Wartość | Wartość domyślna | Opis
--- | --- | --- | ---
`CMAKE_BUILD_TYPE` | `Debug`, `Release`, `RelWithDebInfo`, `MinSizeRel` |  | Typ budowania pakietu: `Debug` (lub `RelWithDebInfo`) jest zalecany dla wersjrozwojowej WeeChat.
`CMAKE_INSTALL_PREFIX` | katalog | `/usr/local` | Katalog, do którego zostanie zainstalowany WeeChat.
`WEECHAT_HOME` | katalog | `(pusty ciąg)` | Domyślny katalog domowy dla WeeChat. Bez ustawionej wartości (zalecane) domyślnie zostaną użyte wartości XDG. Jeśli wartość nie jest pusta zostanie użyty jeden katalog dla wszystkich plików. Wartością mogą być również 4 katalogi oddzielone dwukropkami, w takiej kolejności: config, data, cache, runtime.
`ENABLE_ALIAS` | `ON`, `OFF` | `ON` | Kompilacja wtyczki alias.
`ENABLE_BUFLIST` | `ON`, `OFF` | `ON` | Kompilacja wtyczki buflist.
`ENABLE_CHARSET` | `ON`, `OFF` | `ON` | Kompilacja wtyczki charset.
`ENABLE_CJSON` | `ON`, `OFF` | `ON` | Wsparcie dla JSON z użyciem biblioteki cJSON ↗.
`ENABLE_MAN` | `ON`, `OFF` | `OFF` | Generowanie strony manuala.
`ENABLE_DOC` | `ON`, `OFF` | `OFF` | Generowanie dokumentacji HTML.
`ENABLE_DOC_INCOMPLETE` | `ON`, `OFF` | `OFF` | Wymusza wygenerowanie dokumentacji nawet w przypadku jeśli nie wszystki wtyczki zostaną skompilowane (nie zalecane: dokumentacja nie będzie kompletna).
`ENABLE_ENCHANT` | `ON`, `OFF` | `OFF` | Kompilacja wtyczki spell z Enchant.
`ENABLE_EXEC` | `ON`, `OFF` | `ON` | Kompilacja wtyczki exec.
`ENABLE_FIFO` | `ON`, `OFF` | `ON` | Kompilacja wtyczki fifo.
`ENABLE_FSET` | `ON`, `OFF` | `ON` | Kompilacja wtyczki fset.
`ENABLE_GUILE` | `ON`, `OFF` | `ON` | Kompilacja wtyczki guile (Scheme).
`ENABLE_HEADLESS` | `ON`, `OFF` | `ON` | Kompilacja pliku binarnego w trybie headless.
`ENABLE_IRC` | `ON`, `OFF` | `ON` | Kompilacja wtyczki IRC.
`ENABLE_JAVASCRIPT` | `ON`, `OFF` | `OFF` | Kompilacja wtyczki javascript.
`ENABLE_LARGEFILE` | `ON`, `OFF` | `ON` | Wsparcie dla dużych plików.
`ENABLE_LOGGER` | `ON`, `OFF` | `ON` | Kompilacja wtyczki logger.
`ENABLE_LUA` | `ON`, `OFF` | `ON` | Kompilacja wtyczki lua.
`ENABLE_NCURSES` | `ON`, `OFF` | `ON` | Kompilacja interfejsu Ncurses.
`ENABLE_NLS` | `ON`, `OFF` | `ON` | Włączenie NLS (tłumaczenia).
`ENABLE_PERL` | `ON`, `OFF` | `ON` | Kompilacja wtyczki perl.
`ENABLE_PHP` | `ON`, `OFF` | `ON` | Kompilacja wtyczki PHP.
`ENABLE_PYTHON` | `ON`, `OFF` | `ON` | Kompilacja wtyczki Python.
`ENABLE_RELAY` | `ON`, `OFF` | `ON` | Kompilacja wtyczki relay.
`ENABLE_RUBY` | `ON`, `OFF` | `ON` | Kompilacja wtyczki ruby.
`ENABLE_SCRIPT` | `ON`, `OFF` | `ON` | Kompilacja wtyczki script.
`ENABLE_SCRIPTS` | `ON`, `OFF` | `ON` | Kompilacja wtyczek skryptowych (Python, Perl, Ruby, Lua, Tcl, Guile, PHP).
`ENABLE_SPELL` | `ON`, `OFF` | `ON` | Kompilacja wtyczki spell.
`ENABLE_TCL` | `ON`, `OFF` | `ON` | Kompilacja wtyczki tcl.
`ENABLE_TRIGGER` | `ON`, `OFF` | `ON` | Kompilacja wtyczki trigger.
`ENABLE_TYPING` | `ON`, `OFF` | `ON` | Kompilacja wtyczki typing.
`ENABLE_XFER` | `ON`, `OFF` | `ON` | Kompilacja wtyczki xfer.
`ENABLE_ZSTD` | `ON`, `OFF` | `ON` | Włącza kompresje Zstandard ↗.
`ENABLE_TESTS` | `ON`, `OFF` | `OFF` | Kompiluje testy.
`ENABLE_CODE_COVERAGE` | `ON`, `OFF` | `OFF` | Kompilacja z opcja pokrycia kodu. Ta opcja powinna być używana tylko dla testów, w celu pomiaru pokrycia kodu.

Pozostałe opcje można wyświetlić poleceniem:

    cmake -LA

Lub z interfejsem Curses:

    ccmake ..

#### Testy

Następujące pakiety są wymagane do kompilacji testów:

- libcpputest-dev

- kompilator C++

Testy muszą być włączone podczas kompilacji WeeChat:

    cmake .. -DENABLE_TESTS=ON

Można je uruchomić po skompilowaniu z katalogu kompilacji:

    ctest -V

### 2.4. Źródła z gita

Uwaga: źródła z gita przeznaczone są tylko dla zaawansowanych użytkowników: mogą się nie kompilować lub być niestabilne. Zostałeś ostrzeżony!

W celu pobrania źródeł z gita, wykonaj poniższą komendę:

    git clone https://github.com/weechat/weechat.git

Następnie postępuj zgodnie z instrukcjami dla pakietów źródłowych (zobacz pakiety źródłowe).

### 2.5. Zgłaszanie awarii

Jeśli doświadczyłeś awarii, lub chcesz zgłosić przyszłą awarię WeeChat, należy:

- skompilować WeeChat z:

  - informacjami dla debuggera (albo zainstalować stosowną paczkę w systemie)

  - weryfikacją adresów w pamięci (opcjonalnie)

- włączyć obsługę plików core w systemie

- zainstalować gdb

#### Kompilacja w trybie debug

Jeśli kompilujesz z użyciem CMake:

    cmake .. -DCMAKE_BUILD_TYPE=Debug

#### Weryfikacja adresów w pamięci

Możesz dodatowo włączyć weryfikację adresów, co spowoduje natychmiastową awarię WeeChat w przypadku wystąpienia problemu:

    cmake .. -DCMAKE_BUILD_TYPE=Debug -DCMAKE_C_FLAGS=-fsanitize=address -DCMAKE_CXX_FLAGS=-fsanitize=address -DCMAKE_EXE_LINKER_FLAGS=-fsanitize=address

Uwaga | Powinieneś włączyć tą opcję tylko jeśli chcesz wymusić awarię aplikacji, nie powinno się tego używać do codziennej pracy.

Po skompilowaniu i zainstalowaniu należy uruchamiać WeeChat w taki sposób:

    ASAN_OPTIONS="detect_odr_violation=0 log_path=asan.log" weechat

W przypadku awarii plik logi znajdą się w pliku `asan.log`.

#### CPliki core

W celu włączenia plików core możesz użyć opcji weechat.startup.sys_rlimit:

    /set weechat.startup.sys_rlimit "core:-1"

Dla WeeChat w wersji ≤ 0.3.8 albo jeśli chcesz włączyć obsługę plików core przed startem WeeChat, możesz użyć komendy `ulimit`.

Na przykład pod Linuksem używając powłoki bash, dodaj to do pliku `~/.bashrc`:

    ulimit -c unlimited

Lub z maksymalnym rozmiarem:

    ulimit -c 200000

#### Pozyskiwanie logów za pomocą gdb

Kiedy WeeChat ulegnie awarii, Twój system stworzy plik core lub core.12345 (12345 to id procesu) jeśli zostało to włączone. Plik ten zostanie utworzony w katalogu, z którego uruchomiono WeeChat (nie jest to katalog, gdzie zainstalowano WeeChat!).

Notka | Na niektórych systemach jak Archlinux pliki te mogą znajdować się w innym katalogu jak /var/lib/systemd/coredump i należy użyć komendy `coredumpctl` do ich odczytania. Więcej informacji można znaleźć na tej stronie wiki ↗.

Na przykład jeśli weechat jest zainstalowany w /usr/bin/ i plik core znajduje się w /home/user/, uruchom gdb za pomocą tej komendy:

    gdb /usr/bin/weechat /home/user/core

Następnie pod gdb użyj komendy `bt full`, aby wyświetlić log. Zobaczysz coś podobnego do tego:

    (gdb) set logging file /tmp/crash.txt
    (gdb) set logging on
    Copying output to /tmp/crash.txt.
    (gdb) bt full
    #0  0x00007f9dfb04a465 in raise () from /lib/libc.so.6
    #1  0x00007f9dfb04b8e6 in abort () from /lib/libc.so.6
    #2  0x0000000000437f66 in weechat_shutdown (return_code=1, crash=1)
        at /some_path/src/core/weechat.c:351
    #3  <signal handler called>
    #4  0x000000000044cb24 in hook_process_timer_cb (arg_hook_process=0x254eb90,
        remaining_calls=<value optimized out>) at /some_path/src/core/core-hook.c:1364
            hook_process = 0x254eb90
            status = <value optimized out>
    #5  0x000000000044cc7d in hook_timer_exec ()
        at /some_path/src/core/core-hook.c:1025
            tv_time = {tv_sec = 1272693881, tv_usec = 212665}
            ptr_hook = 0x2811f40
            next_hook = 0x0
    #6  0x000000000041b5b0 in gui_main_loop ()
        at /some_path/src/gui/curses/gui-curses-main.c:319
            hook_fd_keyboard = 0x173b600
            tv_timeout = {tv_sec = 0, tv_usec = 0}
            read_fds = {fds_bits = {0 <repeats 16 times>}}
            write_fds = {fds_bits = {0 <repeats 16 times>}}
            except_fds = {fds_bits = {0 <repeats 16 times>}}
            max_fd = <value optimized out>

Musisz przekazać ten log developerom i powiedzieć im co spowodowało awarię.

Dziękujemy za pomoc!

#### Debugowanie działającego WeeChat

W celu debugowania działającego WeeChat (na przykład kiedy WeeChat wydaje się zawieszony), można użyć gdb podając in procesu (zastąp 12345 numerem PID procesu weechat):

    gdb /usr/bin/weechat 12345

Następnie jak w przypadku awarii, użyj polecenia `bt full`:

    (gdb) bt full

## 3. Uruchamianie WeeChat

Żeby uruchomić WeeChat, wykonaj polecenie:

    weechat

Podczas pierwszego uruchomienia WeeChat tworzone są domyślne pliki konfiguracyjne w ~/.config/weechat z domyślnymi opcjami i wartościami (zobacz Pliki i foldery).

### 3.1. Argumenty linii poleceń

-a, --no-connect

  Wyłącza automatyczne łączenie się z serwerami podczas uruchamiania WeeChat.

-c, --colors

  Wyświetla domślne kolory w terminalu.

--daemon

  Uruchamia WeeChat w tle jako demona (działa tylko z komendą weechat-headless).

--stdout

  Wyświetla informacje z logów na standardowe wyjście zamiast zapisywać je do pliku z logami (działa tylko z opcją weechat-headless, nie kompatybilne z opcją "--daemon").

-d, --dir <ścieżka>

  Wymusza użycie wskazanego katalogu na wszyskie pliki WeeChat (katalog zostanie utworzony jeśli nie istnieje). Można podać cztery katalogi oddzielając je dwukropkami (w kolejności: config, data, cache, runtime). Jeśli ta opcja nie zostanie podada, użyta zostanie zawartość zmiennej WEECHAT_HOME (jeśli została ustawiona).

-t, --temp-dir

  Tworzy tymczasowy katalog dla ustawień WeeChat, który jest kasowany po wyłączeniu aplikacji (nie kompatybilne z opcją "-d").
  Nazwa katalogu jest automatyczne tworzona według wzoru: "weechat_temp_XXXXXX" (gdzie "XXXXXX" jest losowe). Katalog jest tworzony w pierwszym dostępnym miejscu według tej listy: zmienna środowiskowa "TMPDIR", "/tmp" (może być inaczej na niektórych systemach operacyjnych), zmienna środowiskowa "HOME", obecny katalog.
  Utworony katalog ma uprawnienia 0700 (tylko właściciel może czytać, pisać i wykonywać).

-h, --help

  Wyświetla pomoc.

-i, --build-info

  Wyświetla informację o kompilacji.

-l, --license

  Wyświetla licencję.

-p, --no-plugin

  Wyłącza automatyczne ładowanie wtyczek.

-P, --plugins <wtyczki>

  Załaduje przy starcie tylko podane wtyczki (zobacz /help weechat.plugin.autoload). Jeśli ta opcja zotanie użyta, opcja weechat.plugin.autoload zostanie zignorowana.

-r, --run-command <komenda>

  Uruchamia komende(-y) po uruchomieniu; kilka komend należy oddzielić średnikiem, ta opcja może zotać podana kilka razy.

-s, --no-script

  Wyłącza automatyczne ładowanie skryptów.

--upgrade

  Aktualizuje WeeChat z użyciem plików sesji wygenerowanych przez komende `/upgrade -quit`.

-v, --version

  Wyświetla wersję WeeChat.

wtyczka:opcja

  Opcja dla wtyczki.

Kilka dodatkowych opcji jest dostępne tylko do celu debugowania:

Uwaga | NIE używaj żadnej z nich podczas codziennej pracy!

--no-dlclose

  Nie wołaj funkcji dlclose po wyładowaniu wtyczek. Jest to przydatne przy użyciu narzędzi jak Valgrind do wyświetlania stosu wyładowywanych wtyczek.

--no-gnutls

  Nie wywołuj funkcji (de)inicjijących z biblioteki GnuTLS. Jest to przydatne przy użyciu narzędzi jak Valgrind i electric-fence, aby zapobiec błędą pamięci GnuTLS.

--no-gcrypt

  Nie wywołuj funkcji (de)inicjijących z biblioteki Gcrypt. Jest to przydatne przy użyciu narzędzi jak Valgrind, aby zapobiec błędą pamięci Gcrypt.

### 3.2. Zmienne środowiskowe

Niektóre zmienne śwodowiskowe są używane przez WeeChat o ile zostały zdefiniowane:

Nazwa | Opis
--- | ---
`WEECHAT_HOME` | Katalog domowy WeeChat (z plikami konfiguracyjnymi, logami, skryptami, …​). Działa tak samo jak opcja CMake `WEECHAT_HOME`.
`WEECHAT_PASSPHRASE` | Hasło używane do odszyfrowania zabezpieczonych danych.
`WEECHAT_EXTRA_LIBDIR` | Dodatkowy katalog do ładowania wtyczek (z katalogu "plugins" znajdującego się pod tą ścieżką).

### 3.3. Wsparcie kolorów

WeeChat może użyć do 32767 par kolorów do wyświetlania tekstu w paskach i obszarze rozmów (twój terminal musi wspierać do 256 par kolorów, aby użyć ich w WeeChat).

Zgodnie z wartością zmiennej środowiskowej TERM, możesz posiadać następujące limity dla kolorów w WeeChat:

$TERM | Kolory | Pary
--- | --- | ---
"rxvt-unicode", "xterm", …​ | 88 | 32767
"rxvt-256color", "xterm-256color", …​ | 256 | 32767
"screen" | 8 | 64
"screen-256color" | 256 | 32767
"tmux" | 8 | 64
"tmux-256color" | 256 | 32767

Możesz wykonać `weechat --colors` lub użyć komendy `/color` w WeeChat, aby wyświetlić limity dla twojego środowiska.

Niektóre z zalecanych wartości dla TERM jeśli chcesz używać 256 kolorów:

- dla screena: screen-256color

- pod tmux: screen-256color lub tmux-256color

- poza screenem/tmuxem: xterm-256color, rxvt-256color, putty-256color, …​

Notka | Być może konieczne jest zainstalowanie pakietu "ncurses-term", w celu użycia tych wartości dla zmiennej TERM.

Jeśli używasz screena, możesz dodać to do swojego ~/.screenrc:

    term screen-256color

Jeśli wartość zmiennej TERM ma złą wartość, a WeeChat jest już uruchomiony, możesz ją zmienić za pomocą tych dwóch komend:

    /set env TERM screen-256color
    /upgrade

### 3.4. Pliki i foldery

#### Katalogi XDG

WeeChat domyślnie używa katalogów XDG (zgodnie ze specyfikacją: XDG Base Directory Specification ↗).
Pojedynczy katalog może zostać wymuszony przez opcję CMake `WEECHAT_HOME`, zmienną środowiskową `WEECHAT_HOME` lub parametr z linii polecań `-d` / `--dir`.

Kiedy jeden katalog domowy dla WeeChat nie zostanie wymuszony, używane zostają katalogi XDG z takim podziałem:

Katalog | Domyślna wartość | Wartość jeśli $XDG_XXX nie jest zdefiniowana
--- | --- | ---
config | `$XDG_CONFIG_HOME/weechat` | `$HOME/.config/weechat`
data | `$XDG_DATA_HOME/weechat` | `$HOME/.local/share/weechat`
cache | `$XDG_CACHE_HOME/weechat` | `$HOME/.cache/weechat`
runtime | `$XDG_RUNTIME_DIR/weechat` | Taki sam jak katalog cache

Pliki konfiguracyjne z domyślnymi wartościami są tworzone przy pierwszym uruchomieniu WeeChat. The configuration files are created with default values the first time you run WeeChat.

#### Katalogi WeeChat

Katalogi używane przez WeeChat to:

Ścieżka (1) | Opis
--- | ---
`~/.config/weechat/` | Pliki konfiguracyjne WeeChat: `*.conf`, certifikaty, itp.
`~/.local/share/weechat/` | Pliki z danymi WeeChat: logi, skrypty, dane skryptów, pliki xfer, itp.
`logs/` | Pliki z logami (jeden na bufor).
`python/` | Skrypty pythonowe.
`autoload/` | Skrypty pythonowe automatycznie ładowane przy starcie (2).
`perl/` | Skrypty perlowe.
`autoload/` | Skrypty perlowe automatycznie ładowane przy starcie (2).
`ruby/` | Skrypty ruby.
`autoload/` | Skrypty ruby automatycznie ładowane przy starcie (2).
`lua/` | Skrypty lua.
`autoload/` | Skrypty lua automatycznie ładowane przy starcie (2).
`tcl/` | Skrypty tcl.
`autoload/` | Skrypty tcl automatycznie ładowane przy starcie (2).
`guile/` | Skrypty guile.
`autoload/` | Skrypry guile automatycznie ładowane przy starcie (2).
`javascript/` | Skrypty JavaScript.
`autoload/` | Skrypty JavaScript automatycznie ładowane przy starcie (2).
`php/` | Skrypty PHP.
`autoload/` | Skrypty PHP automatycznie ładowane przy starcie (2).
`~/.cache/weechat/` | Pliki pamięci podręcznej WeeChat: pliki pamięci podręcznej skryptów.
`/run/user/1000/weechat/` | Pliki uruchomieniowe WeeChat: kolejki FIFO, Gniazda UNIX pośrednika.

Notka | (1) Katalogi XDG mogą się różnić w zależności od wartości zmiennych `XDG_*`. (2) Ten folder zawiera przewazine linki symboliczne do plików w folderze nadrzędnym.

#### Pliki WeeChat

Pliki tworzone w katalogu domowym WeeChat:

Plik | Opis | Wrażliwe dane
--- | --- | ---
`weechat.conf` | Główny plik konfiguracyjny WeeChat | Możliwe (przykład: lista kanałów w zapisanym układzie buforów).
`sec.conf` | Plik konfiguracyjny z zabezpieczonymi danymi | Tak, bardzo wrażliwe: Tym plikiem nie powinno się z nikim dzielić.
`plugins.conf` | Plik konfiguracyjny wtyczek | Możliwe, zależy od wtyczki/skryptu.
`alias.conf` | Plik konfiguracyjny wtyczki alias | Możliwe, zależy od aliasu.
`buflist.conf` | Plik konfiguracyjny wtyczki buflist | Nie.
`charset.conf` | Plik konfiguracyjny wtyczki charset | Nie.
`exec.conf` | Plik konfiguracyjny wtyczki exec | Nie.
`fifo.conf` | Plik konfiguracyjny wtyczki fifo | Nie.
`fset.conf` | Plik konfiguracyjny wtyczki fset | Nie.
`guile.conf` | Plik konfiguracyjny wtyczki guile | Nie.
`irc.conf` | Plik konfiguracyjny wtyczki irc | Tak: może zawierać hasła dla serwerów, nickserva i kanałów (jeśli nie zostały zapisane w `sec.conf`).
`javascript.conf` | Plik konfiguracyjny wtyczki javascript | Nie.
`logger.conf` | Plik konfiguracyjny wtyczki logger | Nie.
`lua.conf` | Plik konfiguracyjny wtyczki lua | Nie.
`perl.conf` | Plik konfiguracyjny wtyczki perl | Nie.
`php.conf` | Plik konfiguracyjny wtyczki php | Nie.
`python.conf` | Plik konfiguracyjny wtyczki python | Nie.
`relay.conf` | Plik konfiguracyjny wtyczki relay | Tak: może on zawierać hasła pośredników i sekrety TOTP (jeśli nie zostały zapisane w `sec.conf`), dozwolone adresy IP/websockety oraz otwarte porty.
`ruby.conf` | Plik konfiguracyjny wtyczki ruby | Nie.
`script.conf` | Plik konfiguracyjny wtyczki script | Nie.
`spell.conf` | Plik konfiguracyjny wtyczki spell | Nie.
`tcl.conf` | Plik konfiguracyjny wtyczki tcl | Nie.
`trigger.conf` | Plik konfiguracyjny wtyczki trigger | Możliwe, zależy od triggerów.
`typing.conf` | Plik konfiguracyjny wtyczki typing | Nie.
`xfer.conf` | Plik konfiguracyjny wtyczki xfer | Nie.
`weechat.log` | Plik z logami WeeChat | Nie.

Ważne | Nie zaleca się edytowania plików konfiguracyjnych ręcznie, ponieważ WeeChat może je nadpisać w dowolnym momencie (na przykład poprzez komende /quit) oraz po wprowadzeniu ręcznie zmian należy użyć komendy /reload (ryzykując utratę zmian, nie zapisanych za pomocą komendy /save). Możesz użyć komendy /set, która sprawdza ustawianą wartość i od razu wprowadza zmiany.

## 4. Aktualizacja

Jeśli zostanie wydana nowa stabilna wersja WeeChat należy zaktualizować się do tej wersji.

Na samym początku musisz zainstalować nową wersje WeeChat albo za pomocą managera pakietów albo kompilując ją samemu, w taki sposób żeby plik wykonywalny `weechat` i wszystke wymagane pliki znajdowały się w tych samych ścieżkach.
Można to zrobić podczas działania WeeChat.

### 4.1. Komenda aktualizacji

WeeChat może zostać ponownie uruchomiony z nowego pliku binarnego bez potrzeby jego wyłączania za pomocą komendy /upgrade: zawartości buforów i połączenia nie TLS zostają zachowane.
Połączenia TLS są przerywane podczas aktualizacji i są automatycznie przywracane po jej zakończeniu (przeładowanie sesji TLS jest obecnie niemożliwe z użyciem GnuTLS).

Komenda ta może zostać użyta również w momencie restartu maszyny, na przykład w celu aktualizacji kernela albo przeniesienia WeeChat na nową maszynę:

    /upgrade -quit

Zapisuje to obecny stan w plikach `*.upgrade`. Możesz następnie wykonać restart lub przenieść cały katalog WeeChat (konfiguracja, dane, cache) na inną maszynę, następnie uruchomić WeeChat za pomocą polecenia:

    weechat --upgrade

### 4.2. Restart po aktualizacji

#### Informacje o aktualizacji

Po aktualizacji zaleca się zapoznanie z plikiem UPGRADING.md ↗, który zawiera ważne informacje o niekompatybilnych zmianach i czynnościach, jakie mogą być wymagane.

Powinieneś zapoznać się z informacjami dla wersji pomiędzy tą, która aktualizowałeś a nową wersją.
Na przykład dla aktualizacji z wersji 4.0.0 do 4.3.0 należy przeczytać informacje dotyczące wszystkich wersji od 4.0.1 do 4.3.0 włącznie.

#### Aktualizacja konfiguracji

WeeChat potrafi automatycznie aktualizować pliki konfiguracyjne (`*.conf`):

- nowe opcje są dodawane z domyślnymi wartościami

- niepotrzebne już opcje są automatycznie kasowane i WeeChat wyświetla ostrzeżenie z wartościami odczytanymi z pliku.

Przykład ostrzeżenia o usuwanej opcji:

    =!= Ostrzeżenie: /home/user/.config/weechat/sec.conf, linia 15: nieznana opcja dla sekcji "crypt": passphrase_file = ""

Oznaza to, że opcja `sec.crypt.passphrase_file` została usunięta i jej wartość była ustawiona na pusty ciąg, który był domyślną wartością w poprzednej wersji (w tym przypadku żadna dodatkowa akcja nie jest wymagana).

## 5. Interfejs

### 5.1. Układ ekranu

Przykład terminala z WeeChat:

     ▼ bar "buflist"   ▼ bar "title"
    ┌──────────────────────────────────────────────────────────────────────────────────────┐
    │1.libera │Welcome to #test, this is a test channel                                    │
    │  weechat│12:52:27   --> | Flashy (flashcode@weechat.org) has joined #test    │@Flashy│
    │2.  #test│12:52:27    -- | Nicks #test: [@Flashy @joe +weebot peter]          │@joe   │
    │3.  #abc │12:52:27    -- | Channel #test: 4 nicks (2 ops, 1 voice, 1 normal)  │+weebot│
    │4.  #def │12:52:27    -- | Channel created on Tue Jan 27 06:30:17 2009        │peter  │
    │5.  #ghi │12:54:15 peter | hey!                                               │       │
    │         │12:55:01  @joe | hello                                              │       │
    │         │                                                                    │       │
    │         │                                                                    │       │
    │         │                                                                    │       │
    │         │                                                                    │       │
    │         │                                                                    │       │
    │         │                                                                    │       │
    │         │                                                                    │       │
    │         │                                                                    │       │
    │         │                                                                    │       │
    │         │                                                                    │       │
    │         │                                                                    │       │
    │         │                                                                    │       │
    │         │                                                                    │       │
    │         │                                                                    │       │
    │         │[12:55] [5] [irc/libera] 2:#test(+n){4}* M [H: 3:#abc(2,5), 5]              │
    │         │[@Flashy(i)] hi peter!█                                                     │
    └──────────────────────────────────────────────────────────────────────────────────────┘
                ▲ bars "status" and "input"                               bar "nicklist" ▲

Domyślnie ekran jest podzielony na następujące obszary:

- obszar rozmowy (środek ekranu) z liniami rozmowy, zawierającymi:

  - czas

  - prefiks (przed "|")

  - wiadomość (za "|")

- paski dookoła obszaru rozmowy, domyślne paski to:

  - pasek buflist, po lewej

  - pasek title, nad obszarem rozmowy

  - pasek status, pod obszarem rozmowy

  - pasek input, pod paskiem statusu

  - pasek nicklist, po prawej

Pasek buflist posiada następujące domyślne elementy:

Element | Przykład | Opis
--- | --- | ---
buflist | `1.weechat` | Lista buforów.

Pasek title posiada następujące domyślne elementy:

Element | Przykład | Opis
--- | --- | ---
buffer_title | `Witaj na #test` | Tytuł buforu.

Pasek status posiada następujące domyślne elementy:

Element | Przykład | Opis
--- | --- | ---
time | `12:55` | Czas.
buffer_last_number | `5` | Liczba najnowszych buforów (może się różnić od `buffer_count` jeśli opcja weechat.look.buffer_auto_renumber jest ustawiona na `off`).
buffer_plugin | `irc/libera` | Wtyczka dla obecnego bufora (wtyczka irc może dodać nazwę serwera IRC używanego przez bufor).
buffer_number | `2` | Numer obecnego buforu.
buffer_name | `#test` | Nazwa obecnego buforu.
buffer_modes | `+n` | Tryby kanału IRC.
buffer_nicklist_count | `4` | Ilość nicków wyświetlanych na liście nicków.
buffer_zoom | ! | `!` oznacza, że połączony bufor jest przybliżony (tylko ten jest wyświetlany), pusta wartość oznacza, że wszystkie połączone bufory są wyświetlane.
buffer_filter | `*` | Wskaźnik filtrowania: `*` oznacza, że niektóre linie zostały odfiltrowywane (ukryte), pusta wartość oznacza, że wszystkie linie są wyświetlane.
mouse_status | `M` | Status obsługi myszy (pusty jeśli obsługa myszy jest wyłączona), zobacz /mouse i Włącz/wyłącz.
scroll | `-Więcej(50)-` | Wskaźnik przewijania, z numerem linii poniżej ostatniej wyświetlanej.
lag | `Lag: 2.5` | Wskaźnik opóźnienia, w sekundach (ukryty dla niskich opóźnień).
hotlist | `H: 3:#abc(2,5), 5` | Lista buforów z aktywnością (nieprzeczytane wiadomości) (w przykładzie, 2 podświetlenia i 5 nieprzeczytanych wiadomości w #abc, jedna wiadomość w buforze #5).
typing | `Typing: bob, (alice)` | Powiadomienia o pisaniu, zobacz Powiadomienia o pisaniu.
completion | `abc(2) def(5)` | Lista słów do dopełnienia, z ilością możliwych dopełnień dla każdego słowa.

Pasek input posiada następujące domyślne elementy:

Element | Przykład | Opis
--- | --- | ---
input_prompt | `@Flashy(i)` | Input prompt, dla irc: nick i tryby (tryb "+i" oznacza niewidzialny na libera).
away | `away` | Wskaźnik nieobecności.
input_search | `Search lines (~ str,msg)` | Wskaźnik wyszukiwania (zobacz poniżej).
input_paste | `Wkleić 7 linii ? [ctrl-y] Tak [ctrl-n] Nie` | Pyta użytkownika podczas wklejania kilku linii tekstu.
input_text | `hi peter!` | Wprowadzony tekst.

Dostępne są dwa tryby wyszukiwania:

- wyszukiwanie w liniach, na przydład `[Search lines (~ str,msg)]`, z następującymi informacjami:

  - `~`: wielkość liter ma znaczenie

  - `==`: wielkość liter nie ma znaczenia

  - `str`: wyszukiwanie ciągu

  - `regex`: wyszukiwanie wyrażenia regularnego

  - `msg`: wyszukiwanie w wiadomościach

  - `pre`: wyszukiwanie w prefiksach

  - `pre\|msg`: wyszukiwanie w prefiksach i wiadomościach)

- wyszukiwanie w historii komend, na przydład `[Search command (~ str,local)]`, z następującymi informacjami:

  - `~`: wielkość liter ma znaczenie

  - `==`: wielkość liter nie ma znaczenia

  - `str`: wyszukiwanie ciągu

  - `regex`: wyszukiwanie wyrażenia regularnego

  - `local`: wyszukiwanie w lokalnej historii bufora

  - `global`: wyszukiwanie w globalnej historii.

Pasek nicklist posiada następujące domyślne elementy:

Element | Przykład | Opis
--- | --- | ---
buffer_nicklist | `@Flashy` | Lita nicków w obecnym buforze.

Inne dostępne elementy (nie używane domyślnie w paskach):

Element | Przykład | Opis
--- | --- | ---
buffer_count | `5` | Liczba otwartych buforów.
buffer_nicklist_count_all | `4` | Liczba widocznych grup i nicków na nickliście.
buffer_nicklist_count_groups | `0` | Liczba widocznych grup na nickliście.
buffer_short_name | `#test` | Skrócona nazwa obecnego buforu.
buflist2 | `1.weechat` | Lista buforów, drugi element paska (zobacz opcję buflist.look.use_items).
buflist3 | `1.weechat` | Lista buforów, trzeci element paska (zobac opcję buflist.look.use_items).
buflist4 | `1.weechat` | Lista buforów, czwarty element paska (zobacz opcję buflist.look.use_items).
buflist5 | `1.weechat` | Lista buforów, piąty element paska (zobacz opcję buflist.look.use_items).
fset | `buflist.look.sort: …` | Pomoc dla obecnie wybranej opcji w buforze fset.
irc_channel | `#test` | Nazwa bieżącego kanału IRC.
irc_host | `user@host.com` | Aktualny host IRC.
irc_nick | `Flashy` | Aktualny nick IRC.
irc_nick_host | `Flashy!user@host.com` | Aktualny nick i host IRC.
irc_nick_modes | `i` | Atrybuty IRC dla własnego nicka.
irc_nick_prefix | `@` | Prefiks nicku na kanale IRC.
spacer |  | Specjalny element używany do wyrównania tekstu na paskach, zobacz Odstęp.
spell_dict | `fr,en` | Słowniki używane w obecnym buforze.
spell_suggest | `print,prone,prune` | Sugestie dla słowa pod kursorem (jeśli zawiera błąd).
tls_version | `TLS1.3` | Wersja TLS używana przez obecny serwer IRC.
window_number | `2` | Numer obecnego okna.

Każdy aspekt układu może zostać spersonalizowany za pomocą komend: `/bar` do dostosowania pasków, /buffer i `/window` do dostosowania budorów i okien, i /layout żeby nazwać, zapisać i przywrócić układ ekranu i powiązania między oknami i buforami.

### 5.2. Linia poleceń

Linia poleceń WeeChat (na dole okna) pozwala na wykonywanie komend lub wysłanie tekstu do bufora.

#### Składnia

Komendy zaczynają się od znaku "/", następnie wpisujemy komendę. Na przykład, aby zobaczyć listę wszystkich opcji:

    /set

Tekst wysłany do buforu to dowolny tekst, który nie zaczyna się od znaku "/". Na przykład, żeby wysłać tekst hello do obecnego buforu wystarczy:

    hello

Jednak możliwe jest rozpoczęcie tekstu znakiem "/", wpisując go podwójnie. Na przykład, żeby wysłać tekst `/set` do obecnego buforu:

    //set

#### Kody kolorów

Dla niektórych wtyczek jak IRC, można użyć kolorów i atrybutów w następujący sposób (wciśnij `Ctrl`+`c` następnie literę z opcjonalną wartością):

Klawisz | Opis
--- | ---
`Ctrl`+`c`, `b` | Pogrubiony tekst
`Ctrl`+`c`, `c`, `xx` | Kolor tekstu `xx` (zgodnie z poniższą listą kolorów)
`Ctrl`+`c`, `c`, `xx`, `,`, `yy` | Kolor tekstu `xx` i tła `yy` (zgodnie z poniższą listą kolorów)
`Ctrl`+`c`, `d`, `xxxxxx` | Kolor tekstu `xxxxxx` (RGB jako wartości szesnastkowe, na przykład `FF0000` dla czerwonego).
`Ctrl`+`c`, `d`, `xxxxxx`, `,`, `yyyyyy` | Kolor tekstu `xxxxxx` i tła `yyyyyy` (RGB jako wartości szesnastkowe).
`Ctrl`+`c`, `i` | Kursywa
`Ctrl`+`c`, `o` | Wyłącza kolory i atrybuty
`Ctrl`+`c`, `s` | Przekreślony tekst (wyświetlany w interfejsie ncurses jako w połowie jasny, ponieważ przekreślenie nie jest wspierane).
`Ctrl`+`c`, `v` | Odwróć video (przywraca kolor tekstu i tła)
`Ctrl`+`c`, `_` | Podkreślony tekst

Notka | Te same skróty (bez numeru `Ctrl`+`c`, `c` i `Ctrl`+`c`, `d`) mogą zostać użyte dla zatrzymania atrybutu.

Kody kolorów dla `Ctrl`+`c`, `c`:

IRC color | WeeChat color
--- | ---
`00` | white
`01` | black
`02` | blue
`03` | green
`04` | lightred
`05` | red
`06` | magenta
`07` | brown
`08` | yellow
`09` | lightgreen
`10` | cyan
`11` | lightcyan
`12` | lightblue
`13` | lightmagenta
`14` | darkgray
`15` | gray
`16` | 52
`17` | 94
`18` | 100
`19` | 58
`20` | 22
`21` | 29
`22` | 23
`23` | 24
`24` | 17
`25` | 54
`26` | 53
`27` | 89
`28` | 88
`29` | 130
`30` | 142
`31` | 64
`32` | 28
`33` | 35
`34` | 30
`35` | 25
`36` | 18
`37` | 91
`38` | 90
`39` | 125
`40` | 124
`41` | 166
`42` | 184
`43` | 106
`44` | 34
`45` | 49
`46` | 37
`47` | 33
`48` | 19
`49` | 129
`50` | 127
`51` | 161
`52` | 196
`53` | 208
`54` | 226
`55` | 154
`56` | 46
`57` | 86
`58` | 51
`59` | 75
`60` | 21
`61` | 171
`62` | 201
`63` | 198
`64` | 203
`65` | 215
`66` | 227
`67` | 191
`68` | 83
`69` | 122
`70` | 87
`71` | 111
`72` | 63
`73` | 177
`74` | 207
`75` | 205
`76` | 217
`77` | 223
`78` | 229
`79` | 193
`80` | 157
`81` | 158
`82` | 159
`83` | 153
`84` | 147
`85` | 183
`86` | 219
`87` | 212
`88` | 16
`89` | 233
`90` | 235
`91` | 237
`92` | 239
`93` | 241
`94` | 244
`95` | 247
`96` | 250
`97` | 254
`98` | 231
`99` | default

Notka | W celu wyświetlenia wszystkich dostępnych kolorów dla terminala możesz wykonać komendę `/color` następnie `Alt`+`c` (w WeeChat) lub wywołać w terminalu: `weechat --colors`.

Przykład: wyświetlenie "hello Alice!" z pogrubionym jasno niebieskim "hello" i podkreślonym jasno czerwonym "Alice":

    ^Cc12^Cbhello ^Cb^Cc04^C_Alice^C_^Cc!

Skróty klawiszowe:

`Ctrl`+`c` `c` `1` `2` `Ctrl`+`c` `b`
`h` `e` `l` `l` `o` `Space`
`Ctrl`+`c` `b` `Ctrl`+`c` `c` `0` `4` `Ctrl`+`c` `_`
`A` `l` `i` `c` `e`
`Ctrl`+`c` `_` `Ctrl`+`c` `c`
`!`

Notka | We wtyczce irc, można zmienić przypisania tych kolorów za pomocą opcji irc.color.mirc_remap.

### 5.3. Bufory i okna

Bufor posiada numer, nazwę, wyświetlane linie (i trochę innych danych).

Przykłady buforów:

- główny bufor (tworzony po uruchomieniu WeeChat, nie może zostać zamknięty)

- serwer irc (wyświetla informacje z serwera)

- kanał irc

- prywatna rozmowa irc

Okno to obszar ekranu, w którym wyświetlane są bufory. Nie jest możliwe podzielenie ekranu na kilka okien (przykłady poniżej, szczegóły komenda /window).

Każde okno wyświetla jeden bufor. Bufor może zostać ukryty (nie wyświetlany w oknie) lub wyświetlany w jednym lub więcej oknach.

Układy ekranu i powiązania między oknami i buforami mogą być zapisywane i przywracane.

#### Przykłady

Przykład podziału poziomego (`/window splith`):

                                   ▼ window #2 (buffer #4)
    ┌──────────────────────────────────────────────────────────────────────────────────────┐
    │1.libera │Welcome to #def                                                             │
    │  weechat│12:55:12     Max | hi                                               │@Flashy│
    │2.  #test│12:55:20 @Flashy | hi Max!                                          │Max    │
    │3.  #abc │                                                                    │       │
    │4.  #def │                                                                    │       │
    │5.  #ghi │                                                                    │       │
    │         │                                                                    │       │
    │         │                                                                    │       │
    │         │                                                                    │       │
    │         │[12:55] [5] [irc/libera] 4:#def(+n){2}                                      │
    │         │[@Flashy]                                                                   │
    │         │────────────────────────────────────────────────────────────────────────────│
    │         │Welcome to #abc                                                             │
    │         │12:54:15 peter | hey!                                               │@Flashy│
    │         │12:55:01  @joe | hello                                              │@joe   │
    │         │                                                                    │+weebot│
    │         │                                                                    │peter  │
    │         │                                                                    │       │
    │         │                                                                    │       │
    │         │                                                                    │       │
    │         │                                                                    │       │
    │         │[12:55] [5] [irc/libera] 3:#abc(+n){4}                                      │
    │         │[@Flashy] hi peter!█                                                        │
    └──────────────────────────────────────────────────────────────────────────────────────┘
                                   ▲ window #1 (buffer #3)

Przykład podziału pionowego (`/window splitv`):

    ┌──────────────────────────────────────────────────────────────────────────────────────┐
    │1.libera │Welcome to #abc                      │Welcome to #def                       │
    │  weechat│12:54:15 peter | hey!        │@Flashy│12:55:12     Max | hi         │@Flashy│
    │2.  #test│12:55:01  @joe | hello       │@joe   │12:55:20 @Flashy | hi Max!    │Max    │
    │3.  #abc │                             │+weebot│                              │       │
    │4.  #def │                             │peter  │                              │       │
    │5.  #ghi │                             │       │                              │       │
    │         │                             │       │                              │       │
    │         │                             │       │                              │       │
    │         │                             │       │                              │       │
    │         │                             │       │                              │       │
    │         │                             │       │                              │       │
    │         │                             │       │                              │       │
    │         │                             │       │                              │       │
    │         │                             │       │                              │       │
    │         │                             │       │                              │       │
    │         │                             │       │                              │       │
    │         │                             │       │                              │       │
    │         │                             │       │                              │       │
    │         │                             │       │                              │       │
    │         │                             │       │                              │       │
    │         │[12:55] [5] [irc/libera] 3:#abc(+n)  │[12:55] [5] [irc/libera] 4:#def(+n)   │
    │         │[@Flashy] hi peter!█                 │[@Flashy]                             │
    └──────────────────────────────────────────────────────────────────────────────────────┘
                     ▲ window #1 (buffer #3)               ▲ window #2 (buffer #4)

Przykład podziałów pionowego i poziomego:

                                                           ▼ window #3 (buffer #5)
    ┌──────────────────────────────────────────────────────────────────────────────────────┐
    │1.libera │Welcome to #abc                      │Welcome to #ghi                       │
    │  weechat│12:54:15 peter | hey!        │@Flashy│12:55:42 @Flashy | hi         │@Flashy│
    │2.  #test│12:55:01  @joe | hello       │@joe   │12:55:56    alex | hi Flashy  │alex   │
    │3.  #abc │                             │+weebot│                              │       │
    │4.  #def │                             │peter  │                              │       │
    │5.  #ghi │                             │       │                              │       │
    │         │                             │       │                              │       │
    │         │                             │       │                              │       │
    │         │                             │       │                              │       │
    │         │                             │       │[12:55] [5] [irc/libera] 5:#ghi(+n)   │
    │         │                             │       │[@Flashy]                             │
    │         │                             │       │──────────────────────────────────────│
    │         │                             │       │Welcome to #def                       │
    │         │                             │       │12:55:12     Max | hi         │@Flashy│
    │         │                             │       │12:55:20 @Flashy | hi Max!    │Max    │
    │         │                             │       │                              │       │
    │         │                             │       │                              │       │
    │         │                             │       │                              │       │
    │         │                             │       │                              │       │
    │         │                             │       │                              │       │
    │         │[12:55] [5] [irc/libera] 3:#abc(+n)  │[12:55] [5] [irc/libera] 4:#def(+n)   │
    │         │[@Flashy] hi peter!█                 │[@Flashy]                             │
    └──────────────────────────────────────────────────────────────────────────────────────┘
                     ▲ window #1 (buffer #3)               ▲ window #2 (buffer #4)

#### Niesformatowany ekran

Specjalny ekran nazywany "bare display" może zostać użyty do łatwego kliknięcia w długi adres URL i zaznaczania tekstu (za pomocą myszy).

Tryb niesformatowanego ekranu posiada następujące cechy:

- wyświetlana jest tylko zawartość obecnego bufora: bez podziału okna i pasków (brak tematu, listy nicków, statusu, wejścia, …​)

- wsparcie dla myszy w WeeChat jest wyłączone (jeśli zostało włączone): możesz używać myszy jak w normalnym terminalu do klikania w adresy URL i zaznaczania tekstu

- ncurses nie jest używane, dlatego URLe nie są obcinane z końcem linii.

Domyślnym skrótem uruchamiającym ten tryb jest `Alt`+`l` (`L`), tak jak wyłączającym go (lub domyślnie dowolna zmiana wejścia spowoduje wyjście z tego trybu, zobacz weechat.look.bare_display_exit_on_input).

Format czasu może zostać dostosowany za pomocą opcji weechat.look.bare_display_time_format.

Tryb ten może być włączony również na specyficzny czas za pomocą komendy /window.

Jeśłi WeeChat wygląda następująco:

    ┌──────────────────────────────────────────────────────────────────────────────────────┐
    │1.libera │Welcome to #abc                                                             │
    │  weechat│12:52:27   --> | Flashy (flashcode@weechat.org) has joined #abc     │@Flashy│
    │2.  #test│12:52:27    -- | Nicks #abc: [@Flashy @joe +weebot peter]           │@joe   │
    │3.  #abc │12:52:27    -- | Channel #abc: 4 nicks (2 ops, 1 voice, 1 normal)   │+weebot│
    │4.  #def │12:52:27    -- | Channel created on Tue Jan 27 06:30:17 2009        │peter  │
    │5.  #ghi │12:54:15 peter | hey!                                               │       │
    │         │12:55:01  @joe | peter: hook_process: https://weechat.org/files/doc │       │
    │         │               | /weechat/devel/weechat_plugin_api.en.html#_weechat │       │
    │         │               | _hook_process                                      │       │
    │         │                                                                    │       │
    │         │                                                                    │       │
    │         │                                                                    │       │
    │         │                                                                    │       │
    │         │                                                                    │       │
    │         │                                                                    │       │
    │         │                                                                    │       │
    │         │                                                                    │       │
    │         │                                                                    │       │
    │         │                                                                    │       │
    │         │                                                                    │       │
    │         │                                                                    │       │
    │         │[12:55] [5] [irc/libera] 3:#abc(+n){4}                                      │
    │         │[@Flashy(i)] hi peter!█                                                     │
    └──────────────────────────────────────────────────────────────────────────────────────┘

Ekran w trybie niesformatowanego wyświetlania będzie wyglądać tak:

    ┌──────────────────────────────────────────────────────────────────────────────────────┐
    │                                                                                      │
    │                                                                                      │
    │                                                                                      │
    │                                                                                      │
    │                                                                                      │
    │                                                                                      │
    │                                                                                      │
    │                                                                                      │
    │                                                                                      │
    │                                                                                      │
    │                                                                                      │
    │                                                                                      │
    │                                                                                      │
    │                                                                                      │
    │                                                                                      │
    │                                                                                      │
    │12:52 --> Flashy (flashcode@weechat.org) has joined #abc                              │
    │12:52 -- Nicks #abc: [@Flashy @joe +weebot peter]                                     │
    │12:52 -- Channel #abc: 4 nicks (2 ops, 1 voice, 1 normal)                             │
    │12:52 -- Channel created on Tue Jan 27 06:30:17 2009                                  │
    │12:54 <peter> hey!                                                                    │
    │12:55 <@joe> peter: hook_process: https://weechat.org/files/doc/weechat/devel/weechat_│
    │plugin_api.en.html#_weechat_hook_process                                              │
    └──────────────────────────────────────────────────────────────────────────────────────┘

Możesz więc kliknąć w URL od joe bez żadnych problemów w swoim terminalu (jeśli twój terminal wspiera klikanie w URLe).

### 5.4. Buforów

#### Format linii

Linie wyświetlane w formatowanych buforach maja następujące pola:

Pole | Wyświetlane | Opis
--- | --- | ---
data/czas (wiadomość) | Tak | Data/czas wiadomości (może być przeszła).
data/czas (wywietlenie) | Nie | Data/time, kiedy WeeChat wyświetlił wiadomość.
prefiks | Tak | Prefiks wiadomości, zazwyczaj nick.
wiadomość | Tak | Wiadomość.
wyświetlone | Nie | Boolean: true jeśli linia została wyświetlona, false jeśli linia została odfiltrowana komendą /filter.
podświetlenie | Nie | Boolean: true jeśli linia ma podświetlenie, false w przeciwnym wypadku.
tagi | Przez `/debug tags` | Tagi powiązane z linią (zobacz tagi linii).

Wyświetlanie linni może być zmienione za pomocą wielu opcji wyglądu (weechat.look.*) oraz koloru (weechat.color.chat_*).

#### Tagi linii

WeeChat używa tagów w liniach dla różnych celów:

- podświetleń

- poziomu powiadomień

- logowaia

- użycia komendy /filter

Tagi można wyświetlić używając komendy `/debug tags` (tą samą komendą można je ukryć).

Popularnie używane tagi (niepełna lista):

Tag | Opis
--- | ---
`no_filter` | Linia nie może być filtrowana.
`no_highlight` | Podświetlenia nie są dozwolone w tej linii.
`no_log` | Linia nie jest zapisywana w logu.
`log0 … log9` | Poziom logowania dla linii (zobacz komendę /logger).
`notify_none` | Linia nie może być dodana do hotlisty. (1)
`notify_message` | Linia jest wiasomością użytkownika. (1)
`notify_private` | Linia jest wiadomością prywatną. (1)
`notify_highlight` | Linia jest wiadomością z podświetleniem. (1)
`self_msg` | Własna wiadomość.
`nick_xxx` | Wiadomość od nicku "xxx".
`prefix_nick_ccc` | Prefiks to nick o kolorze "ccc".
`host_xxx` | Nazwa użytkowniak i host w wiadomości.
`irc_xxx` | Wiadomość IRC "xxx" (komenda, albo 3 cyfrowy numer).
`irc_numeric` | Wiadomość numeryczna IRC.
`irc_error` | Błąd od erwera IRC.
`irc_action` | Akcja nicka (komenda `/me`).
`irc_ctcp` | Wiadomość CTCP.
`irc_ctcp_reply` | Odpowiedź na wiadomość CTCP.
`irc_smart_filter` | Wiadomość IRC, która może być filtrowana przez "inteligentny filtr".
`away_info` | Wiadomość z powodem nieobecności.

Notka | (1) Kiedy brak jest taga "notify_xxx", poziom jest ustawiony domyślnie na "low". Jeśli tag "notify_xxx" jest obecny, można zdefiniować odpowiedni poziom powiadomień, na przykład jeśli maksymalna hotlista jest używana dla nicku, poziom powiadomień może być niższy niż wartość dla tagu.

#### Zmienne lokalne

Zmienne lokalne mogą być definiowane dla wsystkich buforów.

Zmienna lokalna posiada:

- nazwę (ciąg)

- wartość (ciąg, może być pusty).

Zmienne lokalne mogą być tworzone przez WeeChat, wtyczki, skrypty lub ręcznie w linii poleceń bufora.

Na przykład, żeby dodać zmienna lokalną „completion_default_template” wystarczy polecenie:

    /buffer setvar completion_default_template %(my_completion)

Żeby wyświetlić zmienne lokalne dla obecnego bufora:

    /buffer listvar

Usunięcie zmiennej lokalnej „completion_default_template”:

    /buffer delvar completion_default_template

WeeChat i jego wtyczki domyślnie tworzą następujące zmienne:

Nazwa | Wartość | Opis
--- | --- | ---
`away` | dowolny ciąg | Powód nieobecności na serwerze, ustawiane przez wtyczkę irc.
`channel` | dowolny ciąg | Nazwa kanału, ustawiana przez wtyczki irc/xfer i bufory z informacjami do debugowania wtyczek relay/trigger.
`charset_modifier` | dowolny ciąg | Modyfikacja kodowania używanego na kanale, ustawiane przez wtyczkę irc.
`completion_default_template` | dowolny ciąg | Domyślny szablon dopełnień dla bufora, nadpisuje zmienną `weechat.completion.default_template`.
`filter` | dowolny ciąg | Filtr zdefiniowany w niektórych buforach jak `/fset`, `/list` (irc), `/server raw` (irc) i `/script`.
`host` | dowolny ciąg | Własny host (jeśli jest znany), ustawiane przez wtyczkę irc.
`lag` | dowolny ciąg | Opóźnienie serwera, ustawiane przez wtyczkę irc.
`name` | dowolny ciąg | Nazwa bufora (uważaj, nie jest to pełna nazwa i nie wystarczy ona do zidentyfikowania i wyszukania bufora).
`nick` | dowolny ciąg | Nazwa użytkownika, ustawiane przez wtyczki irc i xfer.
`no_log` | `1` (lub dowolny niepusty ciąg) | Jeśli jest ustawiona, wiadomości z bufora nie są logowane.
`plugin` | dowolny ciąg | Nazwa wtyczki, która stworzyła bufor (`core` dla buforów WeeChat).
`script_close_cb` | dowolny ciąg | Callback zamykania bufora zdefiniowany przez skrypt.
`script_close_cb_data` | dowolny ciąg | Dane dla callbacka zamykania bufora zdefiniowane przez skrypt.
`script_input_cb` | dowolny ciąg | Callback wprowadzania danych w buforze zdefiniowany przez skrypt.
`script_input_cb_data` | dowolny ciąg | Dane dla callbacka wprowadzania danych w buforze zdefiniowane przez skrypt.
`script_name` | dowolny ciąg | Nazwa skryptu, który stworzył bufor.
`server` | dowolny ciąg | Nazwa serwera ustawiana przez wtyczkę irc albo bufor z informacjami do debugowania wtyczki relay/trigger.
`spell_suggest` | dowolny ciąg | Źle napisane słowo i sugestie (format: "słowo:sugestie"), ustawiane przez wtyczkę spell.
`trigger_filter` | dowolny ciąg | Filtr triggerów, ustawiany przez wtyczkę trigger.
`type` | dowolny ciąg, na przykład: `channel`, `debug`, `exec`, `option`, `private`, `relay`, `script`, `server`, `user`, `xfer` | Typ bufora ustawiany przez WeeChat i wiele wtyczek.

Notka | External plugins and scripts can define and use other local variables.

### 5.5. Lista buforów

Wtyczka buflist wyświetla listę buforów w elemencie paska nazwanym "buflist" (cztery dodatkowe elementy "buflist2", "buflist3", "buflist4" i "buflist5" są również dostępne).
Domyślny pasek "buflist" jest tworzony podczas uruchomieina z włączoną wtyczką.

#### Komendy

- `buflist`: bar item with list of buffers

    /buflist  enable|disable|toggle
              bar
              refresh [<item>[,<item>...]]

     enable: enable buflist
    disable: disable buflist
     toggle: toggle buflist
        bar: add the "buflist" bar
    refresh: force the refresh of some bar items (if no item is given, all bar items used are refreshed, according to option buflist.look.use_items)

    The lines with buffers are displayed using string evaluation (see /help eval for the format), with these options:
      - buflist.look.display_conditions: conditions to display a buffer in the list
      - buflist.format.buffer: format for a buffer which is not current buffer
      - buflist.format.buffer_current: format for the current buffer

    The following variables can be used in these options:
      - bar item data (see hdata "bar_item" in API doc for a complete list), for example:
        - ${bar_item.name}
      - window data, where the bar item is displayed (there's no window in root bars, see hdata "window" in API doc for a complete list), for example:
        - ${window.number}
        - ${window.buffer.full_name}
      - buffer data (see hdata "buffer" in API doc for a complete list), for example:
        - ${buffer.number}
        - ${buffer.name}
        - ${buffer.full_name}
        - ${buffer.short_name}
        - ${buffer.nicklist_nicks_count}
      - irc_server: IRC server data, defined only on an IRC buffer (see hdata "irc_server" in API doc)
      - irc_channel: IRC channel data, defined only on an IRC channel buffer (see hdata "irc_channel" in API doc)
      - extra variables added by buflist for convenience:
        - ${format_buffer}: the evaluated value of option buflist.format.buffer; this can be used in option buflist.format.buffer_current to just change the background color for example
        - ${current_buffer}: a boolean ("0" or "1"), "1" if this is the current buffer; it can be used in a condition: ${if:${current_buffer}?...:...}
        - ${merged}: a boolean ("0" or "1"), "1" if the buffer is merged with at least another buffer; it can be used in a condition: ${if:${merged}?...:...}
        - ${format_number}: indented number with separator (evaluation of option buflist.format.number)
        - ${number}: indented number, for example " 1" if there are between 10 and 99 buffers; for merged buffers, this variable is set with number for the first buffer and spaces for the next buffers with same number
        - ${number2}: indented number, for example " 1" if there are between 10 and 99 buffers
        - ${number_zero}: like ${number} but the number is zero-padded
        - ${number_zero2}: like ${number2} but the number is zero-padded
        - ${number_displayed}: "1" if the number is displayed, otherwise "0"
        - ${indent}: indentation for name (channel, private and list buffers are indented) (evaluation of option buflist.format.indent)
        - ${format_nick_prefix}: colored nick prefix for a channel (evaluation of option buflist.format.nick_prefix)
        - ${color_nick_prefix}: color of nick prefix for a channel (set only if the option buflist.look.nick_prefix is enabled)
        - ${nick_prefix}: nick prefix for a channel (set only if the option buflist.look.nick_prefix is enabled)
        - ${format_name}: formatted name (evaluation of option buflist.format.name)
        - ${name}: the short name (if set), with a fallback on the name
        - ${color_hotlist}: the color depending on the highest hotlist level for the buffer (evaluation of option buflist.format.hotlist_xxx where xxx is the level)
        - ${format_hotlist}: the formatted hotlist (evaluation of option buflist.format.hotlist)
        - ${hotlist}: the raw hotlist
        - ${hotlist_priority}: "none", "low", "message", "private" or "highlight"
        - ${hotlist_priority_number}: -1 = none, 0 = low, 1 = message, 2 = private, 3 = highlight
        - ${format_lag}: the lag for an IRC server buffer, empty if there's no lag (evaluation of option buflist.format.lag)
        - ${format_tls_version}: indicator of TLS version for a server buffer, empty for channels (evaluation of option buflist.format.tls_version)
        - ${index_displayed}: index of line displayed in the bar item (starts at 0, only buffers displayed increment this index, see option buflist.look.display_conditions

#### Options

Sekcje w pliku buflist.conf:

Sekcja | Komenda | Opis
--- | --- | ---
`format` | `/set buflist.format.*` | Formaty użyte do wyświetlania listy buforów.
`look` | `/set buflist.look.*` | Wygląd elementów na liście buforów.

Opcje:

- buflist.format.buffer

  - description: format of each line with a buffer (note: content is evaluated, see /help buflist); example: standard format for bar item "buflist" and only the buffer number between square brackets for other bar items ("buflist2" to "buflist5"): "${if:${bar_item.name}==buflist?${format_number}${indent}${format_nick_prefix}${color_hotlist}${format_name}:[${number}]}"

  - type: string

  - values: any string

  - default value: `"${format_number}${indent}${format_nick_prefix}${color_hotlist}${format_name}"`

- buflist.format.buffer_current

  - description: format for the line with current buffer (note: content is evaluated, see /help buflist)

  - type: string

  - values: any string

  - default value: `"${color:,17}${format_buffer}"`

- buflist.format.hotlist

  - description: format for hotlist (note: content is evaluated, see /help buflist)

  - type: string

  - values: any string

  - default value: `" ${color:green}(${hotlist}${color:green})"`

- buflist.format.hotlist_highlight

  - description: format for a buffer with hotlist level "highlight" (note: content is evaluated, see /help buflist)

  - type: string

  - values: any string

  - default value: `"${color:magenta}"`

- buflist.format.hotlist_low

  - description: format for a buffer with hotlist level "low" (note: content is evaluated, see /help buflist)

  - type: string

  - values: any string

  - default value: `"${color:white}"`

- buflist.format.hotlist_message

  - description: format for a buffer with hotlist level "message" (note: content is evaluated, see /help buflist)

  - type: string

  - values: any string

  - default value: `"${color:brown}"`

- buflist.format.hotlist_none

  - description: format for a buffer not in hotlist (note: content is evaluated, see /help buflist)

  - type: string

  - values: any string

  - default value: `"${color:default}"`

- buflist.format.hotlist_private

  - description: format for a buffer with hotlist level "private" (note: content is evaluated, see /help buflist)

  - type: string

  - values: any string

  - default value: `"${color:green}"`

- buflist.format.hotlist_separator

  - description: separator for counts in hotlist (note: content is evaluated, see /help buflist)

  - type: string

  - values: any string

  - default value: `"${color:default},"`

- buflist.format.indent

  - description: string displayed to indent channel, private and list buffers (note: content is evaluated, see /help buflist)

  - type: string

  - values: any string

  - default value: `" "`

- buflist.format.lag

  - description: format for lag on an IRC server buffer (note: content is evaluated, see /help buflist)

  - type: string

  - values: any string

  - default value: `" ${color:green}[${color:brown}${lag}${color:green}]"`

- buflist.format.name

  - description: format for buffer name (note: content is evaluated, see /help buflist)

  - type: string

  - values: any string

  - default value: `"${name}"`

- buflist.format.nick_prefix

  - description: format for nick prefix on a channel (note: content is evaluated, see /help buflist)

  - type: string

  - values: any string

  - default value: `"${color_nick_prefix}${nick_prefix}"`

- buflist.format.number

  - description: format for buffer number, ${number} is the indented number (note: content is evaluated, see /help buflist)

  - type: string

  - values: any string

  - default value: `"${color:green}${number}${if:${number_displayed}?.: }"`

- buflist.format.tls_version

  - description: format for TLS version on an IRC server buffer (note: content is evaluated, see /help buflist)

  - type: string

  - values: any string

  - default value: `" ${color:default}(${if:${tls_version}==TLS1.3?${color:green}:${if:${tls_version}==TLS1.2?${color:yellow}:${color:red}}}${translate:${tls_version}}${color:default})"`

- buflist.look.add_newline

  - description: add newline between the buffers displayed, so each buffer is displayed on a separate line (recommended); if disabled, newlines must be manually added in the formats with "${\n}", and the mouse actions are not possible anymore

  - type: boolean

  - values: on, off

  - default value: `on`

- buflist.look.auto_scroll

  - description: automatically scroll the buflist bar to always see the current buffer (this works only with a bar on the left/right position with a "vertical" filling); this value is the percent number of lines displayed before the current buffer when scrolling (-1 = disable scroll); for example 50 means that after a scroll, the current buffer is at the middle of bar, 0 means on top of bar, 100 means at bottom of bar

  - type: integer

  - values: -1 .. 100

  - default value: `50`

- buflist.look.display_conditions

  - description: conditions to display a buffer (note: content is evaluated, see /help buflist); for example to hide server buffers if they are merged with core buffer: "${buffer.hidden}==0 && ((${type}!=server && ${buffer.full_name}!=core.weechat) || ${buffer.active}==1)"

  - type: string

  - values: any string

  - default value: `"${buffer.hidden}==0"`

- buflist.look.enabled

  - description: enable buflist; it is recommended to use this option instead of just hiding the bar because it also removes some internal hooks that are not needed anymore when the bar is hidden; you can also use the command "/buflist toggle" or use the default key alt+shift+b

  - type: boolean

  - values: on, off

  - default value: `on`

- buflist.look.mouse_jump_visited_buffer

  - description: if enabled, clicks with left/right buttons on the line with current buffer jump to previous/next visited buffer

  - type: boolean

  - values: on, off

  - default value: `off`

- buflist.look.mouse_move_buffer

  - description: if enabled, mouse gestures (drag & drop) move buffers in list

  - type: boolean

  - values: on, off

  - default value: `on`

- buflist.look.mouse_wheel

  - description: if enabled, mouse wheel up/down actions jump to previous/next buffer in list

  - type: boolean

  - values: on, off

  - default value: `on`

- buflist.look.nick_prefix

  - description: get the nick prefix and its color from nicklist so that ${nick_prefix} can be used in format; this can be slow on buffers with lot of nicks in nicklist, so this option is disabled by default

  - type: boolean

  - values: on, off

  - default value: `off`

- buflist.look.nick_prefix_empty

  - description: when the nick prefix is enabled, display a space instead if there is no nick prefix on the buffer (only for channel, private and list buffers)

  - type: boolean

  - values: on, off

  - default value: `on`

- buflist.look.signals_refresh

  - description: comma-separated list of extra signals that are hooked and trigger the refresh of buffers list; this can be useful if some custom variables are used in formats and need specific refresh

  - type: string

  - values: any string

  - default value: `""`

- buflist.look.sort

  - description: comma-separated list of fields to sort buffers; each field is a hdata variable of buffer ("var"), a hdata variable of IRC server ("irc_server.var") or a hdata variable of IRC channel ("irc_channel.var"); char "-" can be used before field to reverse order, char "~" can be used to do a case-insensitive comparison; examples: "-~short_name" for case-insensitive and reverse sort on buffer short name, "-hotlist.priority,hotlist.time,hotlist.time_usec,number,-active" for sort like the hotlist then by buffer number for buffers without activity (note: the content is evaluated, before being split into fields, but at that time "bar_item" is the only variable that can be used, to distinguish between different buflist items, for example "${bar_item.name}")

  - type: string

  - values: any string

  - default value: `"number,-active"`

- buflist.look.use_items

  - description: number of buflist bar items that can be used; the item names are: "buflist", "buflist2", "buflist3", "buflist4" and "buflist5"; be careful, using more than one bar item slows down the display of buffers list

  - type: integer

  - values: 1 .. 5

  - default value: `1`

### 5.6. Tryb kursora

Tryb kursora pozwala na przesuwanie kurdsora w dowolne miejsce na ekranie, w obszarze czatu i paskach, i pozwala na wykonywanie akcji w danym miejscu.
Możesz wejść w tryb kursora za pomocą komendy `/cursor` lub za pomocą środkowego przycisku myszy (obsługa myszy musi być włączona za pomocą `Alt`+`m` lub komendy `/mouse enable`).

Typowym użyciem jest cytowanie wiadomości (obszar czatu) i interakcja z nickami (pasek z listą nicków).

Zobacz komendę /cursor i skróty klawiszowe w trybie kursora dla listy akcji dostępnych w tym trybie.

## 6. Skróty klawiszowe

WeeChat posiada wiele domyślnych skrótów opisanych w poniższych rozdziałach.
Można je zmienić oraz dodać nowe za pomocą komendy /key.

### 6.1. Skróty dla linii poleceń

#### Poruszanie kursora

Skrót | Opis | Komenda
--- | --- | ---
`←` `Shift`+`←` `Ctrl`+`b` | Idź do poprzedniego znaku w linii poleceń. | `/input move_previous_char`
`→` `Shift`+`→` `Ctrl`+`f` | Idź do następnego znaku w linii poleceń. | `/input move_next_char`
`Shift`+`↑` | Idź do poprzedniej linii. | `/input move_previous_line`
`Shift`+`↓` | Idź do następnej linii. | `/input move_next_line`
`Ctrl`+`←` `Alt`+`b` | Idź do poprzedniego słowa w linii poleceń. | `/input move_previous_word`
`Ctrl`+`→` `Alt`+`f` | Idź do następnego słowa w linii poleceń. | `/input move_next_word`
`Home` `Ctrl`+`a` | Idź na początek obecnej linii. | `/input move_beginning_of_line`
`Shift`+`Home` | Idź na początek lini poleceń. | `/input move_beginning_of_input`
`End` `Ctrl`+`e` | Idź na koniec obecnej linii. | `/input move_end_of_line`
`Shift`+`End` | Idż na koniec linii poleceń. | `/input move_end_of_input`

#### Edycja

Skrót | Opis | Komenda
--- | --- | ---
`Del` `Ctrl`+`d` | Usuń następny znak w linii poleceń. | `/input delete_next_char`
`Backspace` `Ctrl`+`h` | Usuń poprzedni znak w linii poleceń. | `/input delete_previous_char`
`Ctrl`+`k` | Usuń wszystko od kursora do końca obecnej linii (skasowany ciąg zostanie skopipowany do wewnętrznego schowka). | `/input delete_end_of_line`
`Alt`+`Ctrl`+`k` | Usuń wszystko od kursora do końca linii poleceń (skasowany ciąg zostanie skopipowany do wewnętrznego schowka). | `/input delete_end_of_input`
`Ctrl`+`t` | Przestaw znaki. | `/input transpose_chars`
`Ctrl`+`u` | Usuń wszystko od kursora do początku obecnej linii (skasowany ciąg zostanie skopipowany do wewnętrznego schowka). | `/input delete_beginning_of_line`
`Alt`+`Ctrl`+`u` | Usuń wszystko od kursora do początku linii poleceń (skasowany ciąg zostanie skopipowany do wewnętrznego schowka). | `/input delete_beginning_of_input`
`Alt`+`Backspace` | Usuń poprzednie słowo w linii poleceń (usuwany ciąg jest kopiowany do wewnętrznego schowka). | `/input delete_previous_word`
`Ctrl`+`w` | Usuń poprzednie słowo w linii poleceń do białego znaku (usuwany ciąg jest kopiowany do wewnętrznego schowka). | `/input delete_previous_word_whitespace`
`Ctrl`+`y` | Wkleja zawartość wewnętrznego schowka. | `/input clipboard_paste`
`Ctrl`+`_` | Cofnij poprzednia akcję w linii poleceń. | `/input undo`
`Alt`+`_` | Powtórz ostatnią akcję w linii poleceń. | `/input redo`
`Tab` | Dopełnij komendę lub nick (ponowne wciśnięcie `Tab`: znajdź następne dopełnienie). | `/input complete_next`
`Shift`+`Tab` | Bez dopełnienia: wykonaj częściowe dopełnienie, z oczekującym dopełnieniem: dopełnij z poprzednim dopełnieniem. | `/input complete_previous`
`Enter` `Ctrl`+`j` `Ctrl`+`m` | Wykonaj komendę lub wyślij wiadomość (w trybie wyszukiwania: przerwij wyszukiwanie). | `/input return`
`Alt`+`Enter` | Wstawia nową linię. | `/input insert \n`
`Alt`+`d` | Usuń następne słowo w linii poleceń (usuwany ciąg jest kopiowany do wewnętrznego schowka). | `/input delete_next_word`
`Alt`+`k` | Przechwyć wciśnięte klawisze i zwróć ich kod (i przypisaną komendę, jeśli istnieje) w linii poleceń. | `/input grab_key_command`
`Alt`+`r` | Usuń obecną linię. | `/input delete_line`
`Alt`+`R` | Usuń całą linię poleceń. | `/input delete_input`

#### Kolory

Skrót | Opis | Komenda
--- | --- | ---
`Ctrl`+`c`, `b` | Wstaw kod dla pogrubionego tekstu. | `/input insert \x02`
`Ctrl`+`c`, `c` | Wstaw kod dla kolorowego tekstu. | `/input insert \x03`
`Ctrl`+`c`, `d` | Wstaw kod dla kolorowego tekstu (kolor RGB jaki liczba szesnastkowa). | `/input insert \x04`
`Ctrl`+`c`, `i` | Wstaw kod dla pochyłego tekstu. | `/input insert \x1D`
`Ctrl`+`c`, `o` | Wstaw kod dla zresetowania koloru. | `/input insert \x0F`
`Ctrl`+`c`, `s` | Wstaw kod dla przekreślonego tekstu. | `/input insert \x1E`
`Ctrl`+`c`, `v` | Wstaw kod dla odwrócenia koloru. | `/input insert \x16`
`Ctrl`+`c`, `_` | Wstaw kod dla podkreślonego tekstu. | `/input insert \x1F`

#### Historia poleceń

Skrót | Opis | Komenda
--- | --- | ---
`↑` | Pokaż poprzednią komendę/wiadomość (w trybie wyszukiwania: szukaj w górę). | `/input history_previous`
`↓` | Pokaż następną komendę/wiadomość (w trybie wyszukiwania: szukaj w dół). | `/input history_next`
`Ctrl`+`↑` | Pokaż poprzednią komendę/wiadomość w historii globalnej (wspólnej dla wszystkich buforów). | `/input history_global_previous`
`Ctrl`+`↓` | Pokaż następną komendę/wiadomość w historii globalnej (wspólnej dla wszystkich buforów). | `/input history_global_next`

#### System

Skrót | Opis | Komenda
--- | --- | ---
`Ctrl`+`z` | Uśpij proces WeeChat. | `/sys suspend`

### 6.2. Bufory

Skrót | Opis | Komenda
--- | --- | ---
`Ctrl`+`r` | Szukaj tekstu w historii komend (zobacz skróty w kontekscie "histsearch"). | `/input search_history`
`Ctrl`+`s` | Szukaj tekstu w liniach bufora (zobacz skróty w kontekscie "search"). | `/input search_text_here`
`Ctrl`+`x` | Przełącz obecny bufor jeśli bufory są połączone pod tym samym numerem, na przykład przełącz na bufor innego serwera IRC. | `/buffer switch`
`Alt`+`x` | Pokaż wybrany z połączonych buforów (naciśnij `Alt`+`x` ponownie: wyświetl wszystkie połączone bufory). | `/buffer zoom`
`PgUp` | Przewiń jedną stronę w górę w historii bufora. | `/window page_up`
`PgDn` | Przewiń jedną stronę w dół w historii bufora. | `/window page_down`
`Alt`+`PgUp` | Przewiń w górę kilka linii w historii bufora. | `/window scroll_up`
`Alt`+`PgDn` | Przewiń w dół kilka linii w historii bufora. | `/window scroll_down`
`Alt`+`Home` | Przewiń na górę bufora. | `/window scroll_top`
`Alt`+`End` | Przewiń na dół bufora. | `/window scroll_bottom`
`Alt`+`←` `Alt`+`↑` `Ctrl`+`p` `F5` | Przełącz na poprzedni bufor. | `/buffer -1`
`Alt`+`→` `Alt`+`↓` `Ctrl`+`n` `F6` | Przełącz na następny bufor. | `/buffer +1`
`Alt`+`j`, `Alt`+`f` | Przełącz na pierwszy bufor. | `/buffer -`
`Alt`+`j`, `Alt`+`l` (`L`) | Przełącz na ostatni bufor. | `/buffer +`
`Alt`+`j`, `Alt`+`r` | Przełącz na bufor IRC raw. | `/server raw`
`Alt`+`j`, `Alt`+`s` | Przełącz na bufor serwera IRC. | `/server jump`
`Alt`+`0…​9` | Przełącz na bufor za pomocą liczb (0 = 10). | `/buffer *N`
`Alt`+`j`, `01…​99` | Przełącz na bufor za pomocą liczb. | `/buffer *NN`
`Alt`+`n` | Przewiń do następnego powiadomienia. | `/window scroll_next_highlight`
`Alt`+`p` | Przewiń do poprzedniego powiadomienia. | `/window scroll_previous_highlight`
`Alt`+`u` | Przewiń do pierwszej nieprzeczytanej linii w buforze. | `/window scroll_unread`
`Alt`+`Shift`+`U` | Ustaw znacznik nieprzeczytania we wszystkich buforach. | `/allbuf /buffer set unread`
`Alt`+`<` | Przełącz na poprzedni bufor z listy odwiedzonych buforów. | `/buffer jump prev_visited`
`Alt`+`>` | Przełącz na następny bufor z listy odwiedzonych buforów. | `/buffer jump next_visited`
`Alt`+`/` | Przełącz na ostatnio wyświetlony bufor (przed ostatnią zmianą bufora). | `/buffer jump last_displayed`

### 6.3. Okna

Skrót | Opis | Komenda
--- | --- | ---
`Ctrl`+`l` (`L`) | Przerysuj całe okno. | `/window refresh`
`Alt`+`l` (`L`) | Przełącz tryb niesformatowanego wyświetlania. | `/window bare`
`F7` | Przełącz na poprzednie okno. | `/window -1`
`F8` | Przełącz na następne okno. | `/window +1`
`Alt`+`w`, `Alt`+`↑` | Przełącz na okno wyżej. | `/window up`
`Alt`+`w`, `Alt`+`↓` | Przełącz na okno niżej. | `/window down`
`Alt`+`w`, `Alt`+`←` | Przełącz na okno z lewej. | `/window left`
`Alt`+`w`, `Alt`+`→` | Przełącz na okno z prawej. | `/window right`
`Alt`+`w`, `Alt`+`b` | Balansuj rozmiar wszystkich okien. | `/window balance`
`Alt`+`w`, `Alt`+`s` | Zamień bufory między dwoma oknami. | `/window swap`
`Alt`+`z` | Pokaż obecne okno (ponowne wciśnięcie `Alt`+`z`: przywraca wcześniejszy układ okien). | `/window zoom`

### 6.4. Paski

Skrót | Opis | Komenda
--- | --- | ---
`F1` `Ctrl`+`F1` | Przewiń do góry jedną stronę na liście buforów. | `/bar scroll buflist * -100%`
`F2` `Ctrl`+`F2` | Przewiń w dół jedną stronę na liście buforów. | `/bar scroll buflist * +100%`
`Alt`+`F1` | Idź na początek listy buforów. | `/bar scroll buflist * b`
`Alt`+`F2` | Idź na koniec listy buforów. | `/bar scroll buflist * e`
`F9` | Przewiń tytuł bufora w lewo. | `/bar scroll title * -30%`
`F10` | Przewiń tytuł bufora w prawo. | `/bar scroll title * +30%`
`F11` `Ctrl`+`F11` | Przewiń w górę jedna stronę listy nicków. | `/bar scroll nicklist * -100%`
`F12` `Ctrl`+`F12` | Przewiń w dół jedna stronę listy nicków. | `/bar scroll nicklist * +100%`
`Alt`+`F11` | Idź na początek listy nicków. | `/bar scroll nicklist * b`
`Alt`+`F12` | Idź na koniec listy nicków. | `/bar scroll nicklist * e`
`Alt`+`Shift`+`B` | Przełącz widoczność listy buforów. | `/buflist toggle`
`Alt`+`Shift`+`N` | Przełącza widoczność paska z listą nicków. | `/bar toggle nicklist`

### 6.5. Hotlista

Skrót | Opis | Komenda
--- | --- | ---
`Alt`+`a` | Przełącz na następny bufor z aktywnością (z priorytetem: powiadomienie, wiadomość, inne). | `/buffer jump smart`
`Alt`+`h`, `Alt`+`c` | Wyczyść hotliste (powiadomienia o aktywności w buforach). | `/hotlist clear`
`Alt`+`h`, `Alt`+`m` | Usuń obecny bufor z hotlisty. | `/hotlist remove`
`Alt`+`h`, `Alt`+`r` | Przywróć ostatnią usuniętą hotlistę w obecnym buforze. | `/hotlist restore`
`Alt`+`h`, `Alt`+`Shift`+`R` | Przywróć ostatnią hotlistę usuniętą we wszystkich buforach. | `/hotlist restore -all`

### 6.6. Włącz/wyłącz

Skrót | Opis | Komenda
--- | --- | ---
`Alt`+`m` | Włącz/wyłącz obsługę myszy. | `/mouse toggle`
`Alt`+`s` | Włącz/wyłącz sprawdzenie pisowni. | `/mute spell toggle`
`Alt`+`=` | Włącz/wyłącz filtry. | `/filter toggle`
`Alt`+`-` | Włącz/wyłącz filtry w bieżącym buforze. | `/filter toggle @`
`Alt`+`Ctrl`+`l` (`L`) | Przełącz między lokalnymi komendami a zdalnym buforem (relay "api"). | `/remote togglecmd`

### 6.7. Wyszukiwanie tekstu

Te skróty można użyć w kontskście "search" (kiedy `Ctrl`+`s` zostało wciśnięte do wyszukiwania tekstu w liniach bufora).

Skrót | Opis | Komenda
--- | --- | ---
`Ctrl`+`x` | Przełącz rodzaj wyszukiwania: ciąg (domyślne), wyrażenie regularne. | `/input search_switch_regex`
`Alt`+`c` | Przełącz dopasowywanie wielości liter podczas wyszukiwania. | `/input search_switch_case`
`Tab` | Przełącz miejsce wyszukiwania: wiadomości (domyślne), prefiksy, prefiksy + wiadmości. | `/input search_switch_where`
`Ctrl`+`r` `↑` | Poprzednie wystąpienie. | `/input search_previous`
`Ctrl`+`s` `↓` | Następne wystąpienie. | `/input search_next`
`Enter` `Ctrl`+`j` `Ctrl`+`m` | Zatrzymaj wyszukiwanie na obecnej pozycji. | `/input search_stop_here`
`Ctrl`+`q` | Zatrzymaj wyszukiwanie i przywróć ekran do stanu z przed wyszukiwania. | `/input search_stop`

### 6.8. Wyszukiwanie w historii komend

Te skróty można użyć w kontskście "histsearch" (kiedy `Ctrl`+`r` zostało wciśnięte do wyszukiwania tekstu w historii komend).

Skrót | Opis | Komenda
--- | --- | ---
`Ctrl`+`x` | Przełącz rodzaj wyszukiwania: ciąg (domyślne), wyrażenie regularne. | `/input search_switch_regex`
`Alt`+`c` | Przełącz dopasowywanie wielości liter podczas wyszukiwania. | `/input search_switch_case`
`Tab` | Przełącz przeszukiwanie w: lokalnej histori (domyślne), historia globalna. | `/input search_switch_where`
`Ctrl`+`r` `↑` | Szukaj we wcześniejszych (starszych) wpisach w historii. | `/input search_previous`
`Ctrl`+`s` `↓` | Szukaj w następnych (nowszych) wpisach w historii. | `/input search_next`
`Enter` `Ctrl`+`j` `Ctrl`+`m` | Zatrzymaj wyszukiwanie i użyj znalezionej komendy. | `/input search_stop_here`
`Ctrl`+`o` | Wykonaj komende znaleziona w historii i wstaw kolejna do linii poleceń. | `/input history_use_get_next`
`Ctrl`+`q` | Zatrzymaj wyszukiwanie i przywróć linię poleceń do początkowej wartości. | `/input search_stop`

### 6.9. Kursor

Te skróty są używane w kontekście kursora (dowolne przemieszczanie kursora na ekranie), zobacz tryb kursora.

Skrót | Obszar | Opis | Komenda
--- | --- | --- | ---
`↑` | - | Przesuń kursor linię wyżej. | `/cursor move up`
`↓` | - | Przesuń kursor linię niżej. | `/cursor move down`
`←` | - | Przesuń kursor kolumnę w lewo. | `/cursor move left`
`→` | - | Przesuń kursor kolumnę w prawo. | `/cursor move right`
`Alt`+`↑` | - | Przesuń kursor do pierwszej linii w obszarze. | `/cursor move edge_top`
`Alt`+`↓` | - | Przesuń kursor do ostatniej linii w obszarze. | `/cursor move edge_bottom`
`Alt`+`←` | - | Przesuń kursor do pierwszej kolumny w obszarze. | `/cursor move edge_left`
`Alt`+`→` | - | Przesuń kursor do ostatniej kolumny w obszarze. | `/cursor move edge_right`
`Alt`+`Home` | - | Przesuń kursor w górny lewy róg obszaru. | `/cursor move top_left`
`Alt`+`End` | - | Przesuń kursor w dolny prawy róg obszaru. | `/cursor move bottom_right`
`Alt`+`Shift`+`↑` | - | Przesuń kursor obszar do góry. | `/cursor move area_up`
`Alt`+`Shift`+`↓` | - | Przesuń kursor obszar w dół. | `/cursor move area_down`
`Alt`+`Shift`+`←` | - | Przesuń kursor obszar w lewo. | `/cursor move area_left`
`Alt`+`Shift`+`→` | - | Przesuń kursor obszar w prawo. | `/cursor move area_right`
`m` | chat | Cytuj wiadomość. | `hsignal:chat_quote_message;/cursor stop`
`l` | chat | Cytuj zaznaczoną linię. | `hsignal:chat_quote_focused_line;/cursor stop`
`q` | chat | Cytuj prefiks i wiadomość. | `hsignal:chat_quote_prefix_message;/cursor stop`
`Q` | chat | Cytuj czas, prefiks i wiadomość. | `hsignal:chat_quote_time_prefix_message;/cursor stop`
`b` | nicklist | Zbanuj osobę. | `/window ${_window_number};/ban ${nick}`
`k` | nicklist | Wykop osobę. | `/window ${_window_number};/kick ${nick}`
`K` | nicklist | Wykop i zbanuj osobę. | `/window ${_window_number};/kickban ${nick}`
`q` | nicklist | Otwórz rozmowę z osobą. | `/window ${_window_number};/query ${nick};/cursor stop`
`w` | nicklist | Wykonaj whois dla osoby. | `/window ${_window_number};/whois ${nick}`
`Enter` `Ctrl`+`j` `Ctrl`+`m` | - | Wyłącz tryb kursora. | `/cursor stop`

### 6.10. Mysz

Te akcje myszą mogą zostać użyte tylko jeśli obsługa myszy została włączona za pomocą skrótu `Alt`+`m` (komenda: `/mouse toggle`).

Klawisz/Wheel (1) | Gest | Obszar | Opis | Komenda
--- | --- | --- | --- | ---
`■ □ □` | - | chat | Przełącz na okno. | `/window ${_window_number}`
`■ □ □` | lewo | chat | Przełącz na poprzedni bufor. | `/window ${_window_number};/buffer +1`
`■ □ □` | prawo | chat | Przełącz na następny bufor. | `/window ${_window_number};/buffer +1`
`■ □ □` | lewo (długo) | chat | Przełącz na pierwszy bufor. | `/window ${_window_number};/buffer 1`
`■ □ □` | prawo (długo) | chat | Przełącz na ostatni bufor. | `/window ${_window_number};/buffer +`
`▲` | - | chat | Przewiń w górę kilka linii w historii bufora. | `/window scroll_up -window ${_window_number}`
`▼` | - | chat | Przewiń w dół kilka linii w historii bufora. | `/window scroll_down -window ${_window_number}`
`Ctrl`+`▲` | - | chat | Przewiń poziomo w lewo. | `/window scroll_horiz -window ${_window_number} -10%`
`Ctrl`+`▼` | - | chat | Przewiń poziomo w prawo. | `/window scroll_horiz -window ${_window_number} +10%`
`▲` | - | chat: bufor fset | Przewiń pięć linii w góre w buforze fset. | `/fset -up 5`
`▼` | - | chat: bufor fset | Przewiń pięć linii w dół w buforze fset. | `/fset -down 5`
`■ □ □` | - | chat: bufor fset | Zaznacz linię b buforze fset. | `/window ${_window_number};/fset -go ${fset_option_index}`
`□ □ ■` | - | chat: bufor fset | Przełącz (włącz/wyłącz) lub edytuj wartośc opcji. | `hsignal:fset_mouse`
`□ □ ■` | lewo | chat: bufor fset | Zmniejsz wartość zmiennej liczbowej / koloru / enum, ustaw/rozszerz wartośc innego typu. | `hsignal:fset_mouse`
`□ □ ■` | prawo | chat: bufor fset | Zwiększ wartość zmiennej liczbowej / koloru / enum, ustaw/rozszerz wartośc innego typu. | `hsignal:fset_mouse`
`□ □ ■` | góra / dół | chat: bufor fset | Zaznacz/odznacz wiele opcji. | `hsignal:fset_mouse`
`▲` | - | chat: /list buffer | Przesuń pięć linii w górę w buforze /list. | `/list -up 5`
`▼` | - | chat: /list buffer | Przesuń pięć linii w dół w buforze /list. | `/list -down 5`
`■ □ □` | - | chat: /list buffer | Wybierz linię w buforze /list. | `/window ${_window_number};/list -go ${_chat_line_y}`
`□ □ ■` | - | chat: /list buffer | Wejdź na kanał IRC w zaznaczonej linii. | `hsignal:irc_list_mouse`
`▲` | - | chat: bufor skryptów | Przejdź 5 linii w górę w buforze skryptów. | `/script -up 5`
`▼` | - | chat: bufor skryptów | Przejdź 5 linii w dół w buforze skryptów. | `/script -down 5`
`■ □ □` | - | chat: bufor skryptów | Zaznacz linię w buforze skryptów. | `/script -go ${_chat_line_y}`
`□ □ ■` | - | chat: bufor skryptów | Zainstaluj/usuń skrypt. | `/script -go ${_chat_line_y};/script installremove -q ${script_name_with_extension}`
`■ □ □` | góra / lewo | buflist | Przenieś bufor na niższy numer. | Sygnał `buflist_mouse`.
`■ □ □` | dół / prawo | buflist | Przenieś bufor na wyższy numer. | Sygnał `buflist_mouse`.
`■ □ □` | - | buflist | Przełącz na bufor (poprzednio odwiedzony bufor, jeśli jest to obecny bufor). | Sygnał `buflist_mouse`.
`□ □ ■` | - | buflist | Przełącz na następny odwiedzony bufor, jeśli jest to obecny bufor. | Sygnał `buflist_mouse`.
`Ctrl`+`▲` | - | buflist | Przełącz na poprzedni bufor. | Sygnał `buflist_mouse`.
`Ctrl`+`▼` | - | buflist | Przełącz na następny bufor. | Sygnał `buflist_mouse`.
`■ □ □` | góra | lista nicków | Przewiń w górę jedna stronę listy nicków. | `/bar scroll nicklist ${_window_number} -100%`
`■ □ □` | dół | lista nicków | Przewiń w dół jedna stronę listy nicków. | `/bar scroll nicklist ${_window_number} +100%`
`■ □ □` | góra (długo) | lista nicków | Idź na początek listy nicków. | `/bar scroll nicklist ${_window_number} b`
`■ □ □` | dół (długo) | lista nicków | Idź na koniec listy nicków. | `/bar scroll nicklist ${_window_number} e`
`■ □ □` | - | lista nicków | Otwórz prywatną rozmowę z nick. | `/window ${_window_number};/query ${nick}`
`□ □ ■` | - | lista nicków | Wykonaj whois dla nicka. | `/window ${_window_number};/whois ${nick}`
`■ □ □` | lewo | lista nicków | Wykop nick. | `/window ${_window_number};/kick ${nick}`
`■ □ □` | lewo (długo) | lista nicków | Wykop i zbanuj nick. | `/window ${_window_number};/kickban ${nick}`
`□ □ ■` | lewo | lista nicków | Zbanuj nick. | `/window ${_window_number};/ban ${nick}`
`□ □ ■` | - | linia poleceń | Przechwyć zdarzenie myszy i wstaw jego kod w linii poleceń. | `/input grab_mouse_area`
`▲` | - | dowolny pasek | Przewiń pasek o -20%. | `/bar scroll ${_bar_name} ${_window_number} -20%`
`▼` | - | dowolny pasek | Przewiń pasek o +20%. | `/bar scroll ${_bar_name} ${_window_number} +20%`
`□ ■ □` | - | gdziekolwiek | Włącz tryb kursora w tym miejscu. | `/cursor go ${_x},${_y}`

Notka | (1) Przyciski: `◼ □ □`: kliknięcie lewym przyciskiem `□ ◼ □`: kliknięcie środkowym przyciskiem `□ □ ◼`: kliknięcie prawym przyciskiem Kółko: `▲`: w górę `▼`: w dół

### 6.11. Bufor fset

Poniższe skróty i akcje mogą zostać użyte w buforze fset (zobacz wtyczka fset).

Skrót | Akcja (1) | Opis | Komenda
--- | --- | --- | ---
`↑` |  | Przejdź linię wyżej. | `/fset -up`
`↓` |  | Przejdź linię niżej. | `/fset -down`
`PgUp` |  | Przejdź stronę do góry. | `/window page_up`
`PgDn` |  | Przejdź stronę w dół. | `/window page_down`
`Alt`+`Home` | `<<` | Przejdź do pierwszej linii. | `/fset -go 0`
`Alt`+`End` | `>>` | Przejdź do ostatniej linii. | `/fset -go end`
`F11` | `<` | Przewiń poziomo w lewo. | `/fset -left`
`F12` | `>` | Przewiń poziomo w prawo. | `/fset -right`
`Alt`+`Space` | `t` | Przełącz zmienną boolowską. | `/fset -toggle`
`Alt`+`-` | `-` | Odejmij 1 od wartości liczbowej/koloru/enum, ustaw wartość pozostałych typów. | `/fset -del -1`
`Alt`+`+` | `+` | Dodaj 1 do wartości liczbowej/koloru/enum, dodaj to wartości pozostałych typów. | `/fset -add 1`
`Alt`+`f`, `Alt`+`r` | `r` | Zresetuj wartość. | `/fset -reset`
`Alt`+`f`, `Alt`+`u` | `u` | Skasuj wartość. | `/fset -unset`
`Alt`+`Enter` | `s` | Ustaw wartość. | `/fset -set`
`Alt`+`f`, `Alt`+`n` | `n` | Ustaw nową wartość. | `/fset -setnew`
`Alt`+`f`, `Alt`+`a` | `a` | Dodaj do wartości. | `/fset -append`
`Alt`+`,` | `,` | Zaznacz/odznacz opcję. | `/fset -mark 1`
`Shift`+`↑` |  | Przejdź do linii wyżej oraz zaznacz/odznacz opcję. | `/fset -up; /fset -mark`
`Shift`+`↓` |  | Przejdź do linii niżej oraz zaznacz/odznacz opcję. | `/fset -mark; /fset -down`
| `m:xxx` | Zaznacz wyświetlane opcje pasujące do filtra "xxx" (dowolny filtr na opcję albo wartość, zobacz komenda /fset). |
| `u:xxx` | Odznacz zaznaczone opcje pasujące do filtra "xxx" (dowolny filtr an opcję lub wartość, zobacz komenda /fset). |
`Ctrl`+`l` (`L`) |  | Odświerz opcje i cały ekran. | `/fset -refresh`
| `$` | Odświerz opcje (zachowuje zaznaczone opcje). |
| `$$` | Odświerz opcje (odznacza zaznaczone kompilację). |
`Alt`+`p` | `p` | Przełącz opcje opisu wtyczki (`plugins.desc.*`). | `/mute /set fset.look.show_plugins_desc toggle`
`Alt`+`v` | `v` | Przełącz pasek pomocy. | `/bar toggle fset`
| `s:x,y` | Sortuj opcje po polach x,y (zobacz opcję fset.look.sort). | `/mute /set fset.look.sort x,y`
| `s:` | Zresetuj soerowanie do domyślnej wartości (zobacz opcję fset.look.sort). | `/mute /unset fset.look.sort`
| `w:xxx` | Wyeksportuj opcje do pliku "xxx". | `/fset -export xxx`
| `w-:xxx` | Wyeksportuj opcje do pliku "xxx" bez dodatkowych informacji. | `/fset -export -nohelp xxx`
| `w+:xxx` | Wyeksportuj opcje do pliku "xxx" z dodatkowymi informacjami. | `/fset -export -help xxx`
`Ctrl`+`x` | `x` | Zmień format w jakim wyświetlane są opcje. | `/fset -format`
| `q` | Zamkknij bufor fset. | `/buffer close`

Notka | (1) Akcja musi zostać wprowadzona z linii poleceń i potwierdzona przez `Enter`.

### 6.12. Bufor IRC /list

Te skróty i akcje mogą zostać użyte w buforze IRC /list (zobacz komendę /list).

Skrót | Akcja (1) | Opis | Komenda
--- | --- | --- | ---
`↑` |  | Przejdź linię wyżej. | `/list -up`
`↓` |  | Przejdź linię niżej. | `/list -down`
`PgUp` |  | Przejdź stronę do góry. | `/window page_up`
`PgDn` |  | Przejdź stronę w dół. | `/window page_down`
`Alt`+`Home` | `<<` | Przejdź do pierwszej linii. | `/list -go 0`
`Alt`+`End` | `>>` | Przejdź do ostatniej linii. | `/list -go end`
`F11` | `<` | Przewiń poziomo w lewo. | `/list -left`
`F12` | `>` | Przewiń poziomo w prawo. | `/list -right`
`Ctrl`+`j` | `j` | Wejdź na kanał IRC z zaznaczonej linii. | `/list -join`
| `xxx` | Pokaż tylko kanały z "xxx" w nazwie lub temacie (wielkość liter nie jest uwzględniana). |
| `n:xxx` | Pokaż tylko kanały z "xxx" w nazwie (wielkość liter nie jest uwzględniana). |
| `t:xxx` | Pokaż tylko kanały z "xxx" w temacie (wielkość liter nie jest uwzględniana). |
| `u:n` | Pokaż tylko kanały z przynajmniej "n" użytkownikami. |
| `u:>n` | Pokaż tylko kanały z więcej niż "n" użytkownikami. |
| `u:<n` | Pokaż tylko kanały z mniej niż "n" użytkownikami. |
| `c:xxx` | Pokaż tylko kanały pasujące do przetworzonego warunku "xxx", z użyciem następujących zmiennych: name, name2, users, topic. |
| `s:x,y` | Sortuj kanały po polach x,y (zobacz komendę /list). |
| `s:` | Zresetuj sortowanie do domyślnej wartości (zobacz komendę /list). |
| `$` | Odświerz listę (wykonaj ponownie komendę /list). |
| `q` | Zamknij bufor. | `/buffer close`

Notka | (1) Akcja musi zostać wprowadzona z linii poleceń i potwierdzona przez `Enter`.

### 6.13. Bufor skryptów

Te skróty klawiszowe i akcje mogą zostać użyte w buforze skryptów (zobacz manager skryptów).

Skrót | Akcja (1) | Opis | Komenda
--- | --- | --- | ---
`↑` |  | Przejdź linię wyżej. | `/script -up`
`↓` |  | Przejdź linię niżej. | `/script -down`
`PgUp` |  | Przewiń stronę do góry. | `/window page_up`
`PgDn` |  | Przewiń stronę w dół. | `/window page_down`
`Alt`+`i` | `i` | Zainstaluj skrypt. | `/script install`
`Alt`+`r` | `r` | Usuń skrypt. | `/script remove`
`Alt`+`l` | `l` | Załaduj skrypt. | `/script load`
`Alt`+`L` | `L` | Przeładuj skrypt. | `/script reload`
`Alt`+`u` | `u` | Wyładuj skrypt. | `/script unload`
`Alt`+`Shift`+`A` | `A` | Automatycznie ładuj skrypt. | `/script toggleautoload`
`Alt`+`h` | `h` | Zablokuj/odblokuj skrypt. | `/script hold`
`Alt`+`v` | `v` | Pokarz skrypt. | `/script show`
| `s:x,y` | Sortuj skrypty po polach x,y (zobacz opcję script.look.sort). |
| `s:` | Zresetuj sortowanie do domyślnej wartości (zobacz opcję script.look.sort). |
| `$` | Odświerza listę. |
| `q` | Zamyka bufor. | `/buffer close`

Notka | (1) Akcja musi zostać wprowadzona z linii poleceń i potwierdzona przez `Enter`.

## 7. Konfiguracja

### 7.1. Fset

Wtyczka Fast Set wyświetla listę opcji w buforze i pomaga w ustawianiu opcji WeeChat i wtyczek.

Przykład bufora fset wyświetlający opcje zaczynające się od `weechat.look` :

    ┌──────────────────────────────────────────────────────────────────────────────────────┐
    │1.weechat│7/125 | Filtr: weechat.look.* | Sortowanie: ~name | Klawisz(wejście): alt+>>│
    │2.fset   │weechat.look.bare_display_exit_on_input: wyjście z trybu niesformatowanego w│
    │         │yświetlania po każdej zmianie wejścia [domyślnie: on]                       │
    │         │----------------------------------------------------------------------------│
    │         │  weechat.look.align_end_of_lines              enum    message              │
    │         │  weechat.look.align_multiline_words           bool    on                   │
    │         │  weechat.look.bar_more_down                   ciąg    "++"                 │
    │         │  weechat.look.bar_more_left                   ciąg    "<<"                 │
    │         │  weechat.look.bar_more_right                  ciąg    ">>"                 │
    │         │  weechat.look.bar_more_up                     ciąg    "--"                 │
    │         │  weechat.look.bare_display_exit_on_input      bool    on                   │
    │         │  weechat.look.bare_display_time_format        ciąg    "%H:%M"              │
    │         │  weechat.look.buffer_auto_renumber            bool    on                   │
    │         │  weechat.look.buffer_notify_default           enum    all                  │
    │         │  weechat.look.buffer_position                 enum    end                  │
    │         │  weechat.look.buffer_search_case_sensitive    bool    off                  │
    │         │  weechat.look.buffer_search_force_default     bool    off                  │
    │         │  weechat.look.buffer_search_history           enum    local                │
    │         │  weechat.look.buffer_search_regex             bool    off                  │
    │         │  weechat.look.buffer_search_where             enum    prefix_message       │
    │         │  weechat.look.buffer_time_format              ciąg    "%H:%M:%S"           │
    │         │[12:55] [2] [fset] 2:fset                                                   │
    │         │█                                                                           │
    └──────────────────────────────────────────────────────────────────────────────────────┘

#### Komendy

- `fset`: fast set WeeChat and plugins options

    /fset  -bar
           -refresh
           -up|-down [<number>]
           -left|-right [<percent>]
           -go <line>|end
           -toggle
           -add [<value>]
           -reset
           -unset
           -set
           -setnew
           -append
           -mark
           -format
           -export [-help|-nohelp] <filename>
           -import <filename>
           <filter>

        -bar: add the help bar
    -refresh: refresh list of options, then whole screen (command: /window refresh)
         -up: move the selected line up by "number" lines
       -down: move the selected line down by "number" lines
       -left: scroll the buffer by "percent" of width on the left
      -right: scroll the buffer by "percent" of width on the right
         -go: select a line by number, first line number is 0 ("end" to select the last line)
     -toggle: toggle the boolean value
        -add: add "value" (which can be a negative number) for integers, colors and enums, set/append to value for other types (set for a negative value, append for a positive value)
      -reset: reset the value of option
      -unset: unset the option
        -set: add the /set command in input to edit the value of option (move the cursor at the beginning of value)
     -setnew: add the /set command in input to edit a new value for the option
     -append: add the /set command to append something in the value of option (move the cursor at the end of value)
       -mark: toggle mark
     -format: switch to the next available format
     -export: export the options and values displayed to a file (each line has format: "/set name value" or "/unset name")
     -import: import the options from a file (all lines containing commands are executed)
       -help: force writing of help on options in exported file (see /help fset.look.export_help_default)
     -nohelp: do not write help on options in exported file (see /help fset.look.export_help_default)
      filter: set a new filter to see only matching options (this filter can be used as input in fset buffer as well); allowed formats are:
              `*`: show all options (no filter)
              `xxx`: show only options with "xxx" in name
              `f:xxx`: show only configuration file "xxx"
              `t:xxx`: show only type "xxx" (bool/int/str/col/enum or boolean/integer/string/color/enum)
              `d`: show only changed options
              `d:xxx`: show only changed options with "xxx" in name
              `d=xxx`: show only changed options with "xxx" in value
              `d==xxx`: show only changed options with exact value "xxx"
              `h=xxx`: show only options with "xxx" in description (translated)
              `he=xxx`: show only options with "xxx" in description (in English)
              `=xxx`: show only options with "xxx" in value
              `==xxx`: show only options with exact value "xxx"
              `c:xxx`: show only options matching the evaluated condition "xxx", using following variables: file, section, option, name, parent_name, type, type_en, type_short (bool/int/str/col/enum), type_tiny (b/i/s/c/e), default_value, default_value_undef, value, quoted_value, value_undef, value_changed, parent_value, min, max, description, description2, description_en, description_en2, string_values, allowed_values

    The lines with options are displayed using string evaluation (see /help eval for the format), with these options:
      - fset.format.option1: first format for an option
      - fset.format.option2: second format for an option

    The following variables can be used in these options:
      - option data, with color and padded by spaces on the right:
        - ${file}: configuration file (for example "weechat" or "irc")
        - ${section}: section
        - ${option}: option name
        - ${name}: full option name (file.section.option)
        - ${parent_name}: parent option name
        - ${type}: option type (translated)
        - ${type_en}: option type (in English)
        - ${type_short}: short option type (bool/int/str/col/enum)
        - ${type_tiny}: tiny option type (b/i/s/c/e)
        - ${default_value}: option default value
        - ${default_value_undef}: "1" if default value is null, otherwise "0"
        - ${value}: option value
        - ${value_undef}: "1" if value is null, otherwise "0"
        - ${value_changed}: "1" if value is different from default value, otherwise "0"
        - ${value2}: option value, with inherited value if null
        - ${parent_value}: parent option value
        - ${min}: min value
        - ${max}: max value
        - ${description}: option description (translated)
        - ${description2}: option description (translated), "(no description)" (translated) if there's no description
        - ${description_en}: option description (in English)
        - ${description_en2}: option description (in English), "(no description)" if there's no description
        - ${string_values}: string values allowed for set of an enum option
        - ${allowed_values}: allowed values
        - ${marked}: "1" if option is marked, otherwise "0"
        - ${index}: index of option in list
      - option data, with color but no spaces:
        - same names prefixed by underscore, for example: ${_name}, ${_type}, ...
      - option data, raw format (no colors/spaces):
        - same names prefixed by two underscores, for example: ${__name}, ${__type}, ...
      - option data, only spaces:
        - same names prefixed with "empty_", for example: ${empty_name}, ${empty_type}
      - other data:
        - ${selected_line}: "1" if the line is selected, otherwise "0"
        - ${newline}: insert a new line at point, so the option is displayed on multiple lines

    For keys, input and mouse actions on the buffer, see key bindings in User's guide.

    Note: if input has one or more leading spaces, the following text is interpreted as a filter, without the spaces. For example " q" searches all options with "q" inside name while "q" closes the fset buffer.

    Examples:
      /fset d:irc.*
      /fset nicklist
      /fset =red
      /fset ==red
      /fset c:${file} == irc && ${type_en} == integer

#### Opcje

Sekcje w pliku fset.conf:

Sekcja | Komenda | Opis
--- | --- | ---
`color` | `/set fset.color.*` | Kolory.
`format` | `/set fset.format.*` | Formaty używane do wyświetlenia listy opcji.
`look` | `/set fset.look.*` | Wygląd.

Opcje:

- fset.color.allowed_values

  - description: color for allowed values

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `default`

- fset.color.allowed_values_selected

  - description: color for allowed values on the selected line

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `white`

- fset.color.color_name

  - description: color for color name when option fset.look.use_color_value is enabled

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `246`

- fset.color.color_name_selected

  - description: color for color name on the selected line when option fset.look.use_color_value is enabled

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `default`

- fset.color.default_value

  - description: color for default value

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `default`

- fset.color.default_value_selected

  - description: color for default value on the selected line

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `white`

- fset.color.description

  - description: color for description

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `242`

- fset.color.description_selected

  - description: color for description on the selected line

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `default`

- fset.color.file

  - description: color for file

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `default`

- fset.color.file_changed

  - description: color for file if value is changed

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `brown`

- fset.color.file_changed_selected

  - description: color for file if value is changed on the selected line

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `yellow`

- fset.color.file_selected

  - description: color for file on the selected line

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `white`

- fset.color.help_default_value

  - description: color for default value in help bar

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `white`

- fset.color.help_description

  - description: color for description in help bar

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `default`

- fset.color.help_name

  - description: color for name in help bar

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `white`

- fset.color.help_quotes

  - description: color for quotes around string values

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `darkgray`

- fset.color.help_values

  - description: color for allowed values

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `default`

- fset.color.index

  - description: color for index of option

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `cyan`

- fset.color.index_selected

  - description: color for index of option on the selected line

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `lightcyan`

- fset.color.line_marked_bg1

  - description: background color for a marked line (used with the first format, see option fset.format.option1)

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `17`

- fset.color.line_marked_bg2

  - description: background color for a marked line (used with the second format, see option fset.format.option2)

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `17`

- fset.color.line_selected_bg1

  - description: background color for the selected line (used with the first format, see option fset.format.option1)

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `24`

- fset.color.line_selected_bg2

  - description: background color for the selected line (used with the second format, see option fset.format.option2)

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `24`

- fset.color.marked

  - description: color for mark indicator

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `brown`

- fset.color.marked_selected

  - description: color for mark indicator on the selected line

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `yellow`

- fset.color.max

  - description: color for max value

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `default`

- fset.color.max_selected

  - description: color for max value on the selected line

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `white`

- fset.color.min

  - description: color for min value

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `default`

- fset.color.min_selected

  - description: color for min value on the selected line

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `white`

- fset.color.name

  - description: color for name

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `default`

- fset.color.name_changed

  - description: color for name if value is changed

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `185`

- fset.color.name_changed_selected

  - description: color for name if value is changed on the selected line

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `yellow`

- fset.color.name_selected

  - description: color for name on the selected line

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `white`

- fset.color.option

  - description: color for option

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `default`

- fset.color.option_changed

  - description: color for option if value is changed

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `brown`

- fset.color.option_changed_selected

  - description: color for option if value is changed on the selected line

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `yellow`

- fset.color.option_selected

  - description: color for option on the selected line

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `white`

- fset.color.parent_name

  - description: color for name of parent option

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `default`

- fset.color.parent_name_selected

  - description: color for name of parent option on the selected line

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `white`

- fset.color.parent_value

  - description: color for value of parent option

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `cyan`

- fset.color.parent_value_selected

  - description: color for value of parent option on the selected line

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `lightcyan`

- fset.color.quotes

  - description: color for quotes around string values

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `darkgray`

- fset.color.quotes_changed

  - description: color for quotes around string values which are changed

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `default`

- fset.color.quotes_changed_selected

  - description: color for quotes around string values which are changed on the selected line

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `white`

- fset.color.quotes_selected

  - description: color for quotes around string values on the selected line

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `default`

- fset.color.section

  - description: color for section

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `default`

- fset.color.section_changed

  - description: color for section if value is changed

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `brown`

- fset.color.section_changed_selected

  - description: color for section if value is changed on the selected line

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `yellow`

- fset.color.section_selected

  - description: color for section on the selected line

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `white`

- fset.color.string_values

  - description: color for string values

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `default`

- fset.color.string_values_selected

  - description: color for string values on the selected line

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `white`

- fset.color.title_count_options

  - description: color for the count of options found with the current filter in title of buffer

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `cyan`

- fset.color.title_current_option

  - description: color for current option number in title of buffer

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `lightcyan`

- fset.color.title_filter

  - description: color for filter in title of buffer

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `yellow`

- fset.color.title_marked_options

  - description: color for number of marked options in title of buffer

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `lightgreen`

- fset.color.title_sort

  - description: color for sort in title of buffer

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `white`

- fset.color.type

  - description: color for type

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `138`

- fset.color.type_selected

  - description: color for type on the selected line

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `216`

- fset.color.unmarked

  - description: color for mark indicator when the option is not marked

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `default`

- fset.color.unmarked_selected

  - description: color for mark indicator when the option is not marked on the selected line

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `white`

- fset.color.value

  - description: color for value

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `38`

- fset.color.value_changed

  - description: color for value changed (different from default)

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `185`

- fset.color.value_changed_selected

  - description: color for value changed (different from default) on the selected line

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `yellow`

- fset.color.value_selected

  - description: color for value on the selected line

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `159`

- fset.color.value_undef

  - description: color for undefined value

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `magenta`

- fset.color.value_undef_selected

  - description: color for undefined value on the selected line

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `lightmagenta`

- fset.format.export_help

  - description: format of help line written before each option exported in a file (note: content is evaluated, see /help fset)

  - type: string

  - values: any string

  - default value: `"# ${description2}"`

- fset.format.export_option

  - description: format of each option exported in a file (note: content is evaluated, see /help fset)

  - type: string

  - values: any string

  - default value: `"/set ${name} ${quoted_value}"`

- fset.format.export_option_null

  - description: format of each option with "null" value exported in a file (note: content is evaluated, see /help fset)

  - type: string

  - values: any string

  - default value: `"/unset ${name}"`

- fset.format.option1

  - description: first format of each line, used when option fset.look.format_number is set to 1 (note: content is evaluated, see /help fset); an empty string uses the default format ("${marked} ${name} ${type} ${value2}"), which is without evaluation of string and then much faster; formats can be switched with key ctrl-x

  - type: string

  - values: any string

  - default value: `""`

- fset.format.option2

  - description: second format of each line, used when option fset.look.format_number is set to 2 (note: content is evaluated, see /help fset); an empty string uses the default format ("${marked} ${name} ${type} ${value2}"), which is without evaluation of string and then much faster; formats can be switched with key ctrl-x

  - type: string

  - values: any string

  - default value: `"${marked} ${name} ${type} ${value2}${newline} ${empty_name} ${_default_value}${color:244} -- ${_allowed_values}${newline} ${empty_name} ${_description}"`

- fset.look.auto_refresh

  - description: comma separated list of options to automatically refresh on the fset buffer (if opened); "*" means all options (recommended), a name beginning with "!" is a negative value to prevent an option to be refreshed, wildcard "*" is allowed in names (example: "*,!plugin.section.*")

  - type: string

  - values: any string

  - default value: `"*"`

- fset.look.auto_unmark

  - description: automatically unmark all options after an action on marked options or after a refresh

  - type: boolean

  - values: on, off

  - default value: `off`

- fset.look.condition_catch_set

  - description: condition to catch /set command and display results in the fset buffer; following variables can be used: ${name} (name of option given for the /set command), ${count} (number of options found with the /set argument); an empty string disables the catch of /set command; with value "1", the fset buffer is always used with /set command

  - type: string

  - values: any string

  - default value: `"${count} >= 1"`

- fset.look.export_help_default

  - description: write help for each option exported by default (this can be overridden with arguments "-help" and "-nohelp" for command /fset -export)

  - type: boolean

  - values: on, off

  - default value: `on`

- fset.look.format_number

  - description: number of format used to display options; this is dynamically changed by the key ctrl-x on the fset buffer

  - type: integer

  - values: 1 .. 2

  - default value: `1`

- fset.look.marked_string

  - description: string displayed when an option is marked (to do an action on multiple options)

  - type: string

  - values: any string

  - default value: `"*"`

- fset.look.scroll_horizontal

  - description: left/right scroll in fset buffer (percent of width)

  - type: integer

  - values: 1 .. 100

  - default value: `10`

- fset.look.show_plugins_desc

  - description: show the plugin description options (plugins.desc.*)

  - type: boolean

  - values: on, off

  - default value: `off`

- fset.look.sort

  - description: comma-separated list of fields to sort options (see /help fset for a list of fields); char "-" can be used before field to reverse order, char "~" can be used to do a case-insensitive comparison; example: "-~name" for case-insensitive and reverse sort on option name

  - type: string

  - values: any string

  - default value: `"~name"`

- fset.look.unmarked_string

  - description: string displayed when an option is not marked

  - type: string

  - values: any string

  - default value: `" "`

- fset.look.use_color_value

  - description: use the color to display value of color options

  - type: boolean

  - values: on, off

  - default value: `on`

- fset.look.use_keys

  - description: use keys alt+X in fset buffer to do actions on options; if disabled, only the input is allowed

  - type: boolean

  - values: on, off

  - default value: `on`

- fset.look.use_mute

  - description: use /mute command to set options

  - type: boolean

  - values: on, off

  - default value: `off`

### 7.2. Kolory

#### Podstawowe kolory

Podstawowe kolory w WeeChat to:

Nazwa | Kolor
--- | ---
`default` | Domyślny kolor terminala (przezroczysty dla tła)
`black` | Czarny
`darkgray` | Ciemny szary
`red` | Ciemny czerwony
`lightred` | Jasny czerwony
`green` | Ciemny zielony
`lightgreen` | Jasny zielony
`brown` | Brązowy
`yellow` | Żółty
`blue` | Ciemny niebieski
`lightblue` | Jasny niebieski
`magenta` | Ciemny karmazynowy
`lightmagenta` | Jasny karmazynowy
`cyan` | Ciemny błękitny
`lightcyan` | Jasny błękitny
`gray` | Szary
`white` | Biały

#### Rozszerzone kolory

WeeChat dynamicznie alokuje pary kolorów, kiedy kolory są używane na ekranie (do wyświetlania buforów i pasków).

W dodatku do podstawowych kolorów, możesz użyć numer koloru pomiędzy 1 a limitem twojego terminala.

Użyj komendy `/color`, aby zobaczyć obecne kolory i limity. Za pomocą `Alt`+`c` możesz tymczasowo przełączyć się na kolory terminala, żeby wybrać kolor.

Na przykład jeśli chcesz wyświetlać czas na pomarańczowo w buforze:

    /set weechat.color.chat_time 214

Lub jeśli chcesz mocno ciemno zielonego tła dla pasku statusu:

    /set weechat.bar.status.color_bg 22

#### Aliasy

Możesz dodać aliasy do kolorów za pomocą komendy `/color alias` i używać ich w dowolnej opcji jako koloru.

Na przykład:

    /color alias 214 orange
    /set weechat.color.chat_delimiters orange

#### Atrybuty

Możliwe jest użycie niektórych atrybutów dla kolorów. Jeden lub więcej z nich może zostać użyty przed nazwą lub numerem koloru:

- `%`: mruganie

- `.`: "przyciemnienie" (połowa jasności)

- `*` : pogrubiony tekst

- `!` : odwrócenie video

- `/` : pochyły

- `_` : podkreślony tekst

- `|`: zachowuje atrybuty: nie resetuje blink/dim/bold/reverse/italic/underlined przy zmianie koloru

Na przykład jeśli chcesz, żeby twój nick był biały i podkreślony:

    /set weechat.color.chat_nick_self _white

Lub jeśli chcesz, żeby czas w pasku statusu był pomarańczowy, podkreślony i pogrubiony:

    /set weechat.color.status_time *_214

Aby użyć atrybutu z domyślnym kolorem terminala (-1), należy użyć numeru większego od ostatniego koloru terminala, na przykład maksymalny kolor w WeeChat: 99999.

Przykład pogrubienia z domyślnym kolorem terminala:

    /set weechat.color.status_time *99999

### 7.3. Charset

Wtyczka charset pozwala na zmianę kodowania dla wysyłanych i otrzymywanych danych.

Można zdefiniować domyślne kodowanie, oraz dla poszczególnych buforów (lub grup buforów).

Ta wtyczka jest opcjonalna, jednak zalecana: jeśli nie jest załadowana WeeChat może odczytywać/zapisywać dane tylko w UTF-8.

Ta wtyczka powinna zostać automatycznie załadowana przy uruchomieniu WeeChat. Aby się upewnić, że została załadowana, spróbuj:

    /charset

Jeśli komenda nie zostanie znaleziona, załaduj tą wtyczkę za pomocą:

    /plugin load charset

Jeśli wtyczka nie zostanie znaleziona, powinieneś skompilować ponownie WeeChat z wtyczkami i wsparciem dla charset.

Kiedy wtyczka charset zostanie uruchomiona wyświetla kodowanie terminala i. wewnętrzne. Kodowanie terminala zależy od ustawień systemu, a wewnętrzne to UTF-8.

Na przykład:

    charset: terminal: ISO-8859-15, internal: UTF-8

#### Ustawianie kodowania

Żeby ustawić globalne kodowanie dla wysyłanych i otrzymywanych danych należy użyć komendy `/set`.

Na przykład:

    /set charset.default.decode ISO-8859-15
    /set charset.default.encode ISO-8859-15

Jeżeli globalna wartość dla kodowania nie jest ustawiona (na przykład podczas pierwszego zaladowania wtyczki), zostanie automatycznie ustawione na kodowanie terminala (jeśli jest inne niż UTF-8), lub domyślnie na ISO-8859-1.

Domyślnie kodowanie dla wysyłanych danych nie jest ustawione, dane domyślnie wysyłane są w kodowaniu wewnętrznym (UTF-8).

W celu ustawienia kodowania dla serwera IRC, należy wywołać komendę `/charset` w buforze serwera. Jeśli zostanie podane tylko kodowanie, zostanie ono użyte dla wysyłania i odbioru.

Na przykład:

    /charset ISO-8859-15

Jest równoważne z:

    /charset decode ISO-8859-15
    /charset encode ISO-8859-15

Aby ustawić kodowanie dla kanału (lub prywatnej rozmowy) należy wykonać to samo, co w przypadku serwera, tylko w buforze kanału (lub prywatnej rozmowy).

Aby ustawić kodowanie dla wszystkich kanałów/rozmów prywatnych na danym serwerze:

    /set charset.encode.irc.libera ISO-8859-15

W celu wyświetlenia wszystkich ustawionych kodowań, wykonaj:

    /set charset.*

#### Rozwiązywanie problemów

W razie jakichś problemów z kodowaniem, zajrzyj do WeeChat FAQ / Charset ↗.

#### Komendy

- `charset`: change charset for current buffer

    /charset  decode|encode <charset>
              reset

     decode: change decoding charset
     encode: change encoding charset
    charset: new charset for current buffer
      reset: reset charsets for current buffer

#### Opcje

Sekcje w pliku charset.conf:

Sekcja | Komenda | Opis
--- | --- | ---
`default` | `/set charset.default.*` | Domyślne kodowanie.
`decode` | `/charset decode /set charset.decode.*` | Kodowanie dla wiadomości przychodzących w buforach (opcje w tej sekcji mogą być dodawane/usuwane).
`encode` | `/charset encode /set charset.encode.*` | Kodowanie dla wiadomości wychodzących w buforach (opcje w tej sekcji mogą być dodawane/usuwane).

Opcje:

- charset.default.decode

  - description: global decoding charset: charset used to decode incoming messages when they are not UTF-8 valid

  - type: string

  - values: any string

  - default value: `"iso-8859-1"`

- charset.default.encode

  - description: global encoding charset: charset used to encode outgoing messages (if empty, default is UTF-8 because it is the WeeChat internal charset)

  - type: string

  - values: any string

  - default value: `""`

### 7.4. Poziomy powiadomień

#### Ustawienia poziomu powiadomień

Dostępne są cztery poziomy dla wiadomości wyświetlanych w buforach, od najniższego do najwyższego:

- low: wiadomości mało istotne (na przykład dla irc join/part/quit)

- message: wiadomość od użytkownika

- private: wiadomość w buforze prywatnym

- highlight: wiadomość z powiadomieniem

Każdy bufor posiada poziom powiadomień, który decyduje o tym, jakie wiadomości zostaną dodane do bufora w hotliście.

Domyślny poziom powiadomień można ustawić za pomocą opcji weechat.look.buffer_notify_default, domyślna wartość to all.

Poziom powiadomień | Poziom wiadomości dodawanej do hotlisty
--- | ---
`none` | (brak)
`highlight` | highlight + private
`message` | highlight + private + message
`all` | highlight + private + message + low

Poziom powiadomień może być definiowany dla zestawu buforów, na przykład dla wszystkich buforów serwera irc "libera":

    /set weechat.notify.irc.libera message

Ustawienie poziomu powiadomień na highlight tylko dla kanału "#weechat":

    /set weechat.notify.irc.libera.#weechat highlight

Poziom powiadomień dla bufora może zostać ustawiony za pomocą komendy `/buffer`:

    /buffer notify highlight

#### Maksymalny poziom hotlisty dla nicków

Jest możliwe ustawienie maksymalnego poziomu hotlist dla nicków, dla bufora lub grupy buforów (jak erwery IRC).

Właściwość bufora "hotlist_max_level_nicks" może być ustawiona na listę nicków, z ustawonym dla każdego z nich maksymalnym poziomem hotlisty, możliwe poziomy to:

- -1: brak zmiany hotlisty dla nicka

- 0: niski priorytet (jak wiadomości join/part)

- 1: wiadomość

- 2: prywatna wiadomość

- 3: podświetlenie (mało przydatne, jest to domyślny poziom dla wszytkich wiadomości)

Na przykład, żeby wyłączyć podświetlenia od "joe" oraz "mike" w obecnym buforze:

    /buffer setauto hotlist_max_level_nicks_add joe:2,mike:2

### 7.5. Podświetlenia

#### Wyłączenie podświetleń

Możesz wyłączyć podświetlenia za pomocą opcji weechat.look.highlight_disable_regex (wyrażenie regularne).
Kiedy podświetlenie jest wyłączone za pomocą tej opcji wszystkie pozostałe opcje podświetleń są ignorowane.

Na przykład żeby wyłączyć wszystkie podświetlenia wiadomości ze słowem zaczynającym się od "flash" pomiędzy nawiasami trójkątnymi:

    /set weechat.look.highlight_disable_regex "<flash.*>"

Można to także osiągnąć za pomocą właściwości bufora "highlight_disable_regex".

Ten sam przykład, tylko dla konkretnego bufora:

    /buffer setauto highlight_disable_regex <flash.*>

#### Dodawanie słów do podświetleń

Domyślnie WeeChat podświetla wiadomości od innych użytkowników zawierające Twój nick, dlatego podświetlenia zależą od buforu (nick może być inny w zależności od buforu).

Możesz dodawać inne słowa do podświetlen używając opcji weechat.look.highlight, na przykład, żeby podświetlać Twój nick oraz słowa "słowo1", "słowo2" oraz wszystko co zaczyna się od "test":

    /set weechat.look.highlight "słowo1,słowo2,test*"

Jeżeli potrzebujesz bardziej przecyzyjnej reguły, możesz użyć wyrażenia reglarnego używając opcji weechat.look.highlight_regex, na przydład do podświetlania słów "flashcode", "flashcöde" i "flashy":

    /set weechat.look.highlight_regex "flashc[oö]de|flashy"

Separatory do okoła podświetlanych słów można zmienić za pomocą opcji weechat.look.word_chars_highlight.

#### Dodawanie tagów do podświetleń

Wyświetlane linie moga zawierać "tagi", które dają troche informacji o pochodzeniu wiasomości lub o samej wiadmości.
Możesz wyświetlić tagi za pomocą komendy `/debug tags` (ta sama komenda je ukrywa).

Możesz dodać konkretne tagi do podświetleń za pomocą opcji weechat.look.highlight_tags. Tagi są oddzielane przecinkami, kilka tagów może być oddzielone przez `+` dla wykonania logicznego "i" między nimi.

Na przykład dla podświetlenia wszytkich wiadomości od nicka "FlashCode" oraz powiadomień od nicków zaczynających się od "toto":

    /set weechat.look.highlight_tags "nick_flashcode,irc_notice+nick_toto*"

#### Ustawianie dodatkowych podświetleń dla bufora

Możesz wymusić podświetlenia używając wyrażenia regularnego z właściwościa bufora "highlight_regex".

Na przykład żeby wymusić podświetlenie dla wszytkich wiadomości w obecnym buforze:

    /buffer setauto highlight_regex .*

### 7.6. Bufor logera

Wtyczka logger pozwala zapisywać zawartość bufora do pliku, oraz wybrać co i jak ma być zapisywane.

#### Poziomy logowania

Logowanie odbywa się dla odpowiedniego poziomu dla każdego bufora. Domyślny poziom to 9 (logowane są wszystkie wiadomości wyświetlane w buforze). Możesz zmienić poziom dla pojedynczego bufora lub grupy buforów.

Dostępne są poziomy od 0 do 9. Zero oznacza "nic nie loguj", a 9 oznacza "loguj wszystko".

Wtyczki wykorzystują różne poziomy dla wyświetlanych wiadomości. Wtyczka IRC używa następujących:

- poziom 1: wiadomość od użytkownika (na kanale lub prywatnie)

- poziom 2: zmiana nicka (twojego lub innego)

- poziom 3: dowolna wiadomość serwera (poza wejściem/opuszczeniem/wyjściem z kanału)

- poziom 4: wiadomości serwera o wejściu/opuszczeniu/wyjściu z kanału

Zatem jeśli ustawisz poziom 3 dla kanału IRC, WeeChat będzie logować wszystkie wiadomości, poza tymi o wejściu/opuszczeniu/wyjściu z kanału.

Kilka przykładów:

- ustawienie poziomu 3 dla kanału IRC #weechat:

    /set logger.level.irc.libera.#weechat 3

- ustawienie poziomu 3 dla buforu serwera libera:

    /set logger.level.irc.server.libera 3

- ustawienie poziomu 3 dla wszystkich kanałów na serwerze libera:

    /set logger.level.irc.libera 3

- ustawienie poziomu 2 dla wszystkich buforów IRC:

    /set logger.level.irc 2

#### Maski dla nazw plików

Możliwe jest zdefiniowanie maski dla nazwy pliku z logiem dla każdego bufora i użycie do tego zmiennych lokalnych bufora. W celu wyświetlenia listy dostępnych zmiennych dla bufora wykonaj:

    /buffer listvar

Maski zostaną dopasowane do opcji w kolejności malejącej specyficznie dla `logger.mask.$plugin.*`, z `logger.file.mask` jako opcją zapasową.

Na przykład, w buforze "irc.libera.#weechat", WeeChat będzie szukał maski dla nazwy w takiej kolejności:

    logger.mask.irc.libera.#weechat
    logger.mask.irc.libera
    logger.mask.irc
    logger.file.mask

Oznacza to, że można mieć maski specyficzne tylko dla niektórych serwerów IRC ("logger.mask.irc.libera") lub dla wtyczek ("logger.mask.irc").

##### Pliki z logami uporządkowane według daty

Żeby mieć pliki z logami uporządkowane według daty, możesz użyć specyfikatorów daty/czasu w masce (obsługiwane formaty można znaleźć w `man strftime`), na przykład:

    /set logger.file.mask "%Y/%m/$plugin.$name.weechatlog"

Spowoduje powstanie następującej struktury:

    ~/.local/share/weechat
    └── logs
        ├── 2010
        │   ├── 11
        │   │   ├── irc.server.libera.weechatlog
        │   │   └── irc.libera.#weechat.weechatlog
        │   └── 12
        │       ├── irc.server.libera.weechatlog
        │       └── irc.libera.#weechat.weechatlog
        ├── 2011
        │   ├── 01
        │   │   ├── irc.server.libera.weechatlog
        │   │   └── irc.libera.#weechat.weechatlog
        │   ├── 02
        ...

##### Pliki z logami IRC uporządkowane według serwera i daty

Jeśli chcesz mieć oddzielne katalogi dla serwerów IRC z oddzielnym plikiem dla każdego kanału:

    /set logger.mask.irc "irc/$server/$channel.weechatlog"

Spowoduje powstanie następującej struktury:

    ~/.local/share/weechat
    └── logs
        └── irc
            ├── libera
            │   ├── libera.weechatlog
            │   ├── #weechat.weechatlog
            │   └── #mychan.weechatlog
            ├── oftc
            │   ├── oftc.weechatlog
            │   ├── #channel1.weechatlog
            │   └── #channel2.weechatlog
            ...

#### Rotowanie i kompresja

Istnieje możliwość zdefiniowania rozmiaru pliku z logami, po przekroczeniu którego nastąpi automatyczne zrotowanie pliku z logiem.

Zrotowany plik z logami może być skompresowany za pomocą gzip lub zstd ↗.

Notka | Jako że kompresowanie pliku może zająć chwilę jest wykonywane w tle.

Przykład dla maksymalnej wielkości pliku 2GB i włączonej kompresji gzip, z użyciem dobrego poziomu kompresji (wolniejsze od domyślnego):

    /set logger.file.rotation_compression_type gzip
    /set logger.file.rotation_compression_level 80
    /set logger.file.rotation_size_max "2g"

Jeśli chcesz użyć liczby dziesiętnej, możesz użyć poniższej jednostki i pomnożyć przez 1000, na przykład aby ustwić maksymalny rozmiar na 2.5GB:

    /set logger.file.rotation_size_max "2500m"

Z tymi ustawieniami, uzyskasz strukturę plików podobną do poniższej (w tym przykładzie rotowany jest tylko plik z logiem kanału #weechat):

    ~/.local/share/weechat
    └── logs
        ├── core.weechat.weechatlog
        ├── irc.server.libera.weechatlog
        ├── irc.libera.#weechat.weechatlog
        ├── irc.libera.#weechat.weechatlog.1.gz
        ├── irc.libera.#weechat.weechatlog.2.gz
        └── irc.libera.#weechat.weechatlog.3.gz

#### Komendy

- `logger`: logger plugin configuration

    /logger  list
             set <level>
             flush
             disable

       list: show logging status for opened buffers
        set: set logging level on current buffer
      level: level for messages to be logged (0 = logging disabled, 1 = a few messages (most important) .. 9 = all messages)
      flush: write all log files now
    disable: disable logging on current buffer (set level to 0)

    Options "logger.level.*" and "logger.mask.*" can be used to set level or mask for a buffer, or buffers beginning with name.

    Log levels used by IRC plugin:
      1: user message (channel and private), notice (server and channel)
      2: nick change
      3: server message
      4: join/part/quit
      9: all other messages

    Examples:
      set level to 5 for current buffer:
        /logger set 5
      disable logging for current buffer:
        /logger disable
      set level to 3 for all IRC buffers:
        /set logger.level.irc 3
      disable logging for main WeeChat buffer:
        /set logger.level.core.weechat 0
      use a directory per IRC server and a file per channel inside:
        /set logger.mask.irc "$server/$channel.weechatlog"

#### Opcje

Sekcje w pliku logger.conf:

Sekcja | Komenda | Opis
--- | --- | ---
`look` | `/set logger.look.*` | Wygląd.
`color` | `/set logger.color.*` | Kolory.
`file` | `/set logger.file.*` | Opcje dla plików z logami.
`level` | `/set logger.level.*` | Poziomy logowania dla buforów (opcje w tej sekcji mogą być dodawane/usuwane).
`mask` | `/set logger.mask.*` | Maski dla nazw plików dla buforów (opcje w tej sekcji mogą być dodawane/usuwane).

Opcje:

- logger.color.backlog_end

  - description: color for line ending the backlog

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `246`

- logger.color.backlog_line

  - description: color for backlog lines, used only if the option logger.file.color_lines is off

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `246`

- logger.file.auto_log

  - description: automatically save content of buffers to files (unless a buffer disables log); if disabled, logging is disabled on all buffers

  - type: boolean

  - values: on, off

  - default value: `on`

- logger.file.color_lines

  - description: use ANSI color codes in lines written in log files and display backlog lines with these colors

  - type: boolean

  - values: on, off

  - default value: `off`

- logger.file.flush_delay

  - description: number of seconds between flush of log files (0 = write in log files immediately for each line printed)

  - type: integer

  - values: 0 .. 3600

  - default value: `120`

- logger.file.fsync

  - description: use fsync to synchronize the log file with the storage device after the flush (see man fsync); this is slower but should prevent any data loss in case of power failure during the save of log file

  - type: boolean

  - values: on, off

  - default value: `off`

- logger.file.info_lines

  - description: write information line in log file when log starts or ends for a buffer

  - type: boolean

  - values: on, off

  - default value: `off`

- logger.file.log_conditions

  - description: conditions to save content of buffers to files (note: content is evaluated, see /help eval); empty value saves content on all buffers; for example to log only private buffers: "${type} == private"

  - type: string

  - values: any string

  - default value: `""`

- logger.file.mask

  - description: default file name mask for log files (format is "directory/to/file" or "file", without first "/" because "path" option is used to build complete path to file); local buffer variables are permitted (you should use only variables that are defined on all buffers, so for example you should NOT use $server nor $channel); date specifiers are permitted (see man strftime)

  - type: string

  - values: any string

  - default value: `"$plugin.$name.weechatlog"`

- logger.file.name_lower_case

  - description: use only lower case for log filenames

  - type: boolean

  - values: on, off

  - default value: `on`

- logger.file.nick_prefix

  - description: text to write before nick in prefix of message, example: "<"

  - type: string

  - values: any string

  - default value: `""`

- logger.file.nick_suffix

  - description: text to write after nick in prefix of message, example: ">"

  - type: string

  - values: any string

  - default value: `""`

- logger.file.path

  - description: path for WeeChat log files; date specifiers are permitted (see man strftime) (path is evaluated, see function string_eval_path_home in plugin API reference)

  - type: string

  - values: any string

  - default value: `"${weechat_data_dir}/logs"`

- logger.file.replacement_char

  - description: replacement char for special chars in filename built with mask (like directory delimiter)

  - type: string

  - values: any string

  - default value: `"_"`

- logger.file.rotation_compression_level

  - description: compression level for rotated log files (with extension ".1", ".2", etc.), if option logger.file.rotation_compression_type is enabled: 1 = low compression / fast ... 100 = best compression / slow; the value is a percentage converted to 1-9 for gzip and 1-19 for zstd; the default value is recommended, it offers a good compromise between compression and speed

  - type: integer

  - values: 1 .. 100

  - default value: `20`

- logger.file.rotation_compression_type

  - description: compression type for rotated log files; if set to "none", rotated log files are not compressed; WARNING: if rotation was enabled with another type of compression (or no compression), you must first unload the logger plugin, compress files with the new type (or decompress files), then change the option in logger.conf, then load the logger plugin

  - type: enum

  - values: none, gzip, zstd

  - default value: `none`

- logger.file.rotation_size_max

  - description: when this size is reached, a rotation of log files is performed: the existing rotated log files are renamed (.1 becomes .2, .2 becomes .3, etc.) and the current file is renamed with extension .1; an integer number with a suffix is allowed: b = bytes (default if no unit given), k = kilobytes, m = megabytes, g = gigabytes, t = terabytes; example: "2g" causes a rotation if the file size is > 2,000,000,000 bytes; if set to "0", no rotation is performed (unlimited log size); WARNING: before changing this option, you should first set the compression type via option logger.file.rotation_compression_type

  - type: string

  - values: any string

  - default value: `"0"`

- logger.file.time_format

  - description: timestamp used in log files (see man strftime for date/time specifiers, extra specifiers are supported, see function util_strftimeval in Plugin API reference)

  - type: string

  - values: any string

  - default value: `"%@%F %T.%fZ"`

- logger.look.backlog

  - description: maximum number of lines to display from log file when creating new buffer (0 = no backlog)

  - type: integer

  - values: 0 .. 2147483647

  - default value: `20`

- logger.look.backlog_conditions

  - description: conditions to display the backlog (note: content is evaluated, see /help eval); empty value displays the backlog on all buffers; for example to display backlog on private buffers only: "${type} == private"

  - type: string

  - values: any string

  - default value: `""`

### 7.7. Wsparcie myszy

WeeChat obsługuje kliknięcia myszy i gesty. Działa to z lokalnym terminalem, jak i zdalnie przez połączenie ssh z lub bez użycia screena/tmuxa.

#### Włączenie obsługi myszy

Żeby włączyć obsługę myszy podczas uruchamiania:

    /set weechat.look.mouse on

Żeby włączyć obsługę myszy teraz, wciśnij `Alt`+`m` lub wykonaj komendę:

    /mouse enable

Możliwe jest czasowe wyłączenie obsługi myszy i przypisanie tego do skrótu. Na przykład skrót `Alt`+`%` wyłączający obsługę myszy na 10 sekund:

    /key bind meta-% /mouse toggle 10

Ważne

Kiedy obsługa myszy jest włączona w WeeChat, wszystkie zdarzenia myszy są przechwytywane przez WeeChat. Dlatego akcje jak kopiowanie/wklejanie lub klikanie w URLe nie są przesyłane do terminala.
Użycie klawisza `Shift` sprawia, że te zdarzenia są przesyłane bezpośrednio do terminala, tak jakby obsługa myszy była wyłączona (w niektórych terminalach jak iTerm, należy użyc klawisza `Alt` zamiast `Shift`).

Notka | W razie jakichkolwiek problemów z obsługą myszy, zajrzyj do WeeChat FAQ / Obsługa myszy ↗.

#### Przypisanie zdarzeń myszy do komend

Wiele domyślnych zdarzeń myszy jest już zdefiniowanych w WeeChat (zobacz obsługa myszy).

Możesz zmienić lub dodać przypisania za pomocą komendy `/key` używając kontekstu "mouse" (dla składni zobacz komenda /key).

Nazwa zdarzenia zawiera modyfikator (opcjonalny), nazwę klawisza/rolki i gest (opcjonalny). Różne elementy są rozdzielane przez `-`.

Lista modyfikatorów (według nazwy):

Modyfikator | Opis
--- | ---
`alt` | Klawisz `Alt`
`ctrl` | Klawisz `Ctrl`
`shift` | Klawisz `Shift` (1)

Notka | (1) Modyfikator `shift` można sporadycznie użyć w WeeChat ponieważ terminale zazwyczaj używają tego modyfikatora do przechwytywania ewentów myszy.

Modyfikatory można ze sobą łączyć, na przykład:

- `alt-ctrl`

- `ctrl-shift`

- `alt-ctrl-shift`

Lista klawiszy/rolek:

Klawisz/rolka | Opis
--- | ---
`button1` | Lewy klawisz myszy
`button2` | Prawy klawisz myszy
`button3` | Środkowy klawisz myszy (często naciśnięcie rolki)
`button4 …​ button11` | Dodatkowe klawisze
`wheelup` | Rolka (w górę)
`wheeldown` | Rolka (w dół)

Lista gestów (tylko dla klawiszy, nie rolki):

Gest | Odległość
--- | ---
`gesture-up` | 3 …​ 19
`gesture-up-long` | ≥ 20
`gesture-down` | 3 …​ 19
`gesture-down-long` | ≥ 20
`gesture-left` | 3 …​ 39
`gesture-left-long` | ≥ 40
`gesture-right` | 3 …​ 39
`gesture-right-long` | ≥ 40

Lista niedkończonych zdarzeń (tylko dla przycisków, użyteczne dla wtyczek/skryptów):

Zdarzenie | Opis
--- | ---
`event-down` | Klawisz został wciśnięty ale jeszcze nie puszczony
`event-drag` | Mysz została przesunięta z wciśniętym klawiszem

Przykłady zdarzeń:

- `button1`

- `ctrl-button1`

- `button1-gesture-right`

- `button1-event-down`

- `button1-event-drag`

- `alt-button2-gesture-down-long`

- `wheelup`

- `alt-ctrl-wheeldown`

- …​

Sugestia | Podczas przypisywania skrótów w kontekście myszy, możliwe jest dopasowanie wielu zdarzeń używając `*` na początku lub końcu nazwy, na przykład `button1-gesture-*` będzie pasować do gestów wykonanych z użyciem lewego przycisku myszy.

Sugestia | Możesz znaleźć nazwę zdarzenia za pomocą komendy `/input grab_mouse` wykonując następnie zdarzenie za pomocą myszy. Umieści to zdarzenie w linii poleceń.

### 7.8. Sprawdzanie pisowni

Wtyczka spell pozwala na sprawdzanie pisowni w linii poleceń. Możliwe jest ustawienie wielu języków dla bufora.

Sprawdzenie pisowni jest domyślnie wyłączone i możę być przełączone za pomocą `Alt`+`s`.

#### Słowniki

Przed użyciem sprawdzania pisowni należy zdefiniować słowniki można to zrobić zarówno globalnie jak i dla poszczególnych buforów.

Możliwe jest użycie kilku słowników równocześnie: WeeChat sprawdzi słowa we wszystkich słownikach.

Na przykład dla angielskiego i francuskiego:

    /set spell.check.default_dict "en,fr"

Możliwe jest użycie innego słownika dla konkretnego buforu, na przykład na kanale niemieckojęzycnzym:

    /spell setdict de

Możesz również ustawić słownik dla grupy buforów, na przykład angielski dla wsystkich kanałów na serwerze IRC libera:

    /set spell.dict.irc.libera en

Więcej informacji można znaleźć w opisie komendy /spell.

#### Opcje słowników

Opcje słowników mogą zostać zdefiniowane poprzez dodanie opcji w sekcji "option" dla konfiguracji aspell.

Nazwa opcji to nazwa opcji konfiguracyjnej aspell. Listę opcji można uzyskać wykonując w powłoce następującą komendę:

    aspell config

Na przykład, aby włączyć opcję "ignore-case":

    /set spell.option.ignore-case "true"

#### Sugestie

Sugestie są wyświetlane w elemencie paska "spell_suggest". Ilość wyświetlanych sugestii można ustawić za pomocą opcji spell.check.suggestions.

Aby włączyć sugestie trzeba ustawić opcję spell.check.suggestions na liczbę ≥ 0 i dodać element "spell_suggest" do jakiegoś paska, jak status.

Przykład sugestii z angielskim słownikiem (`en`):

    │[12:55] [6] [irc/libera] 3:#test(+n){4} [print,prone,prune]                      │
    │[@Flashy] prinr █                                                                │
    └─────────────────────────────────────────────────────────────────────────────────┘

Przykład sugestii ze słownikami angielskim i francuskim (`en,fr`):

    │[12:55] [6] [irc/libera] 3:#test(+n){4} [print,prone,prune/prime,primer,primé]   │
    │[@Flashy] prinr █                                                                │
    └─────────────────────────────────────────────────────────────────────────────────┘

#### Komendy

- `spell`: spell plugin configuration

    /spell  enable|disable|toggle
            listdict
            setdict -|<dict>[,<dict>...]
            deldict
            addword [<dict>] <word>

      enable: enable spell checker
     disable: disable spell checker
      toggle: toggle spell checker
    listdict: show installed dictionaries
     setdict: set dictionary for current buffer (multiple dictionaries can be separated by a comma, the special value "-" disables spell checking on current buffer)
     deldict: delete dictionary used on current buffer
     addword: add a word in personal dictionary

    Input line beginning with a "/" is not checked, except for some commands (see /set spell.check.commands).

    To enable spell checker on all buffers, use option "default_dict", then enable spell checker, for example:
      /set spell.check.default_dict "en"
      /spell enable

    To display a list of suggestions in a bar, use item "spell_suggest".

    Default key to toggle spell checker is alt-s.

#### Opcje

Sekcje w pliku spell.conf:

Sekcja | Komenda | Opis
--- | --- | ---
`color` | `/set spell.color.*` | Kolory.
`check` | `/set spell.check.*` | Opcje do kontrolowania sprawdzania pisowni.
`dict` | `/spell setdict /set spell.dict.*` | Słowniki używane w buforze (opcje w tej sekcji mogą być dodawane/usuwane).
`look` | `/set spell.look.*` | Wygląd.
`option` | `/set spell.option.*` | Opcje słowników (opcje w tej sekcji mogą być dodawane/usuwane).

Opcje:

- spell.check.commands

  - description: comma separated list of commands for which spell checking is enabled (spell checking is disabled for all other commands)

  - type: string

  - values: any string

  - default value: `"away,command,cycle,kick,kickban,me,msg,notice,part,query,quit,topic"`

- spell.check.default_dict

  - description: default dictionary (or comma separated list of dictionaries) to use when buffer has no dictionary defined (leave blank to disable spell checker on buffers for which you didn't explicitly enabled it)

  - type: string

  - values: any string

  - default value: `""`

- spell.check.during_search

  - description: check words during text search in buffer

  - type: boolean

  - values: on, off

  - default value: `off`

- spell.check.enabled

  - description: enable spell checker for command line

  - type: boolean

  - values: on, off

  - default value: `off`

- spell.check.real_time

  - description: real-time spell checking of words (slower, disabled by default: words are checked only if there's delimiter after)

  - type: boolean

  - values: on, off

  - default value: `off`

- spell.check.suggestions

  - description: number of suggestions to display in bar item "spell_suggest" for each dictionary set in buffer (-1 = disable suggestions, 0 = display all possible suggestions in all languages)

  - type: integer

  - values: -1 .. 2147483647

  - default value: `-1`

- spell.check.word_min_length

  - description: minimum length for a word to be spell checked (use 0 to check all words)

  - type: integer

  - values: 0 .. 2147483647

  - default value: `2`

- spell.color.misspelled

  - description: text color for misspelled words (input bar)

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `lightred`

- spell.color.suggestion

  - description: text color for suggestion on a misspelled word in bar item "spell_suggest"

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `default`

- spell.color.suggestion_delimiter_dict

  - description: text color for delimiters displayed between two dictionaries in bar item "spell_suggest"

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `cyan`

- spell.color.suggestion_delimiter_word

  - description: text color for delimiters displayed between two words in bar item "spell_suggest"

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `cyan`

- spell.look.suggestion_delimiter_dict

  - description: delimiter displayed between two dictionaries in bar item "spell_suggest"

  - type: string

  - values: any string

  - default value: `" / "`

- spell.look.suggestion_delimiter_word

  - description: delimiter displayed between two words in bar item "spell_suggest"

  - type: string

  - values: any string

  - default value: `","`

### 7.9. Paski

Pasek to obszar poza rozmową, mogący zawierać dowolny rodzaj tekstu.

Opcje paska mogą być ustawiane za pomocą opcji `weechat.bar.nazwa.opcja`, gdzie `nazwa` to nazwa paska i `opcja` to opcja dla tego paska.

Lista opcji dla pasków:

Opcja | Wartości | Opis
--- | --- | ---

`type`

`root`, `window`

Pasek z typem `root` jest wyświetlany dokładnie jeden raz na ekranie, poza wszystkimi oknami. Domyślny pasek buflist ma typ `root`.
Pasek z typem `window` wyświetlany jest w każdym oknie, na przykład jeśli podzielisz jednorazowo ekran (używając `/window splith` lun `/window splitv`) otrzymasz po jednym pasku w każdym oknie. Domyślnie paski title, status, input i nicklist mają typ `window`.

`position` | `top`, `bottom`, `left`, `right` | Pozycja paska: powyżej/poniżej ekranu rozmowy, po jego lewej/prawej stronie.

`priority`

integer ≥ 0

Priorytet wyświetlania paska: jest on używany do uporządkowania pasków na ekranie, kiedy więcej niż jeden pasek posiada ten sam typ i położenie.
Paski są wyświetlane od brzegu do środka ekranu. Paski z wyższym priorytetem zostaną wyświetlone na początku, czyli bliżej krawędzi.
Przykład: pasek input ma priorytet 1000, dlatego jest wyświetlany przed paskiem status, który ma priorytet 500.

`size` | integer ≥ 0 | Rozmiar paska: ilość kolumn dla pozycji lewo/prawo, numer linii dla pozycji góra/dół. Rozmiar `0` oznacza automatyczny - rozmiar zostanie wyliczony zgodnie z wyświetlaną zawartością.
`size_max` | integer ≥ 0 | Maksymalny rozmiar paska, `0` = brak limitu (opcja ta jest używana tylko jeśli `size` = 0).
`color_bg` | color | Domyślny kolor tła paska.
`color_fg` | color | Domyślny kolor tekstu na pasku.
`color_delim` | color | Kolor separatorów na pasku.
`hidden` | `on`, `off` | Kiedy ta opcja jest ustawiona na `on`, pasek jest ukrywany. Uwaga: zamiast zmiany tej opcji zaleca się użycie komendy `/bar`, na przykład: `/bar toggle nicklist` (zobacz komendę /bar po więcej informacji).
`separator` | `on`, `off` | Kiedy ta opcja jest ustawiona na `on`, separator (linia) jest wyświetlany pomiędzy tym paskiem a pozostałymi (lub oknem rozmowy).
`items` | string | Lista elementów (zobacz elementy po więcej informacji).
`filling_left_right` | `horizontal`, `vertical`, `columns_horizontal`, `columns_vertical` | Typ wypełnienia paska dla pozycji o pozycji `left` lub `right` (zobacz wypełnienie po więcej informacji).
`filling_top_bottom` | `horizontal`, `vertical`, `columns_horizontal`, `columns_vertical` | Typ wypełnienia paska dla pozycji o pozycji `top` lub `bottom` (zobacz wypełnienie po więcej informacji).
`conditions` | string | Warunki wyświetlania paska (zobacz warunki po więcej informacji).

#### Elementy

Opcja items jest ciągiem z listą elementów paska oddzielonych przecinkiem (spacja pomiędzy elementami na ekranie) lub `+` (elementy sklejone).

Lista wszystkich elementów paska jest wyświetlana za pomocą komendy `/bar listitems`.

Przed i za nazwą elementu można używać znaków (nie będących alfanumerycznymi, `-` lub `_`). Będą one wyświetlane przed/za elementem z kolorem separatorów zdefiniowanych dla paska (opcja color_delim).

Przykład paska z elementami "[time],buffer_number+:+buffer_plugin+.+buffer_name,[buffer_last_number]":

    ┌───────────────────────────────────────────────────────────────────────────┐
    │[12:55] 3:irc/libera.#weechat [9]                                          │
    └───────────────────────────────────────────────────────────────────────────┘

##### Odstęp

Element paska `spacer` może być użyty do wyrównywania elementów (lewo, środek, prawo).

Kiedy przynajmniej jeden element `spacer` jest użyty na pasku, użyta jest cała szerokość: odstępy same się skalują do tego samego rozmiaru (albo prawie).
Kiedy pasek nie jest dostatecznie duży dla wszystkich elementów odstępy nie są wyświetlane.

Notka | Elementy `spacer` mogą być tylko użyte w paskach z pozycją `top` lub `bottom`, wypełnieniem `horizontal` i rozmiarem `1`.

Example of bar with items "[time],spacer,buffer_number+:+buffer_plugin+.+buffer_name,spacer,[buffer_last_number]":

    ┌───────────────────────────────────────────────────────────────────────────┐
    │[12:55]                      3:irc/libera.#weechat                      [9]│
    └───────────────────────────────────────────────────────────────────────────┘

##### Wymuszenie bufora

Specjalna składnia może zostać użyta, żeby wymusić bufor używany do wyświetlenia elementów paska: "@bufor:element" (gdzie "bufor" to pełna nazwa bufora i "element" to nazwa elementu paska).

Jest to przydatne w paskach typu `root` do wyświetlania elementów dla konkretnych buforów, które nie są wyświetlane w obecnym oknie (lub nawet nie wyświetlanych w ogóle).

Przykład: lista nicków dla bitlbee w pasku `root` (jeśli pasek nazywa się bitlist i serwer bitlbee nazywa sie bitlbee):

    /set weechat.bar.bitlist.items "@irc.bitlbee.&bitlbee:buffer_nicklist"

##### Niestandardowe elementy

Niestandardowe elementy paska mogą zostać oddane za pomocą komendy /item, każdy nowy element posiada dwie właściwości zdefiniowanymi przez opcje konfiguracyjne:

- `conditions`: warunki do wyświetlenia elementu paska, na przykład wyświetlenie elementu paska tylko w specyficznych buforach (jeśli nie zostanie podany pasek jest wyświetlany wszędzie)

- `content`: przetworzona zawartość elementu paska.

W obu opcjach mogą zostać użyte następujące zmienne:

- `window`: wskaźnik do okna, w którym pasek jest wyświetlany (`NULL` dla pasków typu root)

- `buffer`: wskaźnik do buforu, w którym wyświetlany jest pasek (obecny bufor dla pasków typu root).

Przykłady warunków:

Warunek | Opis
--- | ---
`${window}` | Wyświetlany tylko w paskach okien
`${buffer.number} == 1` | Wyświetlany we wszystkich buforach z numerem = 1.
`${buffer.plugin.name} == irc` | Wyświetlany tylko w buforach IRC
`${type} == channel` | Wyświetlany tylko w buforach, w których zmienna lokalna `type` ma wartość `channel` (przykład: wszystkie kanały IRC)
`${type} == private` | Wyświetlany tylko w buforach, w których zmienna lokalna `type` ma wartość `private` (przykład: wszystkie bufory prywatne IRC)

Notka | Nie istnieje wbudowany sposób na odświerzenie niestandardowych elementów paska. Możesz użyć wtyczki Trigger do wymuszenia odświerzenia, na przykład przez ostrzymanie jednego lub więcej sygnałów.

Więcej informacji i przykładów można otrzymać wykonując komendę /item.

#### Wypełnienie

Są cztery typy wypełnień:

- `horizontal`: elementy są wyświetlane poziomo, od lewej do prawej. Jeśli w elementach występują nowe linie, odstęp jest używany do ich oddzielenia.

- `vertical`: elementy są wyświetlane od góry do dołu. Jeśli w elementach występują nowe linie, do ich oddzielenia używana jest nowa linia.

- `columns_horizontal`: elementy są wyświetlane z użyciem kolumn, gdzie tekst tekst jest wyrównany do lewej. Pierwszy element znajduje się na górze z lewej, kolejny w tej samej linii z prawej.

- `columns_vertical`: elementy są wyświetlane z użyciem kolumn, gdzie tekst tekst jest wyrównany do lewej. Pierwszy element znajduje się na górze z lewej, kolejny jest linię niżej.

Domyślne paski title, status i input mają wypełnienie horizontal, domyślny pasek nicklist ma wypełnienie vertical.

Przykłady wypełnień paska nicklist:

    ┌───────────────────────────────────────────────────────────────────────┐
    │Welcome to #test, this is a test channel                               │
    │12:54:15 peter | hey!                                         │@carl   │
    │12:55:01  +Max | hello                                        │@jessika│
    │                                                              │@maddy  │
    │                                                              │%Diego  │
    │                                                              │%Melody │
    │                                                              │+Max    │
    │                                                              │ celia  │
    │                                                              │ Eva    │
    │                                                              │ freddy │
    │                                                              │ Harold^│
    │                                                              │ henry4 │
    │                                                              │ jimmy17│
    │                                                              │ jodie ▼│
    │[12:55] [6] [irc/libera] 3:#test(+n){24}                               │
    │[@carl] █                                                              │
    └───────────────────────────────────────────────────────────────────────┘
                                         filling_left_right = vertical ▲

    ┌───────────────────────────────────────────────────────────────────────┐
    │Welcome to #test, this is a test channel                               │
    │12:54:15 peter | hey!                                │@carl     lee    │
    │12:55:01  +Max | hello                               │@jessika  louise │
    │                                                     │@maddy    mario  │
    │                                                     │%Diego    mark   │
    │                                                     │%Melody   peter  │
    │                                                     │+Max      Rachel │
    │                                                     │ celia    richard│
    │                                                     │ Eva      sheryl │
    │                                                     │ freddy   Vince  │
    │                                                     │ Harold^  warren │
    │                                                     │ henry4   zack   │
    │                                                     │ jimmy17         │
    │                                                     │ jodie           │
    │[12:55] [6] [irc/libera] 3:#test(+n){24}                               │
    │[@carl] █                                                              │
    └───────────────────────────────────────────────────────────────────────┘
                                 filling_left_right = columns_vertical ▲

    ┌───────────────────────────────────────────────────────────────────────┐
    │@carl    %Diego    celia    Harold^  jodie    mario    Rachel   Vince  │
    │@jessika %Melody   Eva      henry4   lee      mark     richard  warren │
    │@maddy   +Max      freddy   jimmy17  louise   peter    sheryl   zack   │
    │───────────────────────────────────────────────────────────────────────│
    │                                                                       │
            filling_top_bottom = columns_vertical ▲

    ┌───────────────────────────────────────────────────────────────────────┐
    │@carl    @jessika @maddy   %Diego   %Melody  +Max      celia    Eva    │
    │ freddy   Harold^  henry4   jimmy17  jodie    lee      louise   mario  │
    │ mark     peter    Rachel   richard  sheryl   Vince    warren   zack   │
    │───────────────────────────────────────────────────────────────────────│
    │                                                                       │
          filling_top_bottom = columns_horizontal ▲

#### Warunki

Opcja conditions jest jest przetwarzana w celu sprawdzenia czy pasek ma być wyświetlony czy nie.

Dostępne opcje:

- active: okno musi być aktywne

- inactive: okno musi być nieaktywne

- nicklist: bufor wyświetlany w oknie musi mieć listę nicków

- wyrażenie: jest wykonywane jako wyrażenie logiczne (zobacz komendę /eval)

Dla wyrażeń dostępne są następujące zmienne:

- `${active}`: prawda, jeśli okno jest aktywne

- `${inactive}`: prawda, jeśli okno jest nieaktywne

- `${nicklist}`: prawda, jeśli okno posiada listę nicków

Następujące wskaźniki są dostępne:

- `${window}`: okno, dla którego warunek jest sprawdzany

- `${buffer}`: bufor okna, dla którego warunek jest sprawdzany

Przykład pokazujący pasek z listą nicków we wszystkich buforach, które mają ją włączoną i tylko jeśli szerokość terminala jest > 100:

    /set weechat.bar.nicklist.conditions "${nicklist} && ${info:term_width} > 100"

Ten sam warunek, ale lista nicków jest zawsze wyświetlana w buforze &bitlbee (nawet jeśli jest mały):

    /set weechat.bar.nicklist.conditions "${nicklist} && (${info:term_width} > 100 || ${buffer.full_name} == irc.bitlbee.&bitlbee)"

### 7.10. Zabezpieczone dane

#### Przechowywanie

WeeChat umie szyfrować hasła lub prywatne dane i przechowuje je w pliku sec.conf.

Plik ten jest odczytywany przed wszystkimi innymi plikami i wartości przechowywane w nim mogą być użyte w różnych opcjach WeeChat jak i wtyczek/skryptów.

Możesz ustawić hasło dla danych zaszyfrowanych w pliku sec.conf. Nie jest to obowiązkowe ale wysoce zalecane, w przeciwnym wypadku dane są zapisywane jako zwykły tekst.

    /secure passphrase to jest moje hasło

##### Hasło przy uruchomieniu

Kiedy ustawione jest hasło WeeChat poprosi o nie podczas uruchomieina (ale nie podczas `/upgrade`).

Jeśli używasz managera haseł, możesz uruchomić zewnętrzny program do odczytania hasła bez konieczności wprowadzania go ręcznie przy utuchomieniu WeeChat.
Na przykład dla password-store (komenda `pass`):

    /set sec.crypt.passphrase_command "/usr/bin/pass show weechat/passphrase"

Program może poprosić o odblokowanie klucza GPG lub wprowadzenie innego hasła, aby odczytać sekret. WeeChat poczeka do zakończenia komendy i odczyta hasło ze standardowego wyjścia (musi to być w pierwszej linii bez żadnych dodatkowych znaków).
Jeśli wyjście programu nie zawiera hasla lub jest ono błęde, WeeChat poprosi i jego wprowadzenie.

##### Szyfrowanie

Szyfrowanie danych odbywa się w 3 krokach:

1. Pozyskanie klucza z hasła (z opcjonalną solą).

2. Wyliczenia hasha danych do zaszyfrowania.

3. Szyfrowanie hash + dane (wynik to: sól + zaszyfrowany hash/dane).

Notka | Tryb blokowy szyfru to CFB.

Wynik jest zapisywany jako ciąg heksadecymalny w pliku sec.conf, na przykład:

    [data]
    __passphrase__ = on
    libera = "53B1C86FCDA28FC122A95B0456ABD79B5AB74654F21C3D099A6CCA8173239EEA59533A1D83011251F96778AC3F5166A394"

##### Deszyfrowanie

Deszyfrowanie danych odbywa się w 3 krokach:

1. Pozyskanie klucza za pomocą soli i hasła.

2. Deszyfrowanie hash + dane.

3. Sprawdzenie czy odszyfrowany hash == hash danych.

#### Zarządzanie zabezpieczonymi danymi

W celu dodania bezpiecznych danych użyj `/secure set`, na przykład hasło dla serwera IRC libera:

    /secure set libera mojehasło

Dla wygody, zabezpieczone dane mogą być wyświetlone w dedykowanym buforze (`Alt`+`v` w buforze, w celu wyświetlenia wartości), po prostu wykonaj:

    /secure

Bezpieczne dane mogą zostać użyte w opcjach zawierających prywatne dane jak hasła, za pomocą formatu: "${sec.data.xxx}", gdzie "xxx" to nazwa zabezpieczonych danych (utworzone za pomocą `/secure set xxx …​`).
Aby otrzymać pełną listę wspieranych opcji zapoznaj się z komendą /secure.

W celu użycia hasła libera, na przykład z uwierzytelnianiem SASL:

    /set irc.server.libera.sasl_password "${sec.data.libera}"

### 7.11. Aliasy

Wtyczka alias pozwala tworzyć aliasy dla komend (z WeeChat lub innych wtyczek).

Niektóre aliasy tworzone są domyślnie z nazwami pisanymi wielkimi literami (żeby można było je odróżnić od standardowch poleceń); komendy w WeeChat nie rozróżniają wielkości znaków dlatego na przykład `/close` wywoła alias `/CLOSE`.

Lista domyślnych aliasów:

Alias | Command | Completion
--- | --- | ---
`/aaway` | `/allserv /away` | -
`/anick` | `/allserv /nick` | -
`/beep` | `/print -beep` | -
`/bye` | `/quit` | -
`/c` | `/buffer clear` | -
`/cl` | `/buffer clear` | -
`/close` | `/buffer close` | -
`/chat` | `/dcc chat` | -
`/exit` | `/quit` | -
`/ig` | `/ignore` | -
`/j` | `/join` | -
`/k` | `/kick` | -
`/kb` | `/kickban` | -
`/leave` | `/part` | -
`/m` | `/msg` | -
`/mub` | `/unban *` | -
`/msgbuf` | `/command -buffer $1 * /input send $2-` | %(buffers_plugins_names)
`/n` | `/names` | -
`/q` | `/query` | -
`/redraw` | `/window refresh` | -
`/say` | `/msg *` | -
`/signoff` | `/quit` | -
`/t` | `/topic` | -
`/ub` | `/unban` | -
`/umode` | `/mode $nick` | -
`/v` | `/command core version` | -
`/w` | `/who` | -
`/wc` | `/window close` | -
`/wi` | `/whois` | -
`/wii` | `/whois $1 $1` | -
`/wm` | `/window merge` | -
`/ww` | `/whowas` | -

#### Komendy

- `alias`: list, add or remove command aliases

    /alias  list [<name>]
            add|addreplace <name> [<command>[;<command>...]]
            addcompletion|addreplacecompletion <completion> <name> [<command>[;<command>...]]
            del <name>|<mask>...
            rename <name> <new_name>
            missing

                    list: list aliases (without argument, this list is displayed)
                     add: add an alias
              addreplace: add or replace an existing alias
           addcompletion: add an alias with a custom completion
    addreplacecompletion: add or replace an existing alias with a custom completion
                    name: name of alias
              completion: completion for alias: by default completion is done with target command (you can use "%%command" to use the completion of an existing command)
                 command: command name with arguments (many commands can be separated by semicolons)
                     del: delete aliases
                    mask: name where wildcard "*" is allowed
                  rename: rename an alias
                 missing: add missing aliases (using default aliases)

    In command, special variables are replaced:
      $n: argument "n" (between 1 and 9)
      $-m: arguments from 1 to "m"
      $n-: arguments from "n" to last
      $n-m: arguments from "n" to "m"
      $*: all arguments
      $&: all arguments, with " replaced by \"
      $~: last argument
      $var: where "var" is a local variable of buffer (see /buffer listvar), examples: $nick, $channel, $server, $plugin, $name

    Examples:
      /alias add split /window splith
      /alias add hello /allchan -exclude=#weechat hello
      /alias rename hello Hello
      /alias addcompletion %%sajoin forcejoin /quote forcejoin

#### Options

Ssekcje w pliku alias.conf:

Sekcja | Komenda | Opis
--- | --- | ---
`cmd` | `/alias /set alias.cmd.*` | Commands for aliases.
`completion` | `/alias /set alias.completion.*` | Completions for aliases.

### 7.12. Komendy i opcje

#### Komendy WeeChat

- `allbuf`: execute a command on all buffers

    /allbuf  <command>

    command: command to execute (or text to send to buffer if command does not start with "/")

    Example:
      set read marker on all buffers:
        /allbuf /buffer set unread

- `away`: set or remove away status

    /away  [-all] [<message>]

       -all: set or remove away status on all connected servers
    message: message for away (if no message is given, away status is removed)

- `bar`: manage bars

    /bar  list|listfull|listitems
          add|addreplace <name> <type>[,<conditions>] <position> <size> <separator> <item1>[,<item2>...]
          default [input|title|status|nicklist]
          rename <name> <new_name>
          del <name>|<mask>...
          set <name> <option> <value>
          hide|show|toggle <name>
          scroll <name> <window> <scroll_value>

            list: list all bars
        listfull: list all bars (verbose)
       listitems: list all bar items
             add: add a new bar
      addreplace: add or replace an existing bar
            name: name of bar (must be unique)
            type: type of bar:
                  root: outside windows
                  window: inside windows, with optional conditions (see below)
      conditions: the conditions to display the bar (without conditions, the bar is always displayed):
                  active: on active window
                  inactive: on inactive windows
                  nicklist: on windows with nicklist
                  other condition: see /help weechat.bar.xxx.conditions and /help eval
        position: bottom, top, left or right
            size: size of bar (in chars)
       separator: 1 for using separator (line), 0 or nothing means no separator
       item1,...: items for this bar (items can be separated by comma (space between items) or "+" (glued items))
         default: create a default bar (all default bars if no bar name is given)
          rename: rename a bar
             del: delete bars
            mask: name where wildcard "*" is allowed
             set: set a value for a bar property
          option: option to change (for options list, look at /set weechat.bar.<barname>.*)
           value: new value for option
            hide: hide a bar
            show: show an hidden bar
          toggle: hide/show a bar
          scroll: scroll bar
          window: window number ("*" for current window or for root bars)
    scroll_value: value for scroll: "x" or "y" (optional), followed by "+", "-", "b" (beginning) or "e" (end), value (for +/-), and optional "%" (to scroll by % of width/height, otherwise value is number of chars)

    Examples:
      create a bar with time, buffer number + name, and completion:
        /bar add mybar root bottom 1 0 [time],buffer_number+:+buffer_name,completion
      scroll nicklist 10 lines down on current buffer:
        /bar scroll nicklist * y+10
      scroll to end of nicklist on current buffer:
        /bar scroll nicklist * ye

- `buffer`: manage buffers

    /buffer  list
             add [-free] [-switch] <name>
             clear [<id>|<number>|<name>|-merged|-all [<id>|<number>|<name>...]]
             move <number>|-|+
             swap <id1>|<number1>|<name1> [<id2>|<number2>|<name2>]
             cycle <id>|<number>|<name>...
             merge <id>|<number>|<name>
             unmerge [<number>|-all]
             hide [<id>|<number>|<name>|-all [<id>|<number>|<name>...]]
             unhide [<id>|<number>|<name>|-all [<id>|<number>|<name>...]]
             switch [-previous]
             zoom
             renumber [<number1> [<number2> [<start>]]]
             close [<n1>[-<n2>]|<name>...]
             notify [<level>]
             listvar [<id>|<number>|<name>]
             setvar <name> [<value>]
             delvar <name>
             set <property> [<value>]
             setauto <property> [<value>]
             get <property>
             jump smart|last_displayed|prev_visited|next_visited
             <id>|<number>|-|+|<name>

        list: list buffers (without argument, this list is displayed)
         add: add a new buffer (it can be closed with "/buffer close" or input "q")
       clear: clear buffer content (number for a buffer, "-merged" for merged buffers, "-all" for all buffers, or nothing for current buffer)
        move: move buffer in the list (may be relative, for example -1); "-" = move to first buffer number, "+" = move to last buffer number + 1
        swap: swap two buffers (swap with current buffer if only one number/name given)
       cycle: jump loop between a list of buffers
       merge: merge current buffer to another buffer (chat area will be mix of both buffers); by default ctrl-x switches between merged buffers
     unmerge: unmerge buffer from other buffers which have same number
        hide: hide the buffer
      unhide: unhide the buffer
      switch: switch to next merged buffer (or to previous buffer with "-previous")
        zoom: zoom on merged buffer
    renumber: renumber buffers (works only if option weechat.look.buffer_auto_renumber is off)
       close: close buffer (number/range or name is optional)
      notify: display or set notify level for current buffer: this level determines whether buffer will be added to hotlist or not:
              none: never
              highlight: for highlights only
              message: for messages from users + highlights
              all: for all messages
              reset: reset to default value (all)
     listvar: display local variables in a buffer
      setvar: set a local variable in the current buffer
      delvar: delete a local variable from the current buffer
         set: set a property in the current buffer
     setauto: like "set" and also define option "weechat.buffer.<name>.<property>" so that the property is saved in configuration and applied each time this buffer is opened
         get: display a property of current buffer
        jump: jump to another buffer:
              smart: next buffer with activity
              last_displayed: last buffer displayed (before last jump to a buffer)
              prev_visited: previously visited buffer
              next_visited: jump to next visited buffer
          id: jump to buffer by id
      number: jump to buffer by number, possible prefix:
              "+": relative jump, add number to current
              "-": relative jump, sub number to current
              "*": jump to number, using option "weechat.look.jump_current_to_previous_buffer"
           -: jump to first buffer number
           +: jump to last buffer number
        name: jump to buffer by (partial) name; if the name starts with "(?i)", the search is case-insensitive (for example "(?i)upper" will find buffer "irc.libera.#UPPERCASE")

    Examples:
      /buffer move 5
      /buffer swap 1 3
      /buffer swap #weechat
      /buffer cycle #chan1 #chan2 #chan3
      /buffer merge 1
      /buffer merge #weechat
      /buffer close 5-7
      /buffer #weechat
      /buffer +1
      /buffer +

- `color`: define color aliases and display palette of colors

    /color  alias <color> <name>
            unalias <color>
            reset
            term2rgb <color>
            rgb2term <rgb> [<limit>]
            -o

       alias: add an alias for a color
     unalias: delete an alias
       color: color number (greater than or equal to 0, max depends on terminal, commonly 63 or 255)
        name: alias name for color (for example: "orange")
       reset: reset all color pairs (required when no more color pairs are available if automatic reset is disabled, see option "weechat.look.color_pairs_auto_reset")
    term2rgb: convert a terminal color (0-255) to RGB color
    rgb2term: convert a RGB color to terminal color (0-255)
       limit: number of colors to use in terminal table (starting from 0); default is 256
          -o: send terminal/colors info to current buffer as input

    Without argument, this command displays colors in a new buffer.

    Examples:
      /color alias 214 orange
      /color unalias 214

- `command`: launch explicit WeeChat or plugin command

    /command  [-buffer <name>] <plugin> <command>
              -s <command>[;<command>...]

    -buffer: execute the command on this buffer
     plugin: execute the command from this plugin; "core" for a WeeChat command, "*" for automatic plugin (it depends on the buffer where the command is executed)
    command: command to execute (a "/" is automatically added if not found at beginning of command)
         -s: execute one or multiple commands separated by semicolons (the semicolon can be escaped with "\;")

- `cursor`: free movement of cursor on screen to execute actions on specific areas of screen

    /cursor  go chat|<bar> [top_left|top_right|bottom_left|bottom_right]
             go <x>,<y>
             move up|down|left|right|top_left|top_right|bottom_left|bottom_right|edge_top|edge_bottom|edge_left|edge_right|area_up|area_down|area_left|area_right
             stop

      go: move cursor to chat area, a bar (using bar name) or coordinates "x,y"
    move: move cursor with direction
    stop: stop cursor mode

    Without argument, this command toggles cursor mode.

    When mouse is enabled (see /help mouse), by default a middle click will start cursor mode at this point.

    See chapter on key bindings in User's guide for a list of keys that can be used in cursor mode.

    Examples:
      /cursor go chat bottom_left
      /cursor go nicklist
      /cursor go 10,5

- `debug`: debug functions

    /debug  list
            set <plugin> <level>
            dump [<plugin>]
            hooks [<plugin_mask> [<hook_type>...]]
            buffer|certs|color|dirs|infolists|key|libs|memory|tags|term|url|windows
            callbacks <duration>[<unit>]
            mouse|cursor [verbose]
            hdata [free]
            time <command>
            unicode <string>
            whitespace

           list: list plugins with debug levels
            set: set debug level for plugin
         plugin: name of plugin ("core" for WeeChat core)
          level: debug level for plugin (0 = disable debug)
           dump: save memory dump in WeeChat log file (same dump is written when WeeChat crashes)
          hooks: display infos about hooks (with a plugin: display detailed info about hooks created by the plugin)
    plugin_mask: plugin mask, "*" for all plugins
      hook_type: hook type
         buffer: dump buffer content with hexadecimal values in WeeChat log file
      callbacks: write hook and bar item callbacks that took more than "duration" in the WeeChat log file (0 = disable), where optional unit is one of:
                 us: microseconds (default)
                 ms: milliseconds
                 s: seconds
                 m: minutes
                 h: hours
          certs: display number of loaded trusted certificate authorities
          color: display infos about current color pairs
         cursor: toggle debug for cursor mode
           dirs: display directories
          hdata: display infos about hdata (with free: remove all hdata in memory)
      infolists: display infos about infolists
            key: enable keyboard and mouse debug: display raw codes, expanded key name and associated command ("q" to quit this mode)
           libs: display infos about external libraries used
         memory: display infos about memory usage
          mouse: toggle debug for mouse
           tags: display tags for lines
           term: display infos about terminal
            url: toggle debug for calls to hook_url (display output hashtable)
        windows: display windows tree
           time: measure time to execute a command or to send text to the current buffer
        unicode: display information about string and unicode chars (evaluated, see /help eval)
     whitespace: toggle whitespace mode: make spaces and tabulations visible in buffers and bars (see options weechat.look.whitespace_char and weechat.look.tab_whitespace_char)

    Examples:
      /debug set irc 1
      /debug mouse verbose
      /debug time /filter toggle
      /debug hooks * process connect url
      /debug unicode ${chars:${\u26C0}-${\u26CF}}

- `eval`: evaluate expression

    /eval  [-n|-s] [-d] <expression>
           [-n] [-d [-d]] -c <expression1> <operator> <expression2>

            -n: display result without sending it to buffer (debug mode)
            -s: split expression before evaluating it (many commands can be separated by semicolons)
            -d: display debug output after evaluation (with two -d: more verbose debug)
            -c: evaluate as condition: use operators and parentheses, return a boolean value ("0" or "1")
    expression: expression to evaluate, variables with format ${variable} are replaced (see below)
      operator: a logical or comparison operator (see below)

    An expression is considered as "true" if it is not NULL, not empty, and different from "0".
    The comparison is made using floating point numbers if the two expressions are valid numbers, with one of the following formats: integer (examples: 5, -7), floating point number (examples: 5.2, -7.5, 2.83e-2), hexadecimal number (examples: 0xA3, -0xA3).
    To force a string comparison, you can add double quotes around each expression, for example: 50 > 100 == 0 and "50" > "100" == 1

    Some variables are replaced in expression, using the format ${variable}, which can be, by order of priority:
      - ${raw_hl:string}: the string itself without evaluation but with syntax highlighting
      - ${raw:string}: the string itself without evaluation
      - ${hl:string}: the string with syntax highlighting
      - ${name}: the user-defined variable
      - ${weechat_config_dir}: WeeChat config directory
      - ${weechat_data_dir}: WeeChat data directory
      - ${weechat_state_dir}: WeeChat state directory
      - ${weechat_cache_dir}: WeeChat cache directory
      - ${weechat_runtime_dir}: WeeChat runtime directory
      - ${eval:string}: the evaluated string
      - ${eval_cond:string}: the evaluated condition
      - ${esc:string} or ${\string}: the string with escaped chars
      - ${chars:range}: the string with a range of chars, "range" is one of: "digit", "xdigit", "lower", "upper", "alpha", "alnum" or "c1-c2" ("c1" and "c2" are code points with c1 ≤ c2)
      - ${lower:string}: the string converted to lower case
      - ${upper:string}: the string converted to upper case
      - ${hide:char,string}: the string with hidden chars
      - ${cut:max,suffix,string}: the string with max chars (excluding the suffix)
      - ${cut:+max,suffix,string}: the string with max chars (including the suffix)
      - ${cutscr:max,suffix,string}: the string with max chars displayed on screen (excluding the suffix)
      - ${cutscr:+max,suffix,string}: the string with max chars displayed on screen (including the suffix)
      - ${rev:string}: the reversed string
      - ${revscr:string}: the reversed string for display (color codes are not reversed)
      - ${repeat:count,string}: the repeated string
      - ${length:string}: the length of the string (number of UTF-8 chars)
      - ${lengthscr:string}: the length of the string on screen (sum of the width of each UTF-8 char displayed on screen, colors codes are ignored)
      - ${split:N,separators,flags,string}: Nth item of the split string (N is an integer ≥ 1 or ≤ -1, if negative, counts from the last item)
      - ${split:random,separators,flags,string}: random item of the split string
      - ${split:count,separators,flags,string}: number of items of the split string
      - ${split_shell:N,string}: Nth item of the split shell arguments (N is an integer ≥ 1 or ≤ -1, if negative, counts from the last item)
      - ${split_shell:random,string}: random item of the split shell arguments
      - ${split_shell:count,string}: number of items of the split shell arguments
      - ${color:name}: the color (see "Plugin API reference", function "color")
      - ${modifier:name,data,string}: the modifier
      - ${info:name,arguments}: the info (arguments are optional)
      - ${base_encode:base,string}: the string encoded to base: 16, 32, 64 or 64url
      - ${base_decode:base,string}: the string decoded from base: 16, 32, 64 or 64url
      - ${date} or ${date:format}: current date/time
      - ${env:NAME}: the environment variable
      - ${if:condition?value_if_true:value_if_false}: the result of ternary operator
      - ${calc:expression}: the result of the expression with parentheses and operators (+, -, *, /, //, %, **)
      - ${random:min,max}: a random integer number between "min" and "max" (inclusive)
      - ${translate:string}: the translated string
      - ${define:name,value}: declaration of a user variable (return an empty string)
      - ${hdata_count:name[list]}: number of items in this hdata with list
      - ${hdata_count:name[ptr]}: number of items in this hdata with pointer
      - ${sec.data.xxx}: the value of the secured data "xxx"
      - ${file.section.option}: the value of the config option
      - ${name}: the local variable in buffer
      - the hdata name/variable (the value is automatically converted to string), by default "window" and "buffer" point to current window/buffer.

    Format for hdata can be one of following:
      - ${hdata.var1.var2...}: start with a hdata (pointer must be known), and ask variables one after one (other hdata can be followed)
      - ${hdata[list].var1.var2...}: start with a hdata using a list/pointer/pointer name, for example:
        - ${buffer[gui_buffers].full_name}: full name of first buffer in linked list of buffers
        - ${plugin[weechat_plugins].name}: name of first plugin in linked list of plugins
      - ${hdata[pointer].var1.var2...}: start with a hdata using a pointer, for example:
        - ${buffer[0x1234abcd].full_name}: full name of the buffer with this pointer (can be used in triggers)
        - ${buffer[my_pointer].full_name}: full name of the buffer with this pointer name (can be used in triggers)
      - ${hdata[pointer].var1.method()}: when var1 is a hashtable, methods can be called: "keys()", "values()", "keys_sorted()", "keys_values()" and "keys_values_sorted()"
    For name of hdata and variables, please look at "Plugin API reference", function "weechat_hdata_get".

    Logical operators (by order of priority):
      &&   boolean "and"
      ||   boolean "or"

    Comparison operators (by order of priority):
      =~   is matching POSIX extended regex
      !~   is NOT matching POSIX extended regex
      ==*  is matching mask, case-sensitive (wildcard "*" is allowed)
      !!*  is NOT matching mask, case-sensitive (wildcard "*" is allowed)
      =*   is matching mask, case-insensitive (wildcard "*" is allowed)
      !*   is NOT matching mask, case-insensitive (wildcard "*" is allowed)
      ==-  is included, case-sensitive
      !!-  is NOT included, case-sensitive
      =-   is included, case-insensitive
      !-   is NOT included, case-insensitive
      ==   equal
      !=   not equal
      <=   less or equal
      <    less
      >=   greater or equal
      >    greater

    Examples (simple strings):
      /eval -n ${raw:${info:version}}                  ==> ${info:version}
      /eval -n ${eval_cond:${window.win_width}>100}    ==> 1
      /eval -n ${info:version}                         ==> 4.8.1
      /eval -n ${env:HOME}                             ==> /home/user
      /eval -n ${weechat.look.scroll_amount}           ==> 3
      /eval -n ${sec.data.password}                    ==> secret
      /eval -n ${window}                               ==> 0x2549aa0
      /eval -n ${window.buffer}                        ==> 0x2549320
      /eval -n ${window.buffer.full_name}              ==> core.weechat
      /eval -n ${window.buffer.number}                 ==> 1
      /eval -n ${buffer.local_variables.keys_values()} ==> plugin:core,name:weechat
      /eval -n ${buffer.local_variables.plugin}        ==> core
      /eval -n ${hdata_count:buffer[gui_buffers]}      ==> 15
      /eval -n ${\t}                                   ==> <tab>
      /eval -n ${chars:digit}                          ==> 0123456789
      /eval -n ${chars:J-T}                            ==> JKLMNOPQRST
      /eval -n ${lower:TEST}                           ==> test
      /eval -n ${upper:test}                           ==> TEST
      /eval -n ${hide:-,${relay.network.password}}     ==> --------
      /eval -n ${cut:3,+,test}                         ==> tes+
      /eval -n ${cut:+3,+,test}                        ==> te+
      /eval -n ${date:%H:%M:%S}                        ==> 07:46:40
      /eval -n ${if:${info:term_width}>80?big:small}   ==> big
      /eval -n ${rev:Hello}                            ==> olleH
      /eval -n ${repeat:5,-}                           ==> -----
      /eval -n ${length:test}                          ==> 4
      /eval -n ${split:1,,,abc,def,ghi}                ==> abc
      /eval -n ${split:-1,,,abc,def,ghi}               ==> ghi
      /eval -n ${split:count,,,abc,def,ghi}            ==> 3
      /eval -n ${split:random,,,abc,def,ghi}           ==> def
      /eval -n ${split_shell:1,"arg 1" arg2}           ==> arg 1
      /eval -n ${split_shell:-1,"arg 1" arg2}          ==> arg2
      /eval -n ${split_shell:count,"arg 1" arg2}       ==> 2
      /eval -n ${split_shell:random,"arg 1" arg2}      ==> arg2
      /eval -n ${calc:(5+2)*3}                         ==> 21
      /eval -n ${random:0,10}                          ==> 3
      /eval -n ${base_encode:64,test}                  ==> dGVzdA==
      /eval -n ${base_decode:64,dGVzdA==}              ==> test
      /eval -n ${define:len,${calc:5+3}}${len}x${len}  ==> 8x8

    Examples (conditions):
      /eval -n -c ${window.buffer.number} > 2 ==> 0
      /eval -n -c ${window.win_width} > 100   ==> 1
      /eval -n -c (8 > 12) || (5 > 2)         ==> 1
      /eval -n -c (8 > 12) && (5 > 2)         ==> 0
      /eval -n -c abcd =~ ^ABC                ==> 1
      /eval -n -c abcd =~ (?-i)^ABC           ==> 0
      /eval -n -c abcd =~ (?-i)^abc           ==> 1
      /eval -n -c abcd !~ abc                 ==> 0
      /eval -n -c abcd =* a*d                 ==> 1
      /eval -n -c abcd =- bc                  ==> 1

- `filter`: filter messages in buffers, to hide/show them according to tags or regex

    /filter  list
             enable|disable|toggle [<name>|<mask>|@...]
             add|addreplace <name> <buffer>[,<buffer>...] <tags> <regex>
             rename <name> <new_name>
             recreate <name>
             del <name>|<mask>...

          list: list all filters
        enable: enable filters (filters are enabled by default)
       disable: disable filters
        toggle: toggle filters
          mask: name where wildcard "*" is allowed ("@" = enable/disable all filters in current buffer)
           add: add a filter
    addreplace: add or replace an existing filter
          name: filter name
        rename: rename a filter
      recreate: set input with the command used to edit the filter
           del: delete filters
        buffer: comma separated list of buffers where filter is active:
                - this is full name including plugin (example: "irc.libera.#weechat" or "irc.server.libera")
                - "*" means all buffers
                - a name starting with "!" is excluded
                - wildcard "*" is allowed
          tags: comma separated list of tags (for example "irc_join,irc_part,irc_quit"):
                - logical "and": "+" between tags (for example: "nick_toto+irc_action")
                - wildcard "*" is allowed
                - if tag starts with "!", then it is excluded and must NOT be in message
         regex: POSIX extended 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 "!")
                - two regular expressions are created: one for prefix and one for message
                - regex are case-insensitive, they can start by "(?-i)" to become case-sensitive

    The default key alt+"=" toggles filtering on/off globally and alt+"-" toggles filtering on/off in the current buffer.

    Tags most commonly used: no_filter, no_highlight, no_log, log0..log9 (log level), notify_none, notify_message, notify_private, notify_highlight, self_msg, nick_xxx (xxx is nick in message), prefix_nick_ccc (ccc is color of nick), host_xxx (xxx is username + host in message), irc_xxx (xxx is command name or number, see /server raw or /debug tags), irc_numeric, irc_error, irc_action, irc_ctcp, irc_ctcp_reply, irc_smart_filter, away_info.
    To see tags for lines in buffers: /debug tags

    Examples:
      use IRC smart filter on all buffers:
        /filter add irc_smart * irc_smart_filter *
      use IRC smart filter on all buffers except those with "#weechat" in name:
        /filter add irc_smart *,!*#weechat* 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:
        /filter add nicks * irc_366 *
      filter nick "toto" on IRC channel #weechat:
        /filter add toto irc.libera.#weechat nick_toto *
      filter IRC join/action messages from nick "toto":
        /filter add toto * nick_toto+irc_join,nick_toto+irc_action *
      filter lines containing "weechat sucks" on IRC channel #weechat:
        /filter add sucks irc.libera.#weechat * weechat sucks
      filter lines that are strictly equal to "WeeChat sucks" on all buffers:
        /filter add sucks2 * * (?-i)^WeeChat sucks$

- `help`: display help about commands and options

    /help  -list|-listfull [<plugin>...]]
           <command>
           <option>

        -list: list commands, by plugin (without argument, this list is displayed)
    -listfull: list commands with description, by plugin
       plugin: list commands for this plugin
      command: a command name
       option: an option name (use /set to see list)

- `history`: show buffer command history

    /history  clear
              <value>

    clear: clear history
    value: number of history entries to show

- `hotlist`: manage hotlist

    /hotlist  add [low|message|private|highlight]
              clear [<level>]
              remove
              restore [-all]

        add: add current buffer in hotlist (default level: "low", conditions defined in option weechat.look.hotlist_add_conditions are NOT checked)
      clear: clear hotlist
      level: "lowest" to clear only lowest level in hotlist, highest" to clear only highest level in hotlist, or level mask: integer which is a combination of 1=join/part, 2=message, 4=private, 8=highlight
     remove: remove current buffer from hotlist
    restore: restore latest hotlist removed in the current buffer (or all buffers with "-all")

- `input`: functions for command line

    /input  <action> [<arguments>]

       action: the action, one of:
               return: simulate key "enter"
               split_return: split input on newlines then simulate key "enter" for each line
               complete_next: complete word with next completion
               complete_previous: complete word with previous completion
               search_text_here: search text in buffer at current position
               search_text: search text in buffer
               search_history: search text in command line history
               search_switch_case: switch exact case for search
               search_switch_regex: switch search type: string/regular expression
               search_switch_where: switch search in messages/prefixes
               search_previous: search previous line
               search_next: search next line
               search_stop_here: stop search at current position
               search_stop: stop search
               delete_previous_char: delete previous char
               delete_next_char: delete next char
               delete_previous_word: delete previous word
               delete_previous_word_whitespace: delete previous word (until whitespace)
               delete_next_word: delete next word
               delete_beginning_of_line: delete from beginning of line until cursor
               delete_beginning_of_input: delete from beginning of input until cursor
               delete_end_of_line: delete from cursor until end of line
               delete_end_of_input: delete from cursor until end of input
               delete_line: delete current line
               delete_input: delete entire input
               clipboard_paste: paste from the internal clipboard
               transpose_chars: transpose two chars
               undo: undo last command line action
               redo: redo last command line action
               move_beginning_of_line: move cursor to beginning of line
               move_beginning_of_input: move cursor to beginning of input
               move_end_of_line: move cursor to end of line
               move_end_of_input: move cursor to end of input
               move_previous_char: move cursor to previous char
               move_next_char: move cursor to next char
               move_previous_word: move cursor to previous word
               move_next_word: move cursor to next word
               move_previous_line: move cursor to previous line
               move_next_line: move cursor to next line
               history_previous: recall previous command in current buffer history
               history_next: recall next command in current buffer history
               history_global_previous: recall previous command in global history
               history_global_next: recall next command in global history
               history_use_get_next: send the current history entry (found with search or recalled with "up"key) and insert the next history entry in the command line without sending it
               grab_key: grab a key (optional argument: delay for end of grab, default is 500 milliseconds)
               grab_key_command: grab a key with its associated command (optional argument: delay for end of grab, default is 500 milliseconds)
               grab_mouse: grab mouse event code
               grab_mouse_area: grab mouse event code with area
               insert: insert text in command line (escaped chars are allowed, see /help print)
               send: send text to the buffer
    arguments: optional arguments for the action

    This command is used by key bindings or plugins.

- `item`: manage custom bar items

    /item  list
           add|addreplace <name> "<conditions>" "<content>"
           rename <name> <new_name>
           refresh <name>|<mask>...
           recreate <name>
           del <name>|<mask>...

          list: list all custom bar items
           add: add a custom bar item
    addreplace: add or replace an existing custom bar item
          name: custom bar item name
          mask: name where wildcard "*" is allowed
    conditions: evaluated conditions to display the bar item (for example to display the bar item only in specific buffers)
       content: content (evaluated, see /help eval)
        rename: rename a custom bar item
       refresh: update content of item in all bars where the item is displayed; any item can be refreshed: default/plugin/custom bar items
      recreate: set input with the command used to edit the custom bar item
           del: delete custom bar items

    Examples:
      add item with terminal size, displayed only in buffers with number = 1:
        /item add terminfo "${buffer.number} == 1" "term:${info:term_width}x${info:term_height}"
      add item with buffer info:
        /item add bufinfo "" "${buffer.number}:${buffer.name}${if:${buffer.zoomed}?(Z)}"
      add item with date/time using format "Dec 25, 12:34 +0100", refreshed every minute:
        /item add datetime "" "${date:%b %d, %H:%M %z}"
        /trigger add datetime_refresh timer "60000;60" "" "" "/item refresh datetime"
      add item with number of lines in buffer (displayed/total), refreshed each time a new line is displayed or if filtered lines have changed:
        /item add lines_count "" "${calc:${buffer.lines.lines_count}-${buffer.lines.lines_hidden}}/${buffer.lines.lines_count} lines"
        /trigger add lines_count_refresh_print print "" "" "" "/item refresh lines_count"
        /trigger add lines_count_refresh_signal signal "window_switch;buffer_switch;buffer_lines_hidden;filters_*" "" "" "/item refresh lines_count"
      force refresh of item "lines_count":
        /item refresh lines_count
      recreate item "lines_count" with different conditions or content:
        /item recreate lines_count
      delete item "lines_count":
        /item del lines_count

- `key`: bind/unbind keys

    /key  [list|listdefault|listdiff] [<context>]
          bind <key> [<command> [<args>]]
          bindctxt <context> <key> [<command> [<args>]]
          unbind <key>
          unbindctxt <context> <key>
          reset <key>
          resetctxt <context> <key>
          resetall -yes [<context>]
          missing [<context>]
          legacy <key>...

           list: list all current keys
    listdefault: list default keys
       listdiff: list differences between current and default keys (keys added, redefined or deleted)
        context: name of context ("default" or "search")
           bind: bind a command to a key or display command bound to key (for context "default")
       bindctxt: bind a command to a key or display command bound to key, for given context
        command: command (many commands can be separated by semicolons); quotes can be used to preserve spaces at the beginning/end of command
         unbind: remove a key binding (for context "default")
     unbindctxt: remove a key binding for given context
          reset: reset a key to default binding (for context "default")
      resetctxt: reset a key to default binding, for given context
       resetall: restore bindings to the default values and delete ALL personal bindings (use carefully!)
        missing: add missing keys (using default bindings), useful after installing new WeeChat version
         legacy: display new name for legacy keys

    When binding a command to a key, it is recommended to use key alt+k (or Esc then k), and then press the key to bind: this will insert key name in command line.

    For some keys you might need to use /debug key, this displays the raw key code that can be used (for example the key ctrl+backspace could be "ctrl-h" or "ctrl-?", depending on your terminal and other settings).

    Modifiers allowed (in this order when multiple are used):
      "meta-": alt key
      "ctrl-": control key
      "shift-": shift key, can only be used with key names below

    Key names allowed: f0 to f20, home, insert, delete, end, backspace, pgup, pgdn, up, down, right, left, tab, return, comma, space.

    Combo of keys must be separated by a comma.

    For context "mouse" (possible in context "cursor" too), key has format: "@area:key" or "@area1>area2:key" where area can be:
      *: any area on screen
      chat: chat area (any buffer)
      chat(xxx): chat area for buffer with name "xxx" (full name including plugin)
      bar(*): any bar
      bar(xxx): bar "xxx"
      item(*): any bar item
      item(xxx): bar item "xxx"
    Wildcard "*" is allowed in key to match many mouse events.
    A special value for command with format "hsignal:name" can be used for context mouse, this will send the hsignal "name" with the focus hashtable as argument.
    Another special value "-" can be used to disable key (it will be ignored when looking for keys).

    Examples:
      /key bind meta-q /buffer #weechat
      /key reset meta-q
      /key bind meta-v,f1 /help
      /key bindctxt search f12 /input search_stop
      /key bindctxt mouse @item(buffer_nicklist):button3 /msg nickserv info ${nick}

- `layout`: manage buffers/windows layouts

    /layout  store [<name>] [buffers|windows]
             apply [<name>] [buffers|windows]
             leave
             del [<name>] [buffers|windows]
             rename <name> <new_name>

      store: store current buffers/windows in a layout
      apply: apply stored layout
      leave: leave current layout (does not update any layout)
        del: delete buffers and/or windows in a stored layout (if neither "buffers" nor "windows" is given after the name, the layout is deleted)
     rename: rename a layout
       name: name for stored layout (default is "default")
    buffers: store/apply only buffers (order of buffers)
    windows: store/apply only windows (buffer displayed by each window)

    Without argument, this command displays stored layouts.

    The current layout can be saved on /quit command with the option "weechat.look.save_layout_on_exit".

    Note: the layout only remembers windows split and buffers numbers. It does not open buffers. That means for example you must still auto-join IRC channels to open the buffers, the saved layout only applies once the buffers are opened.

- `mouse`: mouse control

    /mouse  enable|disable|toggle [<delay>]

     enable: enable mouse
    disable: disable mouse
     toggle: toggle mouse
      delay: delay (in seconds) after which initial mouse state is restored (useful to temporarily disable mouse)

    The mouse state is saved in option "weechat.look.mouse".

    Examples:
      /mouse enable
      /mouse toggle 5

- `mute`: execute a command silently

    /mute  [-core|-current|-buffer <name>] <command>

       -core: no output on WeeChat core buffer
    -current: no output on current buffer
     -buffer: no output on specified buffer
        name: full buffer name (examples: "irc.server.libera", "irc.libera.#weechat")
     command: command to execute silently (a "/" is automatically added if not found at beginning of command)

    If no target is specified ("-core", "-current" or "-buffer"), then default is to mute all buffers.

    Examples:
      /mute save
      /mute -current msg * hi!
      /mute -buffer irc.libera.#weechat msg #weechat hi!

- `pipe`: redirect command output to a buffer, a file or a hsignal

    /pipe  [-buffer <name>|-file <filename>|-hsignal <name>] [-color strip|keep|ansi] [-concat <separator>] [-strip <chars>] [-skipempty] [-c] [-o] [-g] [-nl] <command>

       -buffer: display command output on this buffer
          name: full buffer name (examples: "core.weechat", "irc.server.libera", "irc.libera.#weechat")
         -file: write command output in this file
      -hsignal: send command output as hsignal; keys: "command", "output" (lines separated by separator) and "tags" (tags of each line separated by newline)
        -color: convert colors
            -o: send command output to the buffer as input; colors are stripped and commands are NOT executed (used only with -buffer)
       -concat: concatenate all lines displayed using a separator; chars can be escaped (example: \x20 for space)
        -strip: strip chars from lines (beginning/end); chars can be escaped (example: \x20 for space)
    -skipempty: skip empty lines when lines are concatenated
            -c: alias for "-concat \x20 -strip \x20 -skipempty"
           -nl: display messages in English during the command execution (do not use the current locale)
       command: command to execute (a "/" is automatically added if not found at beginning of command)

    If no target is specified ("-buffer", "-file" or "-hsignal"), then the command output is sent on the current buffer.

    Note: for commands that display messages in an asynchronous way (like /exec and many IRC commands), the output will not be caught by this command.
    For example "/pipe /whois nick" will NOT redirect the answer from IRC server to the current buffer.

    Examples:
      write info about external libraries in a file:
        /pipe -file /tmp/libs.txt /debug libs
      send output of "/debug libs" as a single line on current channel:
        /pipe -o -c /debug libs
      display info about all buffers on current buffer:
        /pipe /allbuf /eval /print ${buffer.full_name} -> ${buffer.number}. ${buffer.short_name} (${buffer})
      send list of filters on current channel, in English:
        /pipe -o -nl /filter

- `plugin`: list/load/unload plugins

    /plugin  list [-o|-ol|-i|-il|<name>]
             listfull [<name>]
             load <filename> [<arguments>]
             autoload [<arguments>]
             reload [<name>|* [<arguments>]]
             unload [<name>]

         list: list loaded plugins
           -o: send list of loaded plugins to buffer (string in English)
          -ol: send list of loaded plugins to buffer (translated string)
           -i: copy list of loaded plugins in command line (for sending to buffer) (string in English)
          -il: copy list of loaded plugins in command line (for sending to buffer) (translated string)
         name: a plugin name
     listfull: list loaded plugins (verbose)
         load: load a plugin
     filename: plugin (file) to load
    arguments: arguments given to plugin on load
     autoload: autoload plugins in system or user directory
       reload: reload a plugin (if no name given, unload all plugins, then autoload plugins)
       unload: unload a plugin (if no name given, unload all plugins)

    Without argument, this command lists loaded plugins.

- `print`: display text on a buffer

    /print  [-buffer <id>|<number>|<name>] [-newbuffer <name>] [-free] [-switch] [-core|-current] [-y <line>] [-escape] [-date <date>] [-tags <tags>] [-action|-error|-join|-network|-quit] [<text>]
            -stdout|-stderr [<text>]
            -beep

       -buffer: display text in this buffer (default: buffer where command is executed)
    -newbuffer: create a new buffer and display text in this buffer
         -free: create a buffer with free content (with -newbuffer only)
       -switch: switch to the buffer
         -core: alias of "-buffer core.weechat"
      -current: display text on current buffer
            -y: display on a custom line (for buffer with free content only)
          line: line number for buffer with free content (first line is 0, a negative number displays after last line: -1 = after last line, -2 = two lines after last line, etc.)
       -escape: interpret escaped chars (for example \a, \07, \x07)
         -date: message date, format can be:
                -n: "n" seconds before now
                +n: "n" seconds in the future
                n: "n" seconds since the Epoch (see man time)
                date and/or time (ISO 8601): see function "util_parse_time" in Plugin API reference (examples: "11:29:09", "2023-12-25T10:29:09.456789Z")
         -tags: comma-separated list of tags (see /help filter for a list of tags most commonly used)
          text: text to display (prefix and message must be separated by "\t", if text starts with "-", then add a "\" before)
       -stdout: display text on stdout (escaped chars are interpreted)
       -stderr: display text on stderr (escaped chars are interpreted)
         -beep: alias of "-stderr \a"

    The options -action ... -quit use the prefix defined in options "weechat.look.prefix_*".

    Following escaped chars are supported:
      \" \\ \a \b \e \f \n \r \t \v \0ooo \xhh \uhhhh \Uhhhhhhhh

    Examples:
      display a reminder on core buffer with a highlight:
        /print -core -tags notify_highlight Reminder: buy milk
      display an error on core buffer:
        /print -core -error Some error here
      display message on core buffer with prefix "abc":
        /print -core abc\tThe message
      display a message on channel #weechat:
        /print -buffer irc.libera.#weechat Message on #weechat
      display a snowman (U+2603):
        /print -escape \u2603
      send alert (BEL):
        /print -beep

- `proxy`: manage proxies

    /proxy  list
            add|addreplace <name> <type> <address> <port> [<username> [<password>]]
            del <name>|<mask>...
            set <name> <option> <value>

          list: list all proxies
           add: add a new proxy
    addreplace: add or replace an existing proxy
          name: name of proxy (must be unique)
          type: http, socks4 or socks5
       address: IP or hostname
          port: port number
      username: username (optional)
      password: password (optional)
           del: delete proxies
          mask: name where wildcard "*" is allowed
           set: set a value for a proxy property
        option: option to change (for options list, look at /set weechat.proxy.<proxyname>.*)
         value: new value for option

    Examples:
      add a http proxy, running on local host, port 8888:
        /proxy add local http 127.0.0.1 8888
      add a http proxy using IPv6 protocol only:
        /proxy add local http ::1 8888
        /proxy set local ipv6 force
      add a socks5 proxy with username/password:
        /proxy add myproxy socks5 sample.host.org 3128 myuser mypass
      delete a proxy:
        /proxy del myproxy

- `quit`: quit WeeChat

    /quit  [-yes] [<arguments>]

         -yes: required if option "weechat.look.confirm_quit" is enabled
    arguments: text sent with signal "quit" (for example irc plugin uses this text to send quit message to server)

    By default when quitting the configuration files are saved (see option "weechat.look.save_config_on_exit") and the current layout can be saved (see option "weechat.look.save_layout_on_exit").

- `reload`: reload configuration files from disk

    /reload  [<file>...]

    file: configuration file to reload (without extension ".conf")

    Without argument, all files (WeeChat and plugins) are reloaded.

- `repeat`: execute a command several times

    /repeat  [-interval <delay>[<unit>]] <count> <command>

      delay: delay between execution of commands (minimum: 1 millisecond)
       unit: optional, values are:
             us: microseconds
             ms: milliseconds
             s: seconds (default)
             m: minutes
             h: hours
      count: number of times to execute command
    command: command to execute (or text to send to buffer if command does not start with "/"), evaluated and the following variables are set each time the command is executed:
             ${buffer}: buffer pointer
             ${repeat_count}: number of times the command is executed
             ${repeat_index}: current index (from 1 to "count")
             ${repeat_index0}: current index (from 0 to "count" - 1)
             ${repeat_revindex}: current index from the end (from "count" to 1)
             ${repeat_revindex0}: current index from the end (from "count" - 1 to 0)
             ${repeat_first}: "1" for the first execution, "0" for the others
             ${repeat_last}: "1" for the last execution, "0" for the others

    Note: the command is executed on buffer where /repeat was executed (if the buffer does not exist anymore, the command is not executed).

    Examples:
      scroll 2 pages up:
        /repeat 2 /window page_up
      print a countdown, starting at 5:
        /repeat -interval 1 6 /print ${if:${repeat_last}?Boom!:${repeat_revindex0}}

- `reset`: reset config options

    /reset  <option>
            -mask <option>

    option: name of an option
     -mask: use a mask in option (wildcard "*" is allowed to mass-reset options, use carefully!)

    Examples:
      /reset weechat.look.item_time_format
      /reset -mask weechat.color.*

- `save`: save configuration files to disk

    /save  [<file>...]

    file: configuration file to save (without extension ".conf")

    Without argument, all files (WeeChat and plugins) are saved.

    By default all configuration files are saved to disk on /quit command (see option "weechat.look.save_config_on_exit").

- `secure`: manage secured data (passwords or private data encrypted in file sec.conf)

    /secure  passphrase <passphrase>|-delete
             decrypt <passphrase>|-discard
             set <name> <value>
             del <name>

    passphrase: change the passphrase (without passphrase, data is stored as plain text in file sec.conf)
       -delete: delete passphrase
       decrypt: decrypt data still encrypted (it happens only if passphrase was not given on startup)
      -discard: discard all data still encrypted
           set: add or change secured data
           del: delete secured data

    Without argument, this command displays secured data in a new buffer.

    Keys on secure buffer:
      alt+v  toggle values

    When a passphrase is used (data encrypted), it is asked by WeeChat on startup.
    It is possible to set environment variable "WEECHAT_PASSPHRASE" to prevent the prompt (this same variable is used by WeeChat on /upgrade), or to set option sec.crypt.passphrase_command to read the passphrase from the output of an external command like a password manager (see /help sec.crypt.passphrase_command).

    Secured data with format ${sec.data.xxx} can be used in:
      - command /eval
      - command line argument "--run-command"
      - options weechat.startup.command_{before|after}_plugins
      - other options that may contain a password or sensitive data (for example proxy, irc server and relay); see /help on the options to check if they are evaluated.

    Examples:
      set a passphrase:
        /secure passphrase this is my passphrase
      use program "pass" to read the passphrase on startup:
        /set sec.crypt.passphrase_command "/usr/bin/pass show weechat/passphrase"
      encrypt libera SASL password:
        /secure set libera mypassword
        /set irc.server.libera.sasl_password "${sec.data.libera}"
      encrypt oftc password for nickserv:
        /secure set oftc mypassword
        /set irc.server.oftc.command "/msg nickserv identify ${sec.data.oftc}"
      alias to ghost the nick "mynick":
        /alias add ghost /eval /msg -server libera nickserv ghost mynick ${sec.data.libera}

- `set`: set config options and environment variables

    /set  [<option> [<value>]]
          diff [<option>...]
          env [<variable> [<value>]]

    option: name of an option (wildcard "*" is allowed to list options, if no value is specified)
     value: new value for option, according to type:
            boolean: on, off or toggle
            integer: number, ++number or --number
            string: any string ("" for empty string)
            color: color name, ++number or --number
      diff: display only changed options
       env: display or set an environment variable ("" to unset a variable)

    Note: the value "null" (without quotes) can be used to remove option value (undefined value). This works only for some special plugin variables.

    Examples:
      /set *highlight*
      /set weechat.look.highlight "word"
      /set diff
      /set diff irc.*
      /set env LANG
      /set env LANG fr_FR.UTF-8
      /set env ABC ""

- `sys`: system actions

    /sys  get rlimit|rusage
          malloc_trim [<size>]
          suspend
          waitpid <number>

            get: display system info
         rlimit: display resource limits (see /help weechat.startup.sys_rlimit and "man getrlimit")
         rusage: display resource usage (see "man getrusage")
    malloc_trim: call function malloc_trim to release free memory from the heap
           size: amount of free space to leave untrimmed at the top of the heap (default is 0: only the minimum amount of memory is maintained at the top of the heap)
        suspend: suspend WeeChat and go back to the shell, by sending signal SIGTSTP to the WeeChat process
        waitpid: acknowledge the end of children processes (to prevent "zombie" processes)
         number: number of processes to clean

- `toggle`: toggle value of a config option

    /toggle  <option> [<value>...]

    option: name of an option
     value: possible values for the option (values are split like the shell command arguments: quotes can be used to preserve spaces at the beginning/end of values)

    Behavior:
      - only an option of type boolean or string can be toggled without a value:
        - boolean: toggle between on/off according to current value
        - string: toggle between empty string and default value (works only if empty string is allowed for the option)
      - with a single value given, toggle between this value and the default value of option
      - with multiple values given, toggle between these values: the value used is the one following the current value of option; if the current value of option is not in list, the first value in the list is used
      - the special value "null" can be given, but only as first value in the list and without quotes around.

    Examples:
      toggle display of time in chat area (without displaying the new value used):
        /mute /toggle weechat.look.buffer_time_format
      switch format of time in chat area (with seconds, without seconds, disabled):
        /toggle weechat.look.buffer_time_format "%H:%M:%S" "%H:%M" ""
      toggle autojoin of #weechat channel on libera server:
        /toggle irc.server.libera.autojoin null #weechat

- `unset`: unset/reset config options

    /unset  <option>
            -mask <option>

    option: name of an option
     -mask: use a mask in option (wildcard "*" is allowed to mass-reset options, use carefully!)

    According to option, it's reset (for standard options) or removed (for optional settings, like server values).

    Examples:
      /unset weechat.look.item_time_format
      /unset -mask weechat.color.*

- `upgrade`: save WeeChat session and reload the WeeChat binary without disconnecting from servers

    /upgrade  [-yes] [<path_to_binary>|-save|-quit]
              -o|-ol

              -yes: required if option "weechat.look.confirm_upgrade" is enabled
    path_to_binary: path to WeeChat binary (default is current binary)
            -dummy: do nothing (option used to prevent accidental completion with "-quit")
             -save: only save the session, neither quit nor reload WeeChat; the configuration files are not saved (if needed you can use /save before this command)
             -quit: close *ALL* connections, save session and quit WeeChat, which makes possible a delayed restoration (see below)
                -o: send number of upgrades and date of first/last start to current buffer as input (English string)
               -ol: send number of upgrades and date of first/last start to current buffer as input (translated string)

    This command upgrades and reloads a running WeeChat session. The new WeeChat binary must have been compiled or installed with a package manager before running this command.

    Note: TLS connections are lost during upgrade (except with -save), because the reload of TLS sessions is currently not possible with GnuTLS. There is automatic reconnection after upgrade.

    Important: use of option "-save" can be dangerous, it is recommended to use only /upgrade (or with "-quit") for a standard upgrade and a restart; the option "-save" can be used to save the session regularly and restore it in case of after abnormal exit (power outage, crash, etc.).

    Upgrade process has 4 steps:
      1. save session into files for core and plugins (buffers, history, ..)
      2. unload all plugins (configuration files (*.conf) are written on disk)
      3. save WeeChat configuration (weechat.conf)
      4. execute new WeeChat binary and reload session.

    With option "-quit", the process is:
      1. close *ALL* connections (irc, xfer, relay, ...)
      2. save session into files (*.upgrade)
      3. unload all plugins
      4. save WeeChat configuration
      5. quit WeeChat

    With option "-save", the process is:
      1. save session into files (*.upgrade) with a disconnected state for IRC servers and Relay clients (but no disconnection is made)

    With -quit or -save, you can restore the session later with this command: weechat --upgrade
    IMPORTANT: you must restore the session with exactly same configuration (files *.conf) and if possible the same WeeChat version (or a more recent one).
    It is possible to restore WeeChat session on another machine if you copy the content of WeeChat home directories (see /debug dirs).

- `uptime`: show WeeChat uptime

    /uptime  [-o|-ol]

     -o: send uptime to current buffer as input (English string)
    -ol: send uptime to current buffer as input (translated string)

- `version`: show WeeChat version and compilation date

    /version  [-o|-ol] [-v]

     -o: send version to current buffer as input (English string)
    -ol: send version to current buffer as input (translated string)
     -v: verbose mode: display information about upgrades of WeeChat with /upgrade

    The default alias /v can be used to execute this command on all buffers (otherwise the irc command /version is used on irc buffers).

- `wait`: schedule a command execution in future

    /wait  <number>[<unit>] <command>

     number: amount of time to wait (minimum: 1 millisecond)
       unit: optional, values are:
             us: microseconds
             ms: milliseconds
             s: seconds (default)
             m: minutes
             h: hours
    command: command to execute (or text to send to buffer if command does not start with "/")

    Note: the command is executed on buffer where /wait was executed (if the buffer does not exist anymore, the command is not executed).

    Examples:
      join channel #test in 10 seconds:
        /wait 10 /join #test
      set away in 15 minutes:
        /wait 15m /away -all I'm away
      say "hello" in 2 minutes:
        /wait 2m hello

- `window`: manage windows

    /window  list
             -1|+1|b#|up|down|left|right [-window <number>]
             <number>
             splith|splitv [-window <number>] [<pct>]
             resize [-window <number>] [h|v][+|-]<pct>
             balance
             merge [-window <number>] [all]
             close [-window <number>]
             page_up|page_down [-window <number>]
             refresh
             scroll [-window <number>] [+|-]<value>[s|m|h|d|M|y]
             scroll_horiz [-window <number>] [+|-]<value>[%]
             scroll_up|scroll_down|scroll_top|scroll_bottom|scroll_beyond_end|scroll_previous_highlight|scroll_next_highlight|scroll_unread [-window <number>]
             swap [-window <number>] [up|down|left|right]
             zoom [-window <number>]
             bare [<delay>]

                         list: list opened windows (without argument, this list is displayed)
                           -1: jump to previous window
                           +1: jump to next window
                           b#: jump to next window displaying buffer number #
                           up: switch to window above current one
                         down: switch to window below current one
                         left: switch to window on the left
                        right: switch to window on the right
                       number: window number (see /window list)
                       splith: split current window horizontally (to undo: /window merge)
                       splitv: split current window vertically (to undo: /window merge)
                       resize: resize window size, new size is <pct> percentage of parent window; if "h" or "v" is specified, the resize affects the nearest parent window with a split of this type (horizontal/vertical)
                      balance: balance the sizes of all windows
                        merge: merge window with another (all = keep only one window)
                        close: close window
                      page_up: scroll one page up
                    page_down: scroll one page down
                      refresh: refresh screen
                       scroll: scroll a number of lines (+/-N) or with time: s=seconds, m=minutes, h=hours, d=days, M=months, y=years
                 scroll_horiz: scroll horizontally a number of columns (+/-N) or percentage of window size (this scrolling is possible only on buffers with free content)
                    scroll_up: scroll a few lines up
                  scroll_down: scroll a few lines down
                   scroll_top: scroll to top of buffer
                scroll_bottom: scroll to bottom of buffer
            scroll_beyond_end: scroll beyond the end of buffer
    scroll_previous_highlight: scroll to previous highlight
        scroll_next_highlight: scroll to next highlight
                scroll_unread: scroll to unread marker
                         swap: swap buffers of two windows (with optional direction for target window)
                         zoom: zoom on window
                         bare: toggle bare display (with optional delay in seconds for automatic return to standard display mode)

    For splith and splitv, pct is a percentage which represents size of new window, computed with current window as size reference. For example 25 means create a new window with size = current_size / 4

    Examples:
      /window b1
      /window scroll -2
      /window scroll -2d
      /window scroll -d
      /window zoom -window 2
      /window splith 30
      /window resize 75
      /window resize v+10
      /window bare 2

#### Opcje dla bezpiecznych danych

Sekcje w pliku sec.conf:

Sekcja | Komenda | Opis
--- | --- | ---
`crypt` | `/set sec.crypt.*` | Opcje szyfrowania.
`data` | `/secure` | Zabezpieczone dane.

Opcje:

- sec.crypt.cipher

  - description: cipher used to crypt data (the number after algorithm is the size of the key in bits)

  - type: enum

  - values: aes128, aes192, aes256

  - default value: `aes256`

- sec.crypt.hash_algo

  - description: hash algorithm used to check the decrypted data; some of them require a specific libgcrypt version: sha3-*: libgcrypt >= 1.7.0, blake2*: libgcrypt >= 1.8.0, sha512-*: libgcrypt >= 1.9.4

  - type: enum

  - values: sha224, sha256, sha384, sha512, sha512-224, sha512-256, sha3-224, sha3-256, sha3-384, sha3-512, blake2b-160, blake2b-256, blake2b-384, blake2b-512, blake2s-128, blake2s-160, blake2s-224, blake2s-256

  - default value: `sha256`

- sec.crypt.passphrase_command

  - description: read the passphrase from the output of this system command (only the first line is used and it must not contain any extra character); this option is used only when reading file sec.conf and if the environment variable "WEECHAT_PASSPHRASE" is not set (the environment variable has higher priority); example with password-store: "/usr/bin/pass show weechat/passphrase"

  - type: string

  - values: any string

  - default value: `""`

- sec.crypt.salt

  - description: use salt when generating key used in encryption (recommended for maximum security); when enabled, the content of crypted data in file sec.conf will be different on each write of the file; if you put the file sec.conf in a version control system, then you can turn off this option to have always same content in file

  - type: boolean

  - values: on, off

  - default value: `on`

#### Opcje WeeChat

Sekcje w pliku weechat.conf:

Sekcja | Komenda | Opis
--- | --- | ---
`debug` | `/debug set /set weechat.debug.*` | Poziom debugowania dla rdzenia i wtyczek (opcje mogą być dodawane/usuwane w sekcji).
`startup` | `/set weechat.startup.*` | Opcje dla startu aplikacji.
`look` | `/set weechat.look.*` | Wygląd.
`palette` | `/color alias /set weechat.palette.*` | Aliasy kolorów (opcje mogą być dodawane/usuwane w sekcji).
`color` | `/set weechat.color.*` | Kolory.
`completion` | `/set weechat.completion.*` | Opcje dopełnień.
`history` | `/set weechat.history.*` | Opcje historii (komend i buforów).
`proxy` | `/proxy /set weechat.proxy.*` | Opcje proxy.
`network` | `/set weechat.network.*` | Opcje sieci/TLS.
`plugin` | `/set weechat.plugin.*` | Opcje wtyczek.
`signal` | `/set weechat.signal.*` | Opcje sygnałów.
`bar` | `/bar /set weechat.bar.*` | Opcje pasków.
`layout` | `/layout` | Układy.
`buffer` | `/buffer setauto` | Właściwości automatycznie nanoszne na bufory podczas otwierania.
`notify` | `/buffer notify` | Poziomy powiadomień dla buforów (opcje mogą być dodawane/usuwane w sekcji).
`filter` | `/filter` | Filtry.
`key` | `/key` | Skróty klawiszowe dla domyślnego kontekstu.
`key_search` | `/key` | Skróty klawiszowe dla kontekstu wyszukiwania.
`key_cursor` | `/key` | Skróty klawiszowe dla kontekstu kursora.
`key_mouse` | `/key` | Skróty klawiszowe dla kontekstu myszy.

Opcje:

- weechat.color.bar_more

  - description: text color for "+" when scrolling bars

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `lightmagenta`

- weechat.color.chat

  - description: text color for chat

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `default`

- weechat.color.chat_bg

  - description: background color for chat

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `default`

- weechat.color.chat_buffer

  - description: text color for buffer names

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `white`

- weechat.color.chat_channel

  - description: text color for channel names

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `white`

- weechat.color.chat_day_change

  - description: text color for message displayed when the day has changed

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `cyan`

- weechat.color.chat_delimiters

  - description: text color for delimiters

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `22`

- weechat.color.chat_highlight

  - description: text color for highlighted prefix

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `yellow`

- weechat.color.chat_highlight_bg

  - description: background color for highlighted prefix

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `124`

- weechat.color.chat_host

  - description: text color for hostnames

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `cyan`

- weechat.color.chat_inactive_buffer

  - description: text color for chat when line is inactive (buffer is merged with other buffers and is not selected)

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `default`

- weechat.color.chat_inactive_window

  - description: text color for chat when window is inactive (not current selected window)

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `240`

- weechat.color.chat_nick

  - description: text color for nicks in chat window: used in some server messages and as fallback when a nick color is not found; most of times nick color comes from option weechat.color.chat_nick_colors

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `lightcyan`

- weechat.color.chat_nick_colors

  - description: text color for nicks (comma separated list of colors, background is allowed with format: "fg:bg", for example: "lightred:blue")

  - type: string

  - values: any string

  - default value: `"cyan,magenta,green,brown,lightblue,lightcyan,lightmagenta,lightgreen,31,35,38,40,49,63,70,80,92,99,112,126,130,138,142,148,160,162,167,169,174,176,178,184,186,210,212,215,248"`

- weechat.color.chat_nick_offline

  - description: text color for offline nick (not in nicklist anymore); this color is used only if option weechat.look.color_nick_offline is enabled

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `242`

- weechat.color.chat_nick_offline_highlight

  - description: text color for offline nick with highlight; this color is used only if option weechat.look.color_nick_offline is enabled

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `default`

- weechat.color.chat_nick_offline_highlight_bg

  - description: background color for offline nick with highlight; this color is used only if option weechat.look.color_nick_offline is enabled

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `17`

- weechat.color.chat_nick_other

  - description: text color for other nick in private buffer

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `cyan`

- weechat.color.chat_nick_prefix

  - description: color for nick prefix (string displayed before nick in prefix)

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `green`

- weechat.color.chat_nick_self

  - description: text color for local nick in chat window

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `white`

- weechat.color.chat_nick_suffix

  - description: color for nick suffix (string displayed after nick in prefix)

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `green`

- weechat.color.chat_prefix_action

  - description: text color for action prefix

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `white`

- weechat.color.chat_prefix_buffer

  - description: text color for buffer name (before prefix, when many buffers are merged with same number)

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `180`

- weechat.color.chat_prefix_buffer_inactive_buffer

  - description: text color for inactive buffer name (before prefix, when many buffers are merged with same number and if buffer is not selected)

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `default`

- weechat.color.chat_prefix_error

  - description: text color for error prefix

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `yellow`

- weechat.color.chat_prefix_join

  - description: text color for join prefix

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `lightgreen`

- weechat.color.chat_prefix_more

  - description: text color for "+" when prefix is too long

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `lightmagenta`

- weechat.color.chat_prefix_network

  - description: text color for network prefix

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `magenta`

- weechat.color.chat_prefix_quit

  - description: text color for quit prefix

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `lightred`

- weechat.color.chat_prefix_suffix

  - description: text color for suffix (after prefix)

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `24`

- weechat.color.chat_read_marker

  - description: text color for unread data marker

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `magenta`

- weechat.color.chat_read_marker_bg

  - description: background color for unread data marker

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `default`

- weechat.color.chat_server

  - description: text color for server names

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `brown`

- weechat.color.chat_status_disabled

  - description: text color for "disabled" status

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `red`

- weechat.color.chat_status_enabled

  - description: text color for "enabled" status

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `green`

- weechat.color.chat_tags

  - description: text color for tags after messages (displayed with command /debug tags)

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `red`

- weechat.color.chat_text_found

  - description: text color for marker on lines where text sought is found

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `yellow`

- weechat.color.chat_text_found_bg

  - description: background color for marker on lines where text sought is found

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `lightmagenta`

- weechat.color.chat_time

  - description: text color for time in chat window

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `default`

- weechat.color.chat_time_delimiters

  - description: text color for time delimiters

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `brown`

- weechat.color.chat_value

  - description: text color for values

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `cyan`

- weechat.color.chat_value_null

  - description: text color for null values (undefined)

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `blue`

- weechat.color.emphasized

  - description: text color for emphasized text (for example when searching text); this option is used only if option weechat.look.emphasized_attributes is an empty string (default value)

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `yellow`

- weechat.color.emphasized_bg

  - description: background color for emphasized text (for example when searching text); used only if option weechat.look.emphasized_attributes is an empty string (default value)

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `54`

- weechat.color.eval_syntax_colors

  - description: text color for syntax highlighting in evaluated strings, with "${raw_hl:...}" and "${hl:...}" (comma separated list of colors, background is allowed with format: "fg:bg", for example: "lightred:blue")

  - type: string

  - values: any string

  - default value: `"green,lightred,lightblue,lightmagenta,yellow,cyan"`

- weechat.color.input_actions

  - description: text color for actions in input line

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `lightgreen`

- weechat.color.input_text_not_found

  - description: text color for unsuccessful text search in input line

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `red`

- weechat.color.item_away

  - description: text color for away item

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `yellow`

- weechat.color.nicklist_away

  - description: text color for away nicknames

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `240`

- weechat.color.nicklist_group

  - description: text color for groups in nicklist

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `green`

- weechat.color.separator

  - description: color for window separators (when split) and separators beside bars (like nicklist)

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `236`

- weechat.color.status_count_highlight

  - description: text color for count of highlight messages in hotlist (status bar)

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `magenta`

- weechat.color.status_count_msg

  - description: text color for count of messages in hotlist (status bar)

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `brown`

- weechat.color.status_count_other

  - description: text color for count of other messages in hotlist (status bar)

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `default`

- weechat.color.status_count_private

  - description: text color for count of private messages in hotlist (status bar)

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `green`

- weechat.color.status_data_highlight

  - description: text color for buffer with highlight (status bar)

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `lightmagenta`

- weechat.color.status_data_msg

  - description: text color for buffer with new messages (status bar)

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `yellow`

- weechat.color.status_data_other

  - description: text color for buffer with new data (not messages) (status bar)

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `default`

- weechat.color.status_data_private

  - description: text color for buffer with private message (status bar)

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `lightgreen`

- weechat.color.status_filter

  - description: text color for filter indicator in status bar

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `green`

- weechat.color.status_modes

  - description: text color for buffer modes in status bar

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `default`

- weechat.color.status_more

  - description: text color for buffer with new data (status bar)

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `yellow`

- weechat.color.status_mouse

  - description: text color for mouse indicator in status bar

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `lightgreen`

- weechat.color.status_name

  - description: text color for current buffer name in status bar

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `white`

- weechat.color.status_name_insecure

  - description: text color for current buffer name in status bar, if data are exchanged and not secured with a protocol like TLS

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `lightmagenta`

- weechat.color.status_name_tls

  - description: text color for current buffer name in status bar, if data are exchanged and secured with a protocol like TLS

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `white`

- weechat.color.status_nicklist_count

  - description: text color for number of nicks in nicklist (status bar)

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `default`

- weechat.color.status_number

  - description: text color for current buffer number in status bar

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `yellow`

- weechat.color.status_time

  - description: text color for time (status bar)

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `default`

- weechat.completion.base_word_until_cursor

  - description: if enabled, the base word to complete ends at char before cursor; otherwise the base word ends at first space after cursor

  - type: boolean

  - values: on, off

  - default value: `on`

- weechat.completion.case_sensitive

  - description: if enabled, the completion is case-sensitive by default

  - type: boolean

  - values: on, off

  - default value: `on`

- weechat.completion.command_inline

  - description: if enabled, the commands inside command line are completed (the command at beginning of line has higher priority and is used first); note: when this option is enabled, there is no more automatic completion of paths beginning with "/" (outside commands arguments)

  - type: boolean

  - values: on, off

  - default value: `on`

- weechat.completion.cycle

  - description: if enabled, restart from beginning (first completion found) when the last completion is reached, otherwise stop at last completion

  - type: boolean

  - values: on, off

  - default value: `on`

- weechat.completion.default_template

  - description: default completion template (please see documentation for template codes and values: plugin API reference, function "weechat_hook_command")

  - type: string

  - values: any string

  - default value: `"%(nicks)|%(irc_channels)"`

- weechat.completion.nick_add_space

  - description: add space after nick completion (when nick is not first word on command line)

  - type: boolean

  - values: on, off

  - default value: `on`

- weechat.completion.nick_case_sensitive

  - description: case-sensitive completion for nicks

  - type: boolean

  - values: on, off

  - default value: `off`

- weechat.completion.nick_completer

  - description: string inserted after nick completion (when nick is first word on command line)

  - type: string

  - values: any string

  - default value: `": "`

- weechat.completion.nick_first_only

  - description: complete only with first nick found

  - type: boolean

  - values: on, off

  - default value: `off`

- weechat.completion.nick_ignore_chars

  - description: chars ignored for nick completion

  - type: string

  - values: any string

  - default value: `"[]`_-^"`

- weechat.completion.nick_ignore_words

  - description: comma-separated list of nicks to ignore (not completed); the whole nick must be set in this option even if chars are ignored in completion with option weechat.completion.nick_ignore_chars; look up for nicks is with exact case then lower case, so it's possible to use only lower case for nicks in this option

  - type: string

  - values: any string

  - default value: `""`

- weechat.completion.partial_completion_alert

  - description: send alert (BEL) when a partial completion occurs

  - type: boolean

  - values: on, off

  - default value: `on`

- weechat.completion.partial_completion_auto_expand

  - description: automatically expand word after partial completion when completing again

  - type: boolean

  - values: on, off

  - default value: `on`

- weechat.completion.partial_completion_command

  - description: partially complete command names (stop when many commands found begin with same letters)

  - type: boolean

  - values: on, off

  - default value: `off`

- weechat.completion.partial_completion_command_arg

  - description: partially complete command arguments (stop when many arguments found begin with same prefix)

  - type: boolean

  - values: on, off

  - default value: `off`

- weechat.completion.partial_completion_count

  - description: display count for each partial completion in bar item

  - type: boolean

  - values: on, off

  - default value: `on`

- weechat.completion.partial_completion_other

  - description: partially complete outside commands (stop when many words found begin with same letters)

  - type: boolean

  - values: on, off

  - default value: `off`

- weechat.completion.partial_completion_templates

  - description: comma-separated list of templates for which partial completion is enabled by default (with Tab key instead of shift-Tab); the list of templates is in documentation: plugin API reference, function "weechat_hook_command"

  - type: string

  - values: any string

  - default value: `"config_options"`

- weechat.history.display_default

  - description: maximum number of commands to display by default in history listing (0 = unlimited)

  - type: integer

  - values: 0 .. 2147483647

  - default value: `5`

- weechat.history.max_buffer_lines_minutes

  - description: maximum number of minutes in history per buffer (0 = unlimited); examples: 1440 = one day, 10080 = one week, 43200 = one month, 525600 = one year; use 0 ONLY if option weechat.history.max_buffer_lines_number is NOT set to 0

  - type: integer

  - values: 0 .. 2147483647

  - default value: `0`

- weechat.history.max_buffer_lines_number

  - description: maximum number of lines in history per buffer (0 = unlimited); use 0 ONLY if option weechat.history.max_buffer_lines_minutes is NOT set to 0

  - type: integer

  - values: 0 .. 2147483647

  - default value: `4096`

- weechat.history.max_commands

  - description: maximum number of user commands in history (0 = unlimited, NOT RECOMMENDED: no limit in memory usage)

  - type: integer

  - values: 0 .. 2147483647

  - default value: `100`

- weechat.history.max_visited_buffers

  - description: maximum number of visited buffers to keep in memory

  - type: integer

  - values: 0 .. 1000

  - default value: `50`

- weechat.key.backspace

  - description: "backspace" (default)

  - type: string

  - values: any string

  - default value: `"/input delete_previous_char"`

- weechat.key.ctrl-_

  - description: "ctrl-_" (default)

  - type: string

  - values: any string

  - default value: `"/input undo"`

- weechat.key.ctrl-a

  - description: "ctrl-a" (default)

  - type: string

  - values: any string

  - default value: `"/input move_beginning_of_line"`

- weechat.key.ctrl-b

  - description: "ctrl-b" (default)

  - type: string

  - values: any string

  - default value: `"/input move_previous_char"`

- weechat.key.ctrl-c,_

  - description: "ctrl-c,_" (default)

  - type: string

  - values: any string

  - default value: `"/input insert \x1F"`

- weechat.key.ctrl-c,b

  - description: "ctrl-c,b" (default)

  - type: string

  - values: any string

  - default value: `"/input insert \x02"`

- weechat.key.ctrl-c,c

  - description: "ctrl-c,c" (default)

  - type: string

  - values: any string

  - default value: `"/input insert \x03"`

- weechat.key.ctrl-c,d

  - description: "ctrl-c,d" (default)

  - type: string

  - values: any string

  - default value: `"/input insert \x04"`

- weechat.key.ctrl-c,i

  - description: "ctrl-c,i" (default)

  - type: string

  - values: any string

  - default value: `"/input insert \x1D"`

- weechat.key.ctrl-c,o

  - description: "ctrl-c,o" (default)

  - type: string

  - values: any string

  - default value: `"/input insert \x0F"`

- weechat.key.ctrl-c,s

  - description: "ctrl-c,s" (default)

  - type: string

  - values: any string

  - default value: `"/input insert \x1E"`

- weechat.key.ctrl-c,v

  - description: "ctrl-c,v" (default)

  - type: string

  - values: any string

  - default value: `"/input insert \x16"`

- weechat.key.ctrl-d

  - description: "ctrl-d" (default)

  - type: string

  - values: any string

  - default value: `"/input delete_next_char"`

- weechat.key.ctrl-down

  - description: "ctrl-down" (default)

  - type: string

  - values: any string

  - default value: `"/input history_global_next"`

- weechat.key.ctrl-e

  - description: "ctrl-e" (default)

  - type: string

  - values: any string

  - default value: `"/input move_end_of_line"`

- weechat.key.ctrl-f

  - description: "ctrl-f" (default)

  - type: string

  - values: any string

  - default value: `"/input move_next_char"`

- weechat.key.ctrl-f1

  - description: "ctrl-f1" (default)

  - type: string

  - values: any string

  - default value: `"/bar scroll buflist * -100%"`

- weechat.key.ctrl-f11

  - description: "ctrl-f11" (default)

  - type: string

  - values: any string

  - default value: `"/bar scroll nicklist * -100%"`

- weechat.key.ctrl-f12

  - description: "ctrl-f12" (default)

  - type: string

  - values: any string

  - default value: `"/bar scroll nicklist * +100%"`

- weechat.key.ctrl-f2

  - description: "ctrl-f2" (default)

  - type: string

  - values: any string

  - default value: `"/bar scroll buflist * +100%"`

- weechat.key.ctrl-k

  - description: "ctrl-k" (default)

  - type: string

  - values: any string

  - default value: `"/input delete_end_of_line"`

- weechat.key.ctrl-l

  - description: "ctrl-l" (default)

  - type: string

  - values: any string

  - default value: `"/window refresh"`

- weechat.key.ctrl-left

  - description: "ctrl-left" (default)

  - type: string

  - values: any string

  - default value: `"/input move_previous_word"`

- weechat.key.ctrl-n

  - description: "ctrl-n" (default)

  - type: string

  - values: any string

  - default value: `"/buffer +1"`

- weechat.key.ctrl-o

  - description: "ctrl-o" (default)

  - type: string

  - values: any string

  - default value: `"/input history_use_get_next"`

- weechat.key.ctrl-p

  - description: "ctrl-p" (default)

  - type: string

  - values: any string

  - default value: `"/buffer -1"`

- weechat.key.ctrl-r

  - description: "ctrl-r" (default)

  - type: string

  - values: any string

  - default value: `"/input search_history"`

- weechat.key.ctrl-right

  - description: "ctrl-right" (default)

  - type: string

  - values: any string

  - default value: `"/input move_next_word"`

- weechat.key.ctrl-s

  - description: "ctrl-s" (default)

  - type: string

  - values: any string

  - default value: `"/input search_text_here"`

- weechat.key.ctrl-t

  - description: "ctrl-t" (default)

  - type: string

  - values: any string

  - default value: `"/input transpose_chars"`

- weechat.key.ctrl-u

  - description: "ctrl-u" (default)

  - type: string

  - values: any string

  - default value: `"/input delete_beginning_of_line"`

- weechat.key.ctrl-up

  - description: "ctrl-up" (default)

  - type: string

  - values: any string

  - default value: `"/input history_global_previous"`

- weechat.key.ctrl-w

  - description: "ctrl-w" (default)

  - type: string

  - values: any string

  - default value: `"/input delete_previous_word_whitespace"`

- weechat.key.ctrl-x

  - description: "ctrl-x" (default)

  - type: string

  - values: any string

  - default value: `"/buffer switch"`

- weechat.key.ctrl-y

  - description: "ctrl-y" (default)

  - type: string

  - values: any string

  - default value: `"/input clipboard_paste"`

- weechat.key.ctrl-z

  - description: "ctrl-z" (default)

  - type: string

  - values: any string

  - default value: `"/sys suspend"`

- weechat.key.delete

  - description: "delete" (default)

  - type: string

  - values: any string

  - default value: `"/input delete_next_char"`

- weechat.key.down

  - description: "down" (default)

  - type: string

  - values: any string

  - default value: `"/input history_next"`

- weechat.key.end

  - description: "end" (default)

  - type: string

  - values: any string

  - default value: `"/input move_end_of_line"`

- weechat.key.f1

  - description: "f1" (default)

  - type: string

  - values: any string

  - default value: `"/bar scroll buflist * -100%"`

- weechat.key.f10

  - description: "f10" (default)

  - type: string

  - values: any string

  - default value: `"/bar scroll title * +30%"`

- weechat.key.f11

  - description: "f11" (default)

  - type: string

  - values: any string

  - default value: `"/bar scroll nicklist * -100%"`

- weechat.key.f12

  - description: "f12" (default)

  - type: string

  - values: any string

  - default value: `"/bar scroll nicklist * +100%"`

- weechat.key.f2

  - description: "f2" (default)

  - type: string

  - values: any string

  - default value: `"/bar scroll buflist * +100%"`

- weechat.key.f5

  - description: "f5" (default)

  - type: string

  - values: any string

  - default value: `"/buffer -1"`

- weechat.key.f6

  - description: "f6" (default)

  - type: string

  - values: any string

  - default value: `"/buffer +1"`

- weechat.key.f7

  - description: "f7" (default)

  - type: string

  - values: any string

  - default value: `"/window -1"`

- weechat.key.f8

  - description: "f8" (default)

  - type: string

  - values: any string

  - default value: `"/window +1"`

- weechat.key.f9

  - description: "f9" (default)

  - type: string

  - values: any string

  - default value: `"/bar scroll title * -30%"`

- weechat.key.home

  - description: "home" (default)

  - type: string

  - values: any string

  - default value: `"/input move_beginning_of_line"`

- weechat.key.left

  - description: "left" (default)

  - type: string

  - values: any string

  - default value: `"/input move_previous_char"`

- weechat.key.meta--

  - description: "meta--" (default)

  - type: string

  - values: any string

  - default value: `"/filter toggle @"`

- [[option_weechat.key.meta-/]] weechat.key.meta-/

  - description: "meta-/" (default)

  - type: string

  - values: any string

  - default value: `"/buffer jump last_displayed"`

- weechat.key.meta-0

  - description: "meta-0" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *10"`

- weechat.key.meta-1

  - description: "meta-1" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *1"`

- weechat.key.meta-2

  - description: "meta-2" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *2"`

- weechat.key.meta-3

  - description: "meta-3" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *3"`

- weechat.key.meta-4

  - description: "meta-4" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *4"`

- weechat.key.meta-5

  - description: "meta-5" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *5"`

- weechat.key.meta-6

  - description: "meta-6" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *6"`

- weechat.key.meta-7

  - description: "meta-7" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *7"`

- weechat.key.meta-8

  - description: "meta-8" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *8"`

- weechat.key.meta-9

  - description: "meta-9" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *9"`

- [[option_weechat.key.meta-<]] weechat.key.meta-<

  - description: "meta-<" (default)

  - type: string

  - values: any string

  - default value: `"/buffer jump prev_visited"`

- [[option_weechat.key.meta-=]] weechat.key.meta-=

  - description: "meta-=" (default)

  - type: string

  - values: any string

  - default value: `"/filter toggle"`

- [[option_weechat.key.meta→]] weechat.key.meta->

  - description: "meta->" (default)

  - type: string

  - values: any string

  - default value: `"/buffer jump next_visited"`

- weechat.key.meta-B

  - description: "meta-B" (default)

  - type: string

  - values: any string

  - default value: `"/buflist toggle"`

- weechat.key.meta-N

  - description: "meta-N" (default)

  - type: string

  - values: any string

  - default value: `"/bar toggle nicklist"`

- weechat.key.meta-R

  - description: "meta-R" (default)

  - type: string

  - values: any string

  - default value: `"/input delete_input"`

- weechat.key.meta-U

  - description: "meta-U" (default)

  - type: string

  - values: any string

  - default value: `"/allbuf /buffer set unread"`

- weechat.key.meta-_

  - description: "meta-_" (default)

  - type: string

  - values: any string

  - default value: `"/input redo"`

- weechat.key.meta-a

  - description: "meta-a" (default)

  - type: string

  - values: any string

  - default value: `"/buffer jump smart"`

- weechat.key.meta-b

  - description: "meta-b" (default)

  - type: string

  - values: any string

  - default value: `"/input move_previous_word"`

- weechat.key.meta-backspace

  - description: "meta-backspace" (default)

  - type: string

  - values: any string

  - default value: `"/input delete_previous_word"`

- weechat.key.meta-ctrl-k

  - description: "meta-ctrl-k" (default)

  - type: string

  - values: any string

  - default value: `"/input delete_end_of_input"`

- weechat.key.meta-ctrl-l

  - description: "meta-ctrl-l" (default)

  - type: string

  - values: any string

  - default value: `"/remote togglecmd"`

- weechat.key.meta-ctrl-u

  - description: "meta-ctrl-u" (default)

  - type: string

  - values: any string

  - default value: `"/input delete_beginning_of_input"`

- weechat.key.meta-d

  - description: "meta-d" (default)

  - type: string

  - values: any string

  - default value: `"/input delete_next_word"`

- weechat.key.meta-down

  - description: "meta-down" (default)

  - type: string

  - values: any string

  - default value: `"/buffer +1"`

- weechat.key.meta-end

  - description: "meta-end" (default)

  - type: string

  - values: any string

  - default value: `"/window scroll_bottom"`

- weechat.key.meta-f

  - description: "meta-f" (default)

  - type: string

  - values: any string

  - default value: `"/input move_next_word"`

- weechat.key.meta-f1

  - description: "meta-f1" (default)

  - type: string

  - values: any string

  - default value: `"/bar scroll buflist * b"`

- weechat.key.meta-f11

  - description: "meta-f11" (default)

  - type: string

  - values: any string

  - default value: `"/bar scroll nicklist * b"`

- weechat.key.meta-f12

  - description: "meta-f12" (default)

  - type: string

  - values: any string

  - default value: `"/bar scroll nicklist * e"`

- weechat.key.meta-f2

  - description: "meta-f2" (default)

  - type: string

  - values: any string

  - default value: `"/bar scroll buflist * e"`

- weechat.key.meta-h,meta-R

  - description: "meta-h,meta-R" (default)

  - type: string

  - values: any string

  - default value: `"/hotlist restore -all"`

- weechat.key.meta-h,meta-c

  - description: "meta-h,meta-c" (default)

  - type: string

  - values: any string

  - default value: `"/hotlist clear"`

- weechat.key.meta-h,meta-m

  - description: "meta-h,meta-m" (default)

  - type: string

  - values: any string

  - default value: `"/hotlist remove"`

- weechat.key.meta-h,meta-r

  - description: "meta-h,meta-r" (default)

  - type: string

  - values: any string

  - default value: `"/hotlist restore"`

- weechat.key.meta-home

  - description: "meta-home" (default)

  - type: string

  - values: any string

  - default value: `"/window scroll_top"`

- weechat.key.meta-j,0,1

  - description: "meta-j,0,1" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *1"`

- weechat.key.meta-j,0,2

  - description: "meta-j,0,2" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *2"`

- weechat.key.meta-j,0,3

  - description: "meta-j,0,3" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *3"`

- weechat.key.meta-j,0,4

  - description: "meta-j,0,4" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *4"`

- weechat.key.meta-j,0,5

  - description: "meta-j,0,5" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *5"`

- weechat.key.meta-j,0,6

  - description: "meta-j,0,6" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *6"`

- weechat.key.meta-j,0,7

  - description: "meta-j,0,7" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *7"`

- weechat.key.meta-j,0,8

  - description: "meta-j,0,8" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *8"`

- weechat.key.meta-j,0,9

  - description: "meta-j,0,9" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *9"`

- weechat.key.meta-j,1,0

  - description: "meta-j,1,0" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *10"`

- weechat.key.meta-j,1,1

  - description: "meta-j,1,1" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *11"`

- weechat.key.meta-j,1,2

  - description: "meta-j,1,2" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *12"`

- weechat.key.meta-j,1,3

  - description: "meta-j,1,3" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *13"`

- weechat.key.meta-j,1,4

  - description: "meta-j,1,4" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *14"`

- weechat.key.meta-j,1,5

  - description: "meta-j,1,5" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *15"`

- weechat.key.meta-j,1,6

  - description: "meta-j,1,6" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *16"`

- weechat.key.meta-j,1,7

  - description: "meta-j,1,7" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *17"`

- weechat.key.meta-j,1,8

  - description: "meta-j,1,8" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *18"`

- weechat.key.meta-j,1,9

  - description: "meta-j,1,9" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *19"`

- weechat.key.meta-j,2,0

  - description: "meta-j,2,0" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *20"`

- weechat.key.meta-j,2,1

  - description: "meta-j,2,1" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *21"`

- weechat.key.meta-j,2,2

  - description: "meta-j,2,2" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *22"`

- weechat.key.meta-j,2,3

  - description: "meta-j,2,3" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *23"`

- weechat.key.meta-j,2,4

  - description: "meta-j,2,4" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *24"`

- weechat.key.meta-j,2,5

  - description: "meta-j,2,5" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *25"`

- weechat.key.meta-j,2,6

  - description: "meta-j,2,6" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *26"`

- weechat.key.meta-j,2,7

  - description: "meta-j,2,7" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *27"`

- weechat.key.meta-j,2,8

  - description: "meta-j,2,8" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *28"`

- weechat.key.meta-j,2,9

  - description: "meta-j,2,9" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *29"`

- weechat.key.meta-j,3,0

  - description: "meta-j,3,0" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *30"`

- weechat.key.meta-j,3,1

  - description: "meta-j,3,1" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *31"`

- weechat.key.meta-j,3,2

  - description: "meta-j,3,2" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *32"`

- weechat.key.meta-j,3,3

  - description: "meta-j,3,3" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *33"`

- weechat.key.meta-j,3,4

  - description: "meta-j,3,4" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *34"`

- weechat.key.meta-j,3,5

  - description: "meta-j,3,5" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *35"`

- weechat.key.meta-j,3,6

  - description: "meta-j,3,6" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *36"`

- weechat.key.meta-j,3,7

  - description: "meta-j,3,7" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *37"`

- weechat.key.meta-j,3,8

  - description: "meta-j,3,8" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *38"`

- weechat.key.meta-j,3,9

  - description: "meta-j,3,9" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *39"`

- weechat.key.meta-j,4,0

  - description: "meta-j,4,0" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *40"`

- weechat.key.meta-j,4,1

  - description: "meta-j,4,1" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *41"`

- weechat.key.meta-j,4,2

  - description: "meta-j,4,2" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *42"`

- weechat.key.meta-j,4,3

  - description: "meta-j,4,3" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *43"`

- weechat.key.meta-j,4,4

  - description: "meta-j,4,4" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *44"`

- weechat.key.meta-j,4,5

  - description: "meta-j,4,5" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *45"`

- weechat.key.meta-j,4,6

  - description: "meta-j,4,6" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *46"`

- weechat.key.meta-j,4,7

  - description: "meta-j,4,7" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *47"`

- weechat.key.meta-j,4,8

  - description: "meta-j,4,8" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *48"`

- weechat.key.meta-j,4,9

  - description: "meta-j,4,9" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *49"`

- weechat.key.meta-j,5,0

  - description: "meta-j,5,0" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *50"`

- weechat.key.meta-j,5,1

  - description: "meta-j,5,1" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *51"`

- weechat.key.meta-j,5,2

  - description: "meta-j,5,2" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *52"`

- weechat.key.meta-j,5,3

  - description: "meta-j,5,3" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *53"`

- weechat.key.meta-j,5,4

  - description: "meta-j,5,4" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *54"`

- weechat.key.meta-j,5,5

  - description: "meta-j,5,5" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *55"`

- weechat.key.meta-j,5,6

  - description: "meta-j,5,6" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *56"`

- weechat.key.meta-j,5,7

  - description: "meta-j,5,7" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *57"`

- weechat.key.meta-j,5,8

  - description: "meta-j,5,8" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *58"`

- weechat.key.meta-j,5,9

  - description: "meta-j,5,9" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *59"`

- weechat.key.meta-j,6,0

  - description: "meta-j,6,0" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *60"`

- weechat.key.meta-j,6,1

  - description: "meta-j,6,1" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *61"`

- weechat.key.meta-j,6,2

  - description: "meta-j,6,2" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *62"`

- weechat.key.meta-j,6,3

  - description: "meta-j,6,3" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *63"`

- weechat.key.meta-j,6,4

  - description: "meta-j,6,4" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *64"`

- weechat.key.meta-j,6,5

  - description: "meta-j,6,5" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *65"`

- weechat.key.meta-j,6,6

  - description: "meta-j,6,6" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *66"`

- weechat.key.meta-j,6,7

  - description: "meta-j,6,7" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *67"`

- weechat.key.meta-j,6,8

  - description: "meta-j,6,8" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *68"`

- weechat.key.meta-j,6,9

  - description: "meta-j,6,9" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *69"`

- weechat.key.meta-j,7,0

  - description: "meta-j,7,0" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *70"`

- weechat.key.meta-j,7,1

  - description: "meta-j,7,1" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *71"`

- weechat.key.meta-j,7,2

  - description: "meta-j,7,2" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *72"`

- weechat.key.meta-j,7,3

  - description: "meta-j,7,3" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *73"`

- weechat.key.meta-j,7,4

  - description: "meta-j,7,4" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *74"`

- weechat.key.meta-j,7,5

  - description: "meta-j,7,5" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *75"`

- weechat.key.meta-j,7,6

  - description: "meta-j,7,6" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *76"`

- weechat.key.meta-j,7,7

  - description: "meta-j,7,7" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *77"`

- weechat.key.meta-j,7,8

  - description: "meta-j,7,8" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *78"`

- weechat.key.meta-j,7,9

  - description: "meta-j,7,9" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *79"`

- weechat.key.meta-j,8,0

  - description: "meta-j,8,0" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *80"`

- weechat.key.meta-j,8,1

  - description: "meta-j,8,1" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *81"`

- weechat.key.meta-j,8,2

  - description: "meta-j,8,2" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *82"`

- weechat.key.meta-j,8,3

  - description: "meta-j,8,3" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *83"`

- weechat.key.meta-j,8,4

  - description: "meta-j,8,4" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *84"`

- weechat.key.meta-j,8,5

  - description: "meta-j,8,5" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *85"`

- weechat.key.meta-j,8,6

  - description: "meta-j,8,6" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *86"`

- weechat.key.meta-j,8,7

  - description: "meta-j,8,7" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *87"`

- weechat.key.meta-j,8,8

  - description: "meta-j,8,8" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *88"`

- weechat.key.meta-j,8,9

  - description: "meta-j,8,9" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *89"`

- weechat.key.meta-j,9,0

  - description: "meta-j,9,0" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *90"`

- weechat.key.meta-j,9,1

  - description: "meta-j,9,1" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *91"`

- weechat.key.meta-j,9,2

  - description: "meta-j,9,2" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *92"`

- weechat.key.meta-j,9,3

  - description: "meta-j,9,3" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *93"`

- weechat.key.meta-j,9,4

  - description: "meta-j,9,4" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *94"`

- weechat.key.meta-j,9,5

  - description: "meta-j,9,5" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *95"`

- weechat.key.meta-j,9,6

  - description: "meta-j,9,6" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *96"`

- weechat.key.meta-j,9,7

  - description: "meta-j,9,7" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *97"`

- weechat.key.meta-j,9,8

  - description: "meta-j,9,8" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *98"`

- weechat.key.meta-j,9,9

  - description: "meta-j,9,9" (default)

  - type: string

  - values: any string

  - default value: `"/buffer *99"`

- weechat.key.meta-j,meta-f

  - description: "meta-j,meta-f" (default)

  - type: string

  - values: any string

  - default value: `"/buffer -"`

- weechat.key.meta-j,meta-l

  - description: "meta-j,meta-l" (default)

  - type: string

  - values: any string

  - default value: `"/buffer +"`

- weechat.key.meta-j,meta-r

  - description: "meta-j,meta-r" (default)

  - type: string

  - values: any string

  - default value: `"/server raw"`

- weechat.key.meta-j,meta-s

  - description: "meta-j,meta-s" (default)

  - type: string

  - values: any string

  - default value: `"/server jump"`

- weechat.key.meta-k

  - description: "meta-k" (default)

  - type: string

  - values: any string

  - default value: `"/input grab_key_command"`

- weechat.key.meta-l

  - description: "meta-l" (default)

  - type: string

  - values: any string

  - default value: `"/window bare"`

- weechat.key.meta-left

  - description: "meta-left" (default)

  - type: string

  - values: any string

  - default value: `"/buffer -1"`

- weechat.key.meta-m

  - description: "meta-m" (default)

  - type: string

  - values: any string

  - default value: `"/mute mouse toggle"`

- weechat.key.meta-n

  - description: "meta-n" (default)

  - type: string

  - values: any string

  - default value: `"/window scroll_next_highlight"`

- weechat.key.meta-p

  - description: "meta-p" (default)

  - type: string

  - values: any string

  - default value: `"/window scroll_previous_highlight"`

- weechat.key.meta-pgdn

  - description: "meta-pgdn" (default)

  - type: string

  - values: any string

  - default value: `"/window scroll_down"`

- weechat.key.meta-pgup

  - description: "meta-pgup" (default)

  - type: string

  - values: any string

  - default value: `"/window scroll_up"`

- weechat.key.meta-r

  - description: "meta-r" (default)

  - type: string

  - values: any string

  - default value: `"/input delete_line"`

- weechat.key.meta-return

  - description: "meta-return" (default)

  - type: string

  - values: any string

  - default value: `"/input insert \n"`

- weechat.key.meta-right

  - description: "meta-right" (default)

  - type: string

  - values: any string

  - default value: `"/buffer +1"`

- weechat.key.meta-s

  - description: "meta-s" (default)

  - type: string

  - values: any string

  - default value: `"/mute spell toggle"`

- weechat.key.meta-u

  - description: "meta-u" (default)

  - type: string

  - values: any string

  - default value: `"/window scroll_unread"`

- weechat.key.meta-up

  - description: "meta-up" (default)

  - type: string

  - values: any string

  - default value: `"/buffer -1"`

- weechat.key.meta-w,meta-b

  - description: "meta-w,meta-b" (default)

  - type: string

  - values: any string

  - default value: `"/window balance"`

- weechat.key.meta-w,meta-down

  - description: "meta-w,meta-down" (default)

  - type: string

  - values: any string

  - default value: `"/window down"`

- weechat.key.meta-w,meta-left

  - description: "meta-w,meta-left" (default)

  - type: string

  - values: any string

  - default value: `"/window left"`

- weechat.key.meta-w,meta-right

  - description: "meta-w,meta-right" (default)

  - type: string

  - values: any string

  - default value: `"/window right"`

- weechat.key.meta-w,meta-s

  - description: "meta-w,meta-s" (default)

  - type: string

  - values: any string

  - default value: `"/window swap"`

- weechat.key.meta-w,meta-up

  - description: "meta-w,meta-up" (default)

  - type: string

  - values: any string

  - default value: `"/window up"`

- weechat.key.meta-x

  - description: "meta-x" (default)

  - type: string

  - values: any string

  - default value: `"/buffer zoom"`

- weechat.key.meta-z

  - description: "meta-z" (default)

  - type: string

  - values: any string

  - default value: `"/window zoom"`

- weechat.key.pgdn

  - description: "pgdn" (default)

  - type: string

  - values: any string

  - default value: `"/window page_down"`

- weechat.key.pgup

  - description: "pgup" (default)

  - type: string

  - values: any string

  - default value: `"/window page_up"`

- weechat.key.return

  - description: "return" (default)

  - type: string

  - values: any string

  - default value: `"/input return"`

- weechat.key.right

  - description: "right" (default)

  - type: string

  - values: any string

  - default value: `"/input move_next_char"`

- weechat.key.shift-down

  - description: "shift-down" (default)

  - type: string

  - values: any string

  - default value: `"/input move_next_line"`

- weechat.key.shift-end

  - description: "shift-end" (default)

  - type: string

  - values: any string

  - default value: `"/input move_end_of_input"`

- weechat.key.shift-home

  - description: "shift-home" (default)

  - type: string

  - values: any string

  - default value: `"/input move_beginning_of_input"`

- weechat.key.shift-left

  - description: "shift-left" (default)

  - type: string

  - values: any string

  - default value: `"/input move_previous_char"`

- weechat.key.shift-right

  - description: "shift-right" (default)

  - type: string

  - values: any string

  - default value: `"/input move_next_char"`

- weechat.key.shift-tab

  - description: "shift-tab" (default)

  - type: string

  - values: any string

  - default value: `"/input complete_previous"`

- weechat.key.shift-up

  - description: "shift-up" (default)

  - type: string

  - values: any string

  - default value: `"/input move_previous_line"`

- weechat.key.tab

  - description: "tab" (default)

  - type: string

  - values: any string

  - default value: `"/input complete_next"`

- weechat.key.up

  - description: "up" (default)

  - type: string

  - values: any string

  - default value: `"/input history_previous"`

- weechat.key_cursor.@chat:Q

  - description: "@chat:Q" (cursor)

  - type: string

  - values: any string

  - default value: `"hsignal:chat_quote_time_prefix_message;/cursor stop"`

- weechat.key_cursor.@chat:l

  - description: "@chat:l" (cursor)

  - type: string

  - values: any string

  - default value: `"hsignal:chat_quote_focused_line;/cursor stop"`

- weechat.key_cursor.@chat:m

  - description: "@chat:m" (cursor)

  - type: string

  - values: any string

  - default value: `"hsignal:chat_quote_message;/cursor stop"`

- weechat.key_cursor.@chat:q

  - description: "@chat:q" (cursor)

  - type: string

  - values: any string

  - default value: `"hsignal:chat_quote_prefix_message;/cursor stop"`

- weechat.key_cursor.@item(buffer_nicklist):K

  - description: "@item(buffer_nicklist):K" (cursor)

  - type: string

  - values: any string

  - default value: `"/window ${_window_number};/kickban ${nick}"`

- weechat.key_cursor.@item(buffer_nicklist):b

  - description: "@item(buffer_nicklist):b" (cursor)

  - type: string

  - values: any string

  - default value: `"/window ${_window_number};/ban ${nick}"`

- weechat.key_cursor.@item(buffer_nicklist):k

  - description: "@item(buffer_nicklist):k" (cursor)

  - type: string

  - values: any string

  - default value: `"/window ${_window_number};/kick ${nick}"`

- weechat.key_cursor.@item(buffer_nicklist):q

  - description: "@item(buffer_nicklist):q" (cursor)

  - type: string

  - values: any string

  - default value: `"/window ${_window_number};/query ${nick};/cursor stop"`

- weechat.key_cursor.@item(buffer_nicklist):w

  - description: "@item(buffer_nicklist):w" (cursor)

  - type: string

  - values: any string

  - default value: `"/window ${_window_number};/whois ${nick}"`

- weechat.key_cursor.down

  - description: "down" (cursor)

  - type: string

  - values: any string

  - default value: `"/cursor move down"`

- weechat.key_cursor.left

  - description: "left" (cursor)

  - type: string

  - values: any string

  - default value: `"/cursor move left"`

- weechat.key_cursor.meta-down

  - description: "meta-down" (cursor)

  - type: string

  - values: any string

  - default value: `"/cursor move edge_bottom"`

- weechat.key_cursor.meta-end

  - description: "meta-end" (cursor)

  - type: string

  - values: any string

  - default value: `"/cursor move bottom_right"`

- weechat.key_cursor.meta-home

  - description: "meta-home" (cursor)

  - type: string

  - values: any string

  - default value: `"/cursor move top_left"`

- weechat.key_cursor.meta-left

  - description: "meta-left" (cursor)

  - type: string

  - values: any string

  - default value: `"/cursor move edge_left"`

- weechat.key_cursor.meta-right

  - description: "meta-right" (cursor)

  - type: string

  - values: any string

  - default value: `"/cursor move edge_right"`

- weechat.key_cursor.meta-shift-down

  - description: "meta-shift-down" (cursor)

  - type: string

  - values: any string

  - default value: `"/cursor move area_down"`

- weechat.key_cursor.meta-shift-left

  - description: "meta-shift-left" (cursor)

  - type: string

  - values: any string

  - default value: `"/cursor move area_left"`

- weechat.key_cursor.meta-shift-right

  - description: "meta-shift-right" (cursor)

  - type: string

  - values: any string

  - default value: `"/cursor move area_right"`

- weechat.key_cursor.meta-shift-up

  - description: "meta-shift-up" (cursor)

  - type: string

  - values: any string

  - default value: `"/cursor move area_up"`

- weechat.key_cursor.meta-up

  - description: "meta-up" (cursor)

  - type: string

  - values: any string

  - default value: `"/cursor move edge_top"`

- weechat.key_cursor.return

  - description: "return" (cursor)

  - type: string

  - values: any string

  - default value: `"/cursor stop"`

- weechat.key_cursor.right

  - description: "right" (cursor)

  - type: string

  - values: any string

  - default value: `"/cursor move right"`

- weechat.key_cursor.up

  - description: "up" (cursor)

  - type: string

  - values: any string

  - default value: `"/cursor move up"`

- weechat.key_histsearch.ctrl-o

  - description: "ctrl-o" (histsearch)

  - type: string

  - values: any string

  - default value: `"/input history_use_get_next"`

- weechat.key_histsearch.ctrl-q

  - description: "ctrl-q" (histsearch)

  - type: string

  - values: any string

  - default value: `"/input search_stop"`

- weechat.key_histsearch.ctrl-r

  - description: "ctrl-r" (histsearch)

  - type: string

  - values: any string

  - default value: `"/input search_previous"`

- weechat.key_histsearch.ctrl-s

  - description: "ctrl-s" (histsearch)

  - type: string

  - values: any string

  - default value: `"/input search_next"`

- weechat.key_histsearch.ctrl-x

  - description: "ctrl-x" (histsearch)

  - type: string

  - values: any string

  - default value: `"/input search_switch_regex"`

- weechat.key_histsearch.down

  - description: "down" (histsearch)

  - type: string

  - values: any string

  - default value: `"/input search_next"`

- weechat.key_histsearch.meta-c

  - description: "meta-c" (histsearch)

  - type: string

  - values: any string

  - default value: `"/input search_switch_case"`

- weechat.key_histsearch.return

  - description: "return" (histsearch)

  - type: string

  - values: any string

  - default value: `"/input search_stop_here"`

- weechat.key_histsearch.tab

  - description: "tab" (histsearch)

  - type: string

  - values: any string

  - default value: `"/input search_switch_where"`

- weechat.key_histsearch.up

  - description: "up" (histsearch)

  - type: string

  - values: any string

  - default value: `"/input search_previous"`

- weechat.key_mouse.@*:button3

  - description: "@*:button3" (mouse)

  - type: string

  - values: any string

  - default value: `"/cursor go ${_x},${_y}"`

- weechat.key_mouse.@bar(buflist):ctrl-wheeldown

  - description: "@bar(buflist):ctrl-wheeldown" (mouse)

  - type: string

  - values: any string

  - default value: `"hsignal:buflist_mouse"`

- weechat.key_mouse.@bar(buflist):ctrl-wheelup

  - description: "@bar(buflist):ctrl-wheelup" (mouse)

  - type: string

  - values: any string

  - default value: `"hsignal:buflist_mouse"`

- weechat.key_mouse.@bar(input):button2

  - description: "@bar(input):button2" (mouse)

  - type: string

  - values: any string

  - default value: `"/input grab_mouse_area"`

- weechat.key_mouse.@bar(nicklist):button1-gesture-down

  - description: "@bar(nicklist):button1-gesture-down" (mouse)

  - type: string

  - values: any string

  - default value: `"/bar scroll nicklist ${_window_number} +100%"`

- weechat.key_mouse.@bar(nicklist):button1-gesture-down-long

  - description: "@bar(nicklist):button1-gesture-down-long" (mouse)

  - type: string

  - values: any string

  - default value: `"/bar scroll nicklist ${_window_number} e"`

- weechat.key_mouse.@bar(nicklist):button1-gesture-up

  - description: "@bar(nicklist):button1-gesture-up" (mouse)

  - type: string

  - values: any string

  - default value: `"/bar scroll nicklist ${_window_number} -100%"`

- weechat.key_mouse.@bar(nicklist):button1-gesture-up-long

  - description: "@bar(nicklist):button1-gesture-up-long" (mouse)

  - type: string

  - values: any string

  - default value: `"/bar scroll nicklist ${_window_number} b"`

- weechat.key_mouse.@bar:wheeldown

  - description: "@bar:wheeldown" (mouse)

  - type: string

  - values: any string

  - default value: `"/bar scroll ${_bar_name} ${_window_number} +20%"`

- weechat.key_mouse.@bar:wheelup

  - description: "@bar:wheelup" (mouse)

  - type: string

  - values: any string

  - default value: `"/bar scroll ${_bar_name} ${_window_number} -20%"`

- weechat.key_mouse.@chat(fset.fset):button1

  - description: "@chat(fset.fset):button1" (mouse)

  - type: string

  - values: any string

  - default value: `"/window ${_window_number};/fset -go ${fset_option_index}"`

- weechat.key_mouse.@chat(fset.fset):button2*

  - description: "@chat(fset.fset):button2*" (mouse)

  - type: string

  - values: any string

  - default value: `"hsignal:fset_mouse"`

- weechat.key_mouse.@chat(fset.fset):wheeldown

  - description: "@chat(fset.fset):wheeldown" (mouse)

  - type: string

  - values: any string

  - default value: `"/fset -down 5"`

- weechat.key_mouse.@chat(fset.fset):wheelup

  - description: "@chat(fset.fset):wheelup" (mouse)

  - type: string

  - values: any string

  - default value: `"/fset -up 5"`

- weechat.key_mouse.@chat(irc.list_*):button1

  - description: "@chat(irc.list_*):button1" (mouse)

  - type: string

  - values: any string

  - default value: `"/window ${_window_number};/list -go ${_chat_line_y}"`

- weechat.key_mouse.@chat(irc.list_*):button2*

  - description: "@chat(irc.list_*):button2*" (mouse)

  - type: string

  - values: any string

  - default value: `"hsignal:irc_list_mouse"`

- weechat.key_mouse.@chat(irc.list_*):wheeldown

  - description: "@chat(irc.list_*):wheeldown" (mouse)

  - type: string

  - values: any string

  - default value: `"/list -down 5"`

- weechat.key_mouse.@chat(irc.list_*):wheelup

  - description: "@chat(irc.list_*):wheelup" (mouse)

  - type: string

  - values: any string

  - default value: `"/list -up 5"`

- weechat.key_mouse.@chat(script.scripts):button1

  - description: "@chat(script.scripts):button1" (mouse)

  - type: string

  - values: any string

  - default value: `"/window ${_window_number};/script -go ${_chat_line_y}"`

- weechat.key_mouse.@chat(script.scripts):button2

  - description: "@chat(script.scripts):button2" (mouse)

  - type: string

  - values: any string

  - default value: `"/window ${_window_number};/script -go ${_chat_line_y};/script installremove -q ${script_name_with_extension}"`

- weechat.key_mouse.@chat(script.scripts):wheeldown

  - description: "@chat(script.scripts):wheeldown" (mouse)

  - type: string

  - values: any string

  - default value: `"/script -down 5"`

- weechat.key_mouse.@chat(script.scripts):wheelup

  - description: "@chat(script.scripts):wheelup" (mouse)

  - type: string

  - values: any string

  - default value: `"/script -up 5"`

- weechat.key_mouse.@chat:button1

  - description: "@chat:button1" (mouse)

  - type: string

  - values: any string

  - default value: `"/window ${_window_number}"`

- weechat.key_mouse.@chat:button1-gesture-left

  - description: "@chat:button1-gesture-left" (mouse)

  - type: string

  - values: any string

  - default value: `"/window ${_window_number};/buffer -1"`

- weechat.key_mouse.@chat:button1-gesture-left-long

  - description: "@chat:button1-gesture-left-long" (mouse)

  - type: string

  - values: any string

  - default value: `"/window ${_window_number};/buffer 1"`

- weechat.key_mouse.@chat:button1-gesture-right

  - description: "@chat:button1-gesture-right" (mouse)

  - type: string

  - values: any string

  - default value: `"/window ${_window_number};/buffer +1"`

- weechat.key_mouse.@chat:button1-gesture-right-long

  - description: "@chat:button1-gesture-right-long" (mouse)

  - type: string

  - values: any string

  - default value: `"/window ${_window_number};/buffer +"`

- weechat.key_mouse.@chat:ctrl-wheeldown

  - description: "@chat:ctrl-wheeldown" (mouse)

  - type: string

  - values: any string

  - default value: `"/window scroll_horiz -window ${_window_number} +10%"`

- weechat.key_mouse.@chat:ctrl-wheelup

  - description: "@chat:ctrl-wheelup" (mouse)

  - type: string

  - values: any string

  - default value: `"/window scroll_horiz -window ${_window_number} -10%"`

- weechat.key_mouse.@chat:wheeldown

  - description: "@chat:wheeldown" (mouse)

  - type: string

  - values: any string

  - default value: `"/window scroll_down -window ${_window_number}"`

- weechat.key_mouse.@chat:wheelup

  - description: "@chat:wheelup" (mouse)

  - type: string

  - values: any string

  - default value: `"/window scroll_up -window ${_window_number}"`

- weechat.key_mouse.@item(buffer_nicklist):button1

  - description: "@item(buffer_nicklist):button1" (mouse)

  - type: string

  - values: any string

  - default value: `"/window ${_window_number};/query ${nick}"`

- weechat.key_mouse.@item(buffer_nicklist):button1-gesture-left

  - description: "@item(buffer_nicklist):button1-gesture-left" (mouse)

  - type: string

  - values: any string

  - default value: `"/window ${_window_number};/kick ${nick}"`

- weechat.key_mouse.@item(buffer_nicklist):button1-gesture-left-long

  - description: "@item(buffer_nicklist):button1-gesture-left-long" (mouse)

  - type: string

  - values: any string

  - default value: `"/window ${_window_number};/kickban ${nick}"`

- weechat.key_mouse.@item(buffer_nicklist):button2

  - description: "@item(buffer_nicklist):button2" (mouse)

  - type: string

  - values: any string

  - default value: `"/window ${_window_number};/whois ${nick}"`

- weechat.key_mouse.@item(buffer_nicklist):button2-gesture-left

  - description: "@item(buffer_nicklist):button2-gesture-left" (mouse)

  - type: string

  - values: any string

  - default value: `"/window ${_window_number};/ban ${nick}"`

- weechat.key_mouse.@item(buflist):button1*

  - description: "@item(buflist):button1*" (mouse)

  - type: string

  - values: any string

  - default value: `"hsignal:buflist_mouse"`

- weechat.key_mouse.@item(buflist):button2*

  - description: "@item(buflist):button2*" (mouse)

  - type: string

  - values: any string

  - default value: `"hsignal:buflist_mouse"`

- weechat.key_mouse.@item(buflist2):button1*

  - description: "@item(buflist2):button1*" (mouse)

  - type: string

  - values: any string

  - default value: `"hsignal:buflist_mouse"`

- weechat.key_mouse.@item(buflist2):button2*

  - description: "@item(buflist2):button2*" (mouse)

  - type: string

  - values: any string

  - default value: `"hsignal:buflist_mouse"`

- weechat.key_mouse.@item(buflist3):button1*

  - description: "@item(buflist3):button1*" (mouse)

  - type: string

  - values: any string

  - default value: `"hsignal:buflist_mouse"`

- weechat.key_mouse.@item(buflist3):button2*

  - description: "@item(buflist3):button2*" (mouse)

  - type: string

  - values: any string

  - default value: `"hsignal:buflist_mouse"`

- weechat.key_mouse.@item(buflist4):button1*

  - description: "@item(buflist4):button1*" (mouse)

  - type: string

  - values: any string

  - default value: `"hsignal:buflist_mouse"`

- weechat.key_mouse.@item(buflist4):button2*

  - description: "@item(buflist4):button2*" (mouse)

  - type: string

  - values: any string

  - default value: `"hsignal:buflist_mouse"`

- weechat.key_mouse.@item(buflist5):button1*

  - description: "@item(buflist5):button1*" (mouse)

  - type: string

  - values: any string

  - default value: `"hsignal:buflist_mouse"`

- weechat.key_mouse.@item(buflist5):button2*

  - description: "@item(buflist5):button2*" (mouse)

  - type: string

  - values: any string

  - default value: `"hsignal:buflist_mouse"`

- weechat.key_search.ctrl-q

  - description: "ctrl-q" (search)

  - type: string

  - values: any string

  - default value: `"/input search_stop"`

- weechat.key_search.ctrl-r

  - description: "ctrl-r" (search)

  - type: string

  - values: any string

  - default value: `"/input search_previous"`

- weechat.key_search.ctrl-s

  - description: "ctrl-s" (search)

  - type: string

  - values: any string

  - default value: `"/input search_next"`

- weechat.key_search.ctrl-x

  - description: "ctrl-x" (search)

  - type: string

  - values: any string

  - default value: `"/input search_switch_regex"`

- weechat.key_search.down

  - description: "down" (search)

  - type: string

  - values: any string

  - default value: `"/input search_next"`

- weechat.key_search.meta-c

  - description: "meta-c" (search)

  - type: string

  - values: any string

  - default value: `"/input search_switch_case"`

- weechat.key_search.return

  - description: "return" (search)

  - type: string

  - values: any string

  - default value: `"/input search_stop_here"`

- weechat.key_search.tab

  - description: "tab" (search)

  - type: string

  - values: any string

  - default value: `"/input search_switch_where"`

- weechat.key_search.up

  - description: "up" (search)

  - type: string

  - values: any string

  - default value: `"/input search_previous"`

- weechat.look.align_end_of_lines

  - description: alignment for end of lines (all lines after the first): they are starting under this data (time, buffer, prefix, suffix, message (default))

  - type: enum

  - values: time, buffer, prefix, suffix, message

  - default value: `message`

- weechat.look.align_multiline_words

  - description: alignment for multiline words according to option weechat.look.align_end_of_lines; if disabled, the multiline words will not be aligned, which can be useful to not break long URLs

  - type: boolean

  - values: on, off

  - default value: `on`

- weechat.look.bar_more_down

  - description: string displayed when bar can be scrolled down (for bars with filling different from "horizontal")

  - type: string

  - values: any string

  - default value: `"+"+`

- weechat.look.bar_more_left

  - description: string displayed when bar can be scrolled to the left (for bars with filling "horizontal")

  - type: string

  - values: any string

  - default value: `"<<"`

- weechat.look.bar_more_right

  - description: string displayed when bar can be scrolled to the right (for bars with filling "horizontal")

  - type: string

  - values: any string

  - default value: `">>"`

- weechat.look.bar_more_up

  - description: string displayed when bar can be scrolled up (for bars with filling different from "horizontal")

  - type: string

  - values: any string

  - default value: `"--"`

- weechat.look.bare_display_exit_on_input

  - description: exit the bare display mode on any changes in input

  - type: boolean

  - values: on, off

  - default value: `on`

- weechat.look.bare_display_time_format

  - description: time format in bare display mode (see API man strftime for date/time specifiers, extra specifiers are supported, see function util_strftimeval in Plugin API reference)

  - type: string

  - values: any string

  - default value: `"%H:%M"`

- weechat.look.buffer_auto_renumber

  - description: automatically renumber buffers to have only consecutive numbers and start with number 1; if disabled, gaps between buffer numbers are allowed and the first buffer can have a number greater than 1

  - type: boolean

  - values: on, off

  - default value: `on`

- weechat.look.buffer_notify_default

  - description: default notify level for buffers (used to tell WeeChat if buffer must be displayed in hotlist or not, according to importance of message): all=all messages (default), message=messages+highlights, highlight=highlights only, none=never display in hotlist

  - type: enum

  - values: none, highlight, message, all

  - default value: `all`

- weechat.look.buffer_position

  - description: position of a new buffer: end = after the end of list (number = last number + 1) (default), first_gap = at first available number in the list (after the end of list if no number is available); this option is used only if the buffer has no layout number

  - type: enum

  - values: end, first_gap

  - default value: `end`

- weechat.look.buffer_search_case_sensitive

  - description: default text search in buffer: case-sensitive or not

  - type: boolean

  - values: on, off

  - default value: `off`

- weechat.look.buffer_search_force_default

  - description: force default values for text search in buffer (instead of using values from last search in buffer)

  - type: boolean

  - values: on, off

  - default value: `off`

- weechat.look.buffer_search_history

  - description: default text search command line history: local (buffer) or global history

  - type: enum

  - values: local, global

  - default value: `local`

- weechat.look.buffer_search_regex

  - description: default text search in buffer: if enabled, search POSIX extended regular expression, otherwise search simple string

  - type: boolean

  - values: on, off

  - default value: `off`

- weechat.look.buffer_search_where

  - description: default text search in buffer: in message, prefix, prefix and message

  - type: enum

  - values: prefix, message, prefix_message

  - default value: `prefix_message`

- weechat.look.buffer_time_format

  - description: time format for each line displayed in buffers (see man strftime for date/time specifiers, extra specifiers are supported, see function util_strftimeval in Plugin API reference) (note: content is evaluated, so you can use colors with format "${color:xxx}", see /help eval); variable "${highlight}" can be used in a condition to have a format specific to lines with highlight (see also option weechat.look.highlight_prefix); for example time using grayscale: "${color:252}%H${color:243}%M${color:237}%S", the same with milliseconds: "${color:252}%H${color:243}%M${color:237}%S.%.3", red background in case of highlight: "${if:${highlight}?${color:,red}}%H:%M:%S", red background in case of highlight with grayscale: ${if:${highlight}?${color:yellow,124}%H${color:187}%M${color:181}%S.%.3:${color:252}%H${color:243}%M${color:237}%S.%.3}

  - type: string

  - values: any string

  - default value: `"%H:%M:%S"`

- weechat.look.buffer_time_same

  - description: time displayed for a message with same time as previous message: use a space " " to hide time, another string to display this string instead of time, or an empty string to disable feature (display time) (note: content is evaluated, so you can use colors with format "${color:xxx}", see /help eval)

  - type: string

  - values: any string

  - default value: `""`

- weechat.look.chat_space_right

  - description: keep a space on the right side of chat area if there is a bar displayed on the right (for both text and read marker)

  - type: boolean

  - values: on, off

  - default value: `off`

- weechat.look.color_basic_force_bold

  - description: force "bold" attribute for light colors and "darkgray" in basic colors (this option is disabled by default: bold is used only if terminal has less than 16 colors)

  - type: boolean

  - values: on, off

  - default value: `off`

- weechat.look.color_inactive_buffer

  - description: use a different color for lines in inactive buffer (when line is from a merged buffer not selected)

  - type: boolean

  - values: on, off

  - default value: `on`

- weechat.look.color_inactive_message

  - description: use a different color for inactive message (when window is not current window, or if line is from a merged buffer not selected)

  - type: boolean

  - values: on, off

  - default value: `on`

- weechat.look.color_inactive_prefix

  - description: use a different color for inactive prefix (when window is not current window, or if line is from a merged buffer not selected)

  - type: boolean

  - values: on, off

  - default value: `on`

- weechat.look.color_inactive_prefix_buffer

  - description: use a different color for inactive buffer name in prefix (when window is not current window, or if line is from a merged buffer not selected)

  - type: boolean

  - values: on, off

  - default value: `on`

- weechat.look.color_inactive_time

  - description: use a different color for inactive time (when window is not current window, or if line is from a merged buffer not selected)

  - type: boolean

  - values: on, off

  - default value: `on`

- weechat.look.color_inactive_window

  - description: use a different color for lines in inactive window (when window is not current window)

  - type: boolean

  - values: on, off

  - default value: `on`

- weechat.look.color_nick_offline

  - description: use a different color for offline nicks (not in nicklist anymore)

  - type: boolean

  - values: on, off

  - default value: `off`

- weechat.look.color_pairs_auto_reset

  - description: automatically reset table of color pairs when number of available pairs is lower or equal to this number (-1 = disable automatic reset, and then a manual "/color reset" is needed when table is full)

  - type: integer

  - values: -1 .. 256

  - default value: `5`

- weechat.look.color_real_white

  - description: if set, uses real white color, disabled by default for terms with white background (if you never use white background, you should turn on this option to see real white instead of default term foreground color)

  - type: boolean

  - values: on, off

  - default value: `off`

- weechat.look.command_chars

  - description: chars used to determine if input string is a command or not: input must start with one of these chars; the slash ("/") is always considered as command prefix (example: ".$")

  - type: string

  - values: any string

  - default value: `""`

- weechat.look.command_incomplete

  - description: if set, incomplete and unambiguous commands are allowed, for example /he for /help

  - type: boolean

  - values: on, off

  - default value: `off`

- weechat.look.config_permissions

  - description: permissions for configuration files (*.conf), as octal value (see man chmod); it must be a number with 3 digits, each digit can be 0 (no permissions), 2 (write only), 4 (read only) or 6 (read and write); the first digit must be 6 so that the user can read and write the file; by default configuration files can be read and written by the user only, for security reasons; for example 660 = "rw-rw-r--" = file readable and writable by the user and members of the group

  - type: string

  - values: any string

  - default value: `"600"`

- weechat.look.confirm_quit

  - description: if set, /quit command must be confirmed with extra argument "-yes" (see /help quit)

  - type: boolean

  - values: on, off

  - default value: `off`

- weechat.look.confirm_upgrade

  - description: if set, /upgrade command must be confirmed with extra argument "-yes" (see /help upgrade)

  - type: boolean

  - values: on, off

  - default value: `off`

- weechat.look.day_change

  - description: display special message when day changes

  - type: boolean

  - values: on, off

  - default value: `on`

- weechat.look.day_change_message_1date

  - description: message displayed when the day has changed, with one date displayed (for example at beginning of buffer) (see man strftime for date/time specifiers) (note: content is evaluated, so you can use colors with format "${color:xxx}", see /help eval)

  - type: string

  - values: any string

  - default value: `"-- %a, %d %b %Y --"`

- weechat.look.day_change_message_2dates

  - description: message displayed when the day has changed, with two dates displayed (between two messages); the second date specifiers must start with two "%" because strftime is called two times on this string (see man strftime for date/time specifiers) (note: content is evaluated, so you can use colors with format "${color:xxx}", see /help eval)

  - type: string

  - values: any string

  - default value: `"-- %%a, %%d %%b %%Y (%a, %d %b %Y) --"`

- weechat.look.eat_newline_glitch

  - description: if set, the eat_newline_glitch will be set to 0; this is used to not add new line char at end of each line, and then not break text when you copy/paste text from WeeChat to another application (this option is disabled by default because it can cause serious display bugs)

  - type: boolean

  - values: on, off

  - default value: `off`

- weechat.look.emphasized_attributes

  - description: attributes for emphasized text: one or more attribute chars ("%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline); if the string is empty, the colors weechat.color.emphasized* are used

  - type: string

  - values: any string

  - default value: `""`

- weechat.look.highlight

  - description: comma separated list of words to highlight; case-insensitive comparison (use "(?-i)" at beginning of words to make them case-sensitive), words may begin or end with "*" for partial match; example: "test,(?-i)*toto*,flash*"

  - type: string

  - values: any string

  - default value: `""`

- weechat.look.highlight_disable_regex

  - description: POSIX extended regular expression used to prevent any highlight from a message: this option has higher priority over other highlight options (if the string is found in the message, the highlight is disabled and the other options are ignored), regular expression is case-insensitive (use "(?-i)" at beginning to make it case-sensitive), examples: "<flash.*>", "(?-i)<Flash.*>"

  - type: string

  - values: any string

  - default value: `""`

- weechat.look.highlight_prefix

  - description: use a specific color for prefix of line in case of highlight (see also option weechat.look.buffer_time_format)

  - type: boolean

  - values: on, off

  - default value: `on`

- weechat.look.highlight_regex

  - description: POSIX extended regular expression used to check if a message has highlight or not, at least one match in string must be surrounded by delimiters (chars different from: alphanumeric, "-", "_" and "|"), regular expression is case-insensitive (use "(?-i)" at beginning to make it case-sensitive), examples: "flashcode|flashy", "(?-i)FlashCode|flashy"

  - type: string

  - values: any string

  - default value: `""`

- weechat.look.highlight_tags

  - description: comma separated list of tags to highlight; case-insensitive comparison; wildcard "*" is allowed in each tag; many tags can be separated by "+" to make a logical "and" between tags; examples: "nick_flashcode" for messages from nick "FlashCode", "irc_notice+nick_toto*" for notices from a nick starting with "toto"

  - type: string

  - values: any string

  - default value: `""`

- weechat.look.hotlist_add_conditions

  - description: conditions to add a buffer in hotlist (if notify level is OK for the buffer); you can use in these conditions: "window" (current window pointer), "buffer" (buffer pointer to add in hotlist), "priority" (0 = low, 1 = message, 2 = private, 3 = highlight); by default a buffer is added to hotlist if you are away, or if the buffer is not visible on screen (not displayed in any window), or if at least one relay client is connected via the weechat protocol

  - type: string

  - values: any string

  - default value: `"${away} || ${buffer.num_displayed} == 0 || ${info:relay_client_count,weechat,connected} > 0"`

- weechat.look.hotlist_buffer_separator

  - description: string displayed between buffers in hotlist

  - type: string

  - values: any string

  - default value: `", "`

- weechat.look.hotlist_count_max

  - description: max number of messages count to display in hotlist for a buffer: 0 = never display messages count, other number = display max N messages count (from the highest to lowest priority)

  - type: integer

  - values: 0 .. 4

  - default value: `2`

- weechat.look.hotlist_count_min_msg

  - description: display messages count if number of messages is greater or equal to this value

  - type: integer

  - values: 1 .. 100

  - default value: `2`

- weechat.look.hotlist_names_count

  - description: max number of names in hotlist (0 = no name displayed, only buffer numbers)

  - type: integer

  - values: 0 .. 10000

  - default value: `3`

- weechat.look.hotlist_names_length

  - description: max length of names in hotlist (0 = no limit)

  - type: integer

  - values: 0 .. 32

  - default value: `0`

- weechat.look.hotlist_names_level

  - description: level for displaying names in hotlist (combination of: 1=join/part, 2=message, 4=private, 8=highlight, for example: 12=private+highlight)

  - type: integer

  - values: 1 .. 15

  - default value: `12`

- weechat.look.hotlist_names_merged_buffers

  - description: if set, force display of names in hotlist for merged buffers

  - type: boolean

  - values: on, off

  - default value: `off`

- weechat.look.hotlist_prefix

  - description: text displayed at the beginning of the hotlist

  - type: string

  - values: any string

  - default value: `"H: "`

- weechat.look.hotlist_remove

  - description: remove buffers in hotlist: buffer = remove buffer by buffer, merged = remove all visible merged buffers at once

  - type: enum

  - values: buffer, merged

  - default value: `merged`

- weechat.look.hotlist_short_names

  - description: if set, uses short names to display buffer names in hotlist (start after first "." in name)

  - type: boolean

  - values: on, off

  - default value: `on`

- weechat.look.hotlist_sort

  - description: comma-separated list of fields to sort hotlist; each field is a hdata variable of hotlist ("var") or a hdata variable of buffer ("buffer.var"); char "-" can be used before field to reverse order, char "~" can be used to do a case-insensitive comparison; examples: "-priority,buffer.number" for sort on hotlist priority then by buffer number, "-~buffer.full_name" for case-insensitive and reverse sort on buffer full name

  - type: string

  - values: any string

  - default value: `"-priority,time,time_usec"`

- weechat.look.hotlist_suffix

  - description: text displayed at the end of the hotlist

  - type: string

  - values: any string

  - default value: `""`

- weechat.look.hotlist_unique_numbers

  - description: keep only unique numbers in hotlist (this applies only on hotlist items where name is NOT displayed after number)

  - type: boolean

  - values: on, off

  - default value: `on`

- weechat.look.hotlist_update_on_buffer_switch

  - description: update the hotlist when switching buffers

  - type: boolean

  - values: on, off

  - default value: `on`

- weechat.look.input_cursor_scroll

  - description: number of chars displayed after end of input line when scrolling to display end of line

  - type: integer

  - values: 0 .. 100

  - default value: `20`

- weechat.look.input_multiline_lead_linebreak

  - description: start the input text on a new line when the input contains multiple lines, so that the start of the lines align

  - type: boolean

  - values: on, off

  - default value: `on`

- weechat.look.input_share

  - description: share commands, text, or both in input for all buffers (there is still local history for each buffer)

  - type: enum

  - values: none, commands, text, all

  - default value: `none`

- weechat.look.input_share_overwrite

  - description: if set and input is shared, always overwrite input in target buffer

  - type: boolean

  - values: on, off

  - default value: `off`

- weechat.look.input_undo_max

  - description: max number of "undo" for command line, by buffer (0 = undo disabled)

  - type: integer

  - values: 0 .. 65535

  - default value: `32`

- weechat.look.item_away_message

  - description: display server away message in away bar item

  - type: boolean

  - values: on, off

  - default value: `on`

- weechat.look.item_buffer_filter

  - description: string used to show that some lines are filtered in current buffer (bar item "buffer_filter")

  - type: string

  - values: any string

  - default value: `"*"`

- weechat.look.item_buffer_zoom

  - description: string used to show zoom on merged buffer (bar item "buffer_zoom")

  - type: string

  - values: any string

  - default value: `"!"`

- weechat.look.item_mouse_status

  - description: string used to show if mouse is enabled (bar item "mouse_status")

  - type: string

  - values: any string

  - default value: `"M"`

- weechat.look.item_time_format

  - description: time format for "time" bar item (see man strftime for date/time specifiers) (note: content is evaluated, so you can use colors with format "${color:xxx}", see /help eval)

  - type: string

  - values: any string

  - default value: `"%H:%M"`

- weechat.look.jump_current_to_previous_buffer

  - description: jump to previous buffer displayed when jumping to current buffer number with /buffer *N (where N is a buffer number), to easily switch to another buffer, then come back to current buffer

  - type: boolean

  - values: on, off

  - default value: `on`

- weechat.look.jump_previous_buffer_when_closing

  - description: jump to previously visited buffer when closing a buffer (if disabled, then jump to buffer number - 1)

  - type: boolean

  - values: on, off

  - default value: `on`

- weechat.look.jump_smart_back_to_buffer

  - description: jump back to initial buffer after reaching end of hotlist

  - type: boolean

  - values: on, off

  - default value: `on`

- weechat.look.key_bind_safe

  - description: allow only binding of "safe" keys (beginning with a ctrl or meta code)

  - type: boolean

  - values: on, off

  - default value: `on`

- weechat.look.key_grab_delay

  - description: default delay (in milliseconds) to grab a key (using default key alt-k); this delay can be overridden in the /input command (see /help input)

  - type: integer

  - values: 1 .. 10000

  - default value: `800`

- weechat.look.mouse

  - description: enable mouse support

  - type: boolean

  - values: on, off

  - default value: `off`

- weechat.look.nick_color_force

  - description: force color for some nicks: hash computed with nickname to find color will not be used for these nicks (format is: "nick1:color1;nick2:color2"); look up for nicks is with exact case then lower case, so it's possible to use only lower case for nicks in this option; color can include background with the format "text,background", for example "yellow,red"

  - type: string

  - values: any string

  - default value: `""`

- weechat.look.nick_color_hash

  - description: hash algorithm used to find the color for a nick: djb2 = variant of djb2 (position of letters matters: anagrams of a nick have different color), djb2_32 = variant of djb2 using 32-bit instead of 64-bit integer, sum = sum of letters, sum_32 = sum of letters using 32-bit instead of 64-bit integer

  - type: enum

  - values: djb2, sum, djb2_32, sum_32

  - default value: `djb2`

- weechat.look.nick_color_hash_salt

  - description: salt for the hash algorithm used to find nick colors (the nickname is appended to this salt and the hash algorithm operates on this string); modifying this shuffles nick colors

  - type: string

  - values: any string

  - default value: `""`

- weechat.look.nick_color_stop_chars

  - description: chars used to stop in nick when computing color with letters of nick (at least one char outside this list must be in string before stopping) (example: nick "|nick|away" with "|" in chars will return color of nick "|nick"); this option has an impact on option weechat.look.nick_color_force, so the nick for the forced color must not contain the chars ignored by this option

  - type: string

  - values: any string

  - default value: `"_|["`

- weechat.look.nick_prefix

  - description: text to display before nick in prefix of message, example: "<"

  - type: string

  - values: any string

  - default value: `""`

- weechat.look.nick_suffix

  - description: text to display after nick in prefix of message, example: ">"

  - type: string

  - values: any string

  - default value: `""`

- weechat.look.paste_bracketed

  - description: enable terminal "bracketed paste mode" (not supported in all terminals/multiplexers): in this mode, pasted text is bracketed with control sequences so that WeeChat can differentiate pasted text from typed-in text ("ESC[200~", followed by the pasted text, followed by "ESC[201~")

  - type: boolean

  - values: on, off

  - default value: `on`

- weechat.look.paste_bracketed_timer_delay

  - description: force end of bracketed paste after this delay (in seconds) if the control sequence for end of bracketed paste ("ESC[201~") was not received in time

  - type: integer

  - values: 1 .. 60

  - default value: `10`

- weechat.look.paste_max_lines

  - description: max number of lines for paste without asking user (-1 = disable this feature); this option is used only if the bar item "input_paste" is used in at least one bar (by default it is used in "input" bar)

  - type: integer

  - values: -1 .. 2147483647

  - default value: `100`

- weechat.look.prefix_action

  - description: prefix for action messages (note: content is evaluated, so you can use colors with format "${color:xxx}", see /help eval)

  - type: string

  - values: any string

  - default value: `" *"`

- weechat.look.prefix_align

  - description: prefix alignment (none, left, right (default))

  - type: enum

  - values: none, left, right

  - default value: `right`

- weechat.look.prefix_align_max

  - description: max size for prefix (0 = no max size)

  - type: integer

  - values: 0 .. 128

  - default value: `0`

- weechat.look.prefix_align_min

  - description: min size for prefix

  - type: integer

  - values: 0 .. 128

  - default value: `0`

- weechat.look.prefix_align_more

  - description: char to display if prefix is truncated (must be exactly one char on screen)

  - type: string

  - values: any string

  - default value: `""+`

- weechat.look.prefix_align_more_after

  - description: display the truncature char (by default "+") after the text (by replacing the space that should be displayed here); if disabled, the truncature char replaces last char of text

  - type: boolean

  - values: on, off

  - default value: `on`

- weechat.look.prefix_buffer_align

  - description: prefix alignment for buffer name, when many buffers are merged with same number (none, left, right (default))

  - type: enum

  - values: none, left, right

  - default value: `right`

- weechat.look.prefix_buffer_align_max

  - description: max size for buffer name, when many buffers are merged with same number (0 = no max size)

  - type: integer

  - values: 0 .. 128

  - default value: `0`

- weechat.look.prefix_buffer_align_more

  - description: char to display if buffer name is truncated (when many buffers are merged with same number) (must be exactly one char on screen)

  - type: string

  - values: any string

  - default value: `""+`

- weechat.look.prefix_buffer_align_more_after

  - description: display the truncature char (by default "+") after the text (by replacing the space that should be displayed here); if disabled, the truncature char replaces last char of text

  - type: boolean

  - values: on, off

  - default value: `on`

- weechat.look.prefix_error

  - description: prefix for error messages (note: content is evaluated, so you can use colors with format "${color:xxx}", see /help eval)

  - type: string

  - values: any string

  - default value: `"=!="`

- weechat.look.prefix_join

  - description: prefix for join messages (note: content is evaluated, so you can use colors with format "${color:xxx}", see /help eval)

  - type: string

  - values: any string

  - default value: `"-->"`

- weechat.look.prefix_network

  - description: prefix for network messages (note: content is evaluated, so you can use colors with format "${color:xxx}", see /help eval)

  - type: string

  - values: any string

  - default value: `"--"`

- weechat.look.prefix_quit

  - description: prefix for quit messages (note: content is evaluated, so you can use colors with format "${color:xxx}", see /help eval)

  - type: string

  - values: any string

  - default value: `"<--"`

- weechat.look.prefix_same_nick

  - description: prefix displayed for a message with same nick as previous but not next message: use a space " " to hide prefix, another string to display this string instead of prefix, or an empty string to disable feature (display prefix)

  - type: string

  - values: any string

  - default value: `""`

- weechat.look.prefix_same_nick_middle

  - description: prefix displayed for a message with same nick as previous and next message: use a space " " to hide prefix, another string to display this string instead of prefix, or an empty string to disable feature (display prefix)

  - type: string

  - values: any string

  - default value: `""`

- weechat.look.prefix_suffix

  - description: string displayed after prefix

  - type: string

  - values: any string

  - default value: `"│"`

- weechat.look.quote_nick_prefix

  - description: text to display before nick when quoting a message (see /help cursor)

  - type: string

  - values: any string

  - default value: `"<"`

- weechat.look.quote_nick_suffix

  - description: text to display after nick when quoting a message (see /help cursor)

  - type: string

  - values: any string

  - default value: `">"`

- weechat.look.quote_time_format

  - description: time format when quoting a message (see /help cursor) (see man strftime for date/time specifiers, extra specifiers are supported, see function util_strftimeval in Plugin API reference)

  - type: string

  - values: any string

  - default value: `"%H:%M:%S"`

- weechat.look.read_marker

  - description: use a marker (line or char) on buffers to show first unread line

  - type: enum

  - values: none, line, char

  - default value: `line`

- weechat.look.read_marker_always_show

  - description: always show read marker, even if it is after last buffer line

  - type: boolean

  - values: on, off

  - default value: `off`

- weechat.look.read_marker_string

  - description: string used to draw read marker line (string is repeated until end of line)

  - type: string

  - values: any string

  - default value: `"- "`

- weechat.look.read_marker_update_on_buffer_switch

  - description: update the read marker when switching buffers

  - type: boolean

  - values: on, off

  - default value: `on`

- weechat.look.save_config_on_exit

  - description: save configuration file on exit

  - type: boolean

  - values: on, off

  - default value: `on`

- weechat.look.save_config_with_fsync

  - description: use fsync to synchronize the configuration file with the storage device (see man fsync); this is slower but should prevent any data loss in case of power failure during the save of configuration file

  - type: boolean

  - values: on, off

  - default value: `off`

- weechat.look.save_layout_on_exit

  - description: save layout on exit (buffers, windows, or both)

  - type: enum

  - values: none, buffers, windows, all

  - default value: `none`

- weechat.look.scroll_amount

  - description: how many lines to scroll by with scroll_up and scroll_down

  - type: integer

  - values: 1 .. 2147483647

  - default value: `3`

- weechat.look.scroll_bottom_after_switch

  - description: scroll to bottom of window after switch to another buffer (do not remember scroll position in windows); the scroll is done only for buffers with formatted content (not free content)

  - type: boolean

  - values: on, off

  - default value: `off`

- weechat.look.scroll_page_percent

  - description: percent of screen to scroll when scrolling one page up or down (for example 100 means one page, 50 half-page)

  - type: integer

  - values: 1 .. 100

  - default value: `100`

- weechat.look.search_text_not_found_alert

  - description: alert user when text sought is not found in buffer

  - type: boolean

  - values: on, off

  - default value: `on`

- weechat.look.separator_horizontal

  - description: char used to draw horizontal separators around bars and windows (empty value will draw a real line with ncurses, but may cause bugs with URL selection under some terminals); width on screen must be exactly one char

  - type: string

  - values: any string

  - default value: `"-"`

- weechat.look.separator_vertical

  - description: char used to draw vertical separators around bars and windows (empty value will draw a real line with ncurses); width on screen must be exactly one char

  - type: string

  - values: any string

  - default value: `""`

- weechat.look.tab_whitespace_char

  - description: first char to display for tabulations when whitespace mode is enabled with command `/debug whitespace`; width on screen must be exactly one char; subsequent chars are set by option weechat.look.whitespace_char

  - type: string

  - values: any string

  - default value: `"→"`

- weechat.look.tab_width

  - description: number of spaces used to display tabs in messages

  - type: integer

  - values: 1 .. 64

  - default value: `1`

- weechat.look.time_format

  - description: time format for dates converted to strings and displayed in messages (see man strftime for date/time specifiers)

  - type: string

  - values: any string

  - default value: `"%a, %d %b %Y %T"`

- weechat.look.whitespace_char

  - description: char to display for spaces when whitespace mode is enabled with command `/debug whitespace`; width on screen must be exactly one char; see also option weechat.look.tab_whitespace_char

  - type: string

  - values: any string

  - default value: `"·"`

- weechat.look.window_auto_zoom

  - description: automatically zoom on current window if the terminal becomes too small to display all windows (use alt-z to unzoom windows when the terminal is big enough)

  - type: boolean

  - values: on, off

  - default value: `off`

- weechat.look.window_separator_horizontal

  - description: display an horizontal separator between windows

  - type: boolean

  - values: on, off

  - default value: `on`

- weechat.look.window_separator_vertical

  - description: display a vertical separator between windows

  - type: boolean

  - values: on, off

  - default value: `on`

- weechat.look.window_title

  - description: title for window (terminal for Curses GUI), set on startup; an empty string will keep title unchanged (note: content is evaluated, see /help eval); example: "WeeChat ${info:version}"

  - type: string

  - values: any string

  - default value: `""`

- weechat.look.word_chars_highlight

  - description: comma-separated list of chars (or range of chars) that are considered part of words for highlights; each item can be a single char, a range of chars (format: a-z), a class of wide character (for example "alnum", see man wctype); a "!" before the item makes it negative (ie the char is NOT considered part of words); the value "*" matches any char; unicode chars are allowed with the format \u1234, for example \u00A0 for unbreakable space (see /help print for supported formats)

  - type: string

  - values: any string

  - default value: `"!\u00A0,-,_,|,alnum"`

- weechat.look.word_chars_input

  - description: comma-separated list of chars (or range of chars) that are considered part of words for command line; each item can be a single char, a range of chars (format: a-z), a class of wide character (for example "alnum", see man wctype); a "!" before the item makes it negative (ie the char is NOT considered part of words); the value "*" matches any char; unicode chars are allowed with the format \u1234, for example \u00A0 for unbreakable space (see /help print for supported formats)

  - type: string

  - values: any string

  - default value: `"!\u00A0,-,_,|,alnum"`

- weechat.network.connection_timeout

  - description: timeout (in seconds) for connection to a remote host (made in a child process)

  - type: integer

  - values: 1 .. 2147483647

  - default value: `60`

- weechat.network.gnutls_ca_system

  - description: load system's default trusted certificate authorities on startup; this can be turned off to save some memory only if you are not using TLS connections at all

  - type: boolean

  - values: on, off

  - default value: `on`

- weechat.network.gnutls_ca_user

  - description: extra file(s) with certificate authorities; multiple files must be separated by colons (each path is evaluated, see function string_eval_path_home in plugin API reference)

  - type: string

  - values: any string

  - default value: `""`

- weechat.network.gnutls_handshake_timeout

  - description: timeout (in seconds) for gnutls handshake

  - type: integer

  - values: 1 .. 2147483647

  - default value: `30`

- weechat.network.proxy_curl

  - description: name of proxy used for download of URLs with Curl (used to download list of scripts and in scripts calling function hook_process); the proxy must be defined with command /proxy

  - type: string

  - values: any string

  - default value: `""`

- weechat.plugin.autoload

  - description: comma separated list of plugins to load automatically at startup, "*" means all plugins found, a name beginning with "!" is a negative value to prevent a plugin from being loaded, wildcard "*" is allowed in names (examples: "*" or "*,!lua,!tcl")

  - type: string

  - values: any string

  - default value: `"*"`

- weechat.plugin.extension

  - description: comma separated list of file name extensions for plugins

  - type: string

  - values: any string

  - default value: `".so,.dll"`

- weechat.plugin.path

  - description: path for searching plugins (path is evaluated, see function string_eval_path_home in plugin API reference)

  - type: string

  - values: any string

  - default value: `"${weechat_data_dir}/plugins"`

- weechat.plugin.save_config_on_unload

  - description: save configuration files when unloading plugins

  - type: boolean

  - values: on, off

  - default value: `on`

- weechat.signal.sighup

  - description: command to execute when the signal is received, multiple commands can be separated by semicolons (note: commands are evaluated, see /help eval)

  - type: string

  - values: any string

  - default value: `"${if:${info:weechat_headless}?/reload:/quit -yes}"`

- weechat.signal.sigquit

  - description: command to execute when the signal is received, multiple commands can be separated by semicolons (note: commands are evaluated, see /help eval)

  - type: string

  - values: any string

  - default value: `"/quit -yes"`

- weechat.signal.sigterm

  - description: command to execute when the signal is received, multiple commands can be separated by semicolons (note: commands are evaluated, see /help eval)

  - type: string

  - values: any string

  - default value: `"/quit -yes"`

- weechat.signal.sigusr1

  - description: command to execute when the signal is received, multiple commands can be separated by semicolons (note: commands are evaluated, see /help eval)

  - type: string

  - values: any string

  - default value: `""`

- weechat.signal.sigusr2

  - description: command to execute when the signal is received, multiple commands can be separated by semicolons (note: commands are evaluated, see /help eval)

  - type: string

  - values: any string

  - default value: `""`

- weechat.startup.command_after_plugins

  - description: command executed when WeeChat starts, after loading plugins; multiple commands can be separated by semicolons (note: commands are evaluated, see /help eval)

  - type: string

  - values: any string

  - default value: `""`

- weechat.startup.command_before_plugins

  - description: command executed when WeeChat starts, before loading plugins; multiple commands can be separated by semicolons (note: commands are evaluated, see /help eval)

  - type: string

  - values: any string

  - default value: `""`

- weechat.startup.display_logo

  - description: display WeeChat logo at startup

  - type: boolean

  - values: on, off

  - default value: `on`

- weechat.startup.display_version

  - description: display WeeChat version at startup

  - type: boolean

  - values: on, off

  - default value: `on`

- weechat.startup.sys_rlimit

  - description: set resource limits for WeeChat process, format is: "res1:limit1,res2:limit2"; resource name is the end of constant (RLIMIT_XXX) in lower case (see man setrlimit for values); limit -1 means "unlimited"; example: set unlimited size for core file and max 1GB of virtual memory: "core:-1,as:1000000000"

  - type: string

  - values: any string

  - default value: `""`

## 8. IRC

Wtyczka IRC jest zaprojektowana do prowadzenia rozmów z innymi osobami przez protokół IRC.

Jest multi-serwerowa i oferuje wszystkie wspierane komendy IRC włącznie z rozmowami DCC i transferami plików (poprzez wtyczkę xfer, zobacz Wtyczka xfer).

### 8.1. Opcje z linii poleceń

Możliwe jest podanie adresu URL do jednego lub wielu serwerów IRC:

    irc[6][s]://[nick[:hasło]@]adres.serwera.irc[:port][/kanał][,kanał[...]]

Przykład wejścia na kanały #weechat i #weechat-fr na serwerze irc.libera.chat, na domyślnym porcie (6667), z nickiem alice:

    weechat irc://alice@irc.libera.chat/#weechat,#weechat-fr

### 8.2. Serwery

#### Dodanie serwera

Domyślnie nie są zdefiniowane żadne serwery. Możesz dodać ich tyle ile chcesz za pomocą polecenia /server.

Na przykład w celu połączenia się do libera.chat ↗:

    /server add libera irc.libera.chat

Notka | Domyślny port to 6697 i TLS (szyfrowanie ruchu) jest włączone.

Możesz powiedzieć WeeChat, aby automatycznie łączył się z tym serwerem po uruchomieniu:

    /set irc.server.libera.autoconnect on

W celu uwierzytelnienia zalecane jest używanie SASL (jeśli wspiera to serwer), za pomocą hasła przechowaywanego w bezpieczny sposób (więcej w rozdziale Uwierzytelnianie SASL):

    /set irc.server.libera.sasl_username "alice"
    /secure set libera xxxxxxx
    /set irc.server.libera.sasl_password "${sec.data.libera}"

Jeśli SASL nie jest wspierane możesz użyć komendy, aby wysłać wiadomość do nickserva:

    /set irc.server.libera.command "/msg nickserv identify ${sec.data.libera}"

Notka | Wysyłając wiadomość do nickserva możesz sie uwierzytelnić po wejściu na kanały, co może być problemem na kanałach, na które mogą wejść tylko uwierzytelnione osoby. W takim przypadku możesz ustawić opóźnienie dla komendy: `/set irc.server.libera.command_delay 5`.

#### Opcje serwerów

Opcje serwerów są nazywane w taki sposób `irc.server.<serwer>.<opcja>`, gdzie `<serwer>` to zdefiniowana nazwa serwera, `<opcja>` to nazwa opcji.
Wartość opcji jest dziedziczona z `irc.server_default.xxx` w przypadku kiedy opcja ma specalną wartość `null`.

Na przykład jeśli stworzyłeś serwer libera za pomocą po wyższych komend zobaczysz to po wykonaniu `/fset libera`:

    irc.server.libera.addresses             ciąg    "irc.libera.chat"
    irc.server.libera.anti_flood            liczba  null -> 2000
    irc.server.libera.autoconnect           bool    on
    irc.server.libera.autojoin              ciąg    null -> ""
    irc.server.libera.autojoin_delay        liczba  null -> 0
    irc.server.libera.autojoin_dynamic      bool    null -> off
    irc.server.libera.autoreconnect         bool    null -> on
    irc.server.libera.autoreconnect_delay   liczba  null -> 10
    irc.server.libera.autorejoin            bool    null -> off
    irc.server.libera.autorejoin_delay      liczba  null -> 30
    irc.server.libera.away_check            liczba  null -> 0
    irc.server.libera.away_check_max_nicks  liczba  null -> 25
    irc.server.libera.capabilities          ciąg    null -> "*"
    irc.server.libera.charset_message       enum    null -> message
    irc.server.libera.command               ciąg    null -> ""
    irc.server.libera.command_delay         liczba  null -> 0
    irc.server.libera.connection_timeout    liczba  null -> 60
    irc.server.libera.default_chantypes     ciąg    null -> "#&"
    irc.server.libera.ipv6                  enum    null -> auto
    irc.server.libera.local_hostname        ciąg    null -> ""
    irc.server.libera.msg_kick              ciąg    null -> ""
    irc.server.libera.msg_part              ciąg    null -> "WeeChat ${info:version}"
    irc.server.libera.msg_quit              ciąg    null -> "WeeChat ${info:version}"
    irc.server.libera.nicks                 ciąg    null -> "${username},${username}2,${username}3,${username}4,${username}5"
    irc.server.libera.nicks_alternate       bool    null -> on
    irc.server.libera.notify                ciąg    null -> ""
    irc.server.libera.password              ciąg    null -> ""
    irc.server.libera.proxy                 ciąg    null -> ""
    irc.server.libera.realname              ciąg    null -> ""
    irc.server.libera.registered_mode       ciąg    null -> "r"
    irc.server.libera.sasl_fail             enum    null -> reconnect
    irc.server.libera.sasl_key              ciąg    null -> ""
    irc.server.libera.sasl_mechanism        enum    null -> plain
    irc.server.libera.sasl_password         ciąg    "${sec.data.libera}"
    irc.server.libera.sasl_timeout          liczba  null -> 15
    irc.server.libera.sasl_username         ciąg    "alice"
    irc.server.libera.split_msg_max_length  liczba  null -> 512
    irc.server.libera.tls                   bool    null -> on
    irc.server.libera.tls_cert              ciąg    null -> ""
    irc.server.libera.tls_dhkey_size        liczba  null -> 2048
    irc.server.libera.tls_fingerprint       ciąg    null -> ""
    irc.server.libera.tls_password          ciąg    null -> ""
    irc.server.libera.tls_priorities        ciąg    null -> "NORMAL"
    irc.server.libera.tls_verify            bool    null -> on
    irc.server.libera.usermode              ciąg    null -> ""
    irc.server.libera.username              ciąg    null -> "${username}"

Na przykład jeśli chcesz automatycznie połączyć się ze wszystkimi zdefiniowanym serwerami bez potrzeby ustawiania tej opcji dla każdego z serwerów, możesz to zrobić za pomocą:

    /set irc.server_default.autoconnect on

Następnie możesz zresetować opcję serwera do jej domyślnej (dziedziczonej) wartości, która teraz ma wartość `on` zamiast domyślnego `off`:

    /unset irc.server.libera.autoconnect

#### Certyfikaty TLS

Podczas łączenia się z serwerem IRC, WeeChat domyślnie sprawdza czy połączenie jest w pełni zaufane.

Niektóre opcje są używane do kontroli połączenia TLS:

weechat.network.gnutls_ca_system

  ładuje domyślne systemowe zaufane urzędy cetyfikujące

weechat.network.gnutls_ca_user

  dodatkowy plik(i) urzędów certyfikacyjnych

irc.server.xxx.tls_cert

  certyfikat TLS używany do automatycznej identyfikacji twojego nicka (na przykład CertFP w sieci oftc, zobacz niżej)

irc.server.xxx.tls_dhkey_size

  rozmiar klucza użytego podczas wymiany kluczy Diffie-Hellman (domyślnie: 2048)

irc.server.xxx.tls_verify

  sprawdź, że połączenie TLS jest w pełni zaufane (domyślnie włączone)

Notka | Opcja "tls_verify" jest domyślnie włączona, weryfikacja jest restrykcyjna i może się nie powieść, nawet jeśli wszystko było OK w wersjach przed 0.3.1.

##### Pierwszy przykład: połączenie z oftc i sprawdzenie certyfikatu

- Import certyfikatu w kosoli:

    mkdir -p ~/.config/weechat/tls
    wget -O ~/.config/weechat/tls/CAs.pem https://www.spi-inc.org/ca/spi-cacert.crt

Notka | Musisz zamienić `~/.config/weechat` na ścieżkę do katalogu z konfiguracją WeeChat, który może być ustawiony na przykład na `~/.weechat`.

Notka | Możliwe jest umieszczenie wielu certyfikatów w pliku CAs.pem.

- W WeeChat z dodanym wcześniej serwerem "oftc":

    /connect oftc

##### Drugi przykład: połączenie z oftc używając CertFP

- Tworzenie certyfikatu w konsoli:

    mkdir -p ~/.config/weechat/tls
    cd ~/.config/weechat/tls
    openssl req -nodes -newkey rsa:2048 -keyout nick.pem -x509 -days 365 -out nick.pem

Notka | Musisz zamienić `~/.config/weechat` na ścieżkę do katalogu z konfiguracją WeeChat, który może być ustawiony na przykład na `~/.weechat`.

- W WeeChat z dodanym wcześniej serwerem "oftc":

    /set irc.server.oftc.tls_cert "${weechat_config_dir}/tls/nick.pem"
    /connect oftc
    /msg nickserv cert add

Więcej informacji można znaleźć odwiedzając tą stronę ↗.

#### Uwierzytelnianie SASL

WeeChat wspiera uwierzytelnianie SASL, używając różnych mechanizmów:

- plain: hasło w czystym tekście (domyślne)

- scram-sha-1: SCRAM z użyciem algorytmu SHA-1

- scram-sha-256: SCRAM z użyciem algorytmu SHA-256

- scram-sha-512: SCRAM z użyciem algorytmu SHA-512

- ecdsa-nist256p-challenge: klucz prywatny/publiczny

- external: certyfikat TLS po stronie klienta

Opcje dla serwerów to:

- sasl_mechanism: mechanizm do użycia (zobacz wyżej)

- sasl_timeout: limit czasu (w sekundach) na uwierzytelnienie

- sasl_fail: akcja wykonywana jeśli uwierzytelnienie się nie powiedzie

- sasl_username: nazwa użytkownika (nick)

- sasl_password: hasło

- sasl_key: plik z kluczem prywatnym ECc (dla mechanizmu ecdsa-nist256p-challenge)

##### SASL ECDSA-NIST256P-CHALLENGE

Musisz wygenerować klucz prywatny w celu uwierzytelnienia za pomocą mechanizmu ECDSA-NIST256P-CHALLENGE (hasło nie potrzebne do połączenia).

Klucz można wygenerować za pomocą komendy:

    openssl ecparam -genkey -name prime256v1 -out ~/.config/weechat/ecdsa.pem

Notka | Musisz zamienić `~/.config/weechat` na ścieżkę do katalogu z konfiguracją WeeChat, który może być ustawiony na przykład na `~/.weechat`.

Klucz publiczny (zakodowany za pomocą base64) uzyskujemy wywołując komendę:

    openssl ec -noout -text -conv_form compressed -in ~/.config/weechat/ecdsa.pem | grep '^pub:' -A 3 | tail -n 3 | tr -d ' \n:' | xxd -r -p | base64

Połącz się do serwera, zidentyfikuj (na przykład za pomocą "nickserv identify") i ustaw swój klucz publiczny dla swojego konta, za pomocą nickserva (zamień wartość base64 wartościa dla swojego klucza):

    /connect libera
    /msg nickserv identify your_password
    /msg nickserv set pubkey Av8k1FOGetUDq7sPMBfufSIZ5c2I/QYWgiwHtNXkVe/q

Konfiguracja opcji SASL dla serwera:

    /set irc.server.libera.sasl_mechanism ecdsa-nist256p-challenge
    /set irc.server.libera.sasl_username "twój_nick"
    /set irc.server.libera.sasl_key "${weechat_config_dir}/ecdsa.pem"

Ponowne połączenie z serwerem:

    /reconnect libera

#### Łączenie się z serwerem

Możesz połączyć się z serwerem za pomocą komendy /connect:

    /connect libera

Aby się rozłączyć:

    /disconnect libera

Lub tylko to jeśli jesteś w buforze należącym do serwera libera (serwer, kanał, wiadomości prywatne):

    /disconnect

Jeśli łączysz się do wielu serwerów na raz, bufory serwerów są domyślnie połączone i możesz się między nimi przełączać za pomocą klawiszy `Ctrl`+`x`.
Możliwe jest wyłączenie automatycznego łączenia buforów serwerów i posiadania oddzielnych buforów dla serwerów:

    /set irc.look.server_buffer independent

#### Połączenie za pomocą Tora i SASL

Niekróre serwery wspierają połączenia z sieci Tor ↗, sieci wirtualnych tuneli, które umożliwają poprawienie swojej prywatności i bezpieczeństwa w Internecie.

Pierwszym krokiem jest instalacja Tora. Dla Debiana (i pochodnych):

    sudo apt-get install tor

W WeeChat należy stworzyć proxy socks5 dla serwisu Tor (nazwa hosta/IP i port zależą od twojej konfiguracji Tora):

    /proxy add tor socks5 127.0.0.1 9050

Teraz należy dodać nowy serwer (zastąp nazwę serwera "irc-tor" i andres właściwymi wartościami):

    /server add irc-tor adres.serwera.onion

Ustaw proxy dla Tor:

    /set irc.server.irc-tor.proxy "tor"

Ustaw uwierzytelnianie SASL z użyciem ECDSA-NIST256P-CHALLENGE (zobacz rozdział SASL ECDSA-NIST256P-CHALLENGE żeby dowiedzieć się jak wygenerować klucz prywatny):

    /set irc.server.irc-tor.sasl_mechanism ecdsa-nist256p-challenge
    /set irc.server.irc-tor.sasl_username "twój_użytkownik"
    /set irc.server.irc-tor.sasl_key "${weechat_config_dir}/ecdsa.pem"

Teraz pozostaje już się tylko połączyć z serwerem:

    /connect irc-tor

### 8.3. Wsparcie dla IRCv3

WeeChat wspiera następujące rozszerzenia IRCv3 ↗:

- account-notify

- account-tag

- away-notify

- batch

- cap-notify

- chghost

- draft/multiline

- echo-message

- extended-join

- invite-notify

- message-tags

- monitor

- multi-prefix

- SASL v3.2

- server-time

- setname

- typing

- userhost-in-names

- WHOX

Domyślnie wszystkie możliwości wspierane przez serwer i WeeChat są automatycznie włączone (opcja irc.server_default.capabilities).

Tabele z porównaniem różnych klientów IRC, także WeeChat, można znaleźć na tej stronie ↗.

#### account-notify

Specyfikacja: account-notify ↗

Ta właściwość pozwala serwerowi na wysyłanie wiadomości po tym jak użytkownik zostanie zidentyfikwany lub niezidentyfikowany na serwerze.
WeeChat wyświetla takie wiadomości jeśli opcja irc.look.display_account_message jest włączona (domyślna wartość).

Przykłady:

    -- alice zidentyfikował się jako Alice01

    -- alice został niezidentyfikowany

#### account-tag

Specyfikacja: account-tag ↗

Ta właściwość pozwala serwerowi na wysyłanie komend konta jako tagów wiadomości do komend wysyłanych do klienta.
WeeChat parsuje te tagi i zapisuje je w wiadomości ale nie jest on używany ani wyświetlany. Można ich użyć w komendzie /filter do filtrowania wiadmości pasujących do konkretnych kont:

Przykład otrzymanej nieprzetworzonej wiadomości:

    @account=Alice01 :user@example.com PRIVMSG #test :Hello!

Wiadomość wyświetlana na kanale:

    <alice> Hello!

Wiadomość z tagami:

    <alice> Hello! [irc_privmsg,irc_tag_account_Alice01,notify_message,prefix_nick_lightcyan,nick_alice,host_user@example.com,log1]

#### away-notify

Specyfikacja: away-notify ↗

Ta właściwość pozwala serwerowi na wysyłanie powiadomień o nieobecności do użytkowników znajdujących się na tych samych kanałach co ty.

Kiedy status nieobecności zmienia się dla użytkownika, jest to odzwierciedlane konkretnym kolorze na liście nicków, za pomocą następujących opcji:

- irc.server_default.away_check

- irc.server_default.away_check_max_nicks

- weechat.look.item_away_message

#### batch

Specifikacja: batch ↗

Ta właściwość pozwala serwerowi na wysyłanie seri zdarzeń (pogrupowane kilka powiązanych wiadomości).

Obecnie WeeChat tylko przechowuje wiadomości odebrane w seri i przetwarza je w normalny sposób, po zakończeniu seri.

#### cap-notify

Specyfikacja: cap-notify ↗

Ta właściwość pozwala serwerowi na ogłaszanie nowych lub usuniętych możliwości na serwerze (za pomocą komend `CAP NEW` i `CAP DEL`i).

Przykłady:

    -- irc: możliwości klienta, teraz dostępne: sasl

    -- irc: możliwości klienta, usunięte: sasl

#### chghost

Specyfikacja: chghost ↗

Ta właściwość pozwala serwerowi na wysyłanie wiadomości, kiedy użytkownik zmienia nazwę lub hosta. Kiedy opcja irc.look.smart_filter_chghost jest włączona (domyślna wartość), zmiany hosta są domyślnie ukrywane jeśli dany nick nie odzywał się od kilku minut.
Kolor wiadomości o zmianie hosta można ustawić za pomocą opcji irc.color.message_chghost.

Przykłady:

    -- alice (user@example.com) zmienił hosta na test.com

#### draft/multiline

Specifikacja: multiline ↗

Ta właściwość pozwala klientowi i serwerowi wysyłać wieloliniowe wiadomości, za pomocą właściwości batch, która również musi być włączona.

Istnieje limit bajtów lub ilości lini tych wiadomości podawane dla tej właściwości wysyłanej przez serwer, na przykład:

    CAP alice LS * :draft/multiline=max-bytes=4096,max-lines=24

Ustawia to limit na 4096 bajtów i 24 linie dla zawartości wieloliniowej serii.

Jeśli serwer nie ustawia limitu, domyślne wartości dla WeeChat to:

- ilość bajtów: 4096

- ilość lin: 24

Tylko standardowe wiadmości oraz te wysyłane przez polecenie /notice mogą mieć wiele linii.
Ta właściwość nie ma wpływu na wiadomości ACTION CTCP wysyłane przez polecenie /me. Oznacza to ze wieloliniowe akcje wysyłane są jako wiele akcji.

Ostrzeżenie

Ponieważ specyfikacja jest "szkicem" może się zmienić i wsparcie dla tej właściwości w WeeChat może się zepsuć w dowolnym momencie.
Wsparcie dla tej właściwości jest automatycznie włączane jeśli serwer ją wspiera, można ją wyłączyć za pomocą polecenia: `/set irc.server_default.capabilities "*,!draft/multiline"`.
Kiedy wsparcie jest wyłączone, wieloliniowe wiadomości są wysyłane jako wiele wiadomości, tak jakby były wysyłane sekwencyjnie do serwera.

Przykład wiadomości IRC wysłanych dla wiadomości użytkownika z dwoma liniami (`this is a test` / `on two lines`), wysłane na kanał #test:

    BATCH +i8Je7M7gquddoyC9 draft/multiline #test
    @batch=i8Je7M7gquddoyC9 PRIVMSG #test :this is a test
    @batch=i8Je7M7gquddoyC9 PRIVMSG #test :on two lines
    BATCH -i8Je7M7gquddoyC9

Wiadomość wyświetlana w WeeChat:

    19:01:45 alice | this is a test
                   | on two lines

#### echo-message

Specifikacja: echo-message ↗

Ta właściwość wymusza na serwerze wysyłanie wiadomości PRIVMSG, NOTICE i TAGMSG spowrotem do WeeChat.

WeeChat wyświetla tylko otrzymane wiadomości, dlatego można zaobserwować pewne opóźnienia pomiędzy wysłaniem a wyświetleniem wiadomości. Kiedy wiadomość zostanie wyświetlona, oznacza to, że została ona poprawnie odebrana przez serwer i przesłana do innych połączonych klientów.

#### extended-join

Specyfikacja: extended-join ↗

Ta właściwość pozwala serwerowi na wysyłanie konta i prawdziwej nazwy, kiedy użytkownicy wchodzą na kanały.
WeeChat wyświetla te dodatkowe informacje jeśli opcja irc.look.display_extended_join jest włączona (domyślna wartość).

Przykład:

    --> john [John01] (John Doe) (~user@example.com) wszedł na #test

#### invite-notify

Specyfikacja: invite-notify ↗

Ta właściwość pozwala serwerowi na wysyłanie wiadomości zaproszeń, kiedy użytkownicy są zapraszani na kanały.

Przykłady:

    -- alice zaprosił bob na #test

#### message-tags

Specyfikacja: message-tags ↗

Ta właściwość pozwala dodawać metdane do wiadomości.
Tagi te mogą być wyświetlone za pomocą komendy `/debug tags`.

Musi to być włączone, żeby używać powiadomień o pisaniu.

#### monitor

Specyfikacja: monitor ↗

Ta właściwość pozwala serwerowi na wysyłanie powiadomień kiedy klient stanie się online lub offline.
WeeChat automatycznie użyje tego rozszerzenia jeśli jest dostępne podczas użycia komendy /notify.

#### multi-prefix

Specyfikacja: multi-prefix ↗

Ta właściwość pozwala serwerowi na wysyłanie wszystkich trybów użytkownika na raz w odpowiedziach na /names i /whois.

Notka | Obecnie WeeChat nie wyświetla wszystkich prefuksów w wyniku komendy `/names`, nawet jeśli zostały poprawnie otrzmane i zapisane wewnętrznie.

Przykład: wynik `/whois alice`:

    -- [alice] @%+#test

#### SASL

Specyfikacja: SASL 3.2 ↗

Zobacz dedykowany rozdział autentykacja SASL.

#### server-time

Specyfikacja: server-time ↗

Ta właściwość pozwala serwerowi na wysyłanie czasu dla wiadomości w tagach.
Po otrzymaniu czasu w wiadomości WeeChat używa go do jej wyświetlenia (może zostać wyświetlona z wrześniejszym czasem).

IRC proxy we wtyczce Relay wspiera tą właściwość, każdy klient IRC połączony z Relay powinien włączyć tą właściwość jeśli chce wyświetlać prawdziwi czas wysłania wiadomości.

#### setname

Specyfikacja: setname ↗

Ta właściwość pozwala zmienić prawdziwą nazwę za pomocą komendy /setname.

#### typing

Specyfikacja: typing ↗

Zobacz dedykowany rozdział Powiadomienia o pisaniu.

#### userhost-in-names

Specyfikacja: userhost-in-names ↗

Ta właściwość pozwala serwerowi na wysyłanie nazwy kostów w odpowiedzi na komendę /names.

Notka | WeeChat nie wyświetla nazwy hostów w wyjściu komendy `/names`.

Przykład nieprzetworzonych wiadomości IRC otrzymanych bez tej właściwości:

    :irc.server 353 alice = #test :@alice bob +carol

Przykład nieprzetworzonych wiadomości IRC z tą właściwością:

    :irc.server 353 alice = #test :@alice!user1@host1 bob!user2@host2 +carol!user3@host3

#### WHOX

Specyfikacja: WHOX ↗

Ta właściwość pozwala na zarządanie dodatkowych pól w odpowiedzi na WHO (przez komendę /who).
WeeChat wyświetla wszystkie dodatkowe informacje otrzymane w odpowiedzi na WHO.

### 8.4. Kanały

Możesz dołączać do kanałów za pomocą komendy /join:

    /join #channel

Wyjście z kanału (zostawiając otwarty bufor):

    /part [quit message]

Kanały do których dołączyłeś nie są zapisywane. Jeśli chcesz automatycznie do nich dołączać podczas łączenia się z serwerem, należy ustawić opcje serwera `autojoin`:

    /set irc.server.libera.autojoin "#weechat"

Notka | Niektóre skrypty mogą pomóc w automatycznym ustawianiu tej opcji, zobacz `/script search autojoin`.

Bądź ostrożny, spacje mogą być używane tylko do oddzielenia listy kanałów od ich haseł, na przykład jeśli `#kanał1` wymaga hasła ale `#kanał2` już nie:

    /set irc.server.libera.autojoin "#kanał1,#kanał2 hasło1"

Informacje o formacie można znaleźć w opcji irc.server_default.autojoin.

### 8.5. Prywatne wiadomości

Możesz wysłać prywatną wiadomość za pomocą polecenia /query, co otwiera oddzielny bufor:

    /query bob cześć, co tam?

Bez argumentów to polecenie otwiera bufor (lub przechodzi do niego jeśli już jest otwarty):

    /query bob

W celu zamknięcia prywatnego buforu możesz wykonać to polecenie w prywatnym buforze:

    /close

### 8.6. Inteligentne filtry

Inteligentne filtry są dostępne dla filtrowania części wiadomości w przypadku, kiedy ktoś nic nie napisał na kanale w określonym czasie:

- join: user joins the channel

- part: user leaves the channel

- quit: user quits the server

- account: user changes its account

- chghost: user changes name or host

- mode: mode changes on channel

- nick: user changes its nick

- setname: user changes its real name

Intgeligentne filtry są domyślnie włączone, ale musisz dodać filtr ukrywający wiadomości w buforach, na przydład:

    /filter add irc_smart * irc_smart_filter *

Można stworzyć filtry dla pojedynczego kanału lub kanałów, których nazwy zaczynają się tak samo (zobacz komendę /filter):

    /filter add irc_smart_weechat irc.libera.#weechat* irc_smart_filter *

Możesz ustawić dłuższe opóźnienie (w minutach):

    /set irc.look.smart_filter_delay 10

Jeśli ktoś nie napiał nic w ciągu ostatnich 10 minut, jego wiadomości jak join/part/quit zostaną domyślnie ukryte na kanale. Można użyć skrótu `Alt`+`=` (przełącz filtry) żeby je zobaczyć.

### 8.7. Odpowiedzi CTCP

Możliwe jest dostosowywanie odpowiedzi CTCP, lub blokowanie niektórych zapytań CTCP (brak odpowiedzi).

Na przykład, ustawianie własnej odpowiedzi na CTCP "VERSION", możliwe jest za pomocą polecenia:

    /set irc.ctcp.version "I'm running WeeChat ${version}, it rocks!"

Notka | Nazwa wiadomości CTCP musi być pisana małymi literami. Oznacza to, że ustawienie opcji irc.ctcp.VERSION nie zadziała.

Jeśli chcesz zablokować CTCP "VERSION" (nie odpowiadać na zapytanie), ustaw pusty ciąg:

    /set irc.ctcp.version ""

Nawet odpowiedzi na nieznane zapytania CTCP mogą być dostosowywane, na przykład odpowiedź na CTCP "BLABLA":

    /set irc.ctcp.blabla "This is my answer to CTCP BLABLA"

Możliwe jest dostosowywanie odpowiedzi na CTCP tylko w obrębie serwera, używając jego wewnętrznej nazwy przed nazwą zapytania CTCP:

    /set irc.ctcp.libera.version "WeeChat ${version} (for libera)"

Jeśli chcesz przywrócić standardowe odpowiedzi dla CTCP usuń opcję:

    /unset irc.ctcp.version

Odpowiedzi CTCP są przetwarzane (zobacz komendę /eval), można użyć następujących zmiennych:

Zmienna | Opis | Wartość/Przykład
--- | --- | ---
`${clientinfo}` | Lista wspieranych CTCP | `ACTION DCC CLIENTINFO PING SOURCE TIME VERSION`
`${version}` | Wersja WeeChat | `4.1.0-dev`
`${versiongit}` | Wersja WeeChat + wersja Git (1) | `4.1.0-dev (git: v4.0.0-51-g8f98b922a)`
`${git}` | Wersja git (1) | `v4.0.0-51-g8f98b922a`
`${compilation}` | Data kompilacji WeeChat | `Jul 8 2023 20:14:23`
`${osinfo}` | Informacje o systemie operacyjnym | `Linux 5.10.0-23-amd64 / x86_64`
`${site}` | Strona WeeChat | `https://weechat.org/`
`${download}` | Strona WeeChat, pobieranie | `https://weechat.org/download/`
`${time}` | Obecna data/czas | `Sat, 08 Jul 2023 21:11:19 +0200`
`${username}` | Nazwa użytkownika na serwerze IRC | `name`
`${realname}` | Prawdziwa nazwa na serwerze IRC | `John Doe`

Notka | (1) Wersja git jest wynikiem komendy `git describe`. Jest dostępna tylko jeśli WeeChat został skompilowany wewnątrz repozytorium Git i Git był zainstalowany.

Domyślne odpowiedzi CTCP:

CTCP | Format odpowiedzi | Przykład
--- | --- | ---
CLIENTINFO | `${clientinfo}` | `ACTION DCC CLIENTINFO PING SOURCE TIME VERSION`
SOURCE | `${download}` | `https://weechat.org/download/`
TIME | `${time}` | `Sat, 08 Jul 2023 21:11:19 +0200`
VERSION | `WeeChat ${version}` | `WeeChat 4.1.0-dev`

### 8.8. Bufor dla wiadomości IRC

Jest możliwe dostosowanie buforu docelowego dla wiadomości IRC (bufor użyty do wyświetlania wiadomości) za pomocą opcji `irc.msgbuffer.*`.

Dla niektórych wiadomości IRC (Zobacz poniższa listę), można ustawić wartość:

current

  obecny bufor (jeśli jest to bufor IRC, lub domyślnie bufor serwera)

private

  prywatny bufor dla osoby, lub bufor obecny/serwera jeśli nie zostanie znaleziony (zgodnie z opcją irc.look.msgbuffer_fallback)

server

  bufor serwera

weechat

  Bufor "rdzeń" WeeChat

Kiedy opcja nie jest ustawiona (domyślnie), WeeChat wybiera odpowiedni bufor, zazwyczaj bufor serwera albo kanału.

Niepełna lista wiadomości IRC lub aliasów jakie można dostosować:

wiadomość | alias | opis
--- | --- | ---
`error` |  | błąd
`invite` |  | zaproszono na kanał
`join` |  | wejście
`kick` |  | wykopanie
`kill` |  | zabicie
`mode` |  | tryb
`notice` |  | powiadomienie
`part` |  | opuszczenie
`quit` |  | wyjście
`topic` |  | temat
`wallops` |  | wallops
| `ctcp` | ctcp (wysłane lub otrzymane, w wiadomości prywatnej lub powiadomieniu)
`221` |  | ciąg trybu użytkownika
`275` | `whois` | whois (bezpieczne połączenie)
`301` | `whois` | whois (away)
`303` |  | ison
`305` | `unaway` | unaway
`306` | `away` | away
`307` | `whois` | whois (zarejestrowany nick)
`310` | `whois` | whois (tryb pomocy)
`311` | `whois` | whois (użytkownik)
`312` | `whois` | whois (serwer)
`313` | `whois` | whois (operator)
`314` | `whowas` | whowas
`315` | `who` | who (koniec)
`317` | `whois` | whois (idle)
`318` | `whois` | whois (koniec)
`319` | `whois` | whois (kanały)
`320` | `whois` | whois (zidentyfikowany użytkownik)
`321` | `list` | list (start)
`322` | `list` | list (kanał)
`323` | `list` | list (koniec)
`326` | `whois` | whois (ma uprawnienia operatora)
`327` | `whois` | whois (host)
`328` |  | URL kanału
`329` |  | data utworzenia kanału
`330` | `whois` | whois (zalogowany jako)
`331` |  | brak tematu na kanale
`332` |  | temat kanału
`333` |  | informacje o temacie
`335` | `whois` | whois (jest botem na)
`338` | `whois` | whois (host)
`341` |  | zaproszenie
`343` | `whois` | whois (is opered as)
`344` | `reop` | reop dla kanału
`345` | `reop` | reop dla kanału (koniec)
`346` | `invitelist` | lista zaproszonych
`347` | `invitelist` | lista zaproszonych (koniec)
`348` | `exceptionlist` | lista wyjątków
`349` | `exceptionlist` | lista wyjątków (koniec)
`351` |  | wersja serwera
`352` | `who` | who
`353` | `names` | lista osób na kanale
`366` | `names` | koniec listy osób na kanale
`367` | `banlist` | lista zbanowanych
`368` | `banlist` | koniec listy zbanowanych
`369` | `whowas` | whowas (koniec)
`378` | `whois` | whois (łączy się z)
`379` | `whois` | whois (używa trybów)
`401` | `whois` | brak nicka/kanału
`402` | `whois` | brak serwera
`432` |  | błędna nazwa użytkownika
`433` |  | nazwa użytkownika już zajęta
`438` |  | brak uprawnień do zmiany nicka
`671` | `whois` | whois (bezpieczne połączenie)
`728` | `quietlist` | cicha lista
`729` | `quietlist` | koniec cichej listy
`732` | `monitor` | lista monitorowanych nicków
`733` | `monitor` | lista monitorowanych nicków (koniec)
`901` |  | jesteś teraz zalogowany

Inne numeryczne komendy mogą również zostać spersonalizowane.

Wiadomość może być poprzedzona nazwą serwera, żeby być specyficzna dla danego serwera irc (na przykład: `libera.whois`).

Kilka przykładów:

- wyświetlaj wynik komendy `/whois` w prywatnym buforze:

    /set irc.msgbuffer.whois private

- przywróć domyślny bufor dla komendy `/whois` (bufor serwera):

    /unset irc.msgbuffer.whois

- wyświetlaj zaproszenia w obecnym buforze, tylko na serwerze "libera":

    /set irc.msgbuffer.libera.invite current

- wyświetlaj wiadomość "303" (ison) w buforze "core" WeeChat:

    /set irc.msgbuffer.303 weechat

### 8.9. Komendy

- `action`: send a CTCP action to a nick or channel

    /action  [-server <server>] <target>[,<target>...] <text>

    server: send to this server (internal name)
    target: nick or channel (may be mask, "*" = current channel)
      text: text to send

- `admin`: find information about the administrator of the server

    /admin  [<target>]

    target: server name

- `allchan`: execute a command on all channels of all connected servers

    /allchan  [-current] [-parted|-all] [-exclude=<channel>[,<channel>...]] <command>
              [-current] [-parted|-all] -include=<channel>[,<channel>...] <command>

    -current: execute command for channels of current server only
     -parted: execute command on parted channels (by default: execute command on active channels only)
        -all: execute command on all channels (active and parted)
    -exclude: exclude some channels (wildcard "*" is allowed)
    -include: include only some channels (wildcard "*" is allowed)
     command: command to execute (or text to send to buffer if command does not start with "/")

    Command and arguments are evaluated (see /help eval), the following variables are replaced:
      $server: server name
      $channel: channel name
      $nick: nick on server
      ${irc_server.xxx}: variable xxx in server
      ${irc_channel.xxx}: variable xxx in channel

    Examples:
      execute "/me is testing" on all channels:
        /allchan /me is testing
      say "hello" everywhere but not on #weechat:
        /allchan -exclude=#weechat hello
      say "hello" everywhere but not on #weechat and channels beginning with #linux:
        /allchan -exclude=#weechat,#linux* hello
      say "hello" on all channels beginning with #linux:
        /allchan -include=#linux* hello
      close all buffers with parted channels:
        /allchan -parted /close

- `allpv`: execute a command on all private buffers of all connected servers

    /allpv  [-current] [-exclude=<nick>[,<nick>...]] <command>
            [-current] -include=<nick>[,<nick>...] <command>

    -current: execute command for private buffers of current server only
    -exclude: exclude some nicks (wildcard "*" is allowed)
    -include: include only some nicks (wildcard "*" is allowed)
     command: command to execute (or text to send to buffer if command does not start with "/")

    Command and arguments are evaluated (see /help eval), the following variables are replaced:
      $server: server name
      $channel: channel name
      $nick: nick on server
      ${irc_server.xxx}: variable xxx in server
      ${irc_channel.xxx}: variable xxx in channel

    Examples:
      execute "/me is testing" on all private buffers:
        /allpv /me is testing
      say "hello" everywhere but not for nick foo:
        /allpv -exclude=foo hello
      say "hello" everywhere but not for nick foo and nicks beginning with bar:
        /allpv -exclude=foo,bar* hello
      say "hello" for all nicks beginning with bar:
        /allpv -include=bar* hello
      close all private buffers:
        /allpv /close

- `allserv`: execute a command on all connected servers

    /allserv  [-exclude=<server>[,<server>...]] <command>
              -include=<server>[,<server>...] <command>

    -exclude: exclude some servers (wildcard "*" is allowed)
    -include: include only some servers (wildcard "*" is allowed)
     command: command to execute (or text to send to buffer if command does not start with "/")

    Command and arguments are evaluated (see /help eval), the following variables are replaced:
      $server: server name
      $nick: nick on server
      ${irc_server.xxx}: variable xxx in server

    Examples:
      change nick on all servers:
        /allserv /nick newnick
      do a whois on my nick on all servers:
        /allserv /whois $nick

- `auth`: authenticate with SASL

    /auth  [<username> <password>]

    username: SASL username (content is evaluated, see /help eval; server options are evaluated with ${irc_server.xxx} and ${server} is replaced by the server name)
    password: SASL password or path to file with private key (content is evaluated, see /help eval; server options are evaluated with ${irc_server.xxx} and ${server} is replaced by the server name)

    If username and password are not provided, the values from server options "sasl_username" and "sasl_password" (or "sasl_key") are used.

    Examples:
      authenticate with username/password defined in the server:
        /auth
      authenticate as a different user:
        /auth user2 password2
      authenticate as a different user with mechanism ecdsa-nist256p-challenge:
        /auth user2 ${weechat_config_dir}/ecdsa2.pem

- `autojoin`: configure the "autojoin" server option

    /autojoin  add [<channel>...]
               addraw <channel1>[,<channel2>...] [<key1>[,<key2>...]]
               del [<channel>...]
               apply
               join
               sort [buffer]

        add: add current channel or a list of channels (with optional keys) to the autojoin option; if you are on the channel and the key is not provided, the key is read in the channel
     addraw: use the IRC raw format (same as /join command): all channels separated by commas, optional keys separated by commas
        del: delete current channel or a list of channels from the autojoin option
    channel: channel name
        key: key for the channel
      apply: set currently joined channels in the autojoin option
       join: join the channels in the autojoin option
       sort: sort alphabetically channels in the autojoin option; with "buffer": first sort by buffer number, then alphabetically

    Examples:
      /autojoin add
      /autojoin add #test
      /autojoin add #chan1 #chan2
      /allchan /autojoin add
      /autojoin addraw #chan1,#chan2,#chan3 key1,key2
      /autojoin del
      /autojoin del #chan1
      /autojoin apply
      /autojoin join
      /autojoin sort
      /autojoin sort buffer

- `ban`: ban nicks or hosts

    /ban  [<channel>] [<nick>...]

    channel: channel name
       nick: nick or host

    Without argument, this command displays the ban list for current channel.

- `cap`: client capability negotiation

    /cap  ls
          list
          req|ack [<capability>...]
          end

      ls: list the capabilities supported by the server
    list: list the capabilities currently enabled
     req: request a new capability or remove a capability (if starting with "-", for example: "-multi-prefix")
     ack: acknowledge capabilities which require client-side acknowledgement
     end: end the capability negotiation

    Without argument, "ls" and "list" are sent.

    Capabilities supported by WeeChat are: account-notify, account-tag, away-notify, batch, cap-notify, chghost, draft/multiline, echo-message, extended-join, invite-notify, message-tags, multi-prefix, server-time, setname, userhost-in-names.

    The capabilities to automatically enable on servers can be set in option irc.server_default.capabilities (or by server in option irc.server.xxx.capabilities).

    Examples:
      display supported and enabled capabilities:
        /cap
      request capabilities multi-prefix and away-notify:
        /cap req multi-prefix away-notify
      request capability extended-join, remove capability multi-prefix:
        /cap req extended-join -multi-prefix
      remove capability away-notify:
        /cap req -away-notify

- `connect`: connect to IRC server(s)

    /connect  [<server>...] [-<option>[=<value>]] [-no<option>] [-nojoin] [-switch]
              -all|-auto|-open [-nojoin] [-switch]

      server: server name, which can be:
              - internal server name (added by /server add, recommended usage)
              - hostname/port or IP/port, port is 6697 by default for TLS, 6667 otherwise
              - URL with format: irc[6][s]://[nickname[:password]@]irc.example.org[:port][/#channel1][,#channel2[...]]
      option: set option for server (for boolean option, value can be omitted)
    nooption: set boolean option to "off" (for example: -notls)
        -all: connect to all servers defined in configuration
       -auto: connect to servers with autoconnect enabled
       -open: connect to all opened servers that are not currently connected
     -nojoin: do not join any channel (even if autojoin is enabled on server)
     -switch: switch to next server address

    To disconnect from a server or stop any connection attempt, use command /disconnect.

    Examples:
      /connect libera
      /connect irc.oftc.net
      /connect irc.oftc.net/6667 -notls
      /connect irc6.oftc.net/9999 -ipv6=force
      /connect my.server.org -password=test
      /connect irc://nick@irc.oftc.net/#channel
      /connect -switch

- `ctcp`: send a CTCP message (Client-To-Client Protocol)

    /ctcp  [-server <server>] <target>[,<target>...] <type> [<arguments>]

       server: send to this server (internal name)
       target: nick or channel ("*" = current channel)
         type: CTCP type (examples: "version", "ping", etc.)
    arguments: arguments for CTCP

    Examples:
      /ctcp toto time
      /ctcp toto version
      /ctcp * version

- `cycle`: leave and rejoin a channel

    /cycle  [<channel>[,<channel>...]] [<message>]

    channel: channel name
    message: part message (displayed to other users)

- `dcc`: start a DCC (passive file transfer or direct chat)

    /dcc  chat <nick>
          send <nick> <file>

    nick: nick
    file: filename (on local host)

    Examples:
      /dcc chat toto
      /dcc send toto /home/foo/bar.txt

- `dehalfop`: remove channel half-operator status from nick(s)

    /dehalfop  <nick>...
               * -yes

    nick: nick or mask (wildcard "*" is allowed)
       *: remove channel half-operator status from everybody on channel except yourself

- `deop`: remove channel operator status from nick(s)

    /deop  <nick>...
           * -yes

    nick: nick or mask (wildcard "*" is allowed)
       *: remove channel operator status from everybody on channel except yourself

- `devoice`: remove voice from nick(s)

    /devoice  <nick>...
              * -yes

    nick: nick or mask (wildcard "*" is allowed)
       *: remove voice from everybody on channel

- `die`: shutdown the server

    /die  [<target>]

    target: server name

- `disconnect`: disconnect from one or all IRC servers

    /disconnect  [<server>|-all|-pending [<reason>]]

      server: internal server name
        -all: disconnect from all servers
    -pending: cancel auto-reconnection on servers currently reconnecting
      reason: reason for the "quit"

- `halfop`: give channel half-operator status to nick(s)

    /halfop  <nick>...
             * -yes

    nick: nick or mask (wildcard "*" is allowed)
       *: give channel half-operator status to everybody on channel

- `ignore`: ignore nicks/hosts from servers or channels

    /ignore  list
             add|addreplace [re:]<nick> [<server> [<channel>]]
             del <number>|-all

          list: list all ignores
           add: add an ignore
    addreplace: add or replace an existing ignore
          nick: nick or hostname; can be a POSIX extended regular expression if "re:" is given or a mask using "*" to replace zero or more chars (the regular expression can start with "(?-i)" to become case-sensitive)
           del: delete an ignore
        number: number of ignore to delete (look at list to find it)
          -all: delete all ignores
        server: internal server name where ignore is working
       channel: channel name where ignore is working

    Note: if option irc.look.ignore_tag_messages is enabled, the ignored messages are just tagged with "irc_ignored" instead of being completely removed.

    Examples:
      /ignore add toto
      /ignore add toto@domain.com libera
      /ignore add toto*@*.domain.com libera #weechat

- `info`: get information describing the server

    /info  [<target>]

    target: server name

- `invite`: invite a nick on a channel

    /invite  <nick>... [<channel>]

       nick: nick
    channel: channel name

- `ison`: check if a nick is currently on IRC

    /ison  <nick>...

    nick: nick

- `join`: join a channel

    /join  [-noswitch] [-server <server>] [<channel1>[,<channel2>...]] [<key1>[,<key2>...]]

    -noswitch: do not switch to new buffer
       server: send to this server (internal name)
      channel: channel name
          key: key to join the channel (channels with a key must be the first in list)

    Examples:
      /join #weechat
      /join #protectedchan,#weechat key
      /join -server libera #weechat
      /join -noswitch #weechat

- `kick`: kick a user out of a channel

    /kick  [<channel>] <nick> [<reason>]

    channel: channel name
       nick: nick
     reason: reason (evaluated, see /help eval; special variables ${nick} (self nick), ${target} (target nick), ${channel} and ${server} are replaced by their values)

- `kickban`: kick a user out of a channel and ban the host

    /kickban  [<channel>] <nick> [<reason>]

    channel: channel name
       nick: nick
     reason: reason (evaluated, see /help eval; special variables ${nick} (self nick), ${target} (target nick), ${channel} and ${server} are replaced by their values)

    It is possible to kick/ban with a mask, nick will be extracted from mask and replaced by "*".

    Example:
      /kickban toto!*@host.com

- `kill`: close client-server connection

    /kill  <nick> [<reason>]

      nick: nick
    reason: reason

- `knock`: send a notice to an invitation-only channel, requesting an invite

    /knock  <channel> [<message>]

    channel: channel name
    message: message to send

- `links`: list all server names which are known by the server answering the query

    /links  [[<target>] <server_mask>]

         target: this remote server should answer the query
    server_mask: list of servers must match this mask

- `list`: list channels and their topics

    /list  [-server <server>] [<channel>[,<channel>...]] [<target>]
           [-server <server>] [-raw *|<regex>]
           -up|-down [<number>]
           -left|-right [<percent>]
           -go <line>|end
           -join
           -export <filename>

     server: send to this server (internal name)
    channel: channel name
     target: server name
       -raw: display result on server buffer instead of a dedicated buffer
      regex: POSIX extended regular expression used to filter results (case-insensitive, can start by "(?-i)" to become case-sensitive); the special value "*" doesn't filter results
        -up: move the selected line up by "number" lines
      -down: move the selected line down by "number" lines
      -left: scroll the buffer by "percent" of width on the left
     -right: scroll the buffer by "percent" of width on the right
        -go: select a line by number, first line number is 0 ("end" to select the last line)
      -join: join the channel on the selected line
    -export: export list of channels to a file

    For keys, input and mouse actions on the buffer, see key bindings in User's guide.

    Sort keys on /list buffer:
      name: channel name (eg: "##test")
      name2: channel name without prefix (eg: "test")
      users: number of users on channel
      topic: channel topic

    Examples:
      list all channels on server buffer (no dedicated buffer and can be slow on large networks):
        /list -raw *
      list all channels beginning with "#weechat" on server buffer (no dedicated buffer and can be slow on large networks):
        /list -raw #weechat.*
      list all channels on a dedicated buffer (can be slow on large networks):
        /list
      list channel #weechat on a dedicated buffer:
        /list #weechat
      on /list buffer:
        channels with "weechat" in name:
          n:weechat
        channels with at least 100 users:
          u:100
        channels with "freebsd" (case-insensitive) in topic and more than 10 users:
          c:${topic} =- freebsd && ${users} > 10
        sort channels by users (big channels first), then name2 (name without prefix):
          s:-users,name2

- `lusers`: get statistics about the size of the IRC network

    /lusers  [<mask> [<target>]]

      mask: servers matching the mask only
    target: server for forwarding request

- `map`: show a graphical map of the IRC network

- `me`: send a CTCP action to the current channel

    /me  <message>

    message: message to send

- `mode`: change channel or user mode

    /mode  [<channel>] [+|-]o|p|s|i|t|n|m|l|b|e|v|k [<arguments>]
           <nick> [+|-]i|s|w|o

    channel: channel name to modify (default is current one)

    Channel modes:
      o: give/take channel operator privileges
      p: private channel
      s: secret channel
      i: invite-only channel
      t: topic settable by channel operator only
      n: no messages to channel from clients on the outside
      m: moderated channel
      l: set the user limit to channel
      b: set a ban mask to keep users out
      e: set exception mask
      v: give/take the ability to speak on a moderated channel
      k: set a channel key (password)

    User modes:
      nick: nick to modify
      i: invisible
      s: user receives server notices
      w: user receives wallops
      o: operator

    List of modes is not comprehensive, you should read documentation about your server to see all possible modes.

    Examples:
      /mode #weechat +t
      /mode nick +i

- `motd`: get the "Message Of The Day"

    /motd  [<target>]

    target: server name

- `msg`: send message to a nick or channel

    /msg  [-server <server>] <target>[,<target>...] <text>

    server: send to this server (internal name)
    target: nick or channel (may be mask, "*" = current channel)
      text: text to send

- `names`: list nicks on channels

    /names  [-count | -x] [<channel>[,<channel>...]]

     -count: display only number of users
         -x: display only users with this mode: -o for ops, -h for halfops, -v for voiced, etc. and -* for regular users
    channel: channel name

- `nick`: change current nick

    /nick  [-all] <nick>

    -all: set new nick for all connected servers
    nick: new nick

- `notice`: send notice message to user

    /notice  [-server <server>] <target> <text>

    server: send to this server (internal name)
    target: nick or channel name
      text: text to send

- `notify`: add a notification for presence or away status of nicks on servers

    /notify  add|addreplace <nick> [<server> [-away]]
             del <nick>|-all [<server>]

           add: add a notification
    addreplace: add or replace a notification
          nick: nick
        server: internal server name (by default current server)
         -away: notify when away message is changed (by doing whois on nick)
           del: delete a notification
          -all: delete all notifications

    Without argument, this command displays notifications for current server (or all servers if command is issued on core buffer).

    Examples:
      /notify add toto
      /notify add toto libera
      /notify add toto libera -away

- `op`: give channel operator status to nick(s)

    /op  <nick>...
         * -yes

    nick: nick or mask (wildcard "*" is allowed)
       *: give channel operator status to everybody on channel

- `oper`: get operator privileges

    /oper  <user> <password>

        user: user
    password: password

- `part`: leave a channel

    /part  [<channel>[,<channel>...]] [<message>]

    channel: channel name
    message: part message (displayed to other users)

- `ping`: send a ping to server

    /ping  <target1> [<target2>]

    target1: server
    target2: forward ping to this server

- `pong`: answer to a ping message

    /pong  <daemon> [<daemon2>]

     daemon: daemon who has responded to Ping message
    daemon2: forward message to this daemon

- `query`: send a private message to a nick

    /query  [-noswitch] [-server <server>] <nick>[,<nick>...] [<text>]

    -noswitch: do not switch to new buffer
       server: send to this server (internal name)
         nick: nick
         text: text to send

- `quiet`: quiet nicks or hosts

    /quiet  [<channel>] [<nick>...]

    channel: channel name
       nick: nick or host

    Without argument, this command displays the quiet list for current channel.

- `quote`: send raw data to server without parsing

    /quote  [-server <server>] <data>

    server: send to this server (internal name)
      data: raw data to send

- `reconnect`: reconnect to server(s)

    /reconnect  <server>... [-nojoin] [-switch]
                -all [-nojoin] [-switch]

     server: internal server name
       -all: reconnect to all servers
    -nojoin: do not join any channel (even if autojoin is enabled on server)
    -switch: switch to next server address

- `rehash`: tell the server to reload its config file

    /rehash  [<option>]

    option: extra option, for some servers

- `remove`: force a user to leave a channel

    /remove  [<channel>] <nick> [<reason>]

    channel: channel name
       nick: nick
     reason: reason (special variables $nick, $channel and $server are replaced by their values)

- `restart`: tell the server to restart itself

    /restart  [<target>]

    target: server name

- `rules`: request the server rules

- `sajoin`: force a user to join channel(s)

    /sajoin  <nick> <channel>[,<channel>...]

       nick: nick
    channel: channel name

- `samode`: change mode on channel, without having operator status

    /samode  [<channel>] <mode>

    channel: channel name
       mode: mode for channel

- `sanick`: force a user to use another nick

    /sanick  <nick> <new_nick>

        nick: nick
    new_nick: new nick

- `sapart`: force a user to leave channel(s)

    /sapart  <nick> <channel>[,<channel>...]

       nick: nick
    channel: channel name

- `saquit`: force a user to quit server with a reason

    /saquit  <nick> <reason>

      nick: nick
    reason: reason

- `server`: list, add or remove IRC servers

    /server  list|listfull [-connected] [<name>]
             add|addreplace <name> <hostname>[/<port>] [-<option>[=<value>]] [-no<option>]
             copy|rename <name> <new_name>
             reorder <name>...
             open <name>|-all [<name>...]
             del <name>
             deloutq|jump
             raw [<filter>]

          list: list servers (without argument, this list is displayed)
      listfull: list servers with detailed info for each server
    -connected: list only connected servers
           add: add a new server
    addreplace: add or replace an existing server
          name: server name, for internal and display use; this name is used to connect to the server (/connect name) and to set server options: irc.server.name.xxx
      hostname: name or IP address of server, with optional port (default: 6697 for TLS, 6667 otherwise), many addresses can be separated by a comma
        option: set option for server (for boolean option, value can be omitted)
      nooption: set boolean option to "off" (for example: -notls)
          copy: duplicate a server
        rename: rename a server
       reorder: reorder list of servers
          open: open the server buffer without connecting
           del: delete a server
       deloutq: delete messages out queue for all servers (all messages WeeChat is currently sending)
          jump: jump to server buffer
           raw: open buffer with raw IRC data
        filter: set a new filter to see only matching messages (this filter can be used as input in raw IRC data buffer as well); allowed formats are:
                `*`: show all messages (no filter)
                `xxx`: show only messages containing "xxx"
                `s:xxx`: show only messages for server "xxx"
                `f:xxx`: show only messages with a flag: recv (message received), sent (message sent), modified (message modified by a modifier), redirected (message redirected)
                `m:xxx`: show only IRC command "xxx"
                `c:xxx`: show only messages matching the evaluated condition "xxx", using following variables: output of function irc_message_parse (like nick, command, channel, text, etc., see function info_get_hashtable in plugin API reference for the list of all variables), date (format: "%FT%T.%f", see function util_strftimeval in Plugin API reference), server, recv, sent, modified, redirected

    Examples:
      /server listfull
      /server list -connected
      /server add libera irc.libera.chat
      /server add libera irc.libera.chat/6667 -notls -autoconnect
      /server add chatspike irc.chatspike.net/6667,irc.duckspike.net/6667 -notls
      /server copy libera libera-test
      /server rename libera-test libera2
      /server reorder libera2 libera
      /server del libera
      /server deloutq
      /server raw
      /server raw s:libera
      /server raw c:${recv} && ${command}==PRIVMSG && ${nick}==foo

- `service`: register a new service

    /service  <nick> <reserved> <distribution> <type> <reserved> <info>

    distribution: visibility of service
            type: reserved for future usage

- `servlist`: list services currently connected to the network

    /servlist  [<mask> [<type>]]

    mask: list only services matching this mask
    type: list only services of this type

- `setname`: set real name

    /setname  <realname>

    realname: new real name

- `squery`: deliver a message to a service

    /squery  <service> <text>

    service: name of service
       text: text to send

- `squit`: disconnect server links

    /squit  <target> <comment>

     target: server name
    comment: comment

- `stats`: query statistics about server

    /stats  [<query> [<target>]]

     query: c/h/i/k/l/m/o/y/u (see RFC1459)
    target: server name

- `summon`: give users who are on a host running an IRC server a message asking them to please join IRC

    /summon  <user> [<target> [<channel>]]

       user: username
     target: server name
    channel: channel name

- `time`: query local time from server

    /time  [<target>]

    target: query time from specified server

- `topic`: get/set channel topic

    /topic  [<channel>] [<topic>|-delete]

    channel: channel name
      topic: new topic
    -delete: delete channel topic

- `trace`: find the route to specific server

    /trace  [<target>]

    target: server name

- `unban`: unban nicks or hosts

    /unban  [<channel>] <nick>|<number>|<n1>-<n2>...

    channel: channel name
       nick: nick or host
     number: ban number (as displayed by command /ban)
         n1: interval start number
         n2: interval end number

- `unquiet`: unquiet nicks or hosts

    /unquiet  [<channel>] <nick>|<number>|<n1>-<n2>...

    channel: channel name
       nick: nick or host
     number: quiet number (as displayed by command /quiet)
         n1: interval start number
         n2: interval end number

- `userhost`: return a list of information about nicks

    /userhost  <nick>...

    nick: nick

- `users`: list of users logged into the server

    /users  [<target>]

    target: server name

- `version`: give the version info of nick or server (current or specified)

    /version  [<target>|<nick>]

    target: server name
      nick: nick

- `voice`: give voice to nick(s)

    /voice  <nick>...
            * -yes

    nick: nick or mask (wildcard "*" is allowed)
       *: give voice to everybody on channel

- `wallchops`: send a notice to channel ops

    /wallchops  [<channel>] <text>

    channel: channel name
       text: text to send

- `wallops`: send a message to all currently connected users who have set the "w" user mode for themselves

    /wallops  <text>

    text: text to send

- `who`: generate a query which returns a list of information

    /who  [<mask> [o]]

    mask: only information which match this mask
       o: only operators are returned according to the mask supplied

- `whois`: query information about user(s)

    /whois  [<target>] [<nick>[,<nick>...]]

    target: server name
      nick: nick (may be a mask)

    Without argument, this command will do a whois on:
      - your own nick if buffer is a server/channel
      - remote nick if buffer is a private.

    If option irc.network.whois_double_nick is enabled, two nicks are sent (if only one nick is given), to get idle time in answer.

- `whowas`: ask for information about a nick which no longer exists

    /whowas  <nick>[,<nick>...] [<count> [<target>]]

      nick: nick
     count: number of replies to return (full search if negative number)
    target: reply should match this mask

### 8.10. Opcje

Sekcje w pliku irc.conf:

Sekcja | Komenda | Opis
--- | --- | ---
`look` | `/set irc.look.*` | Wygląd.
`color` | `/set irc.color.*` | Kolory.
`network` | `/set irc.network.*` | Opcje sieci.
`msgbuffer` | `/set irc.msgbuffer.*` | Bufor dla wiadomości IRC (opcje w tej sekcji mogą być dodawane/usuwane).
`ctcp` | `/set irc.ctcp.*` | Odpowiedzi CTCP (opcje w tej sekcji mogą być dodawane/usuwane).
`ignore` | `/ignore` | Osoby ignorowane.
`server_default` | `/set irc.server_default.*` | Domyślne ustawienia dla serwerów (opcje w tej sekcji mogą być dodawane/usuwane).
`server` | `/server /set irc.server.*` | Serwery.

Opcje:

- irc.color.input_nick

  - description: color for nick in input bar

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `lightcyan`

- irc.color.item_lag_counting

  - description: color for lag indicator, when counting (pong not received from server, lag is increasing)

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `default`

- irc.color.item_lag_finished

  - description: color for lag indicator, when pong has been received from server

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `yellow`

- irc.color.item_nick_modes

  - description: color for nick modes in bar item "input_prompt"

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `default`

- irc.color.item_tls_version_deprecated

  - description: color for deprecated TLS versions in bar item "tls_version"

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `yellow`

- irc.color.item_tls_version_insecure

  - description: color for insecure TLS versions in bar item "tls_version"

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `red`

- irc.color.item_tls_version_ok

  - description: color for higher supported TLS version in bar item "tls_version"

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `green`

- irc.color.list_buffer_line_selected

  - description: color for selected line on /list buffer

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `white`

- irc.color.list_buffer_line_selected_bg

  - description: background color for selected line on /list buffer

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `24`

- irc.color.message_account

  - description: color for text in account messages

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `cyan`

- irc.color.message_chghost

  - description: color for text in "chghost" messages

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `brown`

- irc.color.message_join

  - description: color for text in join messages

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `green`

- irc.color.message_kick

  - description: color for text in kick/kill messages

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `red`

- irc.color.message_quit

  - description: color for text in part/quit messages

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `red`

- irc.color.message_setname

  - description: color for text in "setname" messages

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `brown`

- irc.color.mirc_remap

  - description: remap mirc colors in messages using a hashtable (used only for standard colors, not RGB colors): keys are "fg,bg" as integers between -1 (not specified) and 15, values are WeeChat color names or numbers (format is: "1,-1:color1;2,7:color2"), example: "1,-1:darkgray;1,2:white,blue" to remap black to "darkgray" and black on blue to "white,blue"; default WeeChat colors for IRC codes: 0=white, 1=black, 2=blue, 3=green, 4=lightred, 5=red, 6=magenta, 7=brown, 8=yellow, 9=lightgreen, 10=cyan, 11=lightcyan, 12=lightblue, 13=lightmagenta, 14=darkgray, 15=gray

  - type: string

  - values: any string

  - default value: `"1,-1:darkgray"`

- irc.color.nick_prefixes

  - description: color for nick prefixes using mode char (o=op, h=halfop, v=voice, ..), format is: "o:color1;h:color2;v:color3" (if a mode is not found, WeeChat will try with next modes received from server ("PREFIX"); a special mode "*" can be used as default color if no mode has been found in list)

  - type: string

  - values: any string

  - default value: `"y:lightred;q:lightred;a:lightcyan;o:lightgreen;h:lightmagenta;v:yellow;*:lightblue"`

- irc.color.notice

  - description: color for text "Notice" in notices

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `green`

- irc.color.reason_kick

  - description: color for reason in kick/kill messages

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `default`

- irc.color.reason_quit

  - description: color for reason in part/quit messages

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `244`

- irc.color.term_remap

  - description: remap terminal color numbers in messages using a hashtable (used only for RGB colors as hexadecimal, which are first translated to terminal color numbers): keys are "fg,bg" as integers between -1 (not specified) and 255, values are WeeChat color names or numbers (format is: "1,-1:color1;2,7:color2"), example: "0,-1:darkgray;0,90:white,blue" to remap black to "darkgray" and black on dark magenta to "white,blue"

  - type: string

  - values: any string

  - default value: `"0,-1:darkgray"`

- irc.color.topic_current

  - description: color for current channel topic (when joining a channel or using /topic)

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `default`

- irc.color.topic_new

  - description: color for new channel topic (when topic is changed)

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `36`

- irc.color.topic_old

  - description: color for old channel topic (when topic is changed)

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `244`

- irc.ctcp.clientinfo

  - description: format for CTCP reply or empty string for blocking CTCP (no reply); content is evaluated, see /help eval; following variables are replaced: ${clientinfo}: list of supported CTCP, ${version}: WeeChat version, ${git}: Git version, ${versiongit}: WeeChat version and Git version, ${compilation}: compilation date, ${osinfo}: info about OS, ${site}: WeeChat site, ${download}: WeeChat site, download page, ${time}: current date and time as text, ${username}: username on server, ${realname}: realname on server

  - type: string

  - values: any string

  - default value: `"${clientinfo}"`

- irc.ctcp.source

  - description: format for CTCP reply or empty string for blocking CTCP (no reply); content is evaluated, see /help eval; following variables are replaced: ${clientinfo}: list of supported CTCP, ${version}: WeeChat version, ${git}: Git version, ${versiongit}: WeeChat version and Git version, ${compilation}: compilation date, ${osinfo}: info about OS, ${site}: WeeChat site, ${download}: WeeChat site, download page, ${time}: current date and time as text, ${username}: username on server, ${realname}: realname on server

  - type: string

  - values: any string

  - default value: `"${download}"`

- irc.ctcp.time

  - description: format for CTCP reply or empty string for blocking CTCP (no reply); content is evaluated, see /help eval; following variables are replaced: ${clientinfo}: list of supported CTCP, ${version}: WeeChat version, ${git}: Git version, ${versiongit}: WeeChat version and Git version, ${compilation}: compilation date, ${osinfo}: info about OS, ${site}: WeeChat site, ${download}: WeeChat site, download page, ${time}: current date and time as text, ${username}: username on server, ${realname}: realname on server

  - type: string

  - values: any string

  - default value: `"${time}"`

- irc.ctcp.version

  - description: format for CTCP reply or empty string for blocking CTCP (no reply); content is evaluated, see /help eval; following variables are replaced: ${clientinfo}: list of supported CTCP, ${version}: WeeChat version, ${git}: Git version, ${versiongit}: WeeChat version and Git version, ${compilation}: compilation date, ${osinfo}: info about OS, ${site}: WeeChat site, ${download}: WeeChat site, download page, ${time}: current date and time as text, ${username}: username on server, ${realname}: realname on server

  - type: string

  - values: any string

  - default value: `"WeeChat ${version}"`

- irc.look.buffer_open_before_autojoin

  - description: open channel buffer before the JOIN is received from server when it is auto joined (with server option "autojoin"); this is useful to open channels with always the same buffer numbers on startup

  - type: boolean

  - values: on, off

  - default value: `on`

- irc.look.buffer_open_before_join

  - description: open channel buffer before the JOIN is received from server when it is manually joined (with /join command)

  - type: boolean

  - values: on, off

  - default value: `off`

- irc.look.buffer_switch_autojoin

  - description: auto switch to channel buffer when it is auto joined (with server option "autojoin")

  - type: boolean

  - values: on, off

  - default value: `on`

- irc.look.buffer_switch_join

  - description: auto switch to channel buffer when it is manually joined (with /join command)

  - type: boolean

  - values: on, off

  - default value: `on`

- irc.look.color_nicks_in_names

  - description: use nick color in output of /names (or list of nicks displayed when joining a channel)

  - type: boolean

  - values: on, off

  - default value: `off`

- irc.look.color_nicks_in_nicklist

  - description: use nick color in nicklist

  - type: boolean

  - values: on, off

  - default value: `off`

- irc.look.color_nicks_in_server_messages

  - description: use nick color in messages from server

  - type: boolean

  - values: on, off

  - default value: `on`

- irc.look.color_pv_nick_like_channel

  - description: use same nick color for channel and private

  - type: boolean

  - values: on, off

  - default value: `on`

- irc.look.ctcp_time_format

  - description: time format used in answer to message CTCP TIME (see man strftime for date/time specifiers, extra specifiers are supported, see function util_strftimeval in Plugin API reference)

  - type: string

  - values: any string

  - default value: `"%a, %d %b %Y %T %z"`

- irc.look.display_account_message

  - description: display ACCOUNT messages received when capability account-notify is enabled

  - type: boolean

  - values: on, off

  - default value: `on`

- irc.look.display_away

  - description: display message when (un)marking as away (off: do not display/send anything, local: display locally, channel: send action to channels)

  - type: enum

  - values: off, local, channel

  - default value: `local`

- irc.look.display_ctcp_blocked

  - description: display CTCP message even if it is blocked

  - type: boolean

  - values: on, off

  - default value: `on`

- irc.look.display_ctcp_reply

  - description: display CTCP reply sent by WeeChat

  - type: boolean

  - values: on, off

  - default value: `on`

- irc.look.display_ctcp_unknown

  - description: display CTCP message even if it is unknown CTCP

  - type: boolean

  - values: on, off

  - default value: `on`

- irc.look.display_extended_join

  - description: display extra information in the JOIN messages: account name and real name (capability extended-join must be enabled)

  - type: boolean

  - values: on, off

  - default value: `on`

- irc.look.display_host_join

  - description: display host in join messages

  - type: boolean

  - values: on, off

  - default value: `on`

- irc.look.display_host_join_local

  - description: display host in join messages from local client

  - type: boolean

  - values: on, off

  - default value: `on`

- irc.look.display_host_notice

  - description: display host in notice messages

  - type: boolean

  - values: on, off

  - default value: `on`

- irc.look.display_host_quit

  - description: display host in part/quit messages

  - type: boolean

  - values: on, off

  - default value: `on`

- irc.look.display_host_wallops

  - description: display host in wallops messages

  - type: boolean

  - values: on, off

  - default value: `on`

- irc.look.display_join_message

  - description: comma-separated list of messages to display after joining a channel: 324 = channel modes, 329 = channel creation date, 332 = topic, 333 = nick/date for topic, 353 = names on channel, 366 = names count

  - type: string

  - values: any string

  - default value: `"329,332,333,366"`

- irc.look.display_old_topic

  - description: display old topic when channel topic is changed

  - type: boolean

  - values: on, off

  - default value: `on`

- irc.look.display_pv_away_once

  - description: display remote away message only once in private

  - type: boolean

  - values: on, off

  - default value: `on`

- irc.look.display_pv_back

  - description: display a message in private when user is back (after quit on server)

  - type: boolean

  - values: on, off

  - default value: `on`

- irc.look.display_pv_nick_change

  - description: display nick change in private

  - type: boolean

  - values: on, off

  - default value: `on`

- irc.look.display_pv_warning_address

  - description: display a warning in private buffer if the address of remote nick has changed; this option is disabled by default because servers like bitlbee are causing this warning to be displayed when it is not expected (the address of remote nick changes multiple times on login)

  - type: boolean

  - values: on, off

  - default value: `off`

- irc.look.highlight_channel

  - description: comma separated list of words to highlight in channel buffers (case-insensitive, use "(?-i)" at beginning of words to make them case-sensitive; special variables $nick, $channel and $server are replaced by their values), these words are added to buffer property "highlight_words" only when buffer is created (it does not affect current buffers), an empty string disables default highlight on nick, examples: "$nick", "(?-i)$nick"

  - type: string

  - values: any string

  - default value: `"$nick"`

- irc.look.highlight_pv

  - description: comma separated list of words to highlight in private buffers (case-insensitive, use "(?-i)" at beginning of words to make them case-sensitive; special variables $nick, $channel and $server are replaced by their values), these words are added to buffer property "highlight_words" only when buffer is created (it does not affect current buffers), an empty string disables default highlight on nick, examples: "$nick", "(?-i)$nick"

  - type: string

  - values: any string

  - default value: `"$nick"`

- irc.look.highlight_server

  - description: comma separated list of words to highlight in server buffers (case-insensitive, use "(?-i)" at beginning of words to make them case-sensitive; special variables $nick, $channel and $server are replaced by their values), these words are added to buffer property "highlight_words" only when buffer is created (it does not affect current buffers), an empty string disables default highlight on nick, examples: "$nick", "(?-i)$nick"

  - type: string

  - values: any string

  - default value: `"$nick"`

- irc.look.highlight_tags_restrict

  - description: restrict highlights to these tags on irc buffers (to have highlight on user messages but not server messages); tags must be separated by a comma and "+" can be used to make a logical "and" between tags; wildcard "*" is allowed in tags; an empty value allows highlight on any tag

  - type: string

  - values: any string

  - default value: `"irc_privmsg,irc_notice"`

- irc.look.ignore_tag_messages

  - description: add tag "irc_ignored" in ignored messages instead of removing them; that way messages can be filtered with /filter command and toggled on-demand

  - type: boolean

  - values: on, off

  - default value: `off`

- irc.look.item_channel_modes_hide_args

  - description: hide channel modes arguments if at least one of these modes is in channel modes ("*" to always hide all arguments, empty value to never hide arguments); example: "kf" to hide arguments if "k" or "f" are in channel modes

  - type: string

  - values: any string

  - default value: `"k"`

- irc.look.item_display_server

  - description: name of bar item where IRC server is displayed (for status bar)

  - type: enum

  - values: buffer_plugin, buffer_name

  - default value: `buffer_plugin`

- irc.look.item_nick_modes

  - description: display nick modes in bar item "input_prompt"

  - type: boolean

  - values: on, off

  - default value: `on`

- irc.look.item_nick_prefix

  - description: display nick prefix in bar item "input_prompt"

  - type: boolean

  - values: on, off

  - default value: `on`

- irc.look.join_auto_add_chantype

  - description: automatically add channel type in front of channel name on command /join if the channel name does not start with a valid channel type for the server; for example: "/join weechat" will in fact send: "/join #weechat"

  - type: boolean

  - values: on, off

  - default value: `off`

- irc.look.list_buffer

  - description: use a dedicated buffer for the output of /list

  - type: boolean

  - values: on, off

  - default value: `on`

- irc.look.list_buffer_format_export

  - description: format of each channel exported in a file (note: content is evaluated, see /help list)

  - type: string

  - values: any string

  - default value: `"${name} (${users}): \"${topic}\""`

- irc.look.list_buffer_scroll_horizontal

  - description: left/right scroll in /list buffer (percent of width)

  - type: integer

  - values: 1 .. 100

  - default value: `10`

- irc.look.list_buffer_sort

  - description: comma-separated list of fields to sort channels (see /help list for a list of fields); char "-" can be used before field to reverse order, char "~" can be used to do a case-insensitive comparison; example: "-count,~name" for biggest channels first then case-insensitive sort on name

  - type: string

  - values: any string

  - default value: `"~name2"`

- irc.look.list_buffer_topic_strip_colors

  - description: strip channel topic colors in /list buffer

  - type: boolean

  - values: on, off

  - default value: `on`

- irc.look.msgbuffer_fallback

  - description: default target buffer for msgbuffer options when target is private and that private buffer is not found

  - type: enum

  - values: current, server

  - default value: `current`

- irc.look.new_channel_position

  - description: force position of new channel in list of buffers (none = default position (should be last buffer), next = current buffer + 1, near_server = after last channel/pv of server)

  - type: enum

  - values: none, next, near_server

  - default value: `none`

- irc.look.new_list_position

  - description: force position of new /list buffer in list of buffers (none = default position (should be last buffer), next = current buffer + 1, near_server = after last channel/pv of server)

  - type: enum

  - values: none, next, near_server

  - default value: `none`

- irc.look.new_pv_position

  - description: force position of new private in list of buffers (none = default position (should be last buffer), next = current buffer + 1, near_server = after last channel/pv of server)

  - type: enum

  - values: none, next, near_server

  - default value: `none`

- irc.look.nick_completion_smart

  - description: smart completion for nicks (completes first with last speakers): speakers = all speakers (including highlights), speakers_highlights = only speakers with highlight

  - type: enum

  - values: off, speakers, speakers_highlights

  - default value: `speakers`

- irc.look.nick_mode

  - description: display nick mode (op, voice, ...) before nick (none = never, prefix = in prefix only (default), action = in action messages only, both = prefix + action messages)

  - type: enum

  - values: none, prefix, action, both

  - default value: `prefix`

- irc.look.nick_mode_empty

  - description: display a space if nick mode is enabled but nick has no mode (not op, voice, ...)

  - type: boolean

  - values: on, off

  - default value: `off`

- irc.look.nicks_hide_password

  - description: comma separated list of nicks for which passwords will be hidden when a message is sent, for example to hide password in message displayed by "/msg nickserv identify password", example: "nickserv,nickbot"

  - type: string

  - values: any string

  - default value: `"nickserv"`

- irc.look.notice_as_pv

  - description: display notices as private messages (if auto, use private buffer if found)

  - type: enum

  - values: auto, never, always

  - default value: `auto`

- irc.look.notice_nicks_disable_notify

  - description: comma separated list of nicks for which notifications are disabled in notice messages (comparison is case-insensitive)

  - type: string

  - values: any string

  - default value: `"chanserv,nickserv"`

- irc.look.notice_welcome_redirect

  - description: automatically redirect channel welcome notices to the channel buffer; such notices have the nick as target but a channel name in beginning of notice message, for example the ENTRYMSG notices sent by Atheme IRC Services which look like: "[#channel] Welcome to this channel..."

  - type: boolean

  - values: on, off

  - default value: `on`

- irc.look.notice_welcome_tags

  - description: comma separated list of tags used in a welcome notices redirected to a channel, for example: "notify_private"

  - type: string

  - values: any string

  - default value: `""`

- irc.look.notify_tags_ison

  - description: comma separated list of tags used in messages displayed by notify when a nick joins or quits server (result of command ison or monitor), for example: "notify_message", "notify_private" or "notify_highlight"

  - type: string

  - values: any string

  - default value: `"notify_message"`

- irc.look.notify_tags_whois

  - description: comma separated list of tags used in messages displayed by notify when a nick away status changes (result of command whois), for example: "notify_message", "notify_private" or "notify_highlight"

  - type: string

  - values: any string

  - default value: `"notify_message"`

- irc.look.open_pv_buffer_echo_msg

  - description: open a private buffer on self message when capability echo-message is enabled

  - type: boolean

  - values: on, off

  - default value: `on`

- irc.look.part_closes_buffer

  - description: close buffer when /part is issued on a channel

  - type: boolean

  - values: on, off

  - default value: `off`

- irc.look.pv_buffer

  - description: merge private buffers

  - type: enum

  - values: independent, merge_by_server, merge_all

  - default value: `independent`

- irc.look.pv_tags

  - description: comma separated list of tags used in private messages, for example: "notify_message", "notify_private" or "notify_highlight"

  - type: string

  - values: any string

  - default value: `"notify_private"`

- irc.look.raw_messages

  - description: number of raw messages to save in memory when raw data buffer is closed (messages will be displayed when opening raw data buffer)

  - type: integer

  - values: 0 .. 65535

  - default value: `256`

- irc.look.server_buffer

  - description: merge server buffers; this option has no effect if a layout is saved and is conflicting with this value (see /help layout)

  - type: enum

  - values: merge_with_core, merge_without_core, independent

  - default value: `merge_with_core`

- irc.look.smart_filter

  - description: filter join/part/quit/nick messages for a nick if not speaking for some minutes on channel (you must create a filter on tag "irc_smart_filter", see /help filter)

  - type: boolean

  - values: on, off

  - default value: `on`

- irc.look.smart_filter_account

  - description: enable smart filter for "account" messages

  - type: boolean

  - values: on, off

  - default value: `on`

- irc.look.smart_filter_chghost

  - description: enable smart filter for "chghost" messages

  - type: boolean

  - values: on, off

  - default value: `on`

- irc.look.smart_filter_delay

  - description: delay for filtering join/part/quit messages (in minutes): if the nick did not speak during the last N minutes, the join/part/quit is filtered

  - type: integer

  - values: 1 .. 10080

  - default value: `5`

- irc.look.smart_filter_join

  - description: enable smart filter for "join" messages

  - type: boolean

  - values: on, off

  - default value: `on`

- irc.look.smart_filter_join_unmask

  - description: delay for unmasking a join message that was filtered with tag "irc_smart_filter" (in minutes): if a nick has joined max N minutes ago and then says something on channel (message, notice or update on topic), the join is unmasked, as well as nick changes after this join (0 = disable: never unmask a join)

  - type: integer

  - values: 0 .. 10080

  - default value: `30`

- irc.look.smart_filter_mode

  - description: enable smart filter for "mode" messages: "*" to filter all modes, "+" to filter all modes in server prefixes (for example "ovh"), "xyz" to filter only modes x/y/z, "-xyz" to filter all modes but not x/y/z; examples: "ovh": filter modes o/v/h, "-bkl": filter all modes but not b/k/l

  - type: string

  - values: any string

  - default value: `""+`

- irc.look.smart_filter_nick

  - description: enable smart filter for "nick" messages (nick changes)

  - type: boolean

  - values: on, off

  - default value: `on`

- irc.look.smart_filter_quit

  - description: enable smart filter for "part" and "quit" messages

  - type: boolean

  - values: on, off

  - default value: `on`

- irc.look.smart_filter_setname

  - description: enable smart filter for "setname" messages

  - type: boolean

  - values: on, off

  - default value: `on`

- irc.look.topic_strip_colors

  - description: strip colors in topic (used only when displaying buffer title)

  - type: boolean

  - values: on, off

  - default value: `off`

- irc.look.typing_status_nicks

  - description: display nicks typing on the channel in bar item "typing" (option typing.look.enabled_nicks must be enabled and capability "message-tags" must be enabled on the server)

  - type: boolean

  - values: on, off

  - default value: `off`

- irc.look.typing_status_self

  - description: send self typing status to channels so that other users see when you are typing a message (option typing.look.enabled_self must be enabled and capability "message-tags" must be enabled on the server)

  - type: boolean

  - values: on, off

  - default value: `off`

- irc.network.autoreconnect_delay_growing

  - description: growing factor for autoreconnect delay to server (1 = always same delay, 2 = delay*2 for each retry, etc.)

  - type: integer

  - values: 1 .. 100

  - default value: `2`

- irc.network.autoreconnect_delay_max

  - description: maximum autoreconnect delay to server (in seconds, 0 = no maximum)

  - type: integer

  - values: 0 .. 604800

  - default value: `600`

- irc.network.ban_mask_default

  - description: default ban mask for commands /ban, /unban and /kickban; variables $nick, $user, $ident and $host are replaced by their values (extracted from "nick!user@host"); $ident is the same as $user if $user does not start with "~", otherwise it is set to "*"; this default mask is used only if WeeChat knows the host for the nick

  - type: string

  - values: any string

  - default value: `"*!$ident@$host"`

- irc.network.colors_receive

  - description: when off, colors codes are ignored in incoming messages

  - type: boolean

  - values: on, off

  - default value: `on`

- irc.network.colors_send

  - description: allow user to send colors with special codes (ctrl-c + a code and optional color: b=bold, cxx=color, cxx,yy=color+background, i=italic, o=disable color/attributes, r=reverse, u=underline)

  - type: boolean

  - values: on, off

  - default value: `on`

- irc.network.lag_check

  - description: interval between two checks for lag (in seconds, 0 = never check)

  - type: integer

  - values: 0 .. 604800

  - default value: `60`

- irc.network.lag_max

  - description: maximum lag (in seconds): if this lag is reached, WeeChat will consider that the answer from server (pong) will never be received and will give up counting the lag (0 = never give up)

  - type: integer

  - values: 0 .. 604800

  - default value: `1800`

- irc.network.lag_min_show

  - description: minimum lag to show (in milliseconds)

  - type: integer

  - values: 0 .. 86400000

  - default value: `500`

- irc.network.lag_reconnect

  - description: reconnect to server if lag is greater than or equal to this value (in seconds, 0 = never reconnect); this value must be less than or equal to irc.network.lag_max

  - type: integer

  - values: 0 .. 604800

  - default value: `300`

- irc.network.lag_refresh_interval

  - description: interval between two refreshes of lag item, when lag is increasing (in seconds)

  - type: integer

  - values: 1 .. 3600

  - default value: `1`

- irc.network.notify_check_ison

  - description: interval between two checks for notify with IRC command "ison" (in minutes)

  - type: integer

  - values: 1 .. 10080

  - default value: `1`

- irc.network.notify_check_whois

  - description: interval between two checks for notify with IRC command "whois" (in minutes)

  - type: integer

  - values: 1 .. 10080

  - default value: `5`

- irc.network.sasl_fail_unavailable

  - description: cause SASL authentication failure when SASL is requested but unavailable on the server; when this option is enabled, it has effect only if option "sasl_fail" is set to "reconnect" or "disconnect" in the server

  - type: boolean

  - values: on, off

  - default value: `on`

- irc.network.send_unknown_commands

  - description: send unknown commands to server

  - type: boolean

  - values: on, off

  - default value: `off`

- irc.network.whois_double_nick

  - description: double the nick in /whois command (if only one nick is given), to get idle time in answer; for example: "/whois nick" will send "whois nick nick"

  - type: boolean

  - values: on, off

  - default value: `off`

- irc.server_default.addresses

  - description: list of hostname/port or IP/port for server (separated by comma) (note: content is evaluated, see /help eval; server options are evaluated with ${irc_server.xxx} and ${server} is replaced by the server name)

  - type: string

  - values: any string

  - default value: `""`

- irc.server_default.anti_flood

  - description: delay in milliseconds between two messages sent to server (anti-flood protection); 0 = disable protection and always send messages immediately (not recommended because the server can close the connection if you send several messages in a short time); internally there are queues with different priorities: when connecting to the server all messages are sent immediately and your messages have higher priority than some automatic messages that are sent in background by WeeChat

  - type: integer

  - values: 0 .. 60000

  - default value: `2000`

- irc.server_default.autoconnect

  - description: automatically connect to server when WeeChat is starting

  - type: boolean

  - values: on, off

  - default value: `off`

- irc.server_default.autojoin

  - description: comma separated list of channels to join after connection to server (and after executing command + delay if they are set); the channels that require a key must be at beginning of the list, and all the keys must be given after the channels (separated by a space) (example: "#channel1,#channel2,#channel3 key1,key2" where #channel1 and #channel2 are protected by key1 and key2) (note: content is evaluated, see /help eval; server options are evaluated with ${irc_server.xxx} and ${server} is replaced by the server name)

  - type: string

  - values: any string

  - default value: `""`

- irc.server_default.autojoin_delay

  - description: delay (in seconds) before auto-join of channels (example: give some time for authentication before joining channels)

  - type: integer

  - values: 0 .. 3600

  - default value: `0`

- irc.server_default.autojoin_dynamic

  - description: set automatically the "autojoin" option according to the channels you manually join and part with commands /join and /part

  - type: boolean

  - values: on, off

  - default value: `off`

- irc.server_default.autoreconnect

  - description: automatically reconnect to server when disconnected

  - type: boolean

  - values: on, off

  - default value: `on`

- irc.server_default.autoreconnect_delay

  - description: delay (in seconds) before trying again to reconnect to server

  - type: integer

  - values: 1 .. 65535

  - default value: `10`

- irc.server_default.autorejoin

  - description: automatically rejoin channels after kick; you can define a buffer local variable on a channel to override this value (name of variable: "autorejoin", value: "on" or "off")

  - type: boolean

  - values: on, off

  - default value: `off`

- irc.server_default.autorejoin_delay

  - description: delay (in seconds) before autorejoin (after kick)

  - type: integer

  - values: 0 .. 86400

  - default value: `30`

- irc.server_default.away_check

  - description: interval between two checks for away (in minutes, 0 = never check)

  - type: integer

  - values: 0 .. 10080

  - default value: `0`

- irc.server_default.away_check_max_nicks

  - description: do not check away nicks on channels with high number of nicks (0 = unlimited)

  - type: integer

  - values: 0 .. 1000000

  - default value: `25`

- irc.server_default.capabilities

  - description: comma-separated list of client capabilities to enable for server if they are available (see /help cap for a list of capabilities supported by WeeChat); "*" enables all capabilities by default (supported by both server and WeeChat); wildcard "*" is allowed; a capability beginning with "!" is excluded (example: "*,!account-*,!extended-join")

  - type: string

  - values: any string

  - default value: `"*"`

- irc.server_default.charset_message

  - description: part of the IRC message (received or sent) which is decoded/encoded to the target charset; message = the whole IRC message (default), channel = starting from the channel name only (if found, with fallback on text), text = starting from the text only (you should try this value if you have issues with the channel name encoding)

  - type: enum

  - values: message, channel, text

  - default value: `message`

- irc.server_default.command

  - description: command(s) to run after connection to server and before auto-join of channels (many commands can be separated by ";", use "\;" for a semicolon, special variables $nick, $channel and $server are replaced by their values) (note: commands are evaluated, see /help eval; server options are evaluated with ${irc_server.xxx} and ${server} is replaced by the server name)

  - type: string

  - values: any string

  - default value: `""`

- irc.server_default.command_delay

  - description: delay (in seconds) before execution of command

  - type: integer

  - values: 0 .. 3600

  - default value: `0`

- irc.server_default.connection_timeout

  - description: timeout (in seconds) between TCP connection to server and message 001 received, if this timeout is reached before 001 message is received, WeeChat will disconnect from server

  - type: integer

  - values: 1 .. 3600

  - default value: `60`

- irc.server_default.default_chantypes

  - description: channel type prefixes to use if the server does not send them in message 005 (default is "#&")

  - type: string

  - values: any string

  - default value: `"#&"`

- irc.server_default.ipv6

  - description: use IPv6 protocol for server communication

  - type: enum

  - values: disable, auto, force

  - default value: `auto`

- irc.server_default.local_hostname

  - description: custom local hostname/IP for server (optional, if empty local hostname is used)

  - type: string

  - values: any string

  - default value: `""`

- irc.server_default.msg_kick

  - description: default kick message used by commands "/kick" and "/kickban" (note: content is evaluated, see /help eval; special variables ${nick} (self nick), ${target} (target nick), ${channel} and ${server} are replaced by their values)

  - type: string

  - values: any string

  - default value: `""`

- irc.server_default.msg_part

  - description: default part message (leaving channel) (note: content is evaluated, see /help eval; special variables ${nick}, ${channel} and ${server} are replaced by their values; "%v" is replaced by WeeChat version if there is no ${...} in string)

  - type: string

  - values: any string

  - default value: `"WeeChat ${info:version}"`

- irc.server_default.msg_quit

  - description: default quit message (disconnecting from server) (note: content is evaluated, see /help eval; special variables ${nick}, ${channel} and ${server} are replaced by their values; "%v" is replaced by WeeChat version if there is no ${...} in string)

  - type: string

  - values: any string

  - default value: `"WeeChat ${info:version}"`

- irc.server_default.nicks

  - description: nicknames to use on server (separated by comma) (note: content is evaluated, see /help eval; ${username} is replaced by system username (fallback to "weechat" if not found), server options are evaluated with ${irc_server.xxx} and ${server} is replaced by the server name)

  - type: string

  - values: any string

  - default value: `"${username},${username}2,${username}3,${username}4,${username}5"`

- irc.server_default.nicks_alternate

  - description: get an alternate nick when all the declared nicks are already used on server: add some "_" until the nick has a length of 9, and then replace last char (or the two last chars) by a number from 1 to 99, until we find a nick not used on server

  - type: boolean

  - values: on, off

  - default value: `on`

- irc.server_default.notify

  - description: notify list for server (you should not change this option but use /notify command instead)

  - type: string

  - values: any string

  - default value: `""`

- irc.server_default.password

  - description: password for server (note: content is evaluated, see /help eval; server options are evaluated with ${irc_server.xxx} and ${server} is replaced by the server name)

  - type: string

  - values: any string

  - default value: `""`

- irc.server_default.proxy

  - description: name of proxy used for this server (optional, proxy must be defined with command /proxy)

  - type: string

  - values: any string

  - default value: `""`

- irc.server_default.realname

  - description: real name to use on server (note: content is evaluated, see /help eval; server options are evaluated with ${irc_server.xxx} and ${server} is replaced by the server name)

  - type: string

  - values: any string

  - default value: `""`

- irc.server_default.registered_mode

  - description: mode that is set on registered users (default is "r")

  - type: string

  - values: any string

  - default value: `"r"`

- irc.server_default.sasl_fail

  - description: action to perform if SASL authentication fails: "continue" to ignore the authentication problem, "reconnect" to schedule a reconnection to the server, "disconnect" to disconnect from server (see also option irc.network.sasl_fail_unavailable)

  - type: enum

  - values: continue, reconnect, disconnect

  - default value: `reconnect`

- irc.server_default.sasl_key

  - description: file with ECC private key for mechanism "ecdsa-nist256p-challenge" (path is evaluated, see function string_eval_path_home in plugin API reference)

  - type: string

  - values: any string

  - default value: `""`

- irc.server_default.sasl_mechanism

  - description: mechanism for SASL authentication: "plain" for plain text password, "scram-sha-1" for SCRAM authentication with SHA-1 digest algorithm, "scram-sha-256" for SCRAM authentication with SHA-256 digest algorithm, "scram-sha-512" for SCRAM authentication with SHA-512 digest algorithm, "ecdsa-nist256p-challenge" for key-based challenge authentication, "external" for authentication using client side TLS certificate

  - type: enum

  - values: plain, scram-sha-1, scram-sha-256, scram-sha-512, ecdsa-nist256p-challenge, external

  - default value: `plain`

- irc.server_default.sasl_password

  - description: password for SASL authentication; this option is not used for mechanisms "ecdsa-nist256p-challenge" and "external" (note: content is evaluated, see /help eval; server options are evaluated with ${irc_server.xxx} and ${server} is replaced by the server name)

  - type: string

  - values: any string

  - default value: `""`

- irc.server_default.sasl_timeout

  - description: timeout (in seconds) before giving up SASL authentication

  - type: integer

  - values: 1 .. 3600

  - default value: `15`

- irc.server_default.sasl_username

  - description: username for SASL authentication; this option is not used for mechanism "external" (note: content is evaluated, see /help eval; server options are evaluated with ${irc_server.xxx} and ${server} is replaced by the server name)

  - type: string

  - values: any string

  - default value: `""`

- irc.server_default.split_msg_max_length

  - description: split outgoing IRC messages to fit in this number of chars; the default value is 512, this is a safe and recommended value; value 0 disables the split (not recommended, unless you know what you do); allowed values are 0 or any integer between 128 and 4096; this option should be changed only on non-standard IRC servers, for example gateways like bitlbee

  - type: integer

  - values: 0 .. 4096

  - default value: `512`

- irc.server_default.tls

  - description: use TLS for server communication

  - type: boolean

  - values: on, off

  - default value: `on`

- irc.server_default.tls_cert

  - description: TLS certificate file used to automatically identify your nick (path is evaluated, see function string_eval_path_home in plugin API reference)

  - type: string

  - values: any string

  - default value: `""`

- irc.server_default.tls_dhkey_size

  - description: size of the key used during the Diffie-Hellman Key Exchange

  - type: integer

  - values: 0 .. 2147483647

  - default value: `2048`

- irc.server_default.tls_fingerprint

  - description: fingerprint of certificate which is trusted and accepted for the server; only hexadecimal digits are allowed (0-9, a-f): 128 chars for SHA-512, 64 chars for SHA-256, 40 chars for SHA-1 (insecure, not recommended); many fingerprints can be separated by commas; if this option is set, the other checks on certificates are NOT performed (option "tls_verify") (note: content is evaluated, see /help eval; server options are evaluated with ${irc_server.xxx} and ${server} is replaced by the server name)

  - type: string

  - values: any string

  - default value: `""`

- irc.server_default.tls_password

  - description: password for TLS certificate's private key; only used with gnutls version >= 3.1.0 (note: content is evaluated, see /help eval; server options are evaluated with ${irc_server.xxx} and ${server} is replaced by the server name)

  - type: string

  - values: any string

  - default value: `""`

- irc.server_default.tls_priorities

  - description: string with priorities for gnutls (for syntax, see documentation of function gnutls_priority_init in gnutls manual, common strings are: "PERFORMANCE", "NORMAL", "SECURE128", "SECURE256", "EXPORT", "NONE")

  - type: string

  - values: any string

  - default value: `"NORMAL"`

- irc.server_default.tls_verify

  - description: check that the TLS connection is fully trusted

  - type: boolean

  - values: on, off

  - default value: `on`

- irc.server_default.usermode

  - description: user mode(s) to set after connection to server and before executing command and the auto-join of channels; examples: "+R" (to set mode "R"), "+R-i" (to set mode "R" and remove "i"); see /help mode for the complete mode syntax (note: content is evaluated, see /help eval; server options are evaluated with ${irc_server.xxx} and ${server} is replaced by the server name)

  - type: string

  - values: any string

  - default value: `""`

- irc.server_default.username

  - description: user name to use on server (note: content is evaluated, see /help eval; ${username} is replaced by system username (fallback to "weechat" if not found), server options are evaluated with ${irc_server.xxx} and ${server} is replaced by the server name)

  - type: string

  - values: any string

  - default value: `"${username}"`

## 9. Xfer

Wtyczka xfer zapewnia:

- bezpośrednią rozmowę (pomiędzy dwoma hostami, bez serwera): na przykład "DCC Chat" przez wtyczkę IRC

- transfer plików, na przykład "DCC" przez wtyczkę IRC

### 9.1. Komendy

- `me`: send a CTCP action to remote host

    /me  <message>

    message: message to send

- `xfer`: xfer control

    /xfer  [list|listfull]

        list: list xfer
    listfull: list xfer (verbose)

    Without argument, this command opens buffer with xfer list.

### 9.2. Opcje

Sekcje w pliku xfer.conf:

Sekcja | Komenda | Opis
--- | --- | ---
`look` | `/set xfer.look.*` | Wygląd.
`color` | `/set xfer.color.*` | Kolory.
`network` | `/set xfer.network.*` | Opcje sieci.
`file` | `/set xfer.file.*` | Opcje dla plików odbieranych/wysyłanych.

Opcje:

- xfer.color.status_aborted

  - description: text color for "aborted" status

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `lightred`

- xfer.color.status_active

  - description: text color for "active" status

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `lightblue`

- xfer.color.status_connecting

  - description: text color for "connecting" status

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `yellow`

- xfer.color.status_done

  - description: text color for "done" status

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `lightgreen`

- xfer.color.status_failed

  - description: text color for "failed" status

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `lightred`

- xfer.color.status_waiting

  - description: text color for "waiting" status

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `lightcyan`

- xfer.color.text

  - description: text color in xfer buffer

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `default`

- xfer.color.text_bg

  - description: background color in xfer buffer

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `default`

- xfer.color.text_selected

  - description: text color of selected line in xfer buffer

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `white`

- xfer.file.auto_accept_chats

  - description: automatically accept chat requests (use carefully!)

  - type: boolean

  - values: on, off

  - default value: `off`

- xfer.file.auto_accept_files

  - description: automatically accept incoming files (use carefully!)

  - type: boolean

  - values: on, off

  - default value: `off`

- xfer.file.auto_accept_nicks

  - description: comma-separated list of nicks for which the incoming files and chats are automatically accepted; format is "server.nick" (for a specific server) or "nick" (for all servers); example: "libera.FlashCode,andrew"

  - type: string

  - values: any string

  - default value: `""`

- xfer.file.auto_check_crc32

  - description: automatically check CRC32 file checksum if it is found in the filename (8 hexadecimal chars)

  - type: boolean

  - values: on, off

  - default value: `off`

- xfer.file.auto_rename

  - description: rename incoming files if already exists (add ".1", ".2", ...)

  - type: boolean

  - values: on, off

  - default value: `on`

- xfer.file.auto_resume

  - description: automatically resume file transfer if connection with remote host is lost

  - type: boolean

  - values: on, off

  - default value: `on`

- xfer.file.convert_spaces

  - description: convert spaces to underscores when sending and receiving files

  - type: boolean

  - values: on, off

  - default value: `on`

- xfer.file.download_path

  - description: path for writing incoming files (path is evaluated, see function string_eval_path_home in plugin API reference)

  - type: string

  - values: any string

  - default value: `"${weechat_data_dir}/xfer"`

- xfer.file.download_temporary_suffix

  - description: temporary filename suffix used during the transfer for a file received, it is removed after successful transfer; if empty string, no filename suffix is used during the transfer

  - type: string

  - values: any string

  - default value: `".part"`

- xfer.file.upload_path

  - description: path for reading files when sending (path is evaluated, see function string_eval_path_home in plugin API reference)

  - type: string

  - values: any string

  - default value: `"~"`

- xfer.file.use_nick_in_filename

  - description: use remote nick as prefix in local filename when receiving a file

  - type: boolean

  - values: on, off

  - default value: `on`

- xfer.look.auto_open_buffer

  - description: auto open xfer buffer when a new xfer is added to list

  - type: boolean

  - values: on, off

  - default value: `on`

- xfer.look.progress_bar_size

  - description: size of progress bar, in chars (if 0, progress bar is disabled)

  - type: integer

  - values: 0 .. 256

  - default value: `20`

- xfer.look.pv_tags

  - description: comma separated list of tags used in private messages, for example: "notify_message", "notify_private" or "notify_highlight"

  - type: string

  - values: any string

  - default value: `"notify_private"`

- xfer.network.blocksize

  - description: block size for sending packets, in bytes

  - type: integer

  - values: 1024 .. 102400

  - default value: `65536`

- xfer.network.fast_send

  - description: does not wait for ACK when sending file

  - type: boolean

  - values: on, off

  - default value: `on`

- xfer.network.own_ip

  - description: IP or DNS address used for sending and passively receiving files/chats (if empty, local interface IP is used)

  - type: string

  - values: any string

  - default value: `""`

- xfer.network.port_range

  - description: restricts outgoing files/chats and incoming/passive files to use only ports in the given range (useful for NAT) (syntax: a single port, ie. 5000 or a port range, ie. 5000-5015, empty value means any port, it's recommended to use ports greater than 1024, because only root can use ports below 1024)

  - type: string

  - values: any string

  - default value: `""`

- xfer.network.send_ack

  - description: send acks when receiving files; if disabled, the transfer may freeze if the sender is waiting for acks (for example a WeeChat sending a file with option xfer.network.fast_send set to off); on the other hand, disabling send of acks may prevent a freeze if the acks are not sent immediately to the sender

  - type: boolean

  - values: on, off

  - default value: `on`

- xfer.network.speed_limit_recv

  - description: speed limit for receiving files, in kilo-bytes by second (0 means no limit)

  - type: integer

  - values: 0 .. 2147483647

  - default value: `0`

- xfer.network.speed_limit_send

  - description: speed limit for sending files, in kilo-bytes by second (0 means no limit)

  - type: integer

  - values: 0 .. 2147483647

  - default value: `0`

- xfer.network.timeout

  - description: timeout for xfer request (in seconds)

  - type: integer

  - values: 5 .. 2147483647

  - default value: `300`

## 10. Powiadomienia o pisaniu

Wtyczka typing jest używana do informowania innych że coś piszesz oraz pokazaniu listy osób piszących obecnie wiadomości w buforze.

Jest używana przez wtyczkę IRC na kanałach i w prywatnych buforach, kiedy serwer posiada włączoną opcję "message-tags" (możesz to sprawdzić komendą /cap).
Pod spodem użyty jest tag klienta, zgodnie z tą specyfikacją ↗.

### 10.1. Aktywacja

W trosce o prywatność, opcja ta jest domyślnie wyłączona.
Jeśli chcesz ją włączyć, musisz ustawić opcje zarówno we wtyczce typing jak i irc:

    /set typing.look.enabled_nicks on
    /set typing.look.enabled_self on
    /set irc.look.typing_status_nicks on
    /set irc.look.typing_status_self on

Powiadomienia o pisaniu są wyświetlane na końcu pasku statusu.

Przykład paska statusu z elementem "typing": "bob" pisze wiadomość, natomiast "alice" pisała coś ale zrobiła sobie przerwę:

    │[12:55] [6] [irc/libera] 3:#test(+n){4} [Typing: bob, (alice)]                   │
    │[@Flashy] █                                                                      │
    └─────────────────────────────────────────────────────────────────────────────────┘

### 10.2. Wysyłane sygnały

Kiedy piszesz wiadomość (ale nie polecenie zaczynające się od `/`) ta wtyczka wysyła sygnały informujące inne wtyczki (jak IRC) o tym że piszesz, te wtyczki mogą następnie wysłać informacje do innych użytkowników.

Następujące sygnały są wysyłane, kiedy piszesz wiadomość:

Sygnał | Argumenty | Opis
--- | --- | ---
typing_self_typing | Wskaźnik: bufor. | Piszesz wiadomość.
typing_self_paused | Wskaźnik: bufor. | Przestałeś pisać wiadomość.
typing_self_cleared | Wskaźnik: bufor. | Skasowałeś pisaną wiadomość z lini poleceń (bez wysłania).
typing_self_sent | Wskaźnik: bufor. | Wysłałeś wiadomość do bufora.

### 10.3. Przechwytywane sygnały

Wtyczka typing przechwyytuje niektóre sygnały, które mogą być wysłane przez inne wtyczki (jak IRC) do aktualizacji wewnętrznych tablicy hashy używanych do przechowywania stanu nicków i buforów. Te tablice są używane do budowania zawartości elementu paska "typing".

Następujące sygnały są przechwytywane przez wtyczke typing:

Sygnal | Argumenty | Opis
--- | --- | ---
typing_set_nick | Ciąg: wskaźnik bufora + ";" + stan (jeden z: "off", "typing", "paused", "cleared") + ";" + nick. Przykład: "0x1234abcd;typing;alice". | Ustawia stan pisania dla nicka w buforze.
typing_reset_buffer | Wskaźnik: bufor. | Usuwa status pisania dla nicków w buforze.

### 10.4. Opcje

Sekcje w pliku typing.conf:

Sekcja | Komenda | Opis
--- | --- | ---
`look` | `/set typing.look.*` | Wygląd.

Opcje:

- typing.look.delay_purge_paused

  - description: number of seconds after paused status has been set: if reached, the typing status is removed

  - type: integer

  - values: 1 .. 2147483647

  - default value: `30`

- typing.look.delay_purge_typing

  - description: number of seconds after typing status has been set: if reached, the typing status is removed

  - type: integer

  - values: 1 .. 2147483647

  - default value: `6`

- typing.look.delay_set_paused

  - description: number of seconds after typing last char: if reached, the typing status becomes "paused" and no more typing signals are sent

  - type: integer

  - values: 1 .. 2147483647

  - default value: `10`

- typing.look.enabled_nicks

  - description: typing enabled for other nicks (display typing info for nicks typing in the current buffer)

  - type: boolean

  - values: on, off

  - default value: `off`

- typing.look.enabled_self

  - description: typing enabled for self messages (send typing info to other users)

  - type: boolean

  - values: on, off

  - default value: `off`

- typing.look.input_min_chars

  - description: min number of chars in message to trigger send of typing signals

  - type: integer

  - values: 1 .. 2147483647

  - default value: `4`

- typing.look.item_max_length

  - description: max number of chars displayed in the bar item "typing" (0 = do not truncate content)

  - type: integer

  - values: 0 .. 2147483647

  - default value: `0`

## 11. Relay

Wtyczka relay jest używana do przekazywania danych przez sieć, z użyciem różnych protokołów:

- irc: pośrednik IRC: używany do dzielenia połączeń z serwerami IRC z jednym lub wieloma klientami IRC

- api: HTTP REST API, używane przez WeeChat i zdalne interfejsy do wyświetlania i interakcji z WeeChat

- weechat: protokół używany przez zdalne interfejsy do wyświetlania i interakcji z WeeChat.

Listę dostępnych zdalnych interfejsów dla protokołów api i weechat można znaleźć na tej stronie ↗.

### 11.1. Hasło

Zaleca się ustawenia hasła dla pośrednika za pomocą poniższych komend:

    /secure set relay moje_hasło
    /set relay.network.password "${sec.data.relay}"

To hasło jest używane przez wszystkie protokoły.

### 11.2. TOTP

TOTP (Time-based One-Time Password) może być użyte jako drugi składnik uwierzytelniania dla protokołów api i weechat, poza samym hasłem.

Jest to opcjomalne ale podnosi to poziom bezpieczeństwa. This is optional and increases the security level.

Hasła jednorazowe mogą być generowane między innymi za pomocą:

- FreeOTP: Android ↗, iOS ↗ (website ↗)

- Google Authenticator: Android ↗, iOS ↗

Ten sam sekret TOTP musi być utawiony w WeeChat i aplikacji używanej do generowania haseł.

Musi to być ciąg zakodowany za pomocą base32, zawierajcy tylko litery i liczby od 2 do 7, na przykład:

    /secure set relay_totp secretpasswordbase32
    /set relay.network.totp_secret "${sec.data.relay_totp}"

### 11.3. TLS

Możesz używać TLS poprzez utworzenie certyfikatu i klucza prywatnego, oraz użycie prefiksu "tls." w nazwie protokołu.

Domyślna ścieżka do certyfikatów/kluczy jest zdefiniowana przez opcję relay.network.tls_cert_key.

Możesz utworzyć certyfikat i klucz prywatny wykonując poniższe komendy:

    mkdir -p ~/.config/weechat/tls
    cd ~/.config/weechat/tls
    openssl req -nodes -newkey rsa:2048 -keyout relay.pem -x509 -days 365 -out relay.pem

Notka | Musisz zamienić `~/.config/weechat` na ścieżkę do katalogu z konfiguracją WeeChat, który może być ustawiony na przykład na `~/.weechat`.

Jeśli WeeChat jest już uruchomiony, możesz przładować certyfikat i klucz prywatny za pomocą polecenia:

    /relay tlscertkey

### 11.4. IRC proxy

Wtyczka relay może zachowywać się jak proxy dla IRC: będzie symulować serwer IRC, możesz się połączyć do niego za pomocą dowolnego klienta IRC (w tym WeeChat).

Możesz zdefiniować oddzielne porty dla serwerów IRC, lub jeden dla wszystkich.

Jeśli używasz jednego portu dla wszystkich serwerów, klient musi wysłać wewnętrzną nazwę serwera w komendzie IRC "PASS", zachowując format (zobacz poniższy przykład):

    PASS serwer:hasło

Przykład: proxy IRC z TLS dla dowolnego serwera (klient wybiera):

    /relay add tls.irc 8000

Przykład: proxy IRC bez TLS tylko dla serwera "libera":

    /relay add irc.libera 8000

Teraz możesz się połączyć na porcie 8000 za pomocą dowolnego klienta IRC używając hasła serwera "moje_hasło" (lub "libera:moje_hasło" jeśli żaden serwer nie został podany w przekaźniku).

Na przydład jeśli używasz WeeChat jako klienta pośrednika IRC, z serwerem nazwanym "relay" i hasłem pośrednika "moje_hasło", możesz ustawić hasło za pomocą tych komend:

    /secure set relay_libera libera:moje_hasło
    /set irc.server.relay.password "{sec.data.relay_libera}"

### 11.5. Protokół API

Wtyczka Relay może wysyłać dane do zdalnego WeeChat lub interfejsu za pomocą protokołu HTTP REST API.

Możesz przeglądać i testować API online: WeeChat Relay API ↗.

Możesz się połączyć przez WeeChat lub zdalnym interfejsem, sprawdź tą stronę ↗.

Na przykład:

    /relay add api 9000

Możesz teraz połączyć się na porcie 9000 używając WeeChat lub zdalnym interfejsem używając hasła 'mypassword'.

Połączenie z pośrednikiem api działającym lokalnie z WeeChat:

    /remote add weechat http://localhost:9000 -password=mypassword
    /remote connect weechat

Połączenie z pośrednikiem api działającym gdzieś z WeeChat (TLS jest baredzo zalecany):

    /remote add weechat https://example.com:9000 -password=mypassword
    /remote connect weechat

Notka | Zdalny WeeChat musi używać tej samej wersji API co lokalny WeeChat, zaleca się używanie dokładnie tych samych wersji WeeChat zarówno lokalnie jak i na zdalnej maszynie.

### 11.6. Protokół WeeChat

Wtyczka relay może wysyłać dane do zdalnego interfejsu korzystając z protokołu WeeChat.

Możesz się łączyć za pomocą zdalnych interfejsów, więcej na tej stronie ↗.

Ważne | WeeChat NIE MOŻE się połączyć z innym WeeChat za pomocą tego protokołu.

Na przykład:

    /relay add weechat 9500

Teraz możesz się połączyć zdalnym interfejsem na porcie 9500 za pomocą hasła "moje_hasło".

### 11.7. WebSocket

Protokół WebSocket (RFC 6455 ↗) jest wspierany dla wszystkich protokołów.

Żądanie WebSocket jest automatycznie wykrywane i socket staje się gotowy do transmisji WebSocket jeśli wymagane nagłówki znajdują się w żądaniu oraz, gdy źródło jest dopuszczone (zobacz opcję relay.network.websocket_allowed_origins).

WebSocket może zostać otworzony w HTML5 za pomocą jednej linii w JavaScript:

    websocket = new WebSocket("ws://example.com:9500/weechat");

Port (9500 w przykładzie) to port zdefiniowany we wtyczce relay.

URI musi się kończyć "/weechat" dla protokołów irc i weechat oraz "/api" dla protokołu api.

### 11.8. Sockety UNIXowe

Używając opcji protokołu "unix" razem z komendą `/relay`, można nasłuchiwać dowolnego protokołu za pomocą socketu UNIXowego w podanej ścieżce. Na przykład:

    /relay add unix.weechat ${weechat_runtime_dir}/relay_socket

Pozwala to na połączenia od klientów za pomocą protokołu weechat do /run/user/1000/weechat/relay_socket. Jest to przydatne zwłaszcza jeśli chcemy tunelować klienty przez SSH, w przypadku, kiedy inne porty nie moga być otwierane.

Za pomocą OpenSSH:

    ssh -L 9000:.weechat/relay_socket user@hostname

Przekerowuje to połączenia lokalnych klientów łączących się na port 9000 do intancji WeeChat uruchomionej na "hostname".

### 11.9. Komendy

- `relay`: relay control

    /relay  list|listfull|listrelay
            add|addreplace <name> <port>|<path>
            del|start|restart|stop <name>
            raw
            tlscertkey

          list: list relay clients (only active relays)
      listfull: list relay clients (verbose, all relays)
     listrelay: list relays (name and port)
           add: add a relay (listen on a port/path)
    addreplace: add or replace an existing relay
           del: remove a relay (clients remain connected)
         start: listen on port
       restart: close the server socket and listen again on port (clients remain connected)
          stop: close the server socket (clients remain connected)
          name: relay name (see format below)
          port: port used for relay
          path: path used for relay (for UNIX domain socket only); path is evaluated (see function string_eval_path_home in plugin API reference)
           raw: open buffer with raw Relay data
    tlscertkey: set TLS certificate/key using path in option relay.network.tls_cert_key

    Relay name is: [ipv4.][ipv6.][tls.]<protocol.name> or unix.[tls.]<protocol.name>:
      - ipv4: force use of IPv4
      - ipv6: force use of IPv6
      - tls: enable TLS
      - unix: use UNIX domain socket
      - protocol.name: protocol and name to relay:
        - protocol "irc": name is the server to share (optional, if not given, the server name must be sent by client in command "PASS", with format: "PASS server:password")
        - protocol "api" (name is not used)
        - protocol "weechat" (name is not used)

    The "irc" protocol allows any IRC client (including WeeChat itself) to connect on the port.
    The "api" protocol allows a remote interface (including WeeChat itself) to connect on the port.
    The "weechat" protocol allows a remote interface (but not WeeChat itself) to connect on the port.

    The list of remote interfaces is here: https://weechat.org/about/interfaces/

    Without argument, this command opens buffer with list of relay clients.

    Examples:
      /relay add irc.libera 8000
      /relay add tls.irc.libera 8001
      /relay add tls.irc 8002
      /relay add tls.api 9000
      /relay add weechat 10000
      /relay add tls.weechat 10001
      /relay add ipv4.tls.weechat 10001
      /relay add ipv6.tls.weechat 10001
      /relay add ipv4.ipv6.tls.weechat 10001
      /relay add unix.weechat ${weechat_runtime_dir}/relay_socket

- `remote`: control of remote relay servers

    /remote  list|listfull [<name>]
             add|addreplace <name> <url> [-<option>[=<value>]]
             connect|reconnect|disconnect|del <name>
             send <name> <json>
             rename <name> <new_name>
             togglecmd

          list: list remote relay servers (without argument, this list is displayed)
      listfull: list remote relay servers (verbose)
           add: add a remote relay server
    addreplace: add or replace an existing remote relay server
          name: name of remote relay server, for internal and display use; this name is used to connect to the remote relay and to set remote relay options: relay.remote.name.xxx
           url: URL of the remote relay, format is https://example.com:9000 or http://example.com:9000 (plain-text connection, not recommended)
        option: set option for remote relay
       connect: connect to a remote relay server
     reconnect: reconnect to a remote relay server
    disconnect: disconnect from a remote relay server
           del: delete a remote relay server
          send: send JSON data to a remote relay server
        rename: rename a remote relay server
     togglecmd: toggle execution of commands on a remote buffer: on the remote WeeChat or locally (default key: alt+ctrl+l)

    Examples:
      /remote add example https://localhost:9000 -password=my_secret_password -totp_secret=secrettotp
      /remote connect example
      /remote disconnect example
      /remote del example

### 11.10. Opcje

Sekcje w pliku relay.conf:

Sekcja | Komenda | Opis
--- | --- | ---
`look` | `/set relay.look.*` | Wygląd.
`color` | `/set relay.color.*` | Kolory.
`network` | `/set relay.network.*` | Opcje sieci.
`irc` | `/set relay.irc.*` | Opcje specyficzne dla protokołu irc (pośrednik irc).
`port` | `/relay add /set relay.port.*` | Porty używane do przekazywania (opcje w tej sekcji mogą być dodawane/usuwane).

Opcje:

- relay.api.remote_autoreconnect_delay_growing

  - description: growing factor for autoreconnect delay to remote relay (1 = always same delay, 2 = delay*2 for each retry, etc.)

  - type: integer

  - values: 1 .. 100

  - default value: `2`

- relay.api.remote_autoreconnect_delay_max

  - description: maximum autoreconnect delay to remote relay (in seconds, 0 = no maximum)

  - type: integer

  - values: 0 .. 604800

  - default value: `600`

- relay.api.remote_get_lines

  - description: number of lines to retrieve on each buffer when connecting to a remote relay

  - type: integer

  - values: 0 .. 2147483647

  - default value: `1000`

- relay.api.remote_input_cmd_local

  - description: text displayed after user input when the command would be executed locally (NOT sent to the remote WeeChat) (note: content is evaluated, see /help eval)

  - type: string

  - values: any string

  - default value: `" ${color:green}<local cmd>"`

- relay.api.remote_input_cmd_remote

  - description: text displayed after user input when the command would be executed on the remote WeeChat (NOT executed locally) (note: content is evaluated, see /help eval)

  - type: string

  - values: any string

  - default value: `" ${color:red}<remote cmd>"`

- relay.color.client

  - description: text color for client description

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `cyan`

- relay.color.status_active

  - description: text color for "connected" status

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `green`

- relay.color.status_auth_failed

  - description: text color for "authentication failed" status

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `lightmagenta`

- relay.color.status_authenticating

  - description: text color for "authenticating" status

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `yellow`

- relay.color.status_connecting

  - description: text color for "connecting" status

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `white`

- relay.color.status_disconnected

  - description: text color for "disconnected" status

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `lightred`

- relay.color.text

  - description: text color in relay buffer

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `default`

- relay.color.text_bg

  - description: background color in relay buffer

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `default`

- relay.color.text_selected

  - description: text color of selected line in relay buffer

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `white`

- relay.irc.backlog_max_minutes

  - description: maximum number of minutes in backlog per IRC channel (0 = unlimited, examples: 1440 = one day, 10080 = one week, 43200 = one month, 525600 = one year)

  - type: integer

  - values: 0 .. 2147483647

  - default value: `0`

- relay.irc.backlog_max_number

  - description: maximum number of lines in backlog per IRC channel (0 = unlimited)

  - type: integer

  - values: 0 .. 2147483647

  - default value: `1024`

- relay.irc.backlog_since_last_disconnect

  - description: display backlog starting from last client disconnect

  - type: boolean

  - values: on, off

  - default value: `on`

- relay.irc.backlog_since_last_message

  - description: display backlog starting from your last message

  - type: boolean

  - values: on, off

  - default value: `off`

- relay.irc.backlog_tags

  - description: comma-separated list of messages tags which are displayed in backlog per IRC channel (supported tags: "irc_join", "irc_part", "irc_quit", "irc_nick", "irc_privmsg"), "*" = all supported tags

  - type: string

  - values: any string

  - default value: `"irc_privmsg"`

- relay.irc.backlog_time_format

  - description: format for time in backlog messages (see man strftime for format) (not used if server capability "server-time" was enabled by client, because time is sent as irc tag); empty string = disable time in backlog messages

  - type: string

  - values: any string

  - default value: `"[%H:%M] "`

- relay.look.auto_open_buffer

  - description: auto open relay buffer when a new client is connecting using one of these protocols (comma-separated list); allowed protocols: "api", "irc", "weechat"

  - type: string

  - values: any string

  - default value: `"irc,weechat"`

- relay.look.display_clients

  - description: display messages when clients connect/disconnect from relay using one of these protocols (comma-separated list); allowed protocols: "api", "irc", "weechat"

  - type: string

  - values: any string

  - default value: `"irc,weechat"`

- relay.look.raw_messages

  - description: number of raw messages to save in memory when raw data buffer is closed (messages will be displayed when opening raw data buffer)

  - type: integer

  - values: 0 .. 65535

  - default value: `256`

- relay.look.raw_messages_max_length

  - description: max number of chars to display in raw messages (very long messages can cause slowness); 0 = display whole messages

  - type: integer

  - values: 0 .. 2147483647

  - default value: `4096`

- relay.network.allow_empty_password

  - description: allow empty password in relay (it should be enabled only for tests or local network)

  - type: boolean

  - values: on, off

  - default value: `off`

- relay.network.allowed_ips

  - description: POSIX extended regular expression with IPs allowed to use relay (case-insensitive, use "(?-i)" at beginning to make it case-sensitive), example: "^(123\.45\.67\.89|192\.160\..*)$"

  - type: string

  - values: any string

  - default value: `""`

- relay.network.auth_timeout

  - description: timeout (in seconds) for client authentication: connection is closed if the client is still not authenticated after this delay and the client status is set to "authentication failed" (0 = wait forever)

  - type: integer

  - values: 0 .. 2147483647

  - default value: `60`

- relay.network.bind_address

  - description: address for bind (if empty, connection is possible on all interfaces, use "127.0.0.1" to allow connections from local machine only with IPv4 and "::ffff:127.0.0.1" with IPv6)

  - type: string

  - values: any string

  - default value: `""`

- relay.network.clients_purge_delay

  - description: delay for purging disconnected clients (in minutes, 0 = purge clients immediately, -1 = never purge)

  - type: integer

  - values: -1 .. 43200

  - default value: `0`

- relay.network.commands

  - description: comma-separated list of commands allowed/denied when input data (text or command) is received from a client ("api" and "weechat" protocols); "*" means any command, a name beginning with "!" is a negative value to prevent a command from being executed, wildcard "*" is allowed in names; this option should be set if the relay client is not safe (someone could use it to run commands); for example "*,!exec,!quit" allows any command except /exec and /quit

  - type: string

  - values: any string

  - default value: `"*,!quit"`

- relay.network.compression

  - description: compression of messages sent to clients with "api" and "weechat" protocols: 0 = disable compression, 1 = low compression / fast ... 100 = best compression / slow; the value is a percentage converted to 1-9 for zlib and 1-19 for zstd; the default value is recommended, it offers a good compromise between compression and speed

  - type: integer

  - values: 0 .. 100

  - default value: `20`

- relay.network.ipv6

  - description: listen on IPv6 socket by default (in addition to IPv4 which is default); protocols IPv4 and IPv6 can be forced (individually or together) in the protocol name (see /help relay)

  - type: boolean

  - values: on, off

  - default value: `on`

- relay.network.max_clients

  - description: maximum number of clients connecting to a port (0 = no limit)

  - type: integer

  - values: 0 .. 2147483647

  - default value: `5`

- relay.network.nonce_size

  - description: size of nonce (in bytes), generated when a client connects; the client must use this nonce, concatenated to the client nonce and the password when hashing the password in the "init" command of the weechat protocol

  - type: integer

  - values: 8 .. 128

  - default value: `16`

- relay.network.password

  - description: password required by clients to access this relay (empty value means no password required, see option relay.network.allow_empty_password) (note: content is evaluated, see /help eval)

  - type: string

  - values: any string

  - default value: `""`

- relay.network.password_hash_algo

  - description: comma separated list of hash algorithms used for password authentication in weechat protocol, among these values: "plain" (password in plain text, not hashed), "sha256", "sha512", "pbkdf2+sha256", "pbkdf2+sha512"), "*" means all algorithms, a name beginning with "!" is a negative value to prevent an algorithm from being used, wildcard "*" is allowed in names (examples: "*", "pbkdf2*", "*,!plain")

  - type: string

  - values: any string

  - default value: `"*"`

- relay.network.password_hash_iterations

  - description: number of iterations asked to the client in weechat protocol when a hashed password with algorithm PBKDF2 is used for authentication; more iterations is better in term of security but is slower to compute; this number should not be too high if your CPU is slow

  - type: integer

  - values: 1 .. 1000000

  - default value: `100000`

- relay.network.time_window

  - description: number of seconds to allow before and after the current time for the hash of time + password in "api" protocol

  - type: integer

  - values: 0 .. 256

  - default value: `5`

- relay.network.tls_cert_key

  - description: file with TLS certificate and private key (for serving clients with TLS) (path is evaluated, see function string_eval_path_home in plugin API reference)

  - type: string

  - values: any string

  - default value: `"${weechat_config_dir}/tls/relay.pem"`

- relay.network.tls_priorities

  - description: string with priorities for gnutls (for syntax, see documentation of function gnutls_priority_init in gnutls manual, common strings are: "PERFORMANCE", "NORMAL", "SECURE128", "SECURE256", "EXPORT", "NONE")

  - type: string

  - values: any string

  - default value: `"NORMAL"`

- relay.network.totp_secret

  - description: secret for the generation of the Time-based One-Time Password (TOTP), encoded in base32 (only letters and digits from 2 to 7); it is used as second factor in "api" and "weechat" protocols, in addition to the password, which must not be empty (empty value means no TOTP is required) (note: content is evaluated, see /help eval)

  - type: string

  - values: any string

  - default value: `""`

- relay.network.totp_window

  - description: number of Time-based One-Time Passwords to accept before and after the current one: 0 = accept only the current password, 1 = accept one password before, the current, and one after, 2 = accept two passwords before, the current, and two after, ...; a high number reduces the security level (0 or 1 are recommended values)

  - type: integer

  - values: 0 .. 256

  - default value: `0`

- relay.network.websocket_allowed_origins

  - description: POSIX extended regular expression with origins allowed in websockets (case-insensitive, use "(?-i)" at beginning to make it case-sensitive), example: "^https?://(www\.)?example\.(com|org)"

  - type: string

  - values: any string

  - default value: `""`

- relay.network.websocket_permessage_deflate

  - description: enable websocket extension "permessage-deflate" to compress websocket frames ("api" protocol only); if disabled, WeeChat (as server) will not enable permessage-deflate even if the client supports it, and when connecting to a remote WeeChat (api relay only), permessage-deflate support is not advertised by WeeChat; it is recommended to keep this option enabled, and you should disable it only if you have troubles with this extension, either with WeeChat or the client

  - type: boolean

  - values: on, off

  - default value: `on`

## 12. Zewnętrzne polecenia

Komenda `/exec` pozwala wykonać zewnętrzne polecenie wewnątrz WeeChat i wyświetlić jej wynik lokalnie lub wysłać do bufora.

### 12.1. Komendy

- `exec`: execute external commands

    /exec  -list
           [-sh|-nosh] [-bg|-nobg] [-stdin|-nostdin] [-buffer <name>] [-l|-o|-oc|-n|-nf] [-oerr] [-cl|-nocl] [-sw|-nosw] [-ln|-noln] [-flush|-noflush] [-color ansi|auto|irc|weechat|strip] [-rc|-norc] [-timeout <timeout>] [-name <name>] [-pipe <command>] [-hsignal <name>] <command>
           -in <id> <text>
           -inclose <id> [<text>]
           -signal <id> <signal>
           -kill <id>
           -killall
           -set <id> <property> <value>
           -del <id>|-all [<id>...]

       -list: list commands
         -sh: use the shell to execute the command, many commands can be piped (WARNING: use this option ONLY if all arguments are safe, see option -nosh)
       -nosh: do not use the shell to execute the command (required if the command has some unsafe data, for example the content of a message from another user) (default)
         -bg: run process in background: do not display process output neither return code (not compatible with options -o/-oc/-n/-nf/-pipe/-hsignal)
       -nobg: catch process output and display return code (default)
      -stdin: create a pipe for sending data to the process (with /exec -in/-inclose)
    -nostdin: do not create a pipe for stdin (default)
     -buffer: display/send output of command on this buffer (if the buffer is not found, a new buffer with name "exec.exec.xxx" is created)
          -l: display locally output of command on buffer (default)
          -o: send output of command to the buffer without executing commands (not compatible with options -bg/-pipe/-hsignal)
         -oc: send output of command to the buffer and execute commands (lines starting with "/" or another custom command char) (not compatible with options -bg/-pipe/-hsignal)
          -n: display output of command in a new buffer (not compatible with options -bg/-pipe/-hsignal)
         -nf: display output of command in a new buffer with free content (no word-wrap, no limit on number of lines) (not compatible with options -bg/-pipe/-hsignal)
       -oerr: also send stderr (error output) to the buffer (can be used only with options -o and -oc)
         -cl: clear the new buffer before displaying output
       -nocl: append to the new buffer without clear (default)
         -sw: switch to the output buffer (default)
       -nosw: don't switch to the output buffer
         -ln: display line numbers (default in new buffer only)
       -noln: don't display line numbers
      -flush: display output of command in real time (default)
    -noflush: display output of command after its end
      -color: action on ANSI colors in output:
              ansi: keep ANSI codes as-is
              auto: convert ANSI colors to WeeChat/IRC (default)
              irc: convert ANSI colors to IRC colors
              weechat: convert ANSI colors to WeeChat colors
              strip: remove ANSI colors
         -rc: display return code (default)
       -norc: don't display return code
    -timeout: set a timeout for the command (in seconds)
       -name: set a name for the command (to name it later with /exec)
       -pipe: send the output to a WeeChat/plugin command (line by line); if there are spaces in command/arguments, enclose them with double quotes; variable $line is replaced by the line (by default the line is added after the command, separated by a space) (not compatible with options -bg/-o/-oc/-n/-nf)
    -hsignal: send the output as a hsignal (to be used for example in a trigger) (not compatible with options -bg/-o/-oc/-n/-nf)
     command: the command to execute; if beginning with "url:", the shell is disabled and the content of URL is downloaded and sent as output
          id: command identifier: either its number or name (if set with "-name xxx")
         -in: send text on standard input of process
    -inclose: same as -in, but stdin is closed after (and text is optional: without text, the stdin is just closed)
     -signal: send a signal to the process; the signal can be an integer or one of these names: hup, int, quit, kill, term, usr1, usr2
       -kill: alias of "-signal <id> kill"
    -killall: kill all running processes
        -set: set a hook property (see function hook_set in plugin API reference)
    property: hook property
       value: new value for hook property
        -del: delete a terminated command
        -all: delete all terminated commands

    Default options can be set in the option exec.command.default_options.

    Examples:
      /exec -n ls -l /tmp
      /exec -sh -n ps xu | grep weechat
      /exec -n -norc url:https://pastebin.com/raw.php?i=xxxxxxxx
      /exec -nf -noln links -dump https://weechat.org/files/doc/weechat/devel/weechat_user.en.html
      /exec -o uptime
      /exec -pipe "/print Machine uptime:" uptime
      /exec -n tail -f /var/log/messages
      /exec -kill 0

### 12.2. Opcje

Sekcje w pliku exec.conf:

Sekcja | Komenda | Opis
--- | --- | ---
`command` | `/set exec.command.*` | Opcje dla komend.
`color` | `/set exec.color.*` | Kolory.

Opcje:

- exec.color.flag_finished

  - description: text color for a finished command flag in list of commands

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `lightred`

- exec.color.flag_running

  - description: text color for a running command flag in list of commands

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `lightgreen`

- exec.command.default_options

  - description: default options for command /exec (see /help exec); example: "-nosh -bg" to run all commands in background (no output), and without using the shell

  - type: string

  - values: any string

  - default value: `""`

- exec.command.purge_delay

  - description: delay for purging finished commands (in seconds, 0 = purge commands immediately, -1 = never purge)

  - type: integer

  - values: -1 .. 25920000

  - default value: `0`

- exec.command.shell

  - description: shell to use with command "/exec -sh"; it can be just the name of shell if it is in PATH (for example "bash") or the absolute path to the shell (for example "/bin/bash"); if value is empty, "sh" is used (note: content is evaluated, see /help eval)

  - type: string

  - values: any string

  - default value: `"${env:SHELL}"`

## 13. Kolejka FIFO

Możesz zdalnie kontrolować WeeChat, poprzez wysyłanie komend lub tekstu do kolejki FIFO (jeśli opcja "fifo.file.enabled" jest włączona, domyślnie jest włączona).

Strumień FIFO jest zlokalizowany w katalogu uruchomieniowym WeeChat i ma domyślnie nazwę weechat_fifo_12345_ (gdzie 12345 to numer procesu WeeChat).

Składnia dla komend/tekstu przekazywanego do kolejki FIFO wygląda następująco:

      wtyczka.bufor *tekst lub komenda
      *tekst lub komenda

Backslashe mogą być użyte w tym formacie zastępując `*` przez `\`, pozwalając na przykład wysyłanie wiadomości wieloliniowych:

      plugin.buffer \text or command here
      \text or command here

Kilka przykładów:

- Zmiana nicka na serwerze IRC libera na "newnick":

    echo 'irc.server.libera */nick newnick' >/run/user/1000/weechat/weechat_fifo_12345

- Wysłanie wiadomości na kanał IRC #weechat:

    echo 'irc.libera.#weechat *hello!' >/run/user/1000/weechat/weechat_fifo_12345

- Wysyłanie wielolinowych wiadomości na kanał IRC #test, jeśli właściwość "draft/multiline" jest włączona na serwerze ergo:

    echo 'irc.ergo.#test \hello\n...on two lines!' >/run/user/1000/weechat/weechat_fifo_12345

- Wysłanie wiadomości do obecnego bufora:

    echo '*hello!' >/run/user/1000/weechat/weechat_fifo_12345

- Wysłanie dwóch komend do wyładowania/przeładowania skryptów Python (należy oddzielić je za pomocą "\n"):

    printf '%b' '*/python unload\n*/python autoload\n' >/run/user/1000/weechat/weechat_fifo_12345

### 13.1. Komendy

- `fifo`: fifo plugin configuration

    /fifo  enable|disable|toggle

     enable: enable FIFO pipe
    disable: disable FIFO pipe
     toggle: toggle FIFO pipe

    FIFO pipe is used as remote control of WeeChat: you can send commands or text to the FIFO pipe from your shell.
    By default the FIFO pipe is called weechat_fifo_xxx (where xxx is the WeeChat process id) and located in the WeeChat runtime directory (see /debug dirs).

    The expected format is one of:
      plugin.buffer *text or command here
      *text or command here

    For example to change your libera nick:
      echo 'irc.server.libera */nick newnick' >/run/user/1000/weechat/weechat_fifo_12345

    Please read the user's guide for more info and examples.

### 13.2. Opcje

Sekcje w pliku fifo.conf:

Sekcja | Komenda | Opis
--- | --- | ---
`plik` | `/set fifo.file.*` | Kontrola kolejki FIFO.

Opcje:

- fifo.file.enabled

  - description: enable FIFO pipe

  - type: boolean

  - values: on, off

  - default value: `on`

- fifo.file.path

  - description: path for FIFO file; WeeChat PID can be used in path with ${info:pid} (path is evaluated, see function string_eval_path_home in plugin API reference)

  - type: string

  - values: any string

  - default value: `"${weechat_runtime_dir}/weechat_fifo_${info:pid}"`

## 14. Trigger

Trigger to scyzoryk szwajcarski dla WeeChat: może być podpięty do wielu rzeczy (sygnał, modyrikator, wyśiwrtlanie, …​), zmieniać zawartość danych, oraz wykonać jedną lub więcej komend. Można użyć warunków w celu ograniczenia działania w określonych przypadkach.

Używanie triggerów wymaga znajomości jak działają sygnały, modyfikatory, …​ . Warto rozważyć przeczytanie Opisu Api wtyczek WeeChat / Hooks ↗ (Angielski).

### 14.1. Domyślne triggery

WeeChat tworzy domyślnie 5 triggerów, które mogą zostać wyłączone, zaktualizowane lub usunięte:

- trigger beep dla powiadomień

- cztery pozostałe triggery służą ukrywaniu haseł na ekranie

Lista domyśłnych triggerów:

Nazwa | Hook | Opis
--- | --- | ---
`beep` | print | Powiadamiaj o podświetleniach/prywatnej wiadomości.
`cmd_pass` | modifier | Ukrywa hasło w komendach: `/msg nickserv id|identify|set password|ghost|release|regain|recover`, `/oper`, `/quote pass`, `/secure passphrase|decrypt|set`.
`cmd_pass_register` | modifier | Ukrywa hasło w komendzie `/msg nickserv register`.
`msg_auth` | modifier | Ukrywa hasło w wiadomości IRC auth (wiadomość otrzymana od serwera po wykonaniu komendy przez użytkownika).
`server_pass` | modifier | Ukrywa hasło serwera w komendach `/server` i `/connect`.

### 14.2. Anatomia triggera

Trigger posiada następujące opcje (nazwy to `trigger.trigger.<nazwa>.<opcja>`):

Opcja | Wartość | Opis
--- | --- | ---
`enabled` | `on`, `off` | Kiedy wartość ustawiona jest na `off`, trigger jest wyłączony i akcje nie będą więcej wykonywane.
`hook` | `signal`, `hsignal`, `modifier`, `line`, `print`, `command`, `command_run`, `timer`, `config`, `focus`, `info`, `info_hashtable` | Zdarzenia używane przez trigger. Więcej informacji można znaleźć w WeeChat Plugin API Reference / Hooks ↗ (Angielski).
`arguments` | string | Argumenty dla zdarzenia, zależą od jego typu.
`conditions` | string | Waruki do wykonania triggera; są one przetwarzane (zobacz komendę /eval).
`regex` | string | Jedno lub więcej rozszerzonych wyrażeń regularnych POSIX, do zamiany danych otrzymanych w odpowiedzi od podpiętego zdarzenia (i trochę rzeczy dodanych przez wtyczkę trigger) zobacz wyrażenia regularne.
`command` | string | Komenda do wykonania (wiele komend należy oddzielić średnikiem); jest to przetwarzane (zobacz komendę /eval).
`return_code` | `ok`, `ok_eat`, `error` | Kod wiadomości zwrotnej (domyślnie jest to `ok`, które powinno być używane dla większości triggerów, pozostałe wartości są sporadycznie używane).
`post_action` | `none`, `disable`, `delete` | Akcja wykonywana na triggerze po jego wykonaniu (domyślna wartość `none` powinna być użyta dla wszystkich triggerów, pozostałe wartości są sporadycznie używane).

Na przykład, domyślny trigger beep ma następujące opcje:

    trigger.trigger.beep.enabled = on
    trigger.trigger.beep.hook = print
    trigger.trigger.beep.arguments = ""
    trigger.trigger.beep.conditions = "${tg_displayed} && (${tg_highlight} || ${tg_msg_pv})"
    trigger.trigger.beep.regex = ""
    trigger.trigger.beep.command = "/print -beep"
    trigger.trigger.beep.return_code = ok
    trigger.trigger.beep.post_action = none

### 14.3. Wykonywanie

Kiedy wywoływany jest trigger, następujące akcje są wykonywane, dokładnie w takiej kolejności, jeśli triggery są globalnie włączone i jeśli sam trigger jest włączony:

1. sprawdzenie warunków triggera: jeśli nie jest spełniony następuje wyjście

2. zastępowanie tekstu w triggerze za pomocą wyrażenia

3. wykonanie komend(-y)

4. wyjście z kodem poweoru (nie dotyczy hooków modifier, line, focus, info i info_hashtable)

5. wykonanie akcji kończącej (jeśli inna niż `none`).

### 14.4. Argumenty uchwytów

Argumenty zależą od rodzaju uchwytu. Są oddzielane średnikami.

Uchwyt | Argumenty | Przykłady | Dokumentacja (API)
--- | --- | --- | ---
signal | 1. nazwa sygnału (dozwolony priorytet) (wymagane) 2. nazwa sygnału (dozwolony priorytet) 3. …​ | `*,irc_in_privmsg` `*,irc_in_privmsg;*,irc_in_notice` `signal_sigwinch` | hook_signal ↗ (Angielski)
hsignal | 1. nazwa sygnału (dozwolony priorytet) (wymagane) 2. nazwa sygnału (dozwolony priorytet) 3. …​ | `nicklist_nick_added` | hook_hsignal ↗ (Angielski)
modifier | 1. nazwa modyfikatora (dozwolony priorytet) (wymagane) 2. nazwa modyfikatora (dozwolony priorytet) 3. …​ | `weechat_print` `5000|input_text_display;5000|history_add` | hook_modifier ↗ (Angielski)
line | 1. typ bufora 2. nazwa bufora 3. tagi | `formatted` `free` `*;irc.libera.*` `*;irc.libera.#weechat` `formatted;irc.libera.#weechat;irc_notice` | hook_line ↗ (Angielski)
print | 1. nazwa buforu 2. tagi 3. wiadomość 4. odrzucić kolory (0/1) | `irc.libera.*` `irc.libera.#weechat` `irc.libera.#weechat;irc_notice` `*;;;1` | hook_print ↗ (Angielski)
command | 1. nazwa komendy dozwolony priorytet) (wymagane) 2. opis (przetwarzane, zobacz komendę /eval) 3. argumenty (przetwarzane, zobacz komendę /eval) 4. opis argumentów (przetwarzane, zobacz komendę /eval) 5. dopełnienie (przetwarzane, zobacz komendę /eval) | `test` `5000|test` `test;test command;arg1 arg2;arg1: description 1${\n}arg2: description 2` | hook_command ↗ (Angielski)
command_run | 1. komenda (dozwolony priorytet) (wymagane) 2. komenda (dozwolony priorytet) 3. …​ | `/cmd argumenty` | hook_command_run ↗ (Angielski)
timer | 1. interwał w milisekundach (wymagane) 2. wyrównanie na sekundę (domyślnie: 0) 3. maksymalna ilość wywołań (domyślnie: 0, co oznacza "brak końca") | `3600000` `60000;0;5` | hook_timer ↗ (Angielski)
config | 1. nazwa opcji (dozwolony priorytet) (wymagane) 2. nazwa opcji (dozwolony priorytet) 3. …​ | `weechat.look.*` | hook_config ↗ (Angielski)
focus | 1. nazwa obszaru (dozwolony priorytet) (wymagane) 2. nazwa obszaru (dozwolony priorytet) 3. …​ | `buffer_nicklist` | hook_focus ↗ (Angielski)
info | 1. info name (dozwolony priorytet) (wymagane) 2. info name (dozwolony priorytet) 3. …​ | `my_info` | hook_info ↗ (Angielski)
info_hashtable | 1. info name (dozwolony priorytet) (wymagane) 2. info name (dozwolony priorytet) 3. …​ | `my_info` | hook_info_hashtable ↗ (Angielski)

### 14.5. Warunki

Warunki są używane do kontynuowania przetwarzania w triggerze, lub zatrzymania wszystkiego.

Są one przetwarzane i dane dostępne w callbackach mogą zostać użyte (zobacz dane w callbackach oraz komendę /eval).

Przykład: domyślny trigger beep używa tego warunku do wywołania dźwięku tylko w przypadku podświetlenia lub otrzymania prywatnej wiadomości:

    ${tg_displayed} && (${tg_highlight} || ${tg_msg_pv})

### 14.6. Wyrażenia regularne

Wyrażenia regularne są używane do zmiany zmiennych w tabelach hashy callbacków.

Format to jeden z poniższych:

    /string1/string2
    /string1/string2/var
    s/string1/string2
    s/string1/string2/var
    y/string1/string2
    y/string1/string2/var

Pola:

- `s` lub `y`: litera z komendą; jeśli nie podana domyślnie zostanie użyte `s` następny znak jest użyty jako ogranicznik:

  - `s`: zamiana z użyciem wyrażenia regularnego: pierwszy ciąg to wyrażenie regularne, drugi to ciąg na który ma zostać zamienione każde dopasowanie

  - `y`: zamiana znaków: pierwszy ciąg to zbiór znaków które zostaną zastąpione przez znaki z drugiego ciągu; po przetworzeniu każdy z ciągów musi mieć dokładnie taką samą ilość znaków UTF-8

- `/`: separator wyrażenia; znak "/" może zostać zastąpiony dowolnym innym znakiem (jeden lub więcej identycznych znaków)

- `string1`: pierwszy ciąg (użycie zależne od polecenia)

- `string2`: drugi ciąg (użycie zależne od polecenia)

- `var`: zmienna w tabeli hashy do zaktualizowania

Wyrażenia regularne można oddzielić spacją, na przykład:

    s/regex1/replace1/var1 y/abcdef/ABDDEF/var2

#### Zamiana wyrażeniem regularnym

Dla komendy `s`, format jest jestępujący: `s/regex/replace` lub `s/regex/replace/var` (gdzie var to zmianna z tablicy hashy).

Jako że `s` to domyślna komenda, można to pominąć, dlatego `/regex/replace` jest także poprawne (jednak pierwszy znak, który będzie separatorem, nie może być literą).

Dopasowanie grup może być także użyte:

- `${re:0}` do `${re:99}`: `${re:0}` to pełne dopasowanie, `${re:1}` do `${re:99}` to złapane grupy

- `${re:+}`: ostatnie dopasowanie (z najwyższym numerem)

- `${re:#}`: index of last group captured

- `${re:repl_index}`: index of replacement being done (starts to 1)

- `${hide:c,${re:N}}`: dopasuje "N" ze wszystkimi znakami zastąpionymi przez "c" (przykład: `${hide:*,${re:2}}` to grupa #2 ze wszystkimi znakami zastąpionymi przez `*`).

Przykład: użyj pogrubienia dla słów pomiędzy `*`:

    s/\*([^ ]+)\*/*${color:bold}${re:1}${color:-bold}*/

Przykład: domyślny trigger server_pass używa tego wyrażenia regularnego do ukrycia haseł w komendach `/server` i `/connect` (znaki w hasłach są zastępowane przez `*`):

    s==^(/(server|connect) .*-(sasl_)?password=)([^ ]+)(.*)==${re:1}${hide:*,${re:4}}${re:5}

Notka | W tym przykładzie jako separator jest użyte "==" ponieważ znak "/" jest użyty w wyrażeniu regularnym.

#### Tłumaczenie znaków

Dla komendy `y`, format to: `y/chars1/chars2` lub `y/chars1/chars2/var` (gdzie var to zmienna w tabeli hashy).

Przykłady: zamienia "a", "b" i "c" na wielkie litery:

    y/abc/ABC/

Przykład: obraca strzałki zgodnie z ruchem wskazówek zegara:

    y/←↑→↓/↑→↓←/

Przykład: zamienia wielkie litery na małe:

    y/${chars:upper}/${chars:lower}/

Przykład: przesuwa litery o jedną pozycję zachowując wielkość: a→b, b→c … y→z, z→a:

    y/${chars:a-z}${chars:A-Z}/${chars:b-z}a${chars:B-Z}A/

#### Zmienna

Jeśli var nie istnieje w tabeli hashy zostanie sutomatycznie utworzona bez wartości. Pozwala to na tworzenie zmiennych tymczasowych.

Jeśli var nie została podana, zostanie użyta domyślna zmienna w zależności od typu hooka:

Uchwyt | Domyślna zmienna | Dozwolona aktualizacja (1)
--- | --- | ---
signal | tg_signal_data |
hsignal |  |
modifier | tg_string | tg_string
line | message | buffer, buffer_name, y, date, date_usec, date_printed, date_usec_printed, str_time, tags, notify_level, highlight, prefix, message
print | tg_message |
command | tg_argv_eol1 |
command_run | tg_command |
timer | tg_remaining_calls |
config | tg_value |
focus |  |
info | tg_info | tg_info
info_hashtable |  | wszytkie zmienne otrzymane w tablicy hashy

Notka | (1) Wszystkie zmienne mogą zostać zaktualizowane, jednak tylko te zmienne mają wpływ na zmienne zwrócone i użyte przez WeeChat.

### 14.7. Komenda

Komenda jest wykonywana po zastąpieniu tekstu przez wyrażenie regularne. Wiele komend może być oddzielonych średnikiem.

Komendy są przetwarzane (zobacz komendę /eval) i tekst zastępowany wyrażeniem może zostać użyty w komendzie.

Przykład: domyślny trigger beep używa tej komendy do wydania dźwięku (BEL):

    /print -beep

### 14.8. Dane w callbackach

Dane otrzymane w callbackach są przechowywane w tablicach hashy (wskaźniki i ciągi) i mogą zostać użyte w następujących opcjach:

- warunki

- wyrażenia

- komendy

Zawartość tablicy hashy zależy od typu uchwytu.

Przystępną drogą do zobaczenia danych w triggerze jest otworzenie buforu monitorującego, za pomocą komendy:

    /trigger monitor

Wszystkie callbacki ustawiają następujące zmienne w tablicy hashy:

Zmienna | Typ | Opis
--- | --- | ---
`tg_trigger_name` | ciąg | Nazwa triggera.
`tg_hook_type` | ciąg | Typ hooka: "signal", "command", etc.

#### Sygnał

Callback "signal" ustawia następujące zmienne w tablicy hashy:

Zmienna | Typ | Opis
--- | --- | ---
`tg_signal` | ciąg | Nazwa sygnału.
`tg_signal_data` | ciąg | Dane wysłane z sygnałem.

Jeśli sygnał zawiera wiadomość IRC, wiadomość jest parsowana i następujące dane są dodawane do tablicy hashy:

Zmienna | Typ | Opis
--- | --- | ---
`irc_server` | wskaźnik | Wskaźnik na serwer IRC (można użyć zmiennych hdata typu "irc_server" jak `${irc_server.name}`).
`irc_channel` | wskaźnik | Wskaźnik na kanał IRC (można użyć zmiennych hdata typu "irc_channel" jak `${irc_channel.name}`).
`server` | ciąg | Nazwa serwera (przykład: "libera").
`tags` | ciąg | Tagi w wiadomości (rzadko używane).
`message_without_tags` | ciąg | Wiadomość bez tagów.
`nick` | ciąg | Nick. (1)
`host` | ciąg | Nazwa hosta.
`command` | ciąg | Komendy IRC (na przykład: "PRIVMSG", "NOTICE", …​).
`channel` | ciąg | Kanał IRC.
`arguments` | ciąg | Argumenty komendy (razem z wartością channel).
`text` | ciąg | Tekst (na przykład wiadomość użytkownika).
`pos_command` | ciąg | Indeks command w wiadomości ("-1" jeśli command nie zostanie znalezione).
`pos_arguments` | ciąg | Indeks arguments w wiadomości ("-1" jeśli arguments nie zostaną znalezione).
`pos_channel` | ciąg | Indeks channel w wiadomości ("-1" jeśli channel nie został znaleziony).
`pos_text` | ciąg | Indeks text w wiadomości ("-1" jeśli text nie został znaleziony).

Notka | (1) Nick to nadawca wiadomości. Twój nick na serwerze to `${irc_server.nick}`.

Kiedy dane są wskaźnikiem, zmienna `tg_signal_data` może zostać użyta do odczytania pola w hdata (w tym przypadku jest to wskaźnik na bufor):

    ${buffer[${tg_signal_data}].full_name}

#### Hsignal

Callback "hsignal" ustawia następujące zmienne w tablicy hashy:

Zmienna | Typ | Opis
--- | --- | ---
`tg_signal` | ciąg | Nazwa sygnału.

Tablica zawiera wszystkie klucze/wartości z otrzymanej tablicy hashy (typ: ciąg/ciąg).

#### Modyfikator

Callback "modifier" ustawia następujące zmienne w tablicy hashy:

Zmienna | Typ | Opis
--- | --- | ---
`tg_modifier` | ciąg | Nazwa modyfikatora.
`tg_modifier_data` | ciąg | Dane wysłane z modyfikatorem.
`tg_string` | ciąg | Ciąg mogący zostać zmodyfikowany.
`tg_string_nocolor` | ciąg | Ciąg bez kodów kolorów.

Dla modyfikatora weechat_print, są dodawane zmienne używające tagi wiadomości zobacz hook print poniżej), oraz następujące zmienne:

Zmienna | Typ | Opis
--- | --- | ---
`buffer` | wskaźnik | Bufor, w którym wiadomość jest wyświetlana.
`tg_plugin` | ciąg | Wtyczka bufora z wyświetlana wiadomością.
`tg_buffer` | ciąg | Pełna nazwa bufora z wyświetlana wiadomością.
`tg_prefix` | ciąg | Prefiks wyświetlanej wiadomości.
`tg_prefix_nocolor` | ciąg | Prefiks bez kodów kolorów.
`tg_message` | ciąg | Wyświetlana wiadomość.
`tg_message_nocolor` | ciąg | Wiadomość bez kodów kolorów.

Jeśli modyfikator zawiera wiadomość IRC, wiadomość jest parsowana i dodawane są dodatkowe dane do tablicy hashy (zobacz hook signal).

#### Line

Callback "line" ustawia następujące zmienne w tablicy hashy:

Zmienna | Typ | Opis
--- | --- | ---
`buffer` | wskaźnik | Bufor.
`buffer_name` | ciąg | Nazwa bufora.
`buffer_type` | ciąg | Typ bufora ("formatted" lub "free").
`y` | ciąg | Numer linii bufora z wolną zawartością (≥ 0), -1 dla bufora ze sformatowaną zawartością.
`date` | ciąg | Linia z datą (timestamp).
`date_usec` | ciąg | Mikrosekundy w linii z datą.
`date_printed` | ciąg | Data, kiedy linia została wyświetlona (timestamp).
`date_usec_printed` | ciąg | Mikrosekundy w dacie wyświetlenia linii.
`str_time` | ciąg | Date do wyświetlenia. Może zawierać kody kolorów.
`tags` | ciąg | Tagi wiadomości (z przecinkiem dodanym na początku/końcu ciągu).
`displayed` | ciąg | "1" jeśli wyświetlono, "0" jeśli nie wyświetlono.
`notify_level` | ciąg | "-1" = brak powiadomienia, "0" = poziom niski, "1" = wiadomość, "2" = wiadomość prywatna, "3" = podświetlenie
`highlight` | ciąg | "1" jeśli podświetlenie, inaczej "0".
`prefix` | ciąg | Prefiks.
`tg_prefix_nocolor` | ciag | Prefiks bez kodów kolorów.
`message` | ciąg | Wiadomość.
`tg_message_nocolor` | ciag | Wiadomość bez kodów kolorów.

Zmienne ustawiane za pomocą tagów w wiadomościach:

Zmienna | Typ | Opis
--- | --- | ---
`tg_tags_count` | ciąg | Liczba tagów w wiadomości.
`tg_tag_nick` | ciąg | Nick (z tagu "nick_xxx").
`tg_tag_prefix_nick` | ciąg | Kolor nicka w prefiksie (z tagu "prefix_nick_ccc").
`tg_tag_host` | ciąg | Nazwa użytkownika i host, format: username@host (z tagu "host_xxx").
`tg_tag_notify` | ciąg | Poziom powiadomień (none, message, private, highlight).
`tg_tag_irc_xxx` | ciąg | Tag wiadomości IRC (klucz "xxx"). (1)
`tg_notify` | ciąg | Poziom powiadomień, jeśli różny od none.
`tg_msg_pv` | ciąg | "1" dla prywatnej wiadomości, inaczej "0".

Notka | (1) Przecinki są zastępowane przez średniki w tagach IRC (kluczach i wartościach)

#### Print

Callback "print" ustawia następujące zmienne w tablicy hashy:

Zmienna | Typ | Opis
--- | --- | ---
`buffer` | wskaźnik | Bufor.
`tg_date` | ciąg | Data/czas wiadomości (format: `%FT%T.%f`, zobacz Opis API wtyczek WeeChat / util_strftimeval ↗).
`tg_displayed` | ciąg | "1" jeśli wyświetlone, "0" jeśli linia odfiltrowana.
`tg_highlight` | ciąg | "1" jeśli higlight, inaczej "0".
`tg_prefix` | ciąg | Prefiks.
`tg_prefix_nocolor` | ciąg | Prefiks bez kodów kolorów.
`tg_message` | ciąg | Wiadomość.
`tg_message_nocolor` | ciąg | Wiadomość bez kodów kolorów.

Zmienne ustawiane za pomocą tagów w wiadomościach:

Zmienna | Typ | Opis
--- | --- | ---
`tg_tags` | ciąg | Tagi wiadomości (z przecinkiem dodanym na początku/końcu ciągu).
`tg_tags_count` | ciąg | Liczba tagów w wiadomości.
`tg_tag_nick` | ciąg | Nick (z tagu "nick_xxx").
`tg_tag_prefix_nick` | ciąg | Kolor nicka w prefiksie (z tagu "prefix_nick_ccc").
`tg_tag_host` | ciąg | Nazwa użytkownika i host, format: username@host (z tagu "host_xxx").
`tg_tag_notify` | ciąg | Poziom powiadomień (none, message, private, highlight).
`tg_tag_irc_xxx` | ciąg | Tag wiadomości IRC (klucz "xxx"). (1)
`tg_notify` | ciąg | Poziom powiadomień, jeśli różny od none.
`tg_msg_pv` | ciąg | "1" dla prywatnej wiadomości, inaczej "0".

Notka | (1) Przecinki są zastępowane przez średniki w tagach IRC (kluczach i wartościach)

#### Command

Callback "command" ustawia następujące zmienne w tablicy hashy:

Zmienna | Typ | Opis
--- | --- | ---
`buffer` | wskaźnik | Bufor.
`tg_argc` | ciąg | Ilość argumentów (komenda liczy się za jeden).
`tg_argvN` | ciąg | Argument #N (`tg_argv0` to komenda, pozostałe to jej argumenty).
`tg_argv_eolN` | ciąg | Od argumentu #N do końca argumentów (`tg_argv_eol0` zawiera komendę).
`tg_shell_argc` | ciąg | Ilość argumentów podzielonych tak jak parametry konsolowe (sama komenda liczy się jako jeden).
`tg_shell_argvN` | ciąg | Argument #N podzielone tak jak parametry konsolowe (`tg_shell_argv0` to nazwa komendy, pozostałe to argumenty).

#### Command_run

Callback "command_run" ustawia następujące zmienne w tablicy hashy:

Zmienna | Typ | Opis
--- | --- | ---
`buffer` | wskaźnik | Bufor.
`tg_command` | ciąg | Wykonana komenda.

#### Timer

Callback "timer" ustawia następujące zmienne w tablicy hashy:

Zmienna | Typ | Opis
--- | --- | ---
`tg_remaining_calls` | ciąg | Liczba pozostałych wywołań.
`tg_date` | ciąg | Obecna data/czas `%FT%T.%f`, zobacz Opis API wtyczek WeeChat / util_strftimeval ↗).

#### Config

Callback "config" ustawia następujące zmienne w tablicy hashy:

Zmienna | Typ | Opis
--- | --- | ---
`tg_option` | ciąg | Opcja.
`tg_value` | ciąg | Wartość.

#### Focus

Callback "focus" ustawia następujące zmienne w tablicy hashy:

Zmienna | Typ | Opis
--- | --- | ---
`window` | wskaźnik | Okno.
`buffer` | wskaźnik | Bufor.

Tablica zawiera wszystkie klucze/wartości z otrzymanej tablicy hashy (typ: ciąg/ciąg).

#### Info

Callback "info" ustawia następujące zmienne w tablicy hashy:

Zmienna | Typ | Opis
--- | --- | ---
`tg_info_name` | string | Name of info.
`tg_arguments` | string | Arguments.
`tg_info` | string | Empty string (the info to return).

#### Info_hashtable

Callback "info_hashtable" ustawia następujące zmienne w tablicy hashy:

Zmienna | Typ | Opis
--- | --- | ---
`tg_info_name` | string | Name of info.

Tablica zawiera wszystkie klucze/wartości z otrzymanej tablicy hashy (typ: ciąg/ciąg).

### 14.9. Przykłady

#### Kolory dla URLi

Wyświetlanie URLi na zielono:

    /trigger add url_color modifier weechat_print "${tg_notify}" "==[a-zA-Z0-9_]+://[^ ]+==${color:green}${re:0}${color:reset}=="

Notka | Proste wyrażenie użyte do wykrycia URLa może nie łapać wszstkich URLi, ale jest szybsze od złożonego wyrażenia.

#### Automatyczna odpowiedz pong na zapytania ping

Kiedy ktoś wyśle "ping" w prywatnym buforze, ten trigger odpowie automatycznie `pong`:

    /trigger add pong print "" "${type} == private && ${tg_message} == ping" "" "pong"

#### Responsywny układ

Następujące triggery mogą zostać użyte do zmiany rzeczy wyświetlanych, kiedy nastąpi zmiana rozmiaru terminala:

    /trigger add resize_small signal signal_sigwinch "${info:term_width} < 100" "" "/bar hide nicklist"
    /trigger add resize_big signal signal_sigwinch "${info:term_width} >= 100" "" "/bar show nicklist"

Triggery przechwytują sygnał "signal_sigwinch", który jest wysyłany przez WeeChat, kiedy sygnał SIGWINCH zostanie otrzymany (kiedy rozmiar terminala się zmieni).

Warunek z `${info:term_width}` sprawdza szerokość terminala (możesz również użyć `${info:term_height}` w razie potrzeby).

W przykładzie, kiedy terminal stanie się mały, ukrywana jest lista nicków. Jest ona przywracana, kiedy szerokość jest większa lub równa 100 znakom.

#### Automatyczne zapisywanie konfiguracji

Możesz automatycznie zapisywać pliki konfiguracyjne (`*.conf`), na przykład co godzinę:

    /trigger add cfgsave timer 3600000;0;0 "" "" "/mute /save"

Argumenty dla uchwytu timera to:

- 3600000: 3600 * 1000 milisekund, callback wywoływany jest co godzinę

- 0: wyrównanie sekund (nie ustawione)

- 0: maksymalna ilość wywołań (0 = brak ograniczenia ilości wywołań)

Komenda `/mute /save` zapisze po cichu pliki konfiguracyjne (nic się nie wyświetli w buforze rdzenia).

### 14.10. Komendy

- `trigger`: manage triggers, the Swiss Army knife for WeeChat

    /trigger  list [-o|-ol|-i|-il]
              listfull
              listdefault
              add|addoff|addreplace <name> <hook> ["<arguments>" ["<conditions>" ["<regex>" ["<command>" ["<return_code>" ["<post_action>"]]]]]]
              addinput [<hook>]
              input|output|recreate <name>
              set <name> <option> <value>
              rename|copy <name> <new_name>
              enable|disable|toggle [<name>|<mask>...]
              restart <name>|<mask>...
              show <name>
              del <name>|<mask>...
              restore <name>|<mask>...
              default -yes
              monitor [<filter>]

           list: list triggers (without argument, this list is displayed)
             -o: send list of triggers enabled to buffer (string in English)
            -ol: send list of triggers enabled to buffer (translated string)
             -i: copy list of triggers enabled in command line (for sending to buffer) (string in English)
            -il: copy list of triggers enabled in command line (for sending to buffer) (translated string)
       listfull: list triggers with detailed info for each trigger
    listdefault: list default triggers
            add: add a trigger
         addoff: add a trigger (disabled)
     addreplace: add or replace an existing trigger
           name: name of trigger
           hook: signal, hsignal, modifier, line, print, command, command_run, timer, config, focus, info, info_hashtable
      arguments: arguments for the hook, depending on hook (separated by semicolons):
                 type `signal`: name(s) of signal (required)
                 type `hsignal`: name(s) of hsignal (required)
                 type `modifier`: name(s) of modifier (required)
                 type `line`: buffer type ("formatted", "free" or "*"), list of buffer masks, tags
                 type `print`: buffer, tags, message, strip colors
                 type `command`: command (required), description, arguments, description of arguments, completion (all arguments except command are evaluated, "${tg_trigger_name}" is replaced by the trigger name, see /help eval)
                 type `command_run`: command(s) (required)
                 type `timer`: interval (required), align on second, max calls
                 type `config`: name(s) of option (required)
                 type `focus`: name(s) of area (required)
                 type `info`: name(s) of info (required)
                 type `info_hashtable`: name(s) of info (required)
     conditions: evaluated conditions for the trigger
          regex: one or more regular expressions to replace strings in variables
        command: command to execute (many commands can be separated by ";")
    return_code: return code in callback (ok (default), ok_eat, error)
    post_action: action to take after execution (none (default), disable, delete)
       addinput: set input with default arguments to create a trigger
          input: set input with the command used to create the trigger
         output: send the command to create the trigger on the buffer
       recreate: same as "input", with option "addreplace" instead of "add"
            set: set an option in a trigger
         option: name of option: name, hook, arguments, conditions, regex, command, return_code (for help on option, you can type: /help trigger.trigger.<name>.<option>)
          value: new value for the option
         rename: rename a trigger
           copy: copy a trigger
         enable: enable triggers (without arguments: enable triggers globally)
        disable: disable triggers (without arguments: disable triggers globally)
         toggle: toggle triggers (without arguments: toggle triggers globally)
        restart: restart triggers (recreate the hooks)
           show: show detailed info on a trigger (with some stats)
            del: delete triggers
        restore: restore triggers with the default values (works only for default triggers)
           mask: name where wildcard "*" is allowed
        default: delete all triggers and restore default ones
        monitor: open the trigger monitor buffer, with optional filter
         filter: filter hooks/triggers to display (a hook must start with "@", for example "@signal"), many filters can be separated by commas; wildcard "*" is allowed in each trigger name

    When a trigger callback is called, following actions are performed, in this order:
      1. check conditions; if false, exit
      2. replace text using POSIX extended regular expression(s) (if defined in trigger)
      3. execute command(s) (if defined in trigger)
      4. exit with a return code (except for modifier, line, focus, info and info_hashtable)
      5. perform post action

    Examples (you can also look at default triggers with /trigger listdefault):
      add text attributes *bold*, _underline_ and /italic/ (only in user messages):
        /trigger add effects modifier weechat_print "${tg_tag_nick}" "==\*([^ ]+)\*==*${color:bold}${re:1}${color:-bold}*== ==_([^ ]+)_==_${color:underline}${re:1}${color:-underline}_== ==/([^ ]+)/==/${color:italic}${re:1}${color:-italic}/"
      hide nicklist bar on small terminals:
        /trigger add resize_small signal signal_sigwinch "${info:term_width} < 100" "" "/bar hide nicklist"
        /trigger add resize_big signal signal_sigwinch "${info:term_width} >= 100" "" "/bar show nicklist"
      silently save config each hour:
        /trigger add cfgsave timer 3600000;0;0 "" "" "/mute /save"
      silently save WeeChat session at midnight (see /help upgrade):
        /trigger add session_save signal day_changed "" "" "/mute /upgrade -save"
      open trigger monitor and show only modifiers and triggers whose name starts with "resize":
        /trigger monitor @modifier,resize*

### 14.11. Opcje

Sekcje w pliku trigger.conf:

Sekcja | Komenda | Opis
--- | --- | ---
`look` | `/set trigger.look.*` | Wygląd.
`color` | `/set trigger.color.*` | Kolory.
`trigger` | `/trigger add /trigger set /set trigger.trigger.*` | Opcje triggerów.

Opcje:

- trigger.color.flag_command

  - description: text color for command flag (in /trigger list)

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `lightgreen`

- trigger.color.flag_conditions

  - description: text color for conditions flag (in /trigger list)

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `yellow`

- trigger.color.flag_post_action

  - description: text color for post action flag (in /trigger list)

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `lightblue`

- trigger.color.flag_regex

  - description: text color for regex flag (in /trigger list)

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `lightcyan`

- trigger.color.flag_return_code

  - description: text color for return code flag (in /trigger list)

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `lightmagenta`

- trigger.color.identifier

  - description: text color for trigger context identifier in monitor buffer

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `cyan`

- trigger.color.regex

  - description: text color for regular expressions

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `white`

- trigger.color.replace

  - description: text color for replacement text (for regular expressions)

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `cyan`

- trigger.look.enabled

  - description: enable trigger support

  - type: boolean

  - values: on, off

  - default value: `on`

- trigger.look.monitor_strip_colors

  - description: strip colors in hashtable values displayed on monitor buffer

  - type: boolean

  - values: on, off

  - default value: `off`

## 15. Rozszerzanie WeeChat

WeeChat zbudowany jest z modułów i może być rozszerzany przez wtyczki i skrypty.

Ważne jest, aby odróżniać wtyczkę od skryptu: wtyczka jest to plik binarny skompilowany i ładowany za pomocą polecenia `/plugin`, natomiast skrypt to plik tekstowy, ładowany za pomocą wtyczki jak na przykład python za pomocą polecenia `/python`.

### 15.1. Wtyczki

Wtyczka jest biblioteka dynamiczną, napisaną w C i skompilowaną, która jest ładowana przez WeeChat. W systemach GNU/Linux plik ma rozszerzenie ".so", w Windowsie ".dll".

Znalezione wtyczki są automatycznie ładowane podczas uruchamiania WeeChat, możliwe jest również ładowanie lub wyładowywanie wtyczek podczas pracy WeeChat.

Możesz użyć komendy `/plugin` żeby załadować/wyładować wtyczkę, lub wyświetlić wszystkie załadowane wtyczki.

Podcza wyładowywania wtyczki WeeChat usówa:

- bufory

- opcje konfiguracyjne (options są zapisywane w plikach)

- wszystkie hooki: komendy, modyfikatory, procesy, etc.

- infos i infolists

- hdata

- elementy pasków.

Przykłady ładowania, wyładowywania i wyświetlania załadowanych wtyczek:

    /plugin load irc
    /plugin unload irc
    /plugin list

Domyślne wtyczki:

Wtyczka | Opis
--- | ---
alias | Definiuje aliasy dla komend.
buflist | Element paska z listą buforów.
charset | Ustawianie kodowania dla buforów.
exec | Wykonuje zewnętrzną komendę z poziomu WeeChat.
fifo | Kolejka FIFO używana do zdalnego wysyłania poleceń dla WeeChat.
fset | Szybkie ustawianie opcji WeeChat i wtyczek.
irc | Protokół IRC.
logger | Logowanie zawartości buforów do plików.
relay | Przekazuje dane przez sieć.
script | Zarządzanie skryptami.
python | Wsparcie dla skryptów napisanych w Pythonie.
perl | Wsparcie dla skryptów napisanych w Perlu.
ruby | Wsparcie dla skryptów napisanych w Ruby.
lua | Wsparcie dla skryptów napisanych w Lua.
tcl | Wsparcie dla skryptów napisanych w Tcl.
guile | Wsparcie dla skryptów napisanych w Guile (scheme).
javascript | Wsparcie dla skryptów napisanych w JavaScript.
php | Wsparcie dla skryptów napisanych w PHP.
spell | Sprawdzanie pisowni w linii poleceń.
trigger | Zamiana tekstu i wykonywanie komend dla zdarzeń wywołanych przez WeeChat/wtyczki.
typing | Pokazuje użytkowników obecnie piszących wiadomości.
xfer | Przesyłanie plików i bezpośredni chat.

Więcej informacji o wtyczkach i tworzeniu skryptów (przez API), można znaleźć w Opisie API wtyczek ↗ (Angielski) i Poradniku pisania skryptów ↗.

### 15.2. Skryptowe

WeeChat posiada 8 wtyczek skryptowych: Python, Perl, Ruby, Lua, Tcl, Guile (scheme), JavaScript i PHP. Wtyczki te potrafią ładować, wykonywać i wyładowywać skrypty w tych językach.

Więcej informacji o tym jak pisać skrypty lub o API WeeChat dla skryptów można znaleźć w Poradniku pisania skryptów ↗.

#### Manager skryptów

Manager skryptów (komenda /script) jest używany do ładowania/wyładowania skryptów w dowolnym języku, oraz do instalowania/usuwania skryptów z repozytorium skryptów WeeChat, które można znależć na tej stronie ↗.

W trosce o prywatność pobieranie skryptów jest domyślnie wyłąćzone.
Żeby je włączyć, wpisz poniższe polecenie:

    /script enable

Następnie możesz pobrać listę skryptów i wyświetlić je w nowym buforze za pomocą polecenia /script:

    ┌──────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
    │1.weechat│322/322 skrypty (filtr: *) | Sort: i,p,n | Alt+klawisz/wejście: i=instaluj r=usuń l=załaduj L=prze>>│
    │2.scripts│*      autosort.py                     3.10    2023-12-31 | Automatycznie grupowanie buforów wg serw│
    │         │*      highmon.pl                      2.7     2020-06-21 | Dodaje bufor monitorujący higlighty.    │
    │         │*ia r  grep.py                   0.8.6 0.8.6   2022-11-11 | Przeszukuje bufor lub plik z logami za p│
    │         │*      colorize_nicks.py               32      2023-10-30 | Używaj kolorów nicków weechat w oknie ro│
    │         │*ia r  go.py                     3.0.1 3.0.1   2024-05-30 | Szybkie przemieszczanie się pomiędzy buf│
    │         │       aesthetic.py                    1.0.6   2020-10-25 | Spraw, że wiadomości będą bardziej E S T│
    │         │       aformat.py                      0.2     2018-06-21 | Alternatywne formatowanie tekstu, przyda│
    │         │       alternatetz.py                  0.4     2022-01-25 | Dodaje alternatywny element strefy czaso│
    │         │       amarok2.pl                      0.7     2012-05-08 | Kontrola i wyświetlanie aktualnie odtwar│
    │         │       amqp_notify.rb                  0.1     2011-01-12 | Wysyła prywatne wiadomości i higlighty d│
    │         │       announce_url_title.py           19      2021-06-05 | Prezentuje tytuł URL'a użytkownikowi lub│
    │         │       anotify.py                      1.0.2   2020-05-16 | Powiadomienia na ekranie dla prywatnych │
    │         │       anti_password.py                1.2.1   2021-03-13 | Zapobiega przypadkowemu wysłaniu hasła d│
    │         │       apply_corrections.py            1.3     2018-06-21 | Wyświetla poprawiony tekst, kiedy użytko│
    │         │       arespond.py                     0.1.2   2022-01-25 | Prosty autoresponder.                   │
    │         │       atcomplete.pl                   0.001   2016-10-29 | Dopełnianie tabem dla nicków poprzedzony│
    │         │       audacious.pl                    0.3     2009-05-03 | Wyświetla aktualnie odtwarzany utwór prz│
    │         │       auth.rb                         0.3     2014-05-30 | Automatyczne uwierzytelnianie w NickServ│
    │         │       auto_away.py                    0.4     2018-11-11 | Prosty skrypt auto-away.                │
    │         │       autoauth.py                     1.3     2021-11-07 | Pozwala na automatyczną identyfikację po│
    │         │       autobump.py                     0.1.0   2019-06-14 | Ustawia bufory według aktywności.       │
    │         │       autoconf.py                     0.4     2021-05-11 | Automatyczne zapisywanie/ładowanie zapis│
    │         │       autoconnect.py                  0.3.3   2019-10-06 | Otwiera kanały i serwery otwarte przed o│
    │         │       autojoin_on_invite.py           0.9     2022-10-25 | Automatycznie wchodzi na kanał po otrzym│
    │         │       automarkbuffer.py               1.0     2015-03-31 | Oznacza bufor jako przeczytany jeśli nie│
    │         │       automerge.py                    0.2     2018-03-03 | Automatyczna łączenie nowych buforów zgo│
    │         │[12:55] [2] [script] 2:scripts                                                                      │
    │         │█                                                                                                   │
    └──────────────────────────────────────────────────────────────────────────────────────────────────────────────┘

##### Komendy wtyczki script

- `script`: WeeChat script manager

    /script  enable
             list [-o|-ol|-i|-il]
             search <text>
             show <script>
             load|unload|reload <script>...
             autoload|noautoload|toggleautoload <script>...
             install|remove|installremove|hold [-q] <script>...
             upgrade
             update
             -up|-down [<number>]
             -go <line>|end

            enable: enable download of scripts (turn on option script.scripts.download_enabled)
              list: list loaded scripts (all languages)
                -o: send list of loaded scripts to buffer (string in English)
               -ol: send list of loaded scripts to buffer (translated string)
                -i: copy list of loaded scripts in command line (for sending to buffer) (string in English)
               -il: copy list of loaded scripts in command line (for sending to buffer) (translated string)
            search: search scripts by tags, language (python, perl, ...), filename extension (py, pl, ...) or text; result is displayed on scripts buffer
              show: show detailed info about a script
              load: load script(s)
            unload: unload script(s)
            reload: reload script(s)
          autoload: autoload the script
        noautoload: do not autoload the script
    toggleautoload: toggle autoload
           install: install/upgrade script(s)
            remove: remove script(s)
     installremove: install or remove script(s), depending on current state
              hold: hold/unhold script(s) (a script held will not be upgraded anymore and cannot be removed)
                -q: quiet mode: do not display messages
           upgrade: upgrade all installed scripts which are obsolete (new version available)
            update: update local scripts cache
               -up: move the selected line up by "number" lines
             -down: move the selected line down by "number" lines
               -go: select a line by number, first line number is 0 ("end" to select the last line)

    Without argument, this command opens a buffer with list of scripts.

    On script buffer, the possible status for each script are:
      `*`: popular script
      `i`: installed
      `a`: autoloaded
      `H`: held
      `r`: running (loaded)
      `N`: obsolete (new version available)

    In output of /script list, this additional status can be displayed:
      `?`: unknown script (cannot be downloaded/updated)

    In input of script buffer, word(s) are used to filter scripts on description, tags, ...). The input "*" removes the filter.

    For keys, input and mouse actions on the buffer, see key bindings in User's guide.

    Examples:
      /script search url
      /script install go.py urlserver.py
      /script remove go.py
      /script hold urlserver.py
      /script reload urlserver
      /script upgrade

##### Opcje wtyczki script

Sekcje w pliku script.conf:

Sekcja | Komenda | Opis
--- | --- | ---
`look` | `/set script.look.*` | Wygląd.
`color` | `/set script.color.*` | Kolory.
`scripts` | `/set script.scripts.*` | Opcja dla pobierania skryptów.

Opcje:

- script.color.status_autoloaded

  - description: color for status "autoloaded" ("a")

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `39`

- script.color.status_held

  - description: color for status "held" ("H")

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `white`

- script.color.status_installed

  - description: color for status "installed" ("i")

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `lightcyan`

- script.color.status_obsolete

  - description: color for status "obsolete" ("N")

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `lightmagenta`

- script.color.status_popular

  - description: color for status "popular" ("*")

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `yellow`

- script.color.status_running

  - description: color for status "running" ("r")

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `lightgreen`

- script.color.status_unknown

  - description: color for status "unknown" ("?")

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `lightred`

- script.color.text

  - description: text color in script buffer

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `default`

- script.color.text_bg

  - description: background color in script buffer

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `default`

- script.color.text_bg_selected

  - description: background color for selected line in script buffer

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `24`

- script.color.text_date

  - description: text color of dates in script buffer

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `65`

- script.color.text_date_selected

  - description: text color of dates for selected line in script buffer

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `50`

- script.color.text_delimiters

  - description: text color of delimiters in script buffer

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `240`

- script.color.text_description

  - description: text color of description in script buffer

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `249`

- script.color.text_description_selected

  - description: text color of description for selected line in script buffer

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `white`

- script.color.text_extension

  - description: text color of extension in script buffer

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `242`

- script.color.text_extension_selected

  - description: text color of extension for selected line in script buffer

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `248`

- script.color.text_name

  - description: text color of script name in script buffer

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `73`

- script.color.text_name_selected

  - description: text color of script name for selected line in script buffer

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `51`

- script.color.text_selected

  - description: text color for selected line in script buffer

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `white`

- script.color.text_tags

  - description: text color of tags in script buffer

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `brown`

- script.color.text_tags_selected

  - description: text color of tags for selected line in script buffer

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `yellow`

- script.color.text_version

  - description: text color of version in script buffer

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `100`

- script.color.text_version_loaded

  - description: text color of version loaded in script buffer

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `246`

- script.color.text_version_loaded_selected

  - description: text color of version loaded for selected line in script buffer

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `white`

- script.color.text_version_selected

  - description: text color of version for selected line in script buffer

  - type: color

  - values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "%" for blink, "." for "dim" (half bright), "*" for bold, "!" for reverse, "/" for italic, "_" for underline

  - default value: `228`

- script.look.columns

  - description: format of columns displayed in script buffer: following column identifiers are replaced by their values: %a=author, %d=description, %D=date added, %e=extension, %l=language, %L=license, %n=name with extension, %N=name, %r=requirements, %s=status, %t=tags, %u=date updated, %v=version, %V=version loaded, %w=min_weechat, %W=max_weechat)

  - type: string

  - values: any string

  - default value: `"%s %n %V %v %u | %d | %t"`

- script.look.diff_color

  - description: colorize output of diff

  - type: boolean

  - values: on, off

  - default value: `on`

- script.look.diff_command

  - description: command used to show differences between script installed and the new version in repository ("auto" = auto detect diff command (git or diff), empty value = disable diff, other string = name of command, for example "diff")

  - type: string

  - values: any string

  - default value: `"auto"`

- script.look.display_source

  - description: display source code of script on buffer with detail on a script (script is downloaded in a temporary file when detail on script is displayed)

  - type: boolean

  - values: on, off

  - default value: `on`

- script.look.quiet_actions

  - description: quiet actions on script buffer: do not display messages on core buffer when scripts are installed/removed/loaded/unloaded (only errors are displayed)

  - type: boolean

  - values: on, off

  - default value: `on`

- script.look.sort

  - description: default sort keys for scripts: comma-separated list of identifiers: a=author, A=autoloaded, d=date added, e=extension, i=installed, l=language, n=name, o=obsolete, p=popularity, r=running, u=date updated; char "-" can be used before identifier to reverse order; example: "i,u": installed scripts first, sorted by update date

  - type: string

  - values: any string

  - default value: `"i,p,n"`

- script.look.translate_description

  - description: translate description of scripts (if translation is available in your language, otherwise English version is used)

  - type: boolean

  - values: on, off

  - default value: `on`

- script.look.use_keys

  - description: use keys alt+X in script buffer to do actions on scripts (alt+i = install, alt+r = remove, ...); if disabled, only the input is allowed: i, r, ...

  - type: boolean

  - values: on, off

  - default value: `on`

- script.scripts.autoload

  - description: autoload scripts installed (make a link in "autoload" directory to script in parent directory)

  - type: boolean

  - values: on, off

  - default value: `on`

- script.scripts.cache_expire

  - description: local cache expiration time, in minutes (-1 = never expires, 0 = always expire)

  - type: integer

  - values: -1 .. 525600

  - default value: `1440`

- script.scripts.download_enabled

  - description: enable download of files from the scripts repository when the /script command is used (list of scripts and scripts themselves); the list of scripts is downloaded from the URL specified in the option script.scripts.url; WeeChat will sometimes download again the list of scripts when you use the /script command, even if you don't install a script

  - type: boolean

  - values: on, off

  - default value: `off`

- script.scripts.download_timeout

  - description: timeout (in seconds) for download of scripts and list of scripts

  - type: integer

  - values: 1 .. 3600

  - default value: `30`

- script.scripts.hold

  - description: scripts to "hold": comma-separated list of scripts which will never been upgraded and cannot be removed, for example: "go.py,urlserver.py"

  - type: string

  - values: any string

  - default value: `""`

- script.scripts.path

  - description: local cache directory for scripts (path is evaluated, see function string_eval_path_home in plugin API reference)

  - type: string

  - values: any string

  - default value: `"${weechat_cache_dir}/script"`

- script.scripts.url

  - description: URL for file with list of scripts

  - type: string

  - values: any string

  - default value: `"https://weechat.org/files/plugins.xml.gz"`

#### Wtyczki skryptowe

##### Komendy wtyczki python

- `python`: list/load/unload scripts

    /python  list|listfull [<name>]
             load [-q] <filename>
             autoload
             reload|unload [-q] [<name>]
             eval [-o|-oc] <code>
             version

        list: list loaded scripts
    listfull: list loaded scripts (verbose)
        load: load a script
    autoload: load all scripts in "autoload" directory
      reload: reload a script (if no name given, unload all scripts, then load all scripts in "autoload" directory)
      unload: unload a script (if no name given, unload all scripts)
    filename: script (file) to load
          -q: quiet mode: do not display messages
        name: a script name (name used in call to "register" function)
        eval: evaluate source code and display result on current buffer
          -o: send evaluation result to the buffer without executing commands
         -oc: send evaluation result to the buffer and execute commands
        code: source code to evaluate
     version: display the version of interpreter used

    Without argument, this command lists all loaded scripts.

##### Komendy wtyczki perl

- `perl`: list/load/unload scripts

    /perl  list|listfull [<name>]
           load [-q] <filename>
           autoload
           reload|unload [-q] [<name>]
           eval [-o|-oc] <code>
           version

        list: list loaded scripts
    listfull: list loaded scripts (verbose)
        load: load a script
    autoload: load all scripts in "autoload" directory
      reload: reload a script (if no name given, unload all scripts, then load all scripts in "autoload" directory)
      unload: unload a script (if no name given, unload all scripts)
    filename: script (file) to load
          -q: quiet mode: do not display messages
        name: a script name (name used in call to "register" function)
        eval: evaluate source code and display result on current buffer
          -o: send evaluation result to the buffer without executing commands
         -oc: send evaluation result to the buffer and execute commands
        code: source code to evaluate
     version: display the version of interpreter used

    Without argument, this command lists all loaded scripts.

##### Komendy wtyczki ruby

- `ruby`: list/load/unload scripts

    /ruby  list|listfull [<name>]
           load [-q] <filename>
           autoload
           reload|unload [-q] [<name>]
           eval [-o|-oc] <code>
           version

        list: list loaded scripts
    listfull: list loaded scripts (verbose)
        load: load a script
    autoload: load all scripts in "autoload" directory
      reload: reload a script (if no name given, unload all scripts, then load all scripts in "autoload" directory)
      unload: unload a script (if no name given, unload all scripts)
    filename: script (file) to load
          -q: quiet mode: do not display messages
        name: a script name (name used in call to "register" function)
        eval: evaluate source code and display result on current buffer
          -o: send evaluation result to the buffer without executing commands
         -oc: send evaluation result to the buffer and execute commands
        code: source code to evaluate
     version: display the version of interpreter used

    Without argument, this command lists all loaded scripts.

##### Komendy wtyczki lua

- `lua`: list/load/unload scripts

    /lua  list|listfull [<name>]
          load [-q] <filename>
          autoload
          reload|unload [-q] [<name>]
          eval [-o|-oc] <code>
          version

        list: list loaded scripts
    listfull: list loaded scripts (verbose)
        load: load a script
    autoload: load all scripts in "autoload" directory
      reload: reload a script (if no name given, unload all scripts, then load all scripts in "autoload" directory)
      unload: unload a script (if no name given, unload all scripts)
    filename: script (file) to load
          -q: quiet mode: do not display messages
        name: a script name (name used in call to "register" function)
        eval: evaluate source code and display result on current buffer
          -o: send evaluation result to the buffer without executing commands
         -oc: send evaluation result to the buffer and execute commands
        code: source code to evaluate
     version: display the version of interpreter used

    Without argument, this command lists all loaded scripts.

##### Komendy wtyczki tcl

- `tcl`: list/load/unload scripts

    /tcl  list|listfull [<name>]
          load [-q] <filename>
          autoload
          reload|unload [-q] [<name>]
          eval [-o|-oc] <code>
          version

        list: list loaded scripts
    listfull: list loaded scripts (verbose)
        load: load a script
    autoload: load all scripts in "autoload" directory
      reload: reload a script (if no name given, unload all scripts, then load all scripts in "autoload" directory)
      unload: unload a script (if no name given, unload all scripts)
    filename: script (file) to load
          -q: quiet mode: do not display messages
        name: a script name (name used in call to "register" function)
        eval: evaluate source code and display result on current buffer
          -o: send evaluation result to the buffer without executing commands
         -oc: send evaluation result to the buffer and execute commands
        code: source code to evaluate
     version: display the version of interpreter used

    Without argument, this command lists all loaded scripts.

##### Komendy wtyczki guile

- `guile`: list/load/unload scripts

    /guile  list|listfull [<name>]
            load [-q] <filename>
            autoload
            reload|unload [-q] [<name>]
            eval [-o|-oc] <code>
            version

        list: list loaded scripts
    listfull: list loaded scripts (verbose)
        load: load a script
    autoload: load all scripts in "autoload" directory
      reload: reload a script (if no name given, unload all scripts, then load all scripts in "autoload" directory)
      unload: unload a script (if no name given, unload all scripts)
    filename: script (file) to load
          -q: quiet mode: do not display messages
        name: a script name (name used in call to "register" function)
        eval: evaluate source code and display result on current buffer
          -o: send evaluation result to the buffer without executing commands
         -oc: send evaluation result to the buffer and execute commands
        code: source code to evaluate
     version: display the version of interpreter used

    Without argument, this command lists all loaded scripts.

##### Komendy wtyczki php

- `php`: list/load/unload scripts

    /php  list|listfull [<name>]
          load [-q] <filename>
          autoload
          reload|unload [-q] [<name>]
          eval [-o|-oc] <code>
          version

        list: list loaded scripts
    listfull: list loaded scripts (verbose)
        load: load a script
    autoload: load all scripts in "autoload" directory
      reload: reload a script (if no name given, unload all scripts, then load all scripts in "autoload" directory)
      unload: unload a script (if no name given, unload all scripts)
    filename: script (file) to load
          -q: quiet mode: do not display messages
        name: a script name (name used in call to "register" function)
        eval: evaluate source code and display result on current buffer
          -o: send evaluation result to the buffer without executing commands
         -oc: send evaluation result to the buffer and execute commands
        code: source code to evaluate
     version: display the version of interpreter used

    Without argument, this command lists all loaded scripts.

##### Opcje dla języka Python

Sekcje w pliku python.conf:

Sekcja | Komenda | Opis
--- | --- | ---
`look` | `/set python.look.*` | Wygląd.

Opcje:

- python.look.check_license

  - description: check the license of scripts when they are loaded: if the license is different from the plugin license, a warning is displayed

  - type: boolean

  - values: on, off

  - default value: `off`

- python.look.eval_keep_context

  - description: keep context between two calls to the source code evaluation (option "eval" of script command or info "%s_eval"); a hidden script is used to eval script code; if this option is disabled, this hidden script is unloaded after each eval: this uses less memory, but is slower

  - type: boolean

  - values: on, off

  - default value: `on`

##### Opcje dla języka Perl

Sekcje w pliku perl.conf:

Sekcja | Komenda | Opis
--- | --- | ---
`look` | `/set perl.look.*` | Wygląd.

Opcje:

- perl.look.check_license

  - description: check the license of scripts when they are loaded: if the license is different from the plugin license, a warning is displayed

  - type: boolean

  - values: on, off

  - default value: `off`

- perl.look.eval_keep_context

  - description: keep context between two calls to the source code evaluation (option "eval" of script command or info "%s_eval"); a hidden script is used to eval script code; if this option is disabled, this hidden script is unloaded after each eval: this uses less memory, but is slower

  - type: boolean

  - values: on, off

  - default value: `on`

##### Opcje dla języka Ruby

Sekcje w pliku ruby.conf:

Sekcja | Komenda | Opis
--- | --- | ---
`look` | `/set ruby.look.*` | Wygląd.

Opcje:

- ruby.look.check_license

  - description: check the license of scripts when they are loaded: if the license is different from the plugin license, a warning is displayed

  - type: boolean

  - values: on, off

  - default value: `off`

- ruby.look.eval_keep_context

  - description: keep context between two calls to the source code evaluation (option "eval" of script command or info "%s_eval"); a hidden script is used to eval script code; if this option is disabled, this hidden script is unloaded after each eval: this uses less memory, but is slower

  - type: boolean

  - values: on, off

  - default value: `on`

##### Opcje dla języka Lua

Sekcje w pliku lua.conf:

Sekcja | Komenda | Opis
--- | --- | ---
`look` | `/set lua.look.*` | Wygląd.

Opcje:

- lua.look.check_license

  - description: check the license of scripts when they are loaded: if the license is different from the plugin license, a warning is displayed

  - type: boolean

  - values: on, off

  - default value: `off`

- lua.look.eval_keep_context

  - description: keep context between two calls to the source code evaluation (option "eval" of script command or info "%s_eval"); a hidden script is used to eval script code; if this option is disabled, this hidden script is unloaded after each eval: this uses less memory, but is slower

  - type: boolean

  - values: on, off

  - default value: `on`

##### Opcje dla języka Tcl

Sekcje w pliku tcl.conf:

Sekcja | Komenda | Opis
--- | --- | ---
`look` | `/set tcl.look.*` | Wygląd.

Opcje:

- tcl.look.check_license

  - description: check the license of scripts when they are loaded: if the license is different from the plugin license, a warning is displayed

  - type: boolean

  - values: on, off

  - default value: `off`

- tcl.look.eval_keep_context

  - description: keep context between two calls to the source code evaluation (option "eval" of script command or info "%s_eval"); a hidden script is used to eval script code; if this option is disabled, this hidden script is unloaded after each eval: this uses less memory, but is slower

  - type: boolean

  - values: on, off

  - default value: `on`

##### Opcje dla języka Guile

Sekcje w pliku guile.conf:

Sekcja | Komenda | Opis
--- | --- | ---
`look` | `/set guile.look.*` | Wygląd.

Opcje:

- guile.look.check_license

  - description: check the license of scripts when they are loaded: if the license is different from the plugin license, a warning is displayed

  - type: boolean

  - values: on, off

  - default value: `off`

- guile.look.eval_keep_context

  - description: keep context between two calls to the source code evaluation (option "eval" of script command or info "%s_eval"); a hidden script is used to eval script code; if this option is disabled, this hidden script is unloaded after each eval: this uses less memory, but is slower

  - type: boolean

  - values: on, off

  - default value: `on`

##### Opcje dla języka PHP

Sekcje w pliku php.conf:

Sekcja | Komenda | Opis
--- | --- | ---
`look` | `/set php.look.*` | Wygląd.

Opcje:

- php.look.check_license

  - description: check the license of scripts when they are loaded: if the license is different from the plugin license, a warning is displayed

  - type: boolean

  - values: on, off

  - default value: `off`

- php.look.eval_keep_context

  - description: keep context between two calls to the source code evaluation (option "eval" of script command or info "%s_eval"); a hidden script is used to eval script code; if this option is disabled, this hidden script is unloaded after each eval: this uses less memory, but is slower

  - type: boolean

  - values: on, off

  - default value: `on`

## 16. Wsparcie

Przed pytaniem o pomoc upewnij się, że przeczytałeś dokumentację i FAQ dostarczone z WeeChat.

Wsparcie w sieci IRC na serwerze irc.libera.chat:

- oficjalne kanały (z developerami):

  - #weechat (Angielski)

  - #weechat-fr (Francuski)

- nieoficjalne kanały:

  - #weechat-de (Niemiecki)

  - #weechat-fi (Fiński)

Inne opcje uzyskania wsparcia można znaleźć na tej stronie ↗.