ダウンローダー

セットアップ

ダウンロードアプリを接続して、HolyArrs がリリースを送信し、完了したものをインポートできるようにします。

HolyArrs 自体はダウンロードしません。各リリースをダウンローダーに渡し、進み具合を追跡して、ファイルをインポートします。

種類	アプリ
トレント	qBittorrent、Transmission 4 以降、Deluge
Usenet	SABnzbd、NZBGet

始める前に

オーナーまたは管理者であること。
ダウンロードアプリが動いていて、その Web ページを開けること。

ダウンローダーを追加する

Settings > Downloaders(設定 > ダウンローダー)を開きます。
Add a Downloader(ダウンローダーを追加)を押します。
Which app(アプリの種類)で、使っているアプリを選びます。
Name(名前)を入力します。
Address(アドレス)に、アプリの Web ページのアドレスを入力します。たとえば http://192.168.1.10:8090 です。
サインイン情報を入力します。アプリごとのサインインを参照してください。
Save(保存)を押し、続けてその行の Test(テスト)を押します。

名前の横に Working(正常)が表示されます。

アプリごとのサインイン

アプリ	入力するもの	確認できる場所
qBittorrent	API key(API キー。qBittorrent 5.2 以降)または Username and password(ユーザー名とパスワード)	Options > Web UI
Transmission	ユーザー名とパスワード。求められない場合は空のまま	Transmission の設定
Deluge	Web UI のパスワード。ユーザー名は不要	Deluge の Web UI
SABnzbd	API キー	Config > General
NZBGet	ユーザー名とパスワード。NZBGet がユーザー名とパスワードなしで HolyArrs を受け入れる場合は空のまま	NZBGet の設定

HolyArrs はキーとパスワードを暗号化して保存し、二度と表示しません。保存済みのものをそのまま使う場合は、欄に触れないでください。アドレスを別のホストに変えるときは、キーをもう一度入力します。HolyArrs が保存済みのキーを新しいホストに送ることはありません。

オプション

qBittorrent の場合、これらは More options(その他のオプション)の中にあります。

カテゴリ

HolyArrs は自分のダウンロードをこのカテゴリに入れ、そのカテゴリだけを追跡します。

アプリ	カテゴリの扱い
qBittorrent	なければ自動で作成されます
SABnzbd	先に Config > Categories で作っておく必要があります
Transmission、Deluge	ラベルとして保存されます
NZBGet	ダウンロードのカテゴリとして送信されます

優先度とタグ

Priority(優先度)は 1 から 50 です。最も小さい番号が先に使われ、同じ番号どうしは交互に使われます。Tags(タグ)を設定すると、同じタグを持つタイトルだけがこのダウンローダーを使います。タグのないタイトルは、タグのないダウンローダーを使います。

パス

Different folder names(フォルダー名が異なる場合)の Downloader’s path(ダウンローダー側のパス)と HolyArrs’ path(HolyArrs 側のパス)は、2 つのアプリでダウンロードフォルダーが違う名前で見えているときだけ入力します。例: ダウンローダーは /data/torrents に保存し、HolyArrs からは /downloads として見えている場合です。Add a path pair(パスの組を追加)で行を増やせます。

より良い解決策は、共有の親フォルダーを 1 つ用意し、両方のコンテナで同じパスにマウントすることです。フォルダーを参照してください。

ローカルネットワークへのアクセス

ダウンローダーはたいてい自宅で動いているため、既定でオンです。インターネット上のダウンローダーではオフにしてください。

HolyArrs によるこのダウンローダーの変更

オフにすると、新しいダウンロードは引き続き送られますが、すでに入っているものを HolyArrs が一時停止、変更、削除することはありません。ほかのアプリと共有しているダウンローダーで使います。

ダウンロードを追跡する

タイトルのページには、各ダウンロードの状況が表示されます。順番待ち、ダウンロード中(速度と残り時間付き)、停滞、失敗(理由付き)のいずれかです。

不要なダウンロードを終わらせるには、Mark failed(失敗として扱う)を押します。すると HolyArrs は次のことを行います。

そのリリースをタイトルの Turned down(不採用)リストに追加し、二度と選ばれないようにします。
ダウンローダーから、ファイルごと削除します。
もう一度検索し、次に良いリリースを送信します。

ルールを満たすものがほかになければ、タイトルは Needs a decision(判断待ち)と表示されます。

行の状態

状態	意味
Working	前回の確認に応答しました
Paused(一時停止中)	自分で一時停止しました。新しいものは送信されませんが、進行中のダウンロードは引き続き追跡されます
Resting(休止中)	応答がなかったため、HolyArrs は表示されている時刻まで待ちます
Not answering(応答なし)	前回の確認に応答がありませんでした
Sign-in refused(サインイン拒否)	キーまたはサインインが拒否されました

行の Pause(一時停止)と Resume(再開)で、送信を止めたり再開したりします。応答しなくなったダウンローダーは、最長 30 分間スキップされます。

うまくいかないとき

症状: Address にホスト名を使うと、SABnzbd のテストが失敗する。 原因: SABnzbd は、知らないホスト名を拒否します。 対処: IP アドレスを使うか、SABnzbd の Config > Special で host_whitelist に HolyArrs のホスト名を追加します。

症状: SABnzbd にカテゴリがないと言われる。 対処: SABnzbd の Config > Categories でカテゴリを作り、Test を押します。

症状: Deluge が動かない。 対処: Deluge の Web UI で、自分でデーモンに接続し、Label プラグインをオンにします。HolyArrs はデーモンを選びません。

症状: プロキシ付きのソースから届いた .torrent または .nzb が拒否される。 原因: Transmission、Deluge、NZBGet は、プロキシ経由のソースのこれらのファイルをまだ受け取れません。マグネットリンクは使えます。

症状: 行に Check whether this download arrived(このダウンロードが届いたか確認してください)と表示される。 原因: Transmission、Deluge、NZBGet がリリースを受け取っている途中で、接続が切れました。HolyArrs が自動で送り直すことはありません。 対処:

ダウンローダーアプリでそのダウンロードを探します。
HolyArrs で Give up on it(あきらめる)を押します。ダウンロードはダウンローダーに残ります。別のリリースがほしい場合は、Needs a decision で選びます。

症状: Sign-in refused。 対処: ダウンローダーからキーまたはパスワードをコピーし、もう一度入力して、Test を押します。

詳しくはトラブルシューティングを参照してください。

上級者向け

HolyArrs がダウンローダーを選ぶしくみ

トレントのリリースはトレントのダウンローダーへ、Usenet のリリースは Usenet のダウンローダーへ送られます。
優先度の番号が最も小さいものが先です。同じ番号どうしは交互に使われます。
一時停止中と休止中のダウンローダーはスキップされます。
あるダウンローダーがリリースを拒否すると、同じ種類の次のダウンローダーを試します(Try the next Downloader(次のダウンローダーを試す))。
1 つのダウンローダーへの送信は、既定で 2 秒ずつ間隔を空けます。
タグは一致する必要があります。タグのないタイトルは、タグのないダウンローダーへ送られます。

ダウンロードで問題が起きたとき: 対象になるものと設定

HolyArrs は、次の場合を Mark failed と同じように扱います。

ダウンローダーがあきらめた場合(パーツの不足、修復の失敗)。ダウンローダーが示した理由が表示されます。
ダウンロードに .exe、.bat、.scr、.lnk などのプログラムが含まれている場合。movie.mkv.exe も含みます。
ダウンロードが偽物に見える場合。パスワードの案内がある、動画も音声もなくアーカイブだけ、メディアを伴わない Web ショートカットだけ、などです。トレントのファイル一覧は届いた時点ですぐ読み取られるので、偽物はダウンロードが始まる前に失敗になります。
ファイルがリリース名と一致しない場合。インポートは拒否され、ダウンロードは削除されます。
打ち切りまでの時間、進行がない場合。順番待ち、ダウンローダー側での一時停止、100% での修復中や展開中は数えません。
ダウンロードが HolyArrs の外で削除された場合。次のリリースに置き換えられます。

これらの設定は、Settings > Downloaders の When downloads go wrong(ダウンロードで問題が起きたとき)にあります。変更後に表示されるバーで Save を押します。

設定	既定値	変更する場面
Remove failed downloads from the Downloader	オン	失敗したものを調べたい(オフ)。オンではそのファイルも削除されます
Add matched titles to your Library	オフ	すでにダウンローダーにあり、確実に一致するものを、検索なしで追加したい
When you remove a download: Delete its files(ファイルを削除する)	オン	ファイルを残したい
When you remove a download: Turn down its Release(そのリリースを不採用にする)	オフ	そのリリースを、そのタイトルで二度と選ばせたくない
When you remove a download: Search again(もう一度検索する)	オン	次のリリースを自分で選ぶ場合はオフ。Turn down its Release が必要です
Stalled after (hours)	6	ダウンロードがもともと遅い。範囲は 1 から 168
Try the next Release after (hours)	24	置き換えるより待ちたい。最後に進行があった時点から数えます。範囲は、停滞と見なす時間から 720 まで
Fail downloads that hold programs or fakes	オン	めったにありません。オフにすると、それらがインポートまで進みます
Replace downloads removed outside HolyArrs	オン	意図してダウンロードを削除している。オフにすると、タイトルは自分の操作を待ちます
Try the next Downloader	オン	ダウンローダーを 1 つだけ使いたい
Seconds between sends to one Downloader	2	連続して送るとダウンローダーが詰まる。0 で間隔なし。範囲は 0 から 60

サーバー側でダウンローダーを読み取り専用に固定する

HOLYARRS_READONLY_DOWNLOADERS に、ダウンローダーの ID またはアドレスをカンマ区切りで設定します。

HOLYARRS_READONLY_DOWNLOADERS=http://your-server:8080

ここに挙げたダウンローダーは、スイッチの状態にかかわらず読み取り専用のままです。削除して追加し直しても変わりません。スイッチはロックされた表示になり、Downloads ページではその行の操作ボタンが隠れます。

削除、NZBGet での削除、API

ダウンローダーに進行中のダウンロードがある間、Remove(削除)は拒否されます。一時停止し、完了を待ってから削除してください。
NZBGet は、ダウンロードまたはその履歴エントリが削除されると必ずファイルを削除します。そのため HolyArrs は、ファイルを残す指定の削除を拒否します。
ダウンローダーのすべてのルートは http://your-server:6262/api/v1/openapi.json にあります。