このアプリが好きですか? ⭐️を付けていただきありがとうございます
デクルッター
目次
- 概要
- 依存関係、ヒント、よくある質問
- はじめる
- 設定の説明
- クレジット
- 免責事項
概要
Decluttarr は、レーダー、ソナー、ライダー、リーダー、ウィスパーのキューを停止/冗長なダウンロードから解放します。
機能の概要:
- メタデータのダウンロード中にスタックしたダウンロードを自動的に削除します (& 別のソースからのダウンロードをトリガーします)
- 失敗したダウンロードを自動的に削除 (& 別のソースからのダウンロードをトリガー)
- レーダー/ソナー/などに属するダウンロードを自動的に削除します。それまでに削除されたアイテム (「孤立したダウンロード」)
- 連続して複数回停止していることが判明した場合、停止したダウンロードを自動的に削除します (別のソースからのダウンロードをトリガーします)。
- 連続して複数回遅いダウンロードが検出された場合、遅いダウンロードを自動的に削除します (別のソースからのダウンロードをトリガーします)。
- レーダー/ソナー/などに属するダウンロードを自動的に削除します。監視されていない項目
- インポートに失敗したダウンロードは、形式のアップグレードではないため、自動的に削除されます (つまり、より良いバージョンがすでに存在します)。
これをローカルで実行するには、main.py を起動するか、Docker イメージをプルします。サンプルの docker-compose.yml は docker フォルダーにあります。
依存関係、ヒント、よくある質問
- Sonarr v4 および Radarr v5 (現在は「最新」タグではなく「夜間」タグ) を使用してください。そうしないと、特定の機能が正しく動作しない可能性があります。
- qBittorrent が推奨されますが、必須ではありません。 qBittorrent を使用しない場合、次の制限が発生します。
- 遅いダウンロードを検出する場合、*arr アプリによって提供される速度が使用されますが、これは直接クエリしたときに qBittorrent が返す速度よりも精度が低くなります。
- ダウンロードを削除から保護する機能 (NO_STALLED_REMOVAL_QBIT_TAG) が機能しない
- プライベートトラッカーを無視する機能が動作しない
- 「10 / 3 回見つかりました」などの奇妙なエラーが表示された場合は、「グラビング中にブロックリストに登録された Torrent ハッシュを拒否する」設定をオンにすることを検討してください。 Nightly Radarr/Sonarr/Readarr/Lidarr/Whisparr では、このオプションは各インデクサーの詳細オプションの設定/インデクサーの下にあり、Prowlarr では設定/アプリの下にあり、その後、それぞれのアプリの詳細設定にあります。
- 壊れたトレントが削除されると、それに属するファイルも削除されます
- すべての削除タイプにわたって: 別のソースからの新しいダウンロードは、raderr/sonarr/lidarr/readarr/whisparr (利用可能な場合) によって自動的に追加されます。
- qBittorrent を使用していて、どの torrent も削除されず、たとえ保護されていない場合でも、すべての torrent が NO_STALLED_REMOVAL_QBIT_TAG によって保護されていることが詳細ログに示されている場合は、API 呼び出しに問題がある qBittorrent バージョンを使用している可能性があるため、切り替えを検討することをお勧めします。別の qBit イメージへ (#56 を参照)
- 現在、「*Arr」アプリは英語でのみサポートされています。詳細については、第 132 号を参照してください。
- yaml の問題が発生した場合は、クローズされた問題を確認してください。さまざまな表記があり、あなたが見つけた問題はいずれかの問題ですでに解決されている可能性があります。問題を理解したら、他の人を助けるために自由に yaml をここに投稿してください: #173
- declutarr は、単一の Radar / Sonarr インスタンスのみをサポートします。これらの *arr のインスタンスが複数ある場合、解決策は複数の decluclutarr も実行することです。
はじめる
これを実行するには 2 つの方法があります。
- docker-compose を使用した Docker コンテナとして
- リポジトリのクローンを作成し、スクリプトを手動で実行する
両方の方法を以下で説明し、その下にさまざまな設定についての説明があります。
方法 1: ドッカー
docker-compose.yml
ファイルを作成する- 以下をベースとして使用し、必要に応じて設定を微調整します。
version: "3.3"
services:
decluttarr:
image: ghcr.io/manimatter/decluttarr:latest
container_name: decluttarr
restart: always
environment:
TZ=Europe/Zurich
PUID=1000
PGID=1000
## General
# TEST_RUN=True
# SSL_VERIFICATION=False
LOG_LEVEL: INFO
## Features
REMOVE_TIMER: 10
REMOVE_FAILED: True
REMOVE_FAILED_IMPORTS: True
REMOVE_METADATA_MISSING: True
REMOVE_MISSING_FILES: True
REMOVE_ORPHANS: True
REMOVE_SLOW: True
REMOVE_STALLED: True
REMOVE_UNMONITORED: True
RUN_PERIODIC_RESCANS: '
{
"SONARR": {"MISSING": true, "CUTOFF_UNMET": true, "MAX_CONCURRENT_SCANS": 3, "MIN_DAYS_BEFORE_RESCAN": 7},
"RADARR": {"MISSING": true, "CUTOFF_UNMET": true, "MAX_CONCURRENT_SCANS": 3, "MIN_DAYS_BEFORE_RESCAN": 7}
}'
# Feature Settings
PERMITTED_ATTEMPTS: 3
NO_STALLED_REMOVAL_QBIT_TAG: Don't Kill
REMOVE_SLOW: True
MIN_DOWNLOAD_SPEED: 100
FAILED_IMPORT_MESSAGE_PATTERNS: '
[
"Not a Custom Format upgrade for existing",
"Not an upgrade for existing"
]'
## Radarr
RADARR_URL: http://radarr:7878
RADARR_KEY: $RADARR_API_KEY
## Sonarr
SONARR_URL: http://sonarr:8989
SONARR_KEY: $SONARR_API_KEY
## Lidarr
LIDARR_URL=http://lidarr:8686
LIDARR_KEY=$LIDARR_API_KEY
## Readarr
READARR_URL=http://readarr:8787
READARR_KEY=$READARR_API_KEY
## Whisparr
WHISPARR_URL=http://whisparr:6969
WHISPARR_KEY=$WHISPARR_API_KEY
## qBitorrent
QBITTORRENT_URL: http://qbittorrent:8080
# QBITTORRENT_USERNAME=Your name
# QBITTORRENT_PASSWORD=Your password
- ファイルが置かれているディレクトリで
docker-compose up -d
を実行して、docker コンテナを作成します。 注: 常に「最新」バージョンをプルしてください。 「dev」バージョンはテスト専用であり、コードを提供する場合、またはバグ修正でサポートする場合にのみプルする必要があります。
方法 2: 手動で実行する
git clone -b main https://github.com/ManiMatter/decluttarr.git
- config フォルダー内の
config.conf-Example
名前をconfig.conf
に変更します。 - 必要に応じて
config.conf
微調整します - docker/requirements.txt (pip install -rrequirements.txt) にリストされているライブラリをインストールします。
-
python3 main.py
を使用してスクリプトを実行します。 注: docker-compose.yml 経由で実行する場合、 config.conf
無視されます。
設定の説明
一般設定
アプリケーションの一般的な動作を構成します(すべての機能にわたって)
LOG_LEVEL
- ロギングが行われるレベルを設定します
INFO
、raderr/sonarr/lidarr/readarr/whisparr に適用された変更のみが表示されますVERBOSE
変更が適用されない場合でも、実行されている各チェックを示します。-
DEBUG
、デバッグにのみ必要な非常に詳細な情報を表示します。 - タイプ: 文字列
- 許容値: CRITICAL、ERROR、WARNING、INFO、VERBOSE、DEBUG
- 必須です: いいえ (デフォルトは INFO)
テスト_実行
- このツールを安全に試すことができます。アクティブな場合、ダウンロードは削除されません
- タイプ: ブール値
- 許容値: True、False
- 必須です: いいえ (デフォルトは False)
SSL_VERIFICATION
- すべての API 呼び出しに対して SSL 証明書の検証をオンまたはオフにします。
-
True
SSL 証明書の検証がオンであることを意味します - 警告: SSL 検証を無効にすると、システムが中間者攻撃に対して脆弱になるため、セキュリティに影響を与える可能性があることに注意することが重要です。リスクが十分に理解され軽減されている、管理された安全な環境でのみ実行する必要があります。
- タイプ: ブール値
- 許容値: True、False
- 必須です: いいえ (デフォルトは True)
機能設定
ダウンロード キューに適用するクリーニングの種類を制御します
REMOVE_TIMER
- 孤立したダウンロードと停止したダウンロードについてキューをチェックする頻度を設定します
- タイプ: 整数
- 単位:分
- 必須です: いいえ (デフォルトは 10)
REMOVE_FAILED
- 接続なしで失敗したダウンロードをキューから削除するかどうかを制御します
- これらのダウンロードはブロックリストに追加されません - 別のソースからの新しいダウンロードは、raderr/sonarr/lidarr/readarr/whisparr (利用可能な場合) によって自動的に追加されます。
- タイプ: ブール値
- 許容値: True、False
- 必須です: いいえ (デフォルトは False)
REMOVE_FAILED_IMPORTS
- インポートに失敗したダウンロードをキューから削除するかどうかを制御します
- これは、より良いバージョンがすでに存在している場合などに発生する可能性があります。
- 注: インポート メッセージに FAILED_IMPORT_MESSAGE_PATTERNS にリストされている警告が含まれている場合にのみ、インポートが失敗したとみなされます (下記を参照)。
- これらのダウンロードはブロックリストに追加されます
- IGNORE_PRIVATE_TRACKERS 設定が true で、影響を受ける torrent がプライベート トラッカーである場合、キュー アイテムは削除されますが、torrent ファイルは保持されます。
- タイプ: ブール値
- 許容値: True、False
- 必須です: いいえ (デフォルトは False)
REMOVE_METADATA_MISSING
- メタデータの取得中にスタックしたダウンロードをキューから削除するかどうかを制御します
- これらのダウンロードはブロックリストに追加されるため、再リクエストされることはありません
- 別のソースからの新しいダウンロードは、raderr/sonarr/lidarr/readarr/whisparr (利用可能な場合) によって自動的に追加されます。
- タイプ: ブール値
- 許容値: True、False
- 必須です: いいえ (デフォルトは False)
REMOVE_MISSING_FILES
- 「ファイルが見つかりません」という警告が表示されるダウンロードをキューから削除するかどうかを制御します
- これらのダウンロードはブロックリストに追加されません
- タイプ: ブール値
- 許容値: True、False
- 必須です: いいえ (デフォルトは False)
REMOVE_ORPHANS
- 孤立したダウンロードをキューから削除するかどうかを制御します
- 孤立したダウンロードとは、要求されたどのメディアにも属していないものです (ダウンロードの開始後にメディアがレーダー/ソナール/ライダー/リーダー/ウィスパーから削除されたため)
- これらのダウンロードはブロックリストに追加されません
- タイプ: ブール値
- 許容値: True、False
- 必須です: いいえ (デフォルトは False)
REMOVE_SLOW
- 遅いダウンロードをキューから削除するかどうかを制御します
- 遅いダウンロードはブロックリストに追加されるため、今後再要求されなくなります。
- 注: usenet のダウンロードには適用されません (ユーザーは一定の速度に対して料金を支払うため、速度が低下することはありません)。
- タイプ: ブール値
- 許容値: True、False
- 必須です: いいえ (デフォルトは False)
REMOVE_STALLED
- 接続がなく停止したダウンロードをキューから削除するかどうかを制御します
- これらのダウンロードはブロックリストに追加されるため、今後再リクエストされることはありません
- タイプ: ブール値
- 許容値: True、False
- 必須です: いいえ (デフォルトは False)
REMOVE_UNMONITORED
- 監視されていないメディアに属するダウンロードをキューから削除するかどうかを制御します
- 注: 同じダウンロードに依存するすべてのテレビ番組が監視されていない場合にのみキューから削除されます。
- これらのダウンロードはブロックリストに追加されません
- 注: sonarr はマルチシーズン パックをサポートしていないため、ダウンロードする場合は、後で説明する
NO_STALLED_REMOVAL_QBIT_TAG
で保護する必要があります。 - タイプ: ブール値
- 許容値: True、False
- 必須です: いいえ (デフォルトは False)
RUN_PERIODIC_RESCANS
- 不足しているアイテムまたはまだ期限を満たしていないアイテムに対して検索を自動的にトリガーするかどうかを制御します
- 注: 現在は Radarr/Sonarr のみをサポートしています (Lidarr は Lidarr/Lidarr#5084 に依存 / Readarr は Readarr/Readarr#3724 に依存します)
- タイプ: 辞書
- 必須です: いいえ (デフォルトでは、検索は自動的にトリガーされません)
- 「SONARR」/「RADARR」は、それぞれのインスタンスの自動検索をオンにします
- 「MISSING」/「CUTOFF_UNMET」は、必要なアイテムの自動検索をオンにします(デフォルトは True)。
- 「MAX_CONCURRENT_SCANS」は、各スキャンで検索する項目の最大数を指定します。この値は、REMOVE_TIMER で設定された間隔に従って実行される検索操作ごとに処理されるアイテムの数を決定します。
- 注: 制限は指名手配リストごとに異なります。したがって、Radarr と Sonarr の両方が、不足しているアイテムとカットオフされた未満たアイテムの両方の自動検索用に設定されている場合、実際のカウントは MAX_CONCURRENT_SCANS の 4 倍になる可能性があります。
- 「MIN_DAYS_BEFORE_RESCAN」は、アイテムが再びスキャン対象とみなされるまでに経過する必要がある日数を指定します。
- 注: RUN_PERIODIC_RESCANS は常に、最も長く検索されているアイテムを検索します。
RUN_PERIODIC_RESCANS: '
{
"SONARR": {"MISSING": true, "CUTOFF_UNMET": true, "MAX_CONCURRENT_SCANS": 3, "MIN_DAYS_BEFORE_RESCAN": 7},
"RADARR": {"MISSING": true, "CUTOFF_UNMET": true, "MAX_CONCURRENT_SCANS": 3, "MIN_DAYS_BEFORE_RESCAN": 7}
}'
さまざまな yaml 表記法がありますが、一部のユーザーは以下の代替表記法を提案しました。問題が発生した場合は、新しい問題を開く前に、まず閉じられた問題を確認してください (例: #173)
- RUN_PERIODIC_RESCANS=[
{
"SONARR":[{"MISSING":true, "CUTOFF_UNMET":true, "MAX_CONCURRENT_SCANS":3, "MIN_DAYS_BEFORE_RESCAN":7}],
"RADARR":[{"MISSING":true, "CUTOFF_UNMET":true, "MAX_CONCURRENT_SCANS":3, "MIN_DAYS_BEFORE_RESCAN":7}]
}
MIN_DOWNLOAD_SPEED
- アクティブなダウンロードの最小ダウンロード速度を設定します
- 連続する 2 回のチェックの間で、ダウンロード ファイル サイズの増加がこの値よりも小さい場合、ダウンロードは遅いとみなされ、許可された試行回数を超えるとダウンロードが削除されます。
- タイプ: 整数
- 単位: キロバイト/秒
- 必須: いいえ (デフォルトは 100 ですが、「REMOVE_SLOW」が true の場合にのみ適用されます)
PERMITTED_ATTEMPTS
- ダウンロードが削除される前に、メタデータのダウンロードが停止、遅い、または停止しているとして検出される回数を定義します。
- タイプ: 整数
- 単位:スキャン回数
- 必須です: いいえ (デフォルトは 3)
NO_STALLED_REMOVAL_QBIT_TAG
- このタグが付けられた qBittorrent のダウンロードは削除されません
- qBittorrent をトレント マネージャーとして使用していない場合、この機能は利用できません
- すべての種類の削除に適用されます (つまり、decluttarr によって自動的に削除されるものはありません)。
- 注: スタックしたトレントを手動でバックアップして実行するには、「強制再チェック」を試してみることをお勧めします。
- タグは qBittorrent で自動的に作成されます (必要な qBittorrent は
QBITTORRENT_URL
でアクセス可能です) - 重要: 監視されていないダウンロードも削除されないように保護します (マルチシーズン パックに関連)
- タイプ: 文字列
- 必須: いいえ (デフォルトは
Don't Kill
)
IGNORE_PRIVATE_TRACKERS
- これが true に設定されている場合、qBittorrent のプライベート トレントはキューから削除されません。
- qBittorrent が使用されている場合にのみ機能します (送信などでは機能しません)
- すべての種類の削除に適用されます (つまり、decluttarr によって自動的に削除されるものは何もありません)。唯一の例外は REMOVE_NO_FORMAT_UPGRADE です。プライベート トラッカーの場合、キュー アイテムは削除されます (ただし、トレント ファイルは保持されます)。
- 注: スタックしたトレントを手動でバックアップして実行するには、「強制再チェック」を試してみることをお勧めします。
- タイプ: ブール値
- 許容値: True、False
- 必須です: いいえ (デフォルトは True)
FAILED_IMPORT_MESSAGE_PATTERNS
- REMOVE_FAILED_IMPORTS と連携して動作します (この設定が true の場合にのみ関係します)
- インポート時に警告が表示される完了したダウンロードを失敗とみなすべきかどうかをツールが判断するパターンを定義します。
- 指定されたパターンのいずれかがキュー アイテムのメッセージの 1 つに含まれている場合、キュー アイテムは失敗したとみなされます。
- 注: 空のままにした場合 (または指定しなかった場合)、警告が表示された保留中のインポートは失敗したとみなされます。
- タイプ: リスト
- 推奨値: [「既存のカスタム フォーマットのアップグレードではない」、「既存のアップグレードではない」]
- 必須: いいえ (デフォルトは [] で、すべてのメッセージが失敗することを意味します)
レーダーセクション
ダウンロード キューを整理する必要があるレーダー インスタンスを定義します
RADARR_URL
- インスタンスにアクセスできる URL
- 定義されていない場合、このインスタンスは監視されません
レーダー_キー
ソナーセクション
ダウンロード キューを整理する必要がある sonarr インスタンスを定義します
SONARR_URL
- インスタンスにアクセスできる URL
- 定義されていない場合、このインスタンスは監視されません
SONAR_KEY
ライダーセクション
ダウンロード キューを整理する必要がある lidarr インスタンスを定義します
LIDAR_URL
- インスタンスにアクセスできる URL
- 定義されていない場合、このインスタンスは監視されません
LIDAR_KEY
読み取りセクション
ダウンロード キューを整理する必要がある readarr インスタンスを定義します
READARR_URL
- インスタンスにアクセスできる URL
- 定義されていない場合、このインスタンスは監視されません
READARR_KEY
ウィスパーセクション
ダウンロード キューを整理する必要がある whisparr インスタンスを定義します
WHISPARR_URL
- インスタンスにアクセスできる URL
- 定義されていない場合、このインスタンスは監視されません
ウィスパー_キー
qBittorrentセクション
qBittorrent に接続するための設定を定義します。別の torrent マネージャーを使用する場合は、このセクションをコメントアウトします (これによって生じる機能の制限については、上記を参照してください)。
QBITTORRENT_URL
- インスタンスにアクセスできる URL
- 定義されていない場合、NO_STALLED_REMOVAL_QBIT_TAG は無効になります。
QBITTORRENT_USERNAME
- qBittorrent へのログインに使用されるユーザー名
- オプション。 qBittorrent での認証バイパスが有効になっている場合 (ローカル接続など) は必要ありません。
QBITTORRENT_PASSWORD
- qBittorrentへのログインに使用するパスワード
- オプション。 qBittorrent での認証バイパスが有効になっている場合 (ローカル接続など) は必要ありません。
クレジット
- MattDGTL/sonarr-radarr-queue-cleaner によってコードを拡張されたダウンロードの停止を検出するためのスクリプト
- syncarr/syncarr でコード上に展開された設定を読み出すスクリプト
- SONARR/RADARR チームとその優れた製品、API ドキュメント、Discord チャネルのガイダンスへの貢献者
- このスクリプトがメタデータの検索でダウンロードが停止していることを検出できるようにする追加のフラグを API に追加してくれたことに特に感謝します。
- アーム互換性のための crangles17
- 改善されたドキュメントの Fxsch / ReadMe
免責事項
このスクリプトにはいかなる保証もありません。ご自身の責任でご使用ください。