WeeChat クイックスタートガイド

X 用端末エミュレータは rxvt-unicode を推奨します: UTF-8 がサポートされており、デフォルトのキーバインドで問題が発生しないためです。

シェルから起動するには:

WeeChat はすべてのコマンドにヘルプがあります。ヘルプを見るには、以下のコマンドを入力してください:

特定のコマンドに対するヘルプを見るには、以下のコマンドを入力してください:

各オプションに関するヘルプもあります:

(ここで config は設定名 (core の場合は weechat もしくはプラグイン名)、section はこの設定のセクション、option はオプション名)。

オプションを設定するには以下のコマンドを入力してください:

オプション設定はすぐに反映されます (設定変更後に WeeChat を再起動する必要は ありません)。

すべての設定は WeeChat の終了時 (または強制的に設定保存を行う /save コマンドを使用した場合) に保存されます。

fset プラグインを使えばオプションを簡単に閲覧、変更できます。

WeeChat オプションの表示:

IRC オプションの表示:

/fset コマンドに対してもオプション名の部分補完機能が使えるため、例えば /fset hot を入力した後、Tab を押すことで、/fset hotlist のように補完されます。その後 Enter を押すことで、ホットリストに関するオプションが表示されます。

/fset コマンドとキーについては /help fset を参照してください。

WeeChat の "core" にはユーザインタフェースに関わるものだけが含まれているため、プラグインがなければ使い物になりません (以前からのユーザーへ: IRC 関連は WeeChat バージョン 0.2.6 までコアに含まれていました)。

IRC 等全てのネットワークプロトコルはそれぞれ異なるプラグインで提供しています。

/plugin コマンドで読み込まれているプラグイン一覧を表示できます。"irc" やその他のプラグインはここから確認してください。

IRC サーバを追加するには /server コマンドを使ってください、例:

このコマンドにおいて、libera は WeeChat が使う内部サーバ名です: 接続時には /connect libera を使うことが可能で、このサーバに関するオプションは irc.server.libera.xxx になります。

書式が思い出せない場合はヘルプを利用してください:

もしサーバオプションが特に設定されていない場合、WeeChat はデフォルト設定をすべてのサーバに適用します (フォールバック方式)。これらのデフォルト設定は "irc.server_default.*" です。

サーバオプションが定義されていれば ("null" でなければ) それを使用します。定義されていなければ、WeeChat はデフォルト設定を使用します ("irc.server_default.xxx")。

例えばデフォルトでは (un*x ログイン名をベースにした) ニックネームが設定されますが、以下のコマンドで libera サーバ用の設定として上書きすることが可能です:

ユーザ名と実名を設定する場合:

サーバへの自動接続を設定する場合:

サーバで SASL を利用可能な場合、SASL を利用してニックネーム認証することができます (チャンネル参加前にニックネーム認証が行われるでしょう):

例えば nickserv との認証などを行うためにサーバ接続後にコマンドを実行するには (SASL を利用して認証を行わない場合):

設定ファイル内にパスワードを直接書きたくない場合、保護データを使うことが可能です。

最初にパスフレーズを登録します:

その後に libera のパスワードを含む保護データを追加します:

こうすることで前述したようにパスワードを IRC オプションに直接書くのではなく ${sec.data.libera_password} を指定可能になります。例えば以下のように設定します:

チャンネルへの自動参加を設定する場合:

The /autojoin command lets you configure the autojoin option easily (see /help autojoin).

You can also configure WeeChat to automatically update the autojoin option when you join or leave channels:

サーバオプションの代わりにデフォルトの値を使用する、例えばデフォルトのニックネーム (irc.server_default.nicks) を使用する場合:

その他設定: その他のオプションも以下のコマンドで設定できます ("xxx" は設定名です):

With this command, WeeChat connects to the libera server and auto-joins the channels configured in the "autojoin" server option.

デフォルトでは、サーババッファは WeeChat の core バッファとマージされます。core バッファとサーババッファ間で切り替えたい場合は、Ctrl+x が使用できます。

サーババッファへの自動マージを無効にして 独立したサーババッファにすることができます:

チャンネルに参加します

チャンネルから退出します (バッファは開いたままにします):

サーバから切断し、チャンネルやプライベートバッファを閉じます (/close は /buffer close の別名です):

サーババッファ上で実行することで、サーバから切断します:

バッファを開いてメッセージを他のユーザ (ニックネーム foo) 宛に送信する:

プライベートバッファを閉じる:

バッファは番号、カテゴリおよび名前とともにプラグインに関連づけられたあるコンポーネントです。バッファは画面に表示するデータを含んでいます。

ウィンドウはバッファを表示するためにあります。デフォルトでは、1 つのウィンドウは 1 つのバッファだけを表示できます。画面を分割することで、同時に複数のウィンドウと関連するバッファを見ることができるでしょう。

バッファとウィンドウを管理するためのコマンド:

例えば、ウィンドウを垂直方向に小さいウィンドウ (1/3 幅) と大きいウィンドウ (2/3 幅) に分割する場合は次のコマンドを実行します:

分割を元に戻す:

WeeChat はデフォルトでたくさんのショートカットキーが設定されています。これらはドキュメントに記載されていますが、いくつか重要なキーがあります:

必要であれば、/key コマンドでショートカットキーの割り当てを変更することができます。キーコードを調べるには、Alt+k が役に立つでしょう。

例えば、Alt+! に /buffer close を割り当てる場合:

コマンドラインには以下のように表示されます:

キー割り当てを解除する場合:

Debian のようにいくつかのディストリビューションでは、プラグイン用パッケージが独立して用意されています (例えば weechat-plugins)。 見つかったプラグインは自動的に読み込まれます (プラグインやスクリプトのロード、有効/無効は WeeChat のドキュメントを参照してください)。

WeeChat では多くの外部スクリプト (貢献者の作った) を利用できます、スクリプトをリポジトリからダウンロードしてインストールするには、/script コマンドを使ってください、例:

より詳しい情報を参照するには /help script を使ってください。

A list of scripts is available in WeeChat with /script or on this page ^↗.

You can now use WeeChat and read FAQ/documentation ^↗ for any other questions.

WeeChat をお楽しみください!