WeeChat FAQ (よくある質問)

"Wee" は再帰的頭字語で、"Wee Enhanced Environment" の略です。そのため、完全な名前は "Wee Enhanced Environment for Chat" です。

"Wee" はまた「とても小さい」を意味します。(もちろん、その他の意味もありますが、それは WeeChat とは関係ありませんよ!)。

WeeChat は非常に軽く、革新的な機能を備えているからです。

More info on the WeeChat features page ^↗.

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

WeeChat must be compiled with CMake.

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

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

Homebrew ^↗ を使うことをお勧めします、ヘルプを見るには:

以下のコマンドで WeeChat をインストールします:

ヘルプを見るには、/help と入力してください。コマンドに関するヘルプを見るには、/help command と入力してください。キー ^↗とコマンド ↗^は文書中で説明されています。

新しいユーザはクイックスタートガイド ^↗を読むことをお勧めします

これは良くある問題であり、様々な原因に起因しています。以下の内容をよく読んで、全ての 解決策をチェックしてください:

この問題は libc の wcwidth 関数のバグによって引き起こされている可能性があります。これは glibc 2.22 で修正されているはずです (使用中のディストリビューションではまだ提供されていないかもしれません)

次の回避方法を使えば、修正済みの wcwidth 関数を使う事が可能です: https://blog.nytsoi.net/2015/05/04/emoji-support-for-weechat ^↗.

See this bug report ^↗ for more information.

シェルの TERM 変数に間違った値が設定されている可能性があります (端末で echo $TERM の出力を確認してください)。

WeeChat を起動した場所に依存しますが、以下の値を持つはずです:

もし必要であれば、TERM 変数を修正してください: export TERM="xxx"

シェルの TERM 変数に間違った値が設定されている可能性があります (端末、screen/tmux の外 で echo $TERM の出力を確認してください)。
例えば、xterm-color の場合、おかしな文字列が表示される可能性があります。xterm と設定すればこのようなことは起こらないので (その他多くの値でも問題は起きません)、これを使ってください。
もし必要であれば、TERM 変数を修正してください: export TERM="xxx"

gnome-terminal を使っている場合、設定/プロファイル/互換性メニュー内にある「曖昧幅の文字」を 半角 にしてください。

ncursesw を自分でコンパイルした場合は、標準の (システムに元から存在する) ncurses を使ってみてください。

さらに macOS では、Homebrew パッケージマネージャを使って WeeChat をインストールすることをお勧めします。

バッファ とは番号、名前、表示行 (とその他のデータ) からなります。

ウィンドウ とはバッファを表示する画面エリアです。画面を複数のウィンドウに分割出来ます。

それぞれのウィンドウは 1 つのバッファの内容もしくは複数のバッファの内容をマージして表示します。バッファを隠す (ウィンドウで表示させない) ことや 1 つ以上のウィンドウに表示させることも出来ます。

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

To limit size of bar:

バッファリストバーの位置を下に移動するには以下の方法を使ってください:

buflist バーをスクロールする方法: マウスを有効化しているならば (キー: Alt+m)、マウスホイールでバッファリストバーをスクロールできます。

buflist バーをスクロールするデフォルトキーは F1 (または Ctrl+F1)、F2 (または Ctrl+F2)、Alt+F1、Alt+F2 です。

You can browse all buflist options with the command:

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

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

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

チャットエリアのニックネームの最大長を短くするには:

ニックネーム整列を抑制するには:

これは「ホットリスト」と呼ばれ、ここにはバッファ番号およびそのバッファの未読メッセージカウンタが表示されます。未読メッセージカウンタの表示順はハイライト、プライベートメッセージ、一般メッセージ、その他のメッセージ (参加/退出メッセージなど) の順です。
バッファの「未読メッセージ」とは、最後にそのバッファにフォーカスが移された以降に表示されたり受信した新しいメッセージを意味します。

上記の例 [H: 3(1,8), 2(4)] の場合:

バッファおよびカウンタのテキスト色はメッセージの種類を意味します。色のデフォルト設定は以下です:

これらの色を変えるには、weechat.color.status_data_* オプション (バッファ) および weechat.color.status_count_* オプション (カウンタ) を設定します。
その他のホットリスト関連オプションは weechat.look.hotlist_* オプションを使って変更します。

ホットリストに関する詳しい情報はユーザーズガイド / 画面レイアウト ^↗を参照してください

インプットバーの size オプションには 1 (サイズ固定、デフォルト値) 以上の値または動的なサイズの意味で 0 を設定できます。size_max オプションではサイズの最大値を設定できます (0 = 制限なし)。

動的サイズを設定する例:

サイズの最大値を 2 に設定:

できます。"root" 型のバー (あなたのいるウィンドウを区別するための要素を持つ) を作成し、現在の入力バーを削除してください。

例えば:

これに満足できない場合は、新しいバーを削除してください。全てのバーに "input_text" 要素が設定されていない場合は WeeChat は自動的にデフォルトバー "input" を作成します:

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

矩形選択のできる端末を使ってください (rxvt-unicode、konsole、gnome-terminal、…​)。通常、キーは Ctrl + Alt + マウス選択です。

別の解決策はニックネームリストを上か下かに移動することです、例えば:

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

URL を簡単にクリックできるようにするには、以下を試してみてください:

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

別の解決策として、スクリプトを利用することもできます:

Sure it is possible:

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

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

In WeeChat, the new value is immediately used:

最初に TERM 環境変数が正しいことを確認してください、お勧めの値は:

screen を使っている場合は、以下の行を ~/.screenrc に追加してください:

TERM 変数が間違った値に設定された状態で WeeChat が起動完了している場合は、以下の 2 つのコマンドを使って変数の値を変更してください:

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

色管理に関するより詳しい情報はユーザーズガイド / 色 ^↗を参照してください

デフォルトのキーは Ctrl+r です (コマンドは: /input search_text_here)。 ハイライト部分へのジャンプは: Alt+p / Alt+n

この機能に関するより詳しい情報はユーザーズガイド / デフォルトのキー割り当て ^↗を参照してください

端末に特殊コードを送信してフォーカスイベントを必ず有効化してください。

重要:

WeeChat の開始時にコードを送信するには:

さらに端末から送信される 2 種類の特殊キーシーケンスに対してコマンドを割り当ててください (例に挙げた /print コマンドは適当なコマンドに書き換えてください):

端末のフォーカスが外れた時点でバッファに未読マークをつける例:

scrreen がデフォルトで有効化されている括弧付きペーストオプションの挙動を別のウィンドウ内で適切に処理できないことが原因です。

括弧付きペーストモードを無効化するには以下のコマンドを使います:

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

Terminal 80x25, with default configuration:

Terminal 80x25, after changes:

xterm や uxterm 等の端末を利用している場合、いくつかのメタキーはデフォルトでは利用できません。以下の行を ~/.Xresources に追加してください:

このファイルをリロードするか (xrdb -override ~/.Xresources) または X を再起動してください。

macOS のターミナル.app を使っている場合、設定メニューのキーボードから「メタキーとして option キーを使用」を有効化してください。こうすることで、Option キーをメタキーとして使うことが可能です。

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

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

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

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

キー割り当ては /key コマンドでカスタマイズできます。

デフォルトキー Alt+k でキーコードを取り込み、これをコマンドラインに入力できます。

キー Alt+j の後に 2 桁の数字を入力します、例えば Alt+j その後に 1、1 でバッファ 11 番にジャンプします。

これにキーを割り当てることが出来ます、例えば:

デフォルトキー割り当てのリストはユーザーズガイド / デフォルトのキー割り当て ^↗を参照してください

番号 100 以上のバッファにジャンプするには、以下のトリガを定義してください。こうすることでコマンド /123 でバッファ #123 にジャンプできるようになります:

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

上下矢印キーをグローバルヒストリに割り当ててください (グローバルヒストリに対するデフォルトのキーは Ctrl+↑ と Ctrl+↓ です。

例:

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

最初にマウスを有効化してください:

これでマウスが動かない場合は、シェルの TERM 変数を確認してください (端末内で echo $TERM の出力を見てください)。端末の種類によってはマウスがサポートされていない可能性があります。

マウスサポートを端末から確認するには:

端末の最初の文字 (左上) をクリックしてください。" !!#!!" と見えるはずです。

端末のマウスサポートを無効化するには:

一部の端末ではマウスの位置座標を指定するために ISO 文字だけを使います、 このため X/Y が 94 (または 222) よりも大きい場合は正しく動きません。

マウスの位置座標を指定するのに UTF-8 座標をサポートしている端末を使ってください、 例えば rxvt-unicode 等です。

WeeChat でマウスが利用可能な場合、Shift キーを押しながら端末をクリックして選択してください、マウスが無効化されます (例えば iTerm 等の場合、Shift の代わりに Alt を使ってください)。

macOS をお使いの場合、必ず Homebrew から openssl をインストールしてください。こうすることでシステムの鍵束に含まれる証明書を使いつつ、CA

gnutls ハンドシェイクに関するエラーの場合、Diffie-Hellman キー (デフォルトは 2048) のサイズを小さくすることを試してみてください:

証明書に関するエラーの場合、"tls_verify" を無効化してください (接続の機密保護がより甘くなることに注意):

サーバが不正な証明書を持っており、正常な証明書がどのようなものであるかわかっている場合、証明書の指紋を設定しておくことが可能です (SHA-512、SHA-256、SHA-1):

You can try a different priority string, replace "xxx" by your server name:

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

サーバポート、TLS を設定の後に接続してください:

twitch などの一部のサーバは接続するために oauth が必要です。

oauth を使うにはパスワードを "oauth:XXXX" のように指定してください。

以下のコマンドを使って、この種のサーバを追加し接続することが可能です (サーバ名とアドレスは適切な値を使ってください):

サーバで SASL を利用可能なら、nickserv 認証のコマンドを送信するよりも SASL を利用する方が良いです。例えば:

対象のサーバが SASL をサポートしない場合、コマンドとチャンネル参加の間に遅延時間を入れることもできます:

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

For all servers:

For a single server:

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

Or another channel:

There are also scripts:

/ignore コマンドは IRC コマンドです、このため IRC バッファ (サーバとチャンネル) にのみ有効です。これを使うことでニックネームやホスト名を基準にして、あるサーバやチャンネルにいる一部のユーザを無視できます (表示済みメッセージに対しては適用されません)。マッチするメッセージは IRC プラグインによって表示される前に削除されます (無視設定されたものは完全に見えなくなります。無視設定を元に戻すには、無視エントリを削除してください)。

/filter コマンドは WeeChat のコアコマンドです。このため、このコマンドの結果は任意のバッファに適用されます。バッファ内の行のプレフィックスと内容に基づいて付けられたタグや正規表現にマッチする行をフィルタすることが可能です。 フィルタされた行は隠されているだけで削除されているわけではありません。このため、フィルタを無効化 (デフォルトでは Alt+= でフィルタの有効無効を切り替えられます) すれば見ることが可能です。

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

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

メッセージを隠す (ただしバッファに残す) には、タグを使ってメッセージをフィルタしてください (たとえばチャンネル作成日時を隠すには irc_329 タグを使ってください)。フィルタの書き方に関する情報は /help filter を参照してください。

voice メッセージをフィルタするのは簡単ではありません、なぜなら voice モードの設定は同じ IRC メッセージの中で他のモード設定と同時に行われる可能性があるからです。

Bitlbee は離席ユーザを表示するために voice を利用します。このため、voice メッセージでチャットエリアが溢れてしまいます。おそらくこれをフィルタしたいのではないでしょうか。この様な場合には、Bitlbee が離席状態を通知することを禁止し、WeeChat にニックネームリスト中に含まれる離席中のニックネームに対して特別な色を使わせることができます。

Bitlbee 3 以上の場合、以下のコマンドをチャンネル &bitlbee で入力:

Bitlbee の古いバージョンでは、以下のコマンドを &bitlbee で入力:

WeeChat で離席中のニックネームをチェックするには、離席状態のニックネームに関する質問を参照してください。

もし本当に voice メッセージをフィルタしたい場合は、以下のコマンドを使ってください、ただしこれは完璧なものではありません (voice モードの変更が最初に指定されている場合のみ有効)。

オプション irc.server_default.away_check に正の値を設定してください (離席状態確認のインターバルを分単位で)。

オプション irc.server_default.away_check_max_nicks を設定することで離席状態確認を小さなチャンネルのみに制限できます。

例えば、5 分間隔で離席状態確認を行い、25 人より多いチャンネルではこれを行わないようにするには:

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

もしくは "beep" トリガにコマンドを追加することもできます:

古い WeeChat をお使いの場合、beep.pl や launcher.pl 等のスクリプトを使ってください。

launcher.pl の場合、コマンドの設定が必要です:

この問題に対するその他のスクリプトは:

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

ハイライトを無効化するだけなら、このプロパティを 2 に設定してください.

For the current buffer:

For all channels on server "libera":

デフォルトのキーは Ctrl+x です (コマンドは: /buffer switch)。

OpenBSD では、プラグインファイル名の末尾が ".so.0.0" です (Linux では ".so")。

以下の様に設定してください:

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

スクリプトは他の IRC クライアントのものと互換性がありません。

手始めに、この FAQ の TLS 接続に関する質問を確認してください。

それでもだめなら、手作業で (シェルから) スクリプトリストファイルを削除してください:

その後、WeeChat からスクリプトリストを更新してください:

それでもまだエラーが出るなら、WeeChat に含まれるファイルの自動更新を無効化して、WeeChat を使わずに手作業でファイルをダウンロードしなければいけません (つまり、更新を入手するには自分自身でそのファイルを更新しなければいけないということです):

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

spell プラグインをリロードしてください:

可能ですが、非推奨 です。

その代わり WeeChat 内でコマンド /set を使うことを推奨します。その理由は:

それでもなお手作業で設定ファイルを編集したいなら、以下の点に注意してください:

メモリ使用量を減らすには以下のヒントを試してください:

以下に挙げる memory に関するヒントに従ってください:

IRC の退出および終了メッセージを無効化します:

すべての CTCP クエリに対する応答を無効化します:

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

"xfer" プラグイン (これは IRC DCC 機能を使うためのものです) をアンロードして自動ロードを無効化します:

パスフレーズを定義してパスワードなどの保護したいデータの使用時は常にセキュアデータを使います: /help secure およびセキュアデータを使用したいオプションの /help を参照してください (セキュアデータを使うことが可能なオプションのヘルプにはこの点が明記されています)。 ユーザーズガイド / 暗号化データ ^↗ を参照してください。

例:

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

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

設定ファイルに関する詳しい情報はユーザーズガイド / ファイルとディレクトリ ^↗を参照してください。

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

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

Steps:

See this page ^↗.

gdb で WeeChat を実行する場合、以下のエラーが出るかもしれません:

これを修正するには、以下のコマンドを使って gdb を実行してください (システム上の libpthread と WeeChat へのパスを変更):

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

我々は可能な限り多くのプラットフォームに移植することに最善を尽くしています。我々が持っていない OS で WeeChat をテストすることを歓迎します。

多くの課題があります (テスト、コード、ドキュメント作成、…​)。

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

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