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|Striking {{ic|Ctrl-q}} twice in quick succession will make rTorrent shutdown without waiting to send a stop announce to the connected trackers.}}

{| 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}} ファイルに追加することで、起動時に自動的にマッピングを削除させることができます。

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

=== tmux や screen を使用する systemd サービスファイル ===

*tmux を使用 (rtorrent がクラッシュした場合に再起動)
{{hc|/etc/systemd/user/rt.service|<nowiki>
[Unit]
Description=rTorrent
After=network.target

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

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

*rtorrent ユーザーで実行した tmux を使用 (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/tmux send-keys -t rtorrent C-q && /usr/bin/tmux kill-session -t rtorrent
WorkingDirectory=/home/rtorrent/
Restart=on-failure

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

*screen を使用

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

[Service]
Type=forking
KillMode=none
ExecStart=/usr/bin/screen -d -m -fa -S rtorrent /usr/bin/rtorrent
ExecStop=/usr/bin/killall -w -s 2 /usr/bin/rtorrent
WorkingDirectory=%h

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

ブート時に起動:
 $ systemctl --user enable rt
手動で起動:
 $ systemctl --user start rt
停止:
 $ systemctl --user stop rt
rtorrent のセッションにアタッチ:
 tmux attach -t rt
デタッチ:
 Ctrl-b d

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

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|
*Currently, this part requires either the git version of rtorrent/libtorrent or having applied the patch to 0.8.6 that adds 'equal'.
* If you're having trouble with this tip, it's probably easier to follow [https://web.archive.org/web/20140213003955/http://libtorrent.rakshasa.no/wiki/RTorrentCommonTasks#Movecompletedtorrentstodifferentdirectorydependingonwatchdirectory this].
}}

It is possible to have rtorrent sort completed torrent data to specific folders based on which 'watch' folder you drop the *.torrent into while continuing to seed. Many examples show how to do this with torrents downloaded by rtorrent.  The problem is when you try to drop in 100% done torrent data and then have rtorrent check the data and resume, it will not be sorted.

As a solution, use the following example in your {{ic|~/.rtorrent.rc}}.
Make sure to change the paths.

{{bc|1=
# location where new torrent data is placed, and where you should place your
# 'complete' data before you place your *.torrent file into the watch folder
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'
schedule = watch_directory_1,10,10,"load_start=/home/user/torrents/watch/*.torrent,d.set_custom1=/home/user/torrents/complete"

# insert a method with the alias 'checkdirs1'
# 1) returns true if the current path of the torrent data is not equal to the value of custom1
# 2) otherwise, returns false
system.method.insert=checkdirs1,simple,"not=\"$equal={d.get_custom1=,d.get_base_path=}\""

# insert a method with the alias 'movecheck1'
# 1) returns true if all 3 commands return true ('result of checkdirs1' && 'torrent is 100% done', 'custom1 variable is set')
# 2) otherwise, returns false
system.method.insert=movecheck1,simple,"and={checkdirs1=,d.get_complete=,d.get_custom1=}"

# insert a method with the alias 'movedir1'
# (a series of commands, separated by ';') 
# 1) "set path of torrent to equal the value of custom1";
# 2) "mv -u <current data path> <custom1 path>";
# 3) "clear custom1", "stop the torrent","resume the torrent"
# 4) stop the torrent
# 5) start the torrent (to get the torrent to update the 'base path')
system.method.insert=movedir1,simple,"d.set_directory=$d.get_custom1=;execute=mv,-u,$d.get_base_path=,$d.get_custom1=;d.set_custom1=;d.stop=;d.start="

# set a key with the name 'move_hashed1' that is triggered by the hash_done event.
# 1) When hashing of a torrent completes, this custom key will be triggered.
# 2) when triggered, execute the 'movecheck1' method and check the return value.
# 3) if the 'movecheck' method returns 'true', execute the 'movedir1' method we inserted above.
# NOTE-0: *Only* data that has had their hash checked manually with ^R [^R = Control r].
# Or on a rtorrent restart[which initiates a hash check]. Will the data move; ~/torrents/incomplete => ~/torrents/complete for example.
# NOTE-1: 'branch' is an 'if' conditional statement: if(movecheck1){movedir1}
system.method.set_key=event.download.hash_done,move_hashed1,"branch={$movecheck1=,movedir1=}"
}}

You can add additional watch folders and rules should you like to sort your torrents into special folders.

For example, if you would like the torrents to download in:
 /home/user/torrents/incomplete
and then sort the torrent data based on which folder you dropped the *.torrent into:
 /home/user/torrents/watch => /home/user/torrents/complete
 /home/user/torrents/watch/iso => /home/user/torrents/complete/iso
 /home/user/torrents/watch/music => /home/user/torrents/complete/music

You can have the following in your .rtorrent.rc:
{{bc|1=
directory = /home/user/torrents/incomplete
schedule = watch_directory_1,10,10,"load_start=/home/user/torrents/watch/*.torrent,d.set_custom1=/home/user/torrents/complete"

schedule = watch_directory_2,10,10,"load_start=/home/user/torrents/watch/iso/*.torrent,d.set_custom1=/home/user/torrents/complete/iso"

schedule = watch_directory_3,10,10,"load_start=/home/user/torrents/watch/music/*.torrent,d.set_custom1=/home/user/torrents/complete/music"

system.method.insert=checkdirs1,simple,"not=\"$equal={d.get_custom1=,d.get_base_path=}\""
system.method.insert=movecheck1,simple,"and={checkdirs1=,d.get_complete=,d.get_custom1=}"
system.method.insert=movedir1,simple,"d.set_directory=$d.get_custom1=;execute=mv,-u,$d.get_base_path=,$d.get_custom1=;d.set_custom1=;d.stop=;d.start="
system.method.set_key=event.download.hash_done,move_hashed1,"branch={$movecheck1=,movedir1=}"
}}

Also see [https://code.google.com/p/pyroscope/ pyroscope] especially the rtcontrol examples. There is an AUR package.

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

Cell phone providers allow you to "email" your phone:
{{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>}}
Where the $@ is a variable holding all the arguments passed to our script.

*And finally, add the important {{ic|~/.rtorrent.rc}} line:
 system.method.set_key = event.download.finished,notify_me,"execute=/path/to/mail.sh,$d.get_name="

Breaking it down:

{{ic|notify_me}} is the command id, which may be used by other commands, it can be just about anything you like, so long as it is unique.

{{ic|1=execute=}} is the rtorrent command, in this case to execute a shell command.

{{ic|/path/to/mail.sh}} is the name of our script (or whatever command you want to execute) followed by a comma separated list of all the switches/arguments to be passed.

{{ic|1=$d.get_name=}} 'd' is an alias to whatever download triggered the command, get_name is a function which returns the name of our download, and the '$' tells rTorrent to replace the command with its output before it calls execute.

The end result? When that torrent, 'All Live Nudibranches', that we started before leaving for work finishes, we will be texted:
 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 が動かなくなって、ロックファイルについてエラーを表示することがあります。

Per the error message, the file called "'''rtorrent.lock'''" can be found within the hidden folder {{ic|.rtorrentsession}} for your download directory and manually removed.

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

system.method.* の行に空白が入っているのが原因です。空白を削除すれば動作するようになります。

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

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/)

Save it, for instance as rtorrent-magnet, give it execution permission, and place it somewhere under your $PATH. Then in Firefox:
# Type {{ic|about:config}} into the Location Bar (address bar) and press {{ic|Enter}}.
# Right-click: ''New > Boolean > Name: '''network.protocol-handler.expose.magnet''' > Value > false''.
# Next time you click a magnet link you will be asked which application to open it with. Select the script we just created and you'll be done.

If you want xdg-open to handle this, which you need if you're using chrome instead of firefox, (though gnome and other DE might have their own programs overriding xdg-open) you need to create the desktop entry for the rtorrent-magnet script in {{ic|~/.local/share/applications/rtorrent-magnet.desktop}} with the following content:

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

Then all you need to do is to register the mimetype using:
 $ 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] is an rTorrent distribution in form of a patchset with UI enhancements, colorization, and some added features.

=== Installation ===

Use the various packages available in the AUR, or alternatively create a package using the build script from the GitHub repository, which additionally builds pre-tested dependency versions and may help avoid known issues. See [https://rtorrent-ps.readthedocs.io/en/latest/install.html#installation-on-arch-linux the docs] for details.

=== Configuration ===

Set "pyro.extended" to 1 in your rTorrent configuration file to activate rTorrent-PS features.
{{bc|<nowiki>method.insert = pyro.extended, value|const, 1</nowiki>}}

See rtorrent-ps templates of the [https://github.com/pyroscope/pimp-my-box/tree/master/roles/rtorrent-ps/templates/rtorrent/rtorrent.d pimp-my-box] repository for additional configuration examples. Be aware they may require PyroScope command line utilities to work.

== rtorrent-pyro ==

[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]