WeeChatのソースを表示

[[Category:Internet Relay Chat]]
[[Category:コンソールアプリケーション]]
[[en:WeeChat]]
{{Related articles start}}
{{Related|IRC チャンネル}}
{{Related|irssi}}
{{Related|HexChat}}
{{Related articles end}}
'''WeeChat''' は高い拡張性を誇る機能豊富な IRC クライアントです。現在も活発に開発されています。

== インストール ==

[[公式リポジトリ]]から {{Pkg|weechat}} を[[インストール]]してください。開発版は [[AUR]] の {{AUR|weechat-git}} でインストールできます。

== 実行 ==

WeeChat は複数のインターフェイスを備えられるようになっています。'''weechat-[interface]''' を実行して WeeChat を起動してください。

現在のところ WeeChat には Ncurses インターフェイスしかありません。WeeChat の起動コマンドは:

 $ weechat

== 設定 ==

デフォルトでは、WeeChat は設定ファイルを [[XDG Base Directory|XDG directory]] に保存します。WeeChat はいつでもファイルを書き込む可能性があるため、これらのファイルを直接編集することはお勧めできません。[https://www.weechat.org/files/doc/stable/weechat_user.en.html#files_and_directories]

代わりに、[https://weechat.org/files/doc/devel/weechat_user.en.html#command_weechat_set /set コマンド] を使用する必要があります。WeeChat バッファウィンドウで {{ic|/set}} を実行すると、設定可能なすべてのオプションのリストを取得できます。デフォルトの設定可能なオプションは 600 近くあるため、ワイルドカード構文 (例として {{ic|/set irc.server.*}} または {{ic|/set *server*}}) を使用して検索できます。{{ic|/help}} コマンドを使用すると、各オプションのヘルプを表示できます。

 /help irc.server.libera.autoconnect

{{Tip|すべての設定ファイルを単一のディレクトリに置きたい場合 ({{ic|~/.weechat}} など)、このオプションを使用します: {{ic|$ weechat -d $HOME/.weechat}} または環境変数 {{ic|WEECHAT_HOME}}}}

== サーバーに接続 ==

IRC サーバーに接続するには、サーバーを追加してから {{ic|/connect}} を使用します:

 /server add libera irc.libera.chat/6697
 /connect libera

詳細については、WeeChat のドキュメントと {{ic|/help server}} を参照してください。

{{Note|事前にサーバーを追加せずに、{{ic|/connect}} を使用した一時的なサーバー接続は許可されません。この機能を有効にするには、最初に {{ic|/set irc.look.temporary_servers on}} を使用します。}}

== SSL の設定 ==

[https://libera.chat/ libera] ([[IRC チャンネル|#archlinux]] を含む) を含む多くの IRC サーバーは SSL をサポートしています。

{{ic|/server}} でサーバーを作成している場合は、SSL ポート (通常は 6697) と {{ic|-tls}} を行の最後に追加します。例えば:

 /server add libera irc.libera.chat/6697 -tls

{{Note|一部のサーバーでは、{{ic|ssl_dhkey_size}} の値をより低い値に変更する必要があります。たとえば、Libera を使用している場合は、コマンド {{ic|/set irc.server.libera.tls_dhkey_size 1024}} または {{ic|/set irc.server.libera.tls_dhkey_size 1024}} コマンドで値を設定する必要があります。(サーバーログを参照)}}

== ヒントとテクニック‎ ==

=== アップグレード ===

WeeChat は、IRC サーバーから切断せずにアップグレードできます (非 SSL 接続のみ):

 /upgrade

これにより、新しい WeeChat バイナリがロードされ、現在の設定が再ロードされます。

=== エイリアス ===

エイリアスを作成して、一般的に実行されるコマンドを簡素化できます。良い例は、Wraithan の '''Smart Filter''' エイリアスです。

'''Smart Filter'''

まず、Smart Filter を有効にする必要があります。

 /set irc.look.smart_filter "on"

次に、'''sfilter''' エイリアスを作成します。

 /alias sfilter filter add irc_smart_$server_$channel irc.$server.$channel irc_smart_filter *

入力できるようになりました

 /sfilter

任意のバッファにある場合、Smart Filter はそのバッファに対してのみ有効になります。

次のエイリアスは、現在のバッファーで以前に有効化された Smart Filter を削除する。エイリアスを追加します:

 /alias rmsfilter filter del irc_smart_$server_$channel

実行

 /rmsfilter

=== Exec コマンド ===

"exec" という新しいプラグインが追加され、コマンドは {{ic|/exec}} です。外部コマンドを実行し、{{ic|-o}} オプションを使用して現在のバッファに出力を表示することも、ローカル (デフォルト) で出力を表示することもできます。

=== キーバインド ===

参照 {{ic|/help key}}

基本的な irssi スタイルのウィンドウスクロールを追加する例:

 /key bind meta-p /window page_up
 /key bind meta-n /window page_down

vimode プラグインを使用している場合、デフォルトのバインディングのほとんどは機能せず、vim のような代替手段が必要になります。[https://github.com/GermainZ/weechat-vimode/#current-key-bindings バインディング] を確認してください。

=== アイドル時に SSH の接続が切れる ===

SSH を使ってリモートシェルから WeeChat に接続している場合、例えば [[GNU Screen]] や [[tmux]] で WeeChat を実行している場合、アイドル状態でしばらくすると接続が切断されることがあります。この現象が発生する原因は複数ありますが、解決する最も簡単な方法はリモートシェル上の SSH 設定にこの設定を追加することで接続を強制的に維持することです。

これは WeeChat 自体とは関係ありませんが、アイドル時に接続が切断されることは代替の [[irssi]] ではデフォルトで起こりません。

{{hc|# /etc/ssh/sshd_config|2=
ClientAliveInterval 300}}

または、[https://mosh.org Mosh] をご覧ください。

=== 絵文字 ===

絵文字はUnicodeセットの一部です。絵文字の要件:

* ターミナルエミュレータはユニコードと絵文字サブセットをサポートしている必要があります。
* ターミナルエミュレータで使用するフォントは、絵文字サブセットに対応している必要があります。

絵文字をサポートするターミナルの不完全なリスト:

* {{Pkg|xfce4-terminal}}
* [[alacritty]]
* [[rxvt-unicode]]

=== マウスのサポート ===

ターミナルエミュレータはマウススクロールイベントを通過し、weechat は [https://weechat.org/files/doc/stable/weechat_user.en.html#screen_layout スクロールイン領域] を通過します。

* チャットエリア
* ニックネームリストバー

==== tmux 内のマウス ====

[[tmux]] で実行する場合は、{{ic|~/.tmux.conf}} でマウスのサポートをオンにします。

 set -g mouse on

=== Matrix ===

{{Pkg|weechat-matrix}} スクリプトを使用すると、[[Matrix]] サーバーに接続できます。それをインストールしてから、次のようにします:

# Weechat 内で {{ic|/script load weechat-matrix.py}} を実行してください、
# [https://github.com/poljar/weechat-matrix#configuration weechat-matrix を設定] します。
# Matrix チャンネルに参加するには、Matrix バッファ内で {{ic|/join}} コマンドを使ってください。

WeeChat の起動時にスクリプトを自動的にロードするには、次のコマンドを実行します:

 $ mkdir -p ~/.local/share/weechat/python/autoload
 $ ln -s /usr/share/weechat/python/weechat-matrix.py -t ~/.local/share/weechat/python/autoload

=== Slack ===

Slack のネイティブクライアントがあります: [https://github.com/rawdigits/wee-slack wee-slack]

=== デスクトップ通知 ===

メンションまたはプライベートメッセージのデスクトップ通知を受信するには、Petr Zemek による {{AUR|weechat-notify-send}} スクリプトを [[インストール]] して下さい。

このスクリプトは {{Pkg|libnotify}} を使用しており、KDE と Gnome の両方で動作します。

組み込みの {{ic|trigger}} プラグインを使用する別の方法は、{{ic|trigger.trigger.beep.command}} の値を設定することです。

 /set trigger.trigger.beep.command "/print -beep;/exec -bg notify-send -i '/usr/share/icons/hicolor/32x32/apps/weechat.png' 'IRC Notification' "${tg_tag_nick}: ${tg_message_nocolor}""

=== モバイルデバイスへの通知 ===

メンションやプライベートメッセージの通知を Android モバイルデバイスで受信するには、[https://www.weechat.org/files/scripts/irssinotifier.py 公式サイト] から WeeChat に [https://irssinotifier.appspot.com/ IrssiNotifier] ポートを接続してください。このスクリプトには Google アカウントと、API キーを取得するためのサービスプロバイダへの登録ステップが必要です。プラグインをインストールします

 $ cd ~/.local/share/weechat/python
 $ curl -O <nowiki>https://www.weechat.org/files/scripts/irssinotifier.py</nowiki>
 $ ln -s ../irssinotifier.py autoload/

WeeChat で API トークンとエンドツーエンド暗号化パスワードを初期化します

 /set plugins.var.python.irssinotifier.api_token your-api-token-from-website
 /set plugins.var.python.irssinotifier.encryption_password your-password-same-as-in-andoid-app
 /save

Google アカウントを必要としない代替手段として、[https://github.com/jamtur01/nma-weechat GitHub] にある [https://www.notifymyandroid.com NotifyMyAndroid.com] 用の Ruby スクリプトがあります。上記と同様の手順で、{{ic|~/.local/weechat/ruby}} にインストールしてください。

=== systemd ユーザーサービスを使用した WeeChat リレー ===

WeeChat インスタンスを他の WeeChat クライアントの WeeChat リレーとして使用するには (IRC リレー機能と混同しないでください)、必要に応じて、WeeChat リレープラグインと [[Systemd/ユーザー|systemd/ユーザーサービス]] のいずれかを使用できます。ヘッドレス操作、または systemd ユーザーサービスと [[tmux]] を組み合わせて完全なコマンドライン機能を維持します。

どちらの方法でも、ディレクトリ {{ic|~/.config/systemd/user/}} にサービスファイルを作成する必要があります。

==== tmux メソッド ====

systemd のジョブ管理方法と tmux のクライアントサーバ動作には非互換性があるため、{{ic|-L}} オプションを使ってデフォルトの tmux セッションと systemd が管理する WeeChat セッションを分離してください。これがデフォルトソケットを使った最初の tmux セッションである場合、WeeChat ユーザサービスを停止して再起動すると、デフォルト tmux ソケットに接続されている全てのセッションが停止します。WeeChat tmux セッションが他のデフォルト tmux セッションの後に開始された場合、systemd が次のサービスユニットに移行すると WeeChat セッションは終了します。WeeChat tmux サーバを独自のソケットに隔離することで、[[systemctl]] を起動した際に期待通りの動作をします。ただし、{{ic|-L}} を使って正しいソケットを選択しないと、tmux を使う際に WeeChat セッションが表示されないことを意味します。

{{hc|~/.config/systemd/user/weechat.service|2=
[Unit]
Description=A WeeChat client and relay service using Tmux
After=network.target

[Service]
Type=forking
RemainAfterExit=yes
ExecStart=/usr/bin/tmux -L weechat new -d -s weechat weechat
ExecStop=/usr/bin/tmux -L weechat kill-session -t weechat

[Install]
WantedBy=default.target
}}

サービスが配置されたら、ユーザーユニットを [[起動/有効化]] して {{ic|loginctl enable-linger}} を実行するだけです。

そこから tmux セッションに接続して、weechat リレープラグインを設定できます:

 $ tmux -L weechat attach

そこから、コンソール上で希望の設定を使用して WeeChat リレープラグインを設定できます: https://www.weechat.org/files/doc/stable/weechat_user.en.html#relay_plugin

tmux ステータスバーを非表示にしたい場合は、このオプションを {{ic|ExecStart}} に追加できます:
 \; set-option status off

セッションで 256 色を表示するには、これを tmux 設定ファイルに追加する必要がある場合があります:
 set -g default-terminal screen-256color

==== ヘッドレス方式 ====

この方法の主な違いは、WeeChat を普通に起動し、リレープラグインを設定し、WeeChat を停止してからサービスを起動するか、WeeChat が起動していない状態で手動で {{ic|relay.conf}} ファイルを編集してからサービスを起動する必要があるということです。いずれにせよ、''systemd'' WeeChat サービスを開始する前にリレー設定を行う必要があります: https://www.weechat.org/files/doc/stable/weechat_user.en.html#relay_plugin

{{hc|~/.config/systemd/user/weechat-headless.service|2=
[Unit]
Description=A headless WeeChat client and relay service 
After=network.target

[Service]
Type=forking
ExecStart=/usr/bin/weechat-headless --daemon

[Install]
WantedBy=default.target
}}

''systemd'' が自動的に PID を追跡し、適切なシャットダウン信号をデーモンに送信するため、{{ic|ExecStop}} を定義する必要がないことに注意してください。

ユーザーユニットを配置したら、それを [[有効化]] します。ヘッドレスリレーを開始する準備ができたら、ユーザーユニットを [[起動]] します。

== トラブルシューティング ==

=== プラグインのロードエラー ===

'''weechat''' を開始すると、メイン ウィンドウに次のような出力が表示される場合があります:

{{bc|<nowiki>13:26:10 =!= | Error: unable to load plugin "/usr/lib/weechat/plugins/ruby.so": libruby.so.2.4: cannot open shared object file: No such file or directory
13:26:10 =!= | If you're trying to load a script and not a C plugin, try command to load scripts (/perl, /python, ...)
13:26:10 =!= | Error: unable to load plugin "/usr/lib/weechat/plugins/lua.so": liblua.so.5.3: cannot open shared object file: No such file or directory
13:26:10 =!= | If you're trying to load a script and not a C plugin, try command to load scripts (/perl, /python, ...)
13:26:10 =!= | Error: unable to load plugin "/usr/lib/weechat/plugins/aspell.so": libaspell.so.15: cannot open shared object file: No such file or directory
13:26:10 =!= | If you're trying to load a script and not a C plugin, try command to load scripts (/perl, /python, ...)
13:26:10 =!= | Error: unable to load plugin "/usr/lib/weechat/plugins/tcl.so": libtcl8.6.so: cannot open shared object file: No such file or directory
13:26:10 =!= | If you're trying to load a script and not a C plugin, try command to load scripts (/perl, /python, ...)</nowiki>|bc}}

weechat のデフォルト設定では、{{ic|/usr/lib/weechat/plugins}} にあるすべてのプラグインをロードしようとします。この場合、ruby、lua、aspell、tcl が含まれます。これらのパッケージは weechat パッケージには必要ないため、マシンにインストールできない場合があります。これらのエラーが気になる場合は、次の 2 つのオプションがあります。

# {{Pkg|ruby}}、{{Pkg|lua}}、{{Pkg|aspell}}、および/または {{Pkg|tcl}} を [[インストール]]
# または、{{ic|/set weechat.plugin.autoload "*,!ruby,!lua,!aspell,!tcl"}} を実行すると、(!) プレフィックスが付いたプラグインがロードされなくなります。

==== multiline.pl の読み込み中に問題が発生しました ====

この問題は、{{Pkg|perl}} バージョン 5.31.1 以上で発生します。

{{ic|multiline.pl}} スクリプトは、{{ic|Pod::Select}} モジュールに依存します。ただし、{{Pkg|perl}} バージョン v5.31.1 以降、{{ic|Pod::Select}} は削除されました。

この問題を解決するには、{{Pkg|perl-pod-parser}} をインストールします。

== 参照 ==

* [http://www.weechat.org Home Page]
* [http://www.weechat.org/doc/ WeeChat Documentation]
* [http://www.weechat.org/scripts/ WeeChat Scripts]
* [http://dev.weechat.org/ WeeChat Development Blog]

=== ガイド ===

* [https://weechat.org/files/doc/stable/weechat_quickstart.en.html Official WeeChat quick start guide] - a good place to start
* [https://guides.fixato.org/weechat FiXato's guide to WeeChat] - A Weechat Contributers Guide
* [https://gist.github.com/pascalpoitras/8406501 My always up-to-date WeeChat configuration] - r3m (weechat-dev)