Irssiのソースを表示

[[Category:Internet Relay Chat]]
[[bg:Irssi]]
[[de:Irssi]]
[[en:Irssi]]
[[es:Irssi]]
[[fr:Irssi]]
[[sv:Irssi]]
[[tr:Irssi]]
[[zh-CN:Irssi]]
[[zh-TW:Irssi]]
{{Related articles start}}
{{Related|IRC チャンネル}}
{{Related|WeeChat}}
{{Related|HexChat}}
{{Related articles end}}
[http://www.irssi.org/ irssi] はモジュール式の、ncurses ベースの IRC (Internet Relay Chat) クライアントです。プラグインにより [[Wikipedia:SILC_(protocol)|SILC]] と [http://www.icb.net/_jrudd/icb/protocol.html ICB] プロトコルもサポートしています。

== インストール ==

{{Pkg|irssi}} パッケージを[[インストール]]してください。

AUR の [https://aur.archlinux.org/packages/?O=0&K=irssi-script irssi-script] や、[http://scripts.irssi.org/ irssi スクリプトリポジトリ] にはスクリプトが多数用意されています。

== 使用方法 ==

詳しい使い方は [http://irssi.org/documentation 公式ドキュメント] を見て下さい。

{{Note|このセクションでは [[Wikipedia:ja:Internet Relay Chat|IRC]] の基本的な知識を既に習得していて他のクライアントを使ったことがあるユーザーを対象にしています。}}

[[tmux]] や [[Screen]] などのターミナルマルチプレクサを使うことが推奨されています。簡単にセッションから切断したり再接続することができ、[http://wouter.coekaerts.be/site/irssi/nicklist nicklist.pl] などのスクリプトはセカンダリウィンドウを使用します。irssi を起動するには、次を実行:

 $ irssi

=== コマンド ===

{| class="wikitable"
! style="font-weight: bold;" | コマンド
! style="font-weight: bold;" | 説明
|-
| {{ic|/server}}, {{ic|/s}}
| 現在のネットワークサーバーを変更。
|-
| {{ic|/connect}}, {{ic|/c}}
| 新しくサーバーに接続する。複数のサーバーに同時に接続するときに使います ({{ic|Ctrl+Shift+x}} でサーバーを切り替えられます)。
|-
| {{ic|/disconnect}}, {{ic|/dc}}
| サーバーとの接続を終了する。
|-
| {{ic|ALT+(1-0,q-p,etc)}}
| 現在のアクティブウィンドウを変更。{{ic|Ctrl+n}} で次のウィンドウに、{{ic|Ctrl+p}} で前のウィンドウに変わります。
|-
| {{ic|/window 1}}
| 最初のウィンドウに移動。キーボードの上段がウィンドウに対応しています: (1-0), (q-p)。
|-
| {{ic|/window close}}, {{ic|/wc}}
| カレントウィンドウを閉じる。
|-
| {{ic|/window move 1}}
| カレントウィンドウを最初のウィンドウの位置に移動。
|-
| {{ic|/layout save}}
| カレントウィンドウの位置を後で使うために保存。
|-
| {{ic|/set}}
| 現在の設定リストを表示。
|-
| {{ic|/help}}
| パラメータの説明を表示。
|-
| {{ic|/alias}}
| ショートカットを作成。
|}

== 設定 ==

個人設定ファイルは {{ic|~/.irssi/config}} に配置します。{{ic|/etc/irssi.conf}} にテンプレートがあります。{{ic|--config}} フラグを使うことで他の設定ファイルを使って irssi を起動できます。

* {{ic|/save}} を使うことで現在の設定を設定ファイルに保存できます。
* {{ic|/layout save}} と入力することで開いているウィンドウの位置を保存できます。

=== SASL で認証 ===

{{AUR|irssi-script-sasl}} パッケージを[[インストール]]してください。irssi が起動するたびにスクリプトをロード:

 $ mkdir -p ~/.irssi/scripts/autorun
 $ cd ~/.irssi/scripts/autorun
 $ ln -s /usr/share/irssi/scripts/cap_sasl.pl cap_sasl.pl

irssi を開いて SASL スクリプトを実行して SASL の設定を入力してください。nickserv で登録したメインのニックネーム "your-primary-nick" と "your-password" を使って下さい。認証メカニズムについては [https://freenode.net/sasl/sasl-irssi.shtml こちら] を参照 (DH-BLOWFISH はもはやサポートされていません):

 /RUN cap_sasl.pl
 /sasl set Freenode ''primary-nick'' ''password'' ''auth''
 /sasl save
 /save

{{Note|
* Make sure to use the correct capitalization for the network name.
* Your password will be visible when you type it and can also be seen in {{ic|~/.irssi/sasl.auth}}
* If your password contains {{ic|$}}, you have to prefix it with another {{ic|$}} for ''irssi'' to properly parse it.}}

irssi を再起動すると "Irssi: SASL authentication successful" と表示されます。

=== 起動時に #archlinux に自動で接続 ===

irssi を起動して以下を入力してください:

 /server add -auto -network freenode chat.freenode.net

{{ic|freenode}} は自由な名前に置き換えることができます (例: {{ic|fn}})。

[[#SASL で認証|SASL]] を正しく設定してください。SASL の代わりに {{ic|-autosendcmd}} を使って手動で NickServ を使うこともできますが、チャンネルに自動で参加するときに競合状態になってしまいます。出来るだけ、NickServ でパスワードを使うよりも、SSL 証明書で認証してください。

 /channel add -auto #archlinux freenode
 /channel add -auto #archlinux-offtopic freenode

=== SSL 接続 ===

Freenode は SSL 接続にポート 6697, 7000, 7070 を使っています (6667 は使っていません)。Freenode IRC ネットワークに SSL を通して接続したい場合、新しい接続をセットアップする必要があります。{{ic|irssi}} を起動して次を実行:

 /server add -auto -ssl -ssl_verify -ssl_capath /etc/ssl/certs -network freenode -port 6697 chat.freenode.net

そして新しい設定を保存:

 /save

問題なければ "Z" モードがセットされるのが確認できます。次のように表示されます: "Mode change (+Zi) for user your-nick"。

==== クライアント証明書 ====

Freenode and OFTC support authentication using SSL certificates, providing an alternative to plaintext passwords. See Freenode's [https://freenode.net/certfp/ Identifying with CERTFP] and [https://freenode.net/certfp/makecert.shtml Creating an SSL Certificate] for more extensive details.

To create an password-less certificate that is valid for 730 days (when requested to enter details like state or even Common Name (CN), you can fill anything you want):

 $ openssl req -newkey rsa:2048 -days 730 -x509 -keyout irssi.key -out irssi.crt -nodes 
 $ cat irssi.crt irssi.key > ~/.irssi/irssi.pem
 $ chmod 600 ~/.irssi/irssi.pem
 $ rm irssi.crt irssi.key

Next, find out the corresponding fingerprint:

 $ openssl x509 -sha1 -fingerprint -noout -in ~/.irssi/irssi.pem | sed -e 's/^.*=//;s/://g;y/ABCDEF/abcdef/'

This will write the fingerprint to stdout. (The sed command is there to format the fingerprint correctly by removing unwanted text and characters.) 
Copy the fingerprint string as you will register it in irssi shortly.

In irssi, disconnect from the network and add the client certificate and keys:

 /disconnect Freenode
 /server add -ssl_cert ~/.irssi/irssi.pem chat.freenode.net

Now connect (not {{ic|/reconnect}}) and register your fingerprint

 /connect Freenode
 /msg NickServ identify YOUR_PASSWORD
 /msg NickServ cert add YOUR_FINGERPRINT

At this point, you can remove your password from the configuration file (if you saved it in there) and save your config with:

 /save

=== 自動ログイン ===

 /SET autolog ON
 /save

=== join, part, quit を隠す ===

In order to ignore showing of joining, leaving and quiting of users for all channels type the following in irssi:

 /ignore * joins
 /ignore * parts
 /ignore * quits

See [https://github.com/lifeforms/irssi-smartfilter smartfilter] to restrict join messages to active users.

== Tips and tricks ==

=== HTTP プロキシ ===

''irssi'' で HTTP プロキシを使うには、以下のコマンドが必要です:

 /SET use_proxy ON
 /SET proxy_address <Proxy host address>
 /SET proxy_port <Proxy port>
 /SET -clear proxy_string
 /SET proxy_string_after conn %s %d
 /EVAL SET proxy_string CONNECT %s:%d HTTP/1.0\n\n

''irssi'' should then alter its config file correspondingly; if the proxy is not required, just set use_proxy to OFF.

Should the proxy require a password, try:

 /SET proxy_password your_pass

Otherwise:

 /SET -clear proxy_password

{{Note|SSL behind a proxy will fail with these settings.}}

=== tmux で irssi と nicklist ===

The ''irssi'' plugin '[http://scripts.irssi.org/scripts/nicklist.pl nicklist]' offers to add a pane listing the users on the channel currently viewed. It has two methods to do this:

* '''screen''', which simply adds the list to the right of ''irssi'', but brings the disadvantage that the entire window gets redrawn every time ''irssi'' prints a line.

* '''fifo''', which like the name suggests writes the list into a fifo that can then be continuously read with e. g. ''cat ~/.irssi/nicklistfifo''.

nicklist will use the more efficient ''fifo'' with:

 /NICKLIST FIFO

This fifo can be used in a [[tmux]] window split vertically with ''irssi'' in its left pane and the ''cat'' from above in a small one in its right. Since the pane is dependent on its creating tmux session's geometry, a subsequent session with a different one needs to recreate it (which also implies a switch in ''irssi'' windows to refill the fifo).

E. g., the following script first checks for a running ''irssi'', presumed to have been run by a previous execution of itself. Unless found it creates a new tmux session, a window named after and running ''irssi'' and then the pane with ''cat''. If however ''irssi'' was found it merely attaches to the session and recreates the ''cat'' pane.

 #!/bin/bash
 
 T3=$(pgrep -u $USER -x irssi)
 
 irssi_nickpane() {
     tmux setw main-pane-width $(( $(tput cols) - 21));
     tmux splitw -v "cat ~/.irssi/nicklistfifo";
     tmux selectl main-vertical;
     tmux selectw -t irssi;
     tmux selectp -t 0;
 }
 
 irssi_repair() {
     tmux selectw -t irssi
     (( $(tmux lsp | wc -l) > 1 )) && tmux killp -a -t 0
     irssi_nickpane
 }
 
 if [ -z "$T3" ]; then
     tmux new-session -d -s main;
     tmux new-window -t main -n irssi irssi;
     irssi_nickpane ;
 fi
     tmux attach-session -d -t main;
     irssi_repair ;
 exit 0

{{Tip|Instead of doing all this work, [http://anti.teamidiot.de/static/nei/*/Code/Irssi/tmux-nicklist-portable.pl this plugin] does all the work needed for a nice nicklist inside tmux.}}

=== バーチャルホストネーム (vhost) ===

A vhost can be used to change your hostname when connected to an IRC-server, commonly viewed when joining/parting or doing a whois. This is most commonly done on a server which have a static IP address. Without a vhost it would commonly look like so when doing a 'whois':

 nick@123.456.78.90.isp.com

The result of a successfull vhost could be like so if you have the domain example.com available:

 nick@example.com

Keep in mind that not every IRC-server supports the use of vhost. This might be individually set between the servers and not the network, so if you are experiencing issues with one server try another on the same network.

==== 必要な設定 ====

irssi supports using a vhost as long as the required configurations has been set. This includes especially that your host supports [[wikipedia:Reverse_DNS_lookup|Recursive DNS Lookup (rDNS)]] using [[wikipedia:List_of_DNS_record_types|Pointer record (PTR)]]. Additionally you should add an appropriate line to your {{ic|/etc/hosts}} file. 

To see if this is working, test with the 'host' DNS lookup utility included in {{Pkg|bind-tools}} like so (where ''ip'' is a normal IPv4 address):

 host ''ip''

If this returns something in the lines of this then you know that your rDNS is working.

 ''ip''.in-addr.arpa domain name pointer example.com

==== vhost の有効化 ====

There are a couple of ways to connect to a server with a given hostname. One is using the 'server' command with a -host argument like so:
 /server -host example.com irc.freenode.org
Another way would be to set your hostname (vhost) with the 'set' command which will save your hostname to {{ic|~/.irssi/config}}:

 /set hostname example.com
 /save
 /server irc.freenode.org

== 参照 ==

* [http://www.irssi.org/ 公式ウェブサイト] 
* [http://linuxtidbits.wordpress.com/2008/01/09/setting-up-irssi/ Setting up Irssi]
* [http://quadpoint.org/articles/irssi Guide to efficiently using Irssi and screen] by Matt Sparks
* [http://scripts.irssi.org/ Official List of Irssi scripts]
* [http://jasonwryan.com/blog/2011/11/07/irc-dzen/ IRC notifications with dzen2] by Jason Ryan
* [http://pthree.org/2010/02/02/irssis-channel-network-server-and-connect-what-it-means/ Irssi’s /channel, /network, /server and /connect – What it means] by Aaron Toponce
* [http://awesome.naquadah.org/wiki/Irssi_tips awesome Wiki Irssi tips]
* [https://github.com/GutenYe/systemd-units/tree/master/irssi irssi systemd ユニット]