RTorrentのソースを表示

{{DISPLAYTITLE:rTorrent}}
[[Category:BitTorrent]]
[[en:RTorrent]]
[[es:RTorrent]]
[[ru:RTorrent]]
[[zh-hans:RTorrent]]
[https://rakshasa.github.io/rtorrent/ rTorrent] は迅速に動作する BitTorrent クライアントです。開発面では、libTorrent ライブラリを使用しています ({{Pkg|libtorrent-rasterbar}} とは違います)。rTorrent は C++ を使って書かれており、[[Wikipedia:ja:ncurses|ncurses]] プログラミングライブラリを利用したテキストユーザーインターフェイスがあります。ターミナルマルチプレクサ (例: [[GNU Screen]] や [[Tmux]]) と [[Secure Shell]] を一緒に使うことで、便利なリモート [[Wikipedia:BitTorrent (protocol)#Operation|BitTorrent クライアント]]として活用できます。

== インストール ==

[[公式リポジトリ]]の {{Pkg|rtorrent}} パッケージを [[インストール]] してください。

=== 非公式パッケージ ===

* {{AUR|rtorrent-git}} - Git [https://github.com/rakshasa/rtorrent main branch] パッケージ
* {{AUR|rtorrent-ps}} - [https://github.com/pyroscope/rtorrent-ps rtorrent-ps patchset] ps パッチセットを含むリリースパッケージ
* {{AUR|rtorrent-pyro-git}} - Git [https://github.com/rakshasa/rtorrent/tree/feature-bind feature-bind branch] を含む [https://github.com/pyroscope/rtorrent-ps rtorrent-ps patchset] パッケージ
* {{AUR|rtorrent-vi-color}} - vi のようなキーバインディングを備えたリリースパッケージ

== 設定 ==

{{Note|設定に関する詳細は次の rTorrent wiki の記事を見て下さい: [https://web.archive.org/web/20140213003955/http://libtorrent.rakshasa.no/wiki/RTorrentCommonTasks Common Tasks in rTorrent for Dummies]。}}

rTorrent を実行する前に、サンプル設定ファイル {{ic|/usr/share/doc/rtorrent/rtorrent.rc}} を探して {{ic|~/.rtorrent.rc}} にコピーしましょう:

 $ cp /usr/share/doc/rtorrent/rtorrent.rc ~/.rtorrent.rc

=== パフォーマンス ===

{{Note|パフォーマンスに関する詳細は次の rTorrent wiki の記事を見て下さい: [https://web.archive.org/web/20140213011439/http://libtorrent.rakshasa.no/wiki/RTorrentPerformanceTuning Performance Tuning]。}}

以下のオプションの値はシステムのハードウェアやインターネットの接続速度に合わせます。最適値の見つけ方については次を読んでください: [http://torrentfreak.com/optimize-your-BitTorrent-download-speed Optimize Your BitTorrent Download Speed]
{{bc|<nowiki>
min_peers = 40
max_peers = 52

min_peers_seed = 10
max_peers_seed = 52

max_uploads = 8

download_rate = 200
upload_rate = 28
</nowiki>}}

{{ic|check_hash}} オプションは torrent のダウンロードが完了した時や rTorrent が起動したときにハッシュチェックを行います。起動時に、完了済みのファイルに問題がないか確認します。
 check_hash = yes

=== ファイルの作成と管理 ===

{{ic|directory}} オプションには torrent データを保存するディレクトリを指定します (相対パスでも指定できます):
 directory = ~/downloaded

{{ic|session}} オプションを使うことで rTorrent の torrent の進捗を保存することができます。ホームディレクトリにディレクトリを作成することが推奨されます (例: {{ic|mkdir ~/.rtorrent.session}})。
 session = ~/.rtorrent.session

{{ic|schedule}} オプションを設定すると rTorrent は新しい torrent ファイルが追加されないか特定のディレクトリを監視します。このディレクトリに torrent ファイルを保存すると、自動的にダウンロードが開始されます。かならず監視するディレクトリを作成してください (例: {{ic|mkdir ~/watch}})。また、このオプションを使用すると、rTorrent が torrent ファイルをセッションフォルダに移動してハッシュ値に名前を変更するので注意してください。
 schedule = watch_directory,5,5,load_start=/home/''user''/watch/*.torrent
 schedule = untied_directory,5,5,stop_untied=
 schedule = tied_directory,5,5,start_tied=

以下の {{ic|schedule}} オプションはディスク容量が少なくなった時に rTorrent がデータをダウンロードするのを止めさせます。
 schedule = low_diskspace,5,60,close_low_diskspace=100M

=== ポート設定 ===

{{ic|port_range}} オプションでは使用するポートを設定します。49152 以上のポート番号を使用することが推奨されます (参照: [[Wikipedia:ja:TCPやUDPにおけるポート番号の一覧|ポート番号の一覧]])。rTorrent ではポートの範囲を指定することができますが、使用するポートは一つだけに絞ることが推奨されています。
 port_range = 49164-49164

また、適切なポートのポートフォワーディングが有効になっていることを確認してください (参照: [http://portforward.com/english/routers/port_forwarding/routerindex.htm Port Forward guides])。

=== その他の設定 ===

{{ic|encryption}} オプションは暗号化を有効化または無効化します。このオプションは、あなた自身だけのためではなく、torrent スウォームのピアのためでもあります。たとえセキュリティを上げる必要がなかったとしても、有効にすることに害はありません。
 encryption = allow_incoming,try_outgoing,enable_retry
また、全ての接続で強制的に暗号化を使用することもできます。ただし、あまり厳しいルールを使用するとクライアントの可用性が減少していきます:
 encryption = require,require_RC4,allow_incoming,try_outgoing

[[Wikipedia:BitTorrent Protocol Encryption]] も見て下さい。

最後に、{{ic|dht}} オプションは [[Wikipedia:ja:分散ハッシュテーブル|DHT]] のサポートを有効にします。DHT は主要なトラッカーで使われており、クライアントがより多くのピアを獲得できるようになります。
{{bc|<nowiki>
dht = auto
dht_port = 6881
peer_exchange = yes
</nowiki>}}

== キーバインディング ==

rTorrent では専らキーボードショートカットを使って操作を行います。下のクイックレファレンスを参照してください。完全なガイドは rTorrent wiki にあります (参照: [https://github.com/rakshasa/rtorrent/wiki/User-Guide rTorrent User Guide])。

{{Note|{{ic|Ctrl-q}} を 2 回連続で押すと、接続中のトラッカーへの停止アナウンスの送信を待たずに rTorrent がシャットダウンします。}}

{| class="wikitable"
|-
!width="75" |コマンド
!操作
|-
|Ctrl-q
|アプリケーションを終了
|-
|Ctrl-s
|ダウンロードを開始。ハッシュが行われていない場合は先に実行
|-
|Ctrl-d
|ダウンロードを停止または停止したダウンロードを削除
|-
|Ctrl-k
|ファイルのダウンロードを停止して終了
|-
|Ctrl-r
|torrent のハッシュチェックを開始。ダウンロード/アップロードは行わない。
|-
|Left
|前の画面に戻る
|-
|Right
|次の画面に移る
|-
|Backspace/Return
|指定した *.torrent を追加
|-
|<nowiki>a|s|d</nowiki>
|<nowiki>全体のアップロード速度を 1|5|50 KB/s 間隔で増やす</nowiki>
|-
|<nowiki>A|S|D</nowiki>
|<nowiki>全体のダウンロード速度を 1|5|50 KB/s 間隔で増やす</nowiki>
|-
|<nowiki>z|x|c</nowiki>
|<nowiki>全体のアップロード速度を 1|5|50 KB/s 間隔で減らす</nowiki>
|-
|<nowiki>Z|X|C</nowiki>
|<nowiki>全体のダウンロード速度を 1|5|50 KB/s 間隔で減らす</nowiki>
|}

=== マッピングの重複 ===

{{ic|Ctrl-s}} は画面の出力の停止に、{{ic|Ctrl-q}} は画面の出力の開始に使われるのがターミナルでは普通です。これらのマッピングが rTorrent と干渉してしまうことがあります。ターミナルのオプションがマッピングと関連付けられていないか確認してください:
{{hc|$ stty -a|<nowiki>...
swtch = <undef>; start = ^Q; stop = ^S; susp = ^Z; rprnt = ^R; werase = ^W; lnext = ^V;
...
</nowiki>}}

マッピングを削除するには、ターミナルの特性を変更して前述の特殊文字列を定義します (つまり {{ic|stop}} と {{ic|start}}):
 # stty stop undef
 # stty start undef

前述のコマンドを {{ic|~/.bashrc}} ファイルに追加することで、起動時に自動的にマッピングを削除させることができます。

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

=== ヘッドレスサーバのための Systemd サービス ===

このユニット ファイルは、rtorrent という 1 人のユーザーの実行と、rtorrent がデーモンとして実行されるように設定することに依存しています。

次のファイルを作成します。
{{hc|/etc/systemd/system/rtorrent.service|<nowiki>>
[Unit]
Description=rTorrent System Daemon
After=network.target

[Service]
Type=simple
User=rtorrent
Group=rtorrent
# Modify the next 2 lines to use absolute paths
ExecStartPre=-/bin/rm -f /<home>/.session/rtorrent.lock
ExecStart=/usr/bin/rtorrent -o import=/<home>/rtorrent.rc
Restart=on-failure
RestartSec=3

[Install]
WantedBy=multi-user.target
</nowiki>}}

=== ユーザーのためのデーモンとしての Systemd サービス ===

このユニットでは、複数のユーザー、または 1 人のユーザーが rtorrent をデーモンとして実行できるようにします。

ブート時に rtorrent を起動するには、[[有効]] {{ic|rtorrent@''user''}} ({{ic|''user''}} は rtorrent を実行するユーザー) を指定します。

以下のファイルを作成します。

{{hc|/etc/systemd/system/rtorrent@.service|2=
[Unit]
Description=rTorrent for %i
After=network.target

[Service]
Type=simple
User=%i
Group=%i
WorkingDirectory=/home/%i
# Modify the next line to the absolute path for rtorrent.lock, for example
ExecStartPre=-/bin/rm -f /home/%i/.session/rtorrent.lock
ExecStart=/usr/bin/rtorrent -o system.daemon.set=true
Restart=on-failure
RestartSec=3

[Install]
WantedBy=multi-user.target
}}

=== tmux や screen を使った Systemd サービス ===

以下のサービスは、サービスユニットの種類によって使用方法が異なります。

'''システムサービスの場合'''（/etc/systemd/system/ の中）

ブート時に起動させる:
 # systemctl enable rtorrent
手動で起動:
 # systemctl start rtorrent
ストップ:
 # systemctl stop rtorrent 

''rtorrent'' ユーザーが適切なホーム ディレクトリに作成され、rtorrent.rc が配置されていることを確認します。

'''ユーザーサービス''' (/etc/systemd/user/ の中):
 $ systemctl --user enable rtorrent
手動で起動:
 $ systemctl --user start rtorrent
ストップ:
 $ systemctl --user stop rtorrent

==== screen を使用 ====

*システム・サービス・ユニットとして

{{hc|/etc/systemd/system/rtorrent.service|<nowiki>
[Unit]
Description=rTorrent
After=network.target

[Service]
Type=forking
KillMode=none
User=rtorrent
ExecStartPre=/usr/bin/bash -c "if test -e %h/.rtorrent_session/rtorrent.lock && test -z `pidof rtorrent`; then rm -f %h/.rtorrent_session/rtorrent.lock; fi"
ExecStart=/usr/bin/screen -dmfa -S rtorrent /usr/bin/rtorrent
ExecStop=/usr/bin/bash -c "test `pidof rtorrent` && killall -w -s 2 /usr/bin/rtorrent"
WorkingDirectory=%h
Restart=on-failure

[Install]
WantedBy=multi-user.target
</nowiki>}}

*ユーザーサービスユニットとして

{{hc|/etc/systemd/user/rtorrent.service|<nowiki>
[Unit]
Description=rTorrent
After=network.target

[Service]
Type=forking
KillMode=none
ExecStart=/usr/bin/screen -dmfa -S rtorrent /usr/bin/rtorrent
ExecStop=/usr/bin/killall -w -sユーザーのためのデーモンとしての Systemd サービス 2 /usr/bin/rtorrent
WorkingDirectory=%h

[Install]
WantedBy=default.target
</nowiki>}}

rtorrent のセッションにアタッチします。
 screen -D -r rtorrent

==== tmux を使用 ====

*独立した tmux サーバー付き (クラッシュした場合は rtorrent を再起動)

{{hc|~/.config/systemd/user/rtorrent.service|<nowiki>
[Unit]
Description=rtorrent
After=network.target

[Service]
Type=forking
ExecStartPre=/usr/bin/bash -c "if test -e ~/.session/rtorrent.lock && test -z `pidof rtorrent`; then rm -f ~/.session/rtorrent.lock; fi"
ExecStart=/usr/bin/tmux -L rt new-session -s rt -n rtorrent -d rtorrent 
ExecStop=/usr/bin/bash -c "/usr/bin/tmux -L rt send-keys -t rt:rtorrent.0 C-q; while pidof rtorrent > /dev/null; do echo stopping rtorrent...; sleep 1; done"
Restart=on-failure

[Install]
WantedBy=default.target
</nowiki>}}

*tmux をユーザー rtorrent として実行した場合 (クラッシュした場合は rtorrent を再起動)

{{hc|/etc/systemd/system/rtorrent.service|<nowiki>
[Unit]
Description=rTorrent Daemon
After=network.target

[Service]
Type=forking
KillMode=none
User=rtorrent
ExecStart=/usr/bin/tmux new-session -c /mnt/storage/rtorrent -s rtorrent -n rtorrent -d rtorrent
ExecStop=/usr/bin/bash -c "/usr/bin/tmux send-keys -t rtorrent C-q && while pidof rtorrent > /dev/null; do sleep 0.5; done"
WorkingDirectory=%h
Restart=on-failure

[Install]
WantedBy=multi-user.target
</nowiki>}}

rtorrent のセッションにアタッチ:
 tmux -L rt attach -t rt
 tmux attach -t rt

デタッチ:
 Ctrl-b d

=== dtach を使った systemd サービスファイル ===

systemd 単位で dtach を実行する場合、rtorrent が動作するためには [[systemd/ユーザー#環境変数|環境変数]] が明示的に設定されている必要があります。

このサービス ファイルには再起動がありません。これは、作者が問題のドライブをオフラインにすることがあり、このシナリオで起動すると rtorrent が失敗し、各トレントを格納する特定のディレクトリなど、多くのトレント固有の設定が失われるためです (''最適化されていない'' と言うべきでしょうか) 実際、rtorrent を起動するシンボリック リンクは、関連ドライブに存在します。 rtorrent の起動をブロックするこの使用例は、NAS、USB、eSATA ドライブなどのリムーバブル メディアにダウンロードしたファイルを置くユーザーに関連するものです。

{{hc|~/.config/systemd/user/rtorrent.service|<nowiki>
[Unit]
Description=rTorrent
#After=network.target

[Service]
# set TERM according to your terminal
Environment="TERM=xterm"
#Environment="TERM=linux" 
Type=forking
KillMode=none
ExecStart=-/usr/bin/dtach -n /home/sam/run/dtach_fifos/fifo -e "^T" /home/sam/bin/rtr_new -n -o import=/home/sam/.config/rtorrent/new_.rc 
   # dtach -n <separate filename for each instance>
   # 
   # rtr_new -n to ignore the default .rtorrent.rc
   # rtr_new -o import to load the instance-specific rc
ExecStop=-/usr/bin/killall -u sam -e -w -s INT /home/sam/bin/rtr_new

[Install]
WantedBy=multi-user.target
</nowiki>}}

このサービスファイルには、dtach 以外にもいくつかの問題があることに注意してください。

{{ic|/home/sam/bin/rtr_new}} is a symlink to {{ic|/usr/bin/rtorrent}}

これにより、複数のインスタンスを実行し、それぞれを異なるバージョンの ExecStop で個別に終了させることができます。

{{bc|1=ExecStop=-/usr/bin/killall -u sam -e -w -s INT /home/sam/bin/rtr_new
ExecStop=-/usr/bin/killall -u sam -e -w -s INT /home/sam/bin/rtr_academic
ExecStop=-/usr/bin/killall -u sam -e -w -s INT /home/sam/bin/rtr_other_stuff}}

これらはそれぞれ別のサービスファイル内にあり、それぞれが1つのインスタンスを制御します。

このステップを実行しないと、複数のインスタンスを実行している場合、killall ソリューションにより実行中のすべての rtorrent インスタンスが削除されます。

複数の rtorrent インスタンスが不要で、rtorrent rc ファイルがデフォルトの場所にある場合、上記のサービス ファイルを簡略化することができます。 ファイル全体が含まれますが、ExecStart と 
ExecStop の行が変わります。

{{hc|~/.config/systemd/user/rtorrent.service|<nowiki>
[Unit]
Description=rTorrent
#After=network.target

[Service]
# set TERM according to your terminal
Environment="TERM=xterm"
#Environment="TERM=linux" 
# Type=forking is not required if ExecStart command is run using dtach -N (i.e dtach will run on foreground).
Type=forking
KillMode=none
ExecStart=-/usr/bin/dtach -n /home/sam/run/dtach_fifos/fifo -e "^T" /usr/bin/rtorrent 
   # dtach -n <user specified FIFO name> -e <user specified character> /usr/bin/rtorrent 
ExecStop=/usr/bin/killall -w -s INT /usr/bin/rtorrent
   # -e (exact match) and -u (user name) were added above to stop specific processes
   #  and may be omitted here because only one rtorrent will be running

[Install]
WantedBy=multi-user.target
</nowiki>}}

ExecStart=-/usr/bin/dtach` の部分にあるハイフンに注意してください。これは、失敗の終了コードも成功の終了を表すことができるようにするためです。これは現在の問題 [https://github.com/crigler/dtach/issues/12] のためと思われます。代替案としては、サービスセクションで `SuccessExitStatus=1` を使用することです。

このサービスは [[systemctl --user]] で制御することができます。起動したら、セッションにアタッチすることができます。

 $ dtach -a /home/sam/run/dtach_fifos/fifo -e "^T".

=== 事前割り当て ===

community リポジトリに入っている rTorrent パッケージは事前割り当ての機能が削られています。事前割り当てを有効にして rTorrent をコンパイルすることで、torrent をダウンロードする前にファイルを割り当てることが可能になります。ファイルシステムのフラグメント化を防ぐことができるという利点がありますが、ファイルシステムが fallocate システムコールをサポートしてないかった場合、事前割り当てで遅延が発生することになります。

したがって、ネイティブで fallocate をサポートしている xfs, ext4, btrfs ファイルシステムを使用する場合は、このスイッチを利用することを推奨します。これらのファイルシステムでは事前割り当てで遅延が発生することなく、ファイルシステムのフラグメンテーションを少なくします。他のファイルシステムで事前割り当てを有効にすると遅延が発生します。ただし、ファイルのフラグメント化は防げます。

事前割り当てを利用できるようには、[[ABS]] ツリーから以下のスイッチを使って libTorrent をリコンパイルしてください:
 $ ./configure --prefix=/usr --disable-debug --with-posix-fallocate

有効化するには、以下を {{ic|~/rtorrent.rc}} に追加します:
{{hc|~/rtorrent.rc|<nowiki>
# Preallocate files; reduces defragmentation on filesystems.
system.file_allocate.set = yes
</nowiki>}}

=== 完了したファイルの管理 ===

{{Note|このヒントで困っている場合、こちらも参照して見て下さい。[https://github.com/rakshasa/rtorrent/wiki/Common-Tasks-in-rTorrent#move-completed-torrents-to-a-fixed-location docs]}}

rtorrent は、シードを継続しながら、*.torrent をどの ''監視'' フォルダーにドロップしたかに基づいて、完了したトレント データを特定のフォルダーに整理することができます。

解決策として、次の例を {{ic|~/.rtorrent.rc}} で使用してください。
パスを変更することを確認してください。

{{bc|1=
# default path for in progress downloads
directory = /home/user/torrents/incomplete

# schedule a timer event named 'watch_directory_1':
# 1) triggers 10 seconds after rtorrent starts
# 2) triggers at 10 second intervals thereafter
# 3) Upon trigger, attempt to load (and start) new *.torrent files found in /home/user/torrents/watch/
# 4) set a variable named 'custom1' with the value "/home/user/torrents/complete"
# NOTE: if you do not want it to automatically start the torrent, change 'load.start' to 'load.normal'
schedule2 = watch_directory_1,10,10,"load.start=/home/user/torrents/watch/*.torrent,d.custom1.set=/home/user/torrents/complete"

# upon completion, move content to path specified above via custom1
method.insert = d.data_path, simple, "if=(d.is_multi_file), (cat,(d.directory),/), (cat,(d.directory),/,(d.name))"
method.insert = d.move_to_complete, simple, "d.directory.set=$argument.1=; execute=mkdir,-p,$argument.1=; execute=mv,-u,$argument.0=,$argument.1=; d.save_full_session="
method.set_key = event.download.finished,move_complete,"d.move_to_complete=$d.data_path=,$d.custom1="
}}

このように、ウォッチディレクトリとそれに対応する補完ディレクトリを追加することができます。

{{bc|1=
directory = /home/user/torrents/incomplete

schedule2 = watch_directory_1,10,10,"load.start=/home/user/torrents/watch/*.torrent,d.custom1.set=/home/user/torrents/complete"
schedule2 = watch_directory_2,10,10,"load.start=/home/user/torrents/watch/iso/*.torrent,d.custom1.set=/home/user/torrents/complete/iso"
schedule2 = watch_directory_3,10,10,"load.start=/home/user/torrents/watch/music/*.torrent,d.custom1.set=/home/user/torrents/complete/music"

method.insert = d.data_path, simple, "if=(d.is_multi_file), (cat,(d.directory),/), (cat,(d.directory),/,(d.name))"
method.insert = d.move_to_complete, simple, "d.directory.set=$argument.1=; execute=mkdir,-p,$argument.1=; execute=mv,-u,$argument.0=,$argument.1=; d.save_full_session="
method.set_key = event.download.finished,move_complete,"d.move_to_complete=$d.data_path=,$d.custom1="
}}

また、ウォッチディレクトリごとに不完全なディレクトリを指定することも可能です。

{{bc|1=
directory = /home/user/torrents/incomplete

schedule2 = watch_directory_1,10,10,"load.start=/home/user/torrents/watch/*.torrent,d.directory.set=/home/user/torrents/incomplete,d.custom1.set=/home/user/torrents/complete"
schedule2 = watch_directory_2,10,10,"load.start=/home/user/torrents/watch/iso/*.torrent,d.directory.set=/home/user/torrents/incomplete/iso,d.custom1.set=/home/user/torrents/complete/iso"
schedule2 = watch_directory_3,10,10,"load.start=/home/user/torrents/watch/music/*.torrent,d.directory.set=/home/user/torrents/incomplete/music,d.custom1.set=/home/user/torrents/complete/music"

method.insert = d.data_path, simple, "if=(d.is_multi_file), (cat,(d.directory),/), (cat,(d.directory),/,(d.name))"
method.insert = d.move_to_complete, simple, "d.directory.set=$argument.1=; execute=mkdir,-p,$argument.1=; execute=mv,-u,$argument.0=,$argument.1=; d.save_full_session="
method.set_key = event.download.finished,move_complete,"d.move_to_complete=$d.data_path=,$d.custom1="
}}

また、[https://rtorrent-docs.readthedocs.io/en/latest/use-cases.html#versatile-move-on-completion bash スクリプトによる補完移動]、[https://pyrocore.readthedocs.io/en/latest/howto.html#moving-all-data-for-selected-items-to-a-new-location pyrocore の rtcontrol] (AUR パッケージがあります) も参照してください。

==== Google メールでの通知 ====

携帯電話に ''メール'' を送ることもできます。

{{bc|<nowiki>
Verizon: 10digitphonenumber@vtext.com
AT&T: 10digitphonenumber@txt.att.net
Former AT&T customers: 10digitphonenumber@mmode.com
Sprint: 10digitphonenumber@messaging.sprintpcs.com
T-Mobile: 10digitphonenumber@tmomail.net
Nextel: 10digitphonenumber@messaging.nextel.com
Cingular: 10digitphonenumber@cingularme.com
Virgin Mobile: 10digitphonenumber@vmobl.com
Alltel: 10digitphonenumber@alltelmessage.com OR
10digitphonenumber@message.alltel.com
CellularOne: 10digitphonenumber@mobile.celloneusa.com
Omnipoint: 10digitphonenumber@omnipointpcs.com
Qwest: 10digitphonenumber@qwestmp.com
Telus: 10digitphonenumber@msg.telus.com
Rogers Wireless: 10digitphonenumber@pcs.rogers.com
Fido: 10digitphonenumber@fido.ca
Bell Mobility: 10digitphonenumber@txt.bell.ca
Koodo Mobile: 10digitphonenumber@msg.koodomobile.com
MTS: 10digitphonenumber@text.mtsmobility.com
President's Choice: 10digitphonenumber@txt.bell.ca
Sasktel: 10digitphonenumber@sms.sasktel.com
Solo: 10digitphonenumber@txt.bell.ca
</nowiki>}}

*[[公式リポジトリ]] にある {{Pkg|s-nail}} パッケージで提供されている mailx をインストールします。

*{{ic|/etc/mail.rc}} ファイルをクリアして、入力します。

{{bc|<nowiki>
set sendmail="/usr/bin/mailx"
set smtp=smtp.gmail.com:587
set smtp-use-starttls
set ssl-verify=ignore
set ssl-auth=login
set smtp-auth-user=USERNAME@gmail.com
set smtp-auth-password=PASSWORD
</nowiki>}}

本文を送信するには、mailx プログラムにメッセージをパイプで送る必要があります。
*Bash スクリプトを作成します。

{{hc|/path/to/mail.sh|<nowiki>
echo "$@: Done" | mailx 5551234567@vtext.com
</nowiki>}}
ここで、$@ はスクリプトに渡されるすべての引数を保持する変数です。
    最後に、重要な ~/.rtorrent.rc 行を追加します。
以下分解です,

{{ic|notify_me}} はコマンドIDで、他のコマンドで使用される可能性があり、ユニークであれば何でもかまいません。

{{ic|1=execute=}} は、rtorrent コマンドで、この場合はシェル コマンドを実行します。

{{ic|/path/to/mail.sh}} は、スクリプトの名前 (または実行するコマンド) と、渡されるすべてのスイッチ/引数をカンマで区切ったリストです。

{{ic|1=$d.get_name=}} ''d'' はコマンドのトリガーとなるダウンロードのエイリアス、''get_name'' はダウンロードの名前を返す関数、''$'' は実行を呼び出す前にコマンドをその出力に置き換えるよう rTorrent に指示します。

最終結果は? 出勤前に開始したトレント、''All Live Nudibranches'' が終了すると、テキストが送信されます。
 All Live Nudibranches: Done

=== アクティブな torrent を表示 ===

デフォルトでは rtorrent はアクティブなタブを正しく表示しません。アクティブな torrent だけを表示するには {{ic|.rtorrent.rc}} に以下の行を追加してください:
 schedule = filter_active,30,30,"view_filter = active,\"or={d.get_up_rate=,d.get_down_rate=}\""

rTorrent クライアントで {{ic|9}} 押すと動作の変更が確認できます。

=== 手動でトラッカーを torrent に追加 ===

# rTorrent のコンソールビューから編集する torrent を選択。
# {{ic|Ctrl+x}} を押す。
# If you had four trackers type following lines one at a time (always press {{ic|Ctrl+x}} first) to add four more for example:

 d.tracker.insert="5","udp://tracker.publicbt.com:80"
 d.tracker.insert="6","udp://tracker.openbittorrent.com:80"
 d.tracker.insert="7","udp://tracker.istole.it:80"
 d.tracker.insert="8","udp://tracker.ccc.de:80"

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

=== CA 証明書 ===

rTorrent で HTTPS を使用するトラッカーを使う場合、root で以下を実行してください:

{{bc|
# cd /etc/ssl/certs
<nowiki># wget --no-check-certificate https://www.geotrust.com/resources/root_certificates/certificates/Equifax_Secure_Global_eBusiness_CA-1.cer</nowiki>
# mv Equifax_Secure_Global_eBusiness_CA-1.cer Equifax_Secure_Global_eBusiness_CA-1.pem
# c_rehash
}}

そして rTorrent を次のコマンドで実行してください:
 $ rtorrent -o http_capath=/etc/ssl/certs

GNU Screen を使っている場合、変更が適用されるように {{ic|.screenrc}} 設定ファイルを更新:
 $ screen -t rtorrent rtorrent -o http_capath=/etc/ssl/certs

rTorrent 0.8.9 では {{ic|<nowiki>network.http.ssl_verify_peer.set=0</nowiki>}} を設定することで [https://bbs.archlinux.org/viewtopic.php?pid=981832#p981832 問題が修正] されます。

詳細は次を参照: [https://bbs.archlinux.org/viewtopic.php?pid=331850 rTorrent Error & CA Certificate] と [https://bbs.archlinux.org/viewtopic.php?id=45800 rTorrent Certificates Problem]

=== ディレクトリのロック ===

クラッシュや不正のシャットダウンの後、ときどき rTorrent が動かなくなって、ロックファイルについてエラーを表示することがあります。

エラーメッセージによると、ダウンロード ディレクトリの隠しフォルダ {{ic|.rtorrentsession}} 内に '''rtorrent.lock''' というファイルが見つかった場合、手動で削除することができます。

=== Event failed: bad return code ===

これは、system.method.* の行にスペースがある場合や、単にインストールされていない外部スクリプトを呼び出すイベントハンドラ、または0以外の終了コードを返す場合によく起こります。

前者については、偽のスペースを削除するか、意図的にパスなどを引用することで、動作するようになります。

== ウェブインターフェイス ==

rTorrent には様々なウェブインターフェイスやフロントエンドが存在しています:
* [[en2:WTorrent|WTorrent]] は PHP ライブラリの Smarty テンプレートと XMLRPC を使って PHP でプログラミングされた rtorrent のウェブインターフェイスです。
* [https://code.google.com/p/ntorrent/ nTorrent] は rtorrent (cli torrent クライアント) の Java で書かれたグラフィカルユーザーインターフェイスです。
* [https://rtwi.jmk.hu/ rTWi] は PHP で書かれたシンプルな rTorrent ウェブインターフェイスです。
* [[Rtgui]] は PHP で書かれたウェブベースの rTorrent フロントエンドで、XML-RPC を使って rTorrent クライアントと対話します。
* [https://github.com/Novik/ruTorrent rutorrent] と [http://forums.rutorrent.org/ Forum] - uTorrent とよく似たインターフェイスを持つウェブベースのフロントエンドです。多数のプラグインと高度な機能をサポートしています (参照: [[ruTorrent]] と [https://bbs.archlinux.org/viewtopic.php?pid=897577#p897577 Guide on forum])。

{{Note|rTorrent is currently built using [http://xmlrpc-c.sourceforge.net/ XML-RPC for C/C++], which is required for some web interfaces (e.g. ruTorrent).}}

=== XMLRPC インターフェイス ===

rtorrent をウェブインターフェイス (例: rutorrent) で使いたい場合は設定ファイルに以下の行を追加してください:
 scgi_port = localhost:5000

詳細は次を参照: [https://github.com/rakshasa/rtorrent/wiki/RPC-Setup-XMLRPC Using XMLRPC with rtorrent]

=== マグネットリンクを watch フォルダに torrent ファイルとして保存 ===

{{Note|Rtorrent はネイティブでマグネットリンクによる torrent のダウンロードに対応しています。(Rtorrent を起動して 1 を押すと表示される) メインビューで、エンターを押してください。"load.normal>" にマグネットリンクを貼り付けてエンターを再度押すとダウンロードが開始されます。}}

マグネットリンクを watch フォルダに自動的に追加したい場合、以下のスクリプトで行うことができます:

 #!/bin/bash
 watch_folder=~/.rtorrent/watch
 cd $watch_folder
 <nowiki>[[ "$1" =~ xt=urn:btih:([^&/]+) ]] || exit;</nowiki>
 echo "d10:magnet-uri${#1}:${1}e" > "meta-${BASH_REMATCH[1]}.torrent"

(ソース: http://blog.gonzih.org/blog/2012/02/17/how-to-use-magnet-links-with-rtorrent/)

例えば、rtorrent-magnet という名前で保存し、実行権限を与え、$PATH の下のどこかに配置します。次に、Firefox で
# ロケーション バー (アドレス バー) に {{ic|about:config}} と入力し、{{ic|Enter}} キーを押します。
# 右クリックする。''新規 > Boolean > Name: '''network.protocol-handler.expose.magnet''' と入力します。> 値＞ false'' です。
# 次回マグネットリンクをクリックすると、どのアプリケーションでそれを開くか尋ねられます。先ほど作成したスクリプトを選択すれば完了です。

xdg-open で処理したい場合、Firefox の代わりに chrome を使用している場合は必要ですが、（gnome やその他の DE では xdg-open を上書きする独自のプログラムがあるかもしれません）rtorrent-magnet スクリプト用のデスクトップ エントリを {{ic|~/.local/share/applications/rtorrent-magnet.desktop}} に次の内容で作成する必要があります。

 <nowiki>
 [Desktop Entry]
 Type=Application
 Name=rtorrent-magnet
 Exec=rtorrent-magnet %U
 MimeType=x-scheme-handler/magnet;
 NoDisplay=true</nowiki>

以下でmimetypeを登録するだけです。
 $ xdg-mime default rtorrent-magnet.desktop x-scheme-handler/magnet

== マグネットを Torrent に変換 ==
{{AUR|magnet2torrent-git}} パッケージを使うことでメタデータをダウンロードして torrent ファイルを作成することができます。

使用方法:
 $ magnet2torrent <magnet link> [torrent file]

== rtorrent-ps ==

[https://github.com/pyroscope/rtorrent-ps rTorrent-PS] は、UI の強化、カラー化、およびいくつかの機能追加を行ったパッチセット形式の rTorrent ディストリビューションです。

=== インストール方法 ===

AUR から入手できる様々なパッケージを使うか、GitHub リポジトリにあるビルドスクリプトを使ってパッケージを作成してください。詳しくは [https://rtorrent-ps.readthedocs.io/en/latest/install.html#installation-on-arch-linux the docs] を見て下さい。

=== 設定 ===

rTorrent 設定ファイルで ''pyro.extended'' を 1 に設定し、rTorrent-PS 機能を有効にします。
{{bc|<nowiki>method.insert = pyro.extended, value|const, 1</nowiki>}}

その他の設定例については、[https://github.com/pyroscope/pimp-my-box/tree/master/roles/rtorrent-ps/templates/rtorrent/rtorrent.d pimp-my-box] リポジトリの rtorrent-ps テンプレートを参照してください。動作させるには PyroScope のコマンドライン ユーティリティが必要な場合があることに注意してください。

== PyroScope コマンドラインユーティリティ ==

[https://github.com/pyroscope/pyrocore/ PyroScope コマンドラインユーティリティ] は、rTorrent クライアント用のツールのコレクションで、[[#rtorrent-ps]]パッチセットと一緒に使用すると便利です。
特に、一般的なタスクの自動化や、rTorrent のキュー マネージャを提供します。

インストールと設定については、[https://pyrocore.readthedocs.io/ 公式ドキュメント] に従ってください。その他の設定例については、[https://github.com/pyroscope/pimp-my-box/tree/master/roles/rtorrent-ps/templates/rtorrent/rtorrent.d pimp-my-box] リポジトリの rtorrent-ps テンプレートを参照してください。

== 参照 ==

* [http://libtorrent.rakshasa.no/rtorrent/rtorrent.1.html Manpage for rtorrent]
* [[Wikipedia:Comparison of BitTorrent clients|Comparison of BitTorrent clients]] on Wikipedia
* [http://community.rutorrent.org/ rTorrent Community Wiki] - Public place for information on rTorrent and any project related to rTorrent, regarding setup, configuration, operations, and development.
* [https://code.google.com/p/pyroscope/ PyroScope] - Collection of command line tools for rTorrent. It provides commands for creating and modifying torrent files, moving data on completion without having multiple watch folders, and mass-controlling download items via rTorrent's XML-RPC interface: searching, start/stop, deleting items with or without their data, etc. It also offers a documented [[Python]] API.
* [[en2:Rutorrent with lighttpd|ruTorrent と Lighttpd]]
* [http://wiki.theaveragegeek.com/howto/installing_rtorrent_and_hellanzb_on_centos5_64-bit_vps How-to install rTorrent and Hellanzb on CentOS 5 64-bit VPS]
* [https://code.google.com/p/pyroscope/wiki/DebianInstallFromSource Installation guide for rTorrent and Pryoscope on Debian] - Collection of tools for the BitTorrent protocol and especially the rTorrent client
* [http://mktorrent.sourceforge.net/ mktorrent] - torrent ファイルを作成するためのコマンドラインアプリケーション、[[公式リポジトリ]]の {{Pkg|mktorrent}} でインストールできます。
* [https://github.com/kfei/docktorrent docktorrent] - Docker, rTorrent, ruTorrent を使用してフル機能の BitTorrent マシンを実行。
* [https://github.com/nelhage/reptyr reptyr] - another tool to take over a program's TTY (it is in the standard repos).  The process may have started being attached to a terminal or to a socket in tmux, screen or dtach.
* [http://caca.zoy.org/wiki/neercs neercs] - a more screen/tmux like tool than reptyr, but, like reptyr, neercs can also "steal" a process that  may have started slaved to a terminal or to a socket in tmux, screen or dtach. {{AUR|neercs-git}}{{Broken package link|{{aur-mirror|neercs-git}}}}

'''フォーラムスレッド'''
* 2009-03-11 - Arch Linux - [https://bbs.archlinux.org/viewtopic.php?id=67304 HOWTO: rTorrent stats in Conky]