mirror of
https://github.com/plexguide/Huntarr.io.git
synced 2026-02-19 23:37:26 -05:00
2997382d37
- Move donate page from help/donate.html to donate.html (URL: .../donate.html) - Update all doc links and README to new donate URL - Sidebar Donate link: red border, left accent, subtle red glow and background - Applies to all doc pages via shared main.css
207 lines
10 KiB
HTML
207 lines
10 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="en">
|
|
<head>
|
|
<meta charset="UTF-8">
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
<title>Swaparr - Huntarr Docs</title>
|
|
<link rel="icon" type="image/png" href="../images/huntarr-logo.png">
|
|
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.5.1/css/all.min.css">
|
|
<link rel="stylesheet" href="../css/main.css">
|
|
</head>
|
|
<body>
|
|
|
|
<!-- Mobile Topbar -->
|
|
<div class="docs-mobile-topbar">
|
|
<button class="mob-hamburger" aria-label="Open navigation"><span></span><span></span><span></span></button>
|
|
<img src="../images/huntarr-logo.png" alt="Huntarr" class="mob-logo">
|
|
<span class="mob-title">Documentation</span>
|
|
</div>
|
|
|
|
<!-- Sidebar Backdrop (mobile) -->
|
|
<div class="docs-sidebar-backdrop"></div>
|
|
|
|
<div class="docs-layout">
|
|
|
|
<!-- ===== SIDEBAR ===== -->
|
|
<nav class="docs-sidebar" aria-label="Documentation navigation">
|
|
<a href="../index.html" class="sidebar-brand">
|
|
<img src="../images/huntarr-logo.png" alt="Huntarr">
|
|
<span>Huntarr</span>
|
|
</a>
|
|
|
|
<div class="sidebar-scroll">
|
|
|
|
<!-- Getting Started -->
|
|
<div class="nav-group">
|
|
<div class="nav-group-title">Getting Started</div>
|
|
<div class="nav-group-items">
|
|
<a href="../index.html"><i class="fas fa-home"></i> Welcome</a>
|
|
<a href="../getting-started/installation.html"><i class="fas fa-download"></i> Installation</a>
|
|
<a href="../getting-started/setup-wizard.html"><i class="fas fa-magic"></i> Setup Wizard</a>
|
|
<a href="../getting-started/first-steps.html"><i class="fas fa-rocket"></i> First Steps</a>
|
|
</div>
|
|
</div>
|
|
|
|
<!-- Apps -->
|
|
<div class="nav-group">
|
|
<div class="nav-group-title">Apps</div>
|
|
<div class="nav-group-items">
|
|
<a href="index.html"><i class="fas fa-th-large"></i> Overview</a>
|
|
<a href="sonarr.html"><i class="fas fa-tv"></i> Sonarr</a>
|
|
<a href="radarr.html"><i class="fas fa-film"></i> Radarr</a>
|
|
<a href="lidarr.html"><i class="fas fa-music"></i> Lidarr</a>
|
|
<a href="readarr.html"><i class="fas fa-book"></i> Readarr</a>
|
|
<a href="whisparr.html"><i class="fas fa-mask"></i> Whisparr</a>
|
|
<a href="prowlarr.html"><i class="fas fa-search"></i> Prowlarr</a>
|
|
<a href="swaparr.html" class="active"><i class="fas fa-exchange-alt"></i> Swaparr</a>
|
|
</div>
|
|
</div>
|
|
|
|
<!-- Movie Hunt -->
|
|
<div class="nav-group">
|
|
<div class="nav-group-title">Movie Hunt</div>
|
|
<div class="nav-group-items">
|
|
<a href="../movie-hunt/index.html"><i class="fas fa-clapperboard"></i> Overview <span class="nav-badge nav-badge-beta">Beta</span></a>
|
|
<a href="../movie-hunt/media-collection.html"><i class="fas fa-photo-film"></i> Media Collection</a>
|
|
<a href="../movie-hunt/indexers-clients.html"><i class="fas fa-server"></i> Indexers & Clients</a>
|
|
<a href="../movie-hunt/profiles.html"><i class="fas fa-sliders"></i> Profiles</a>
|
|
</div>
|
|
</div>
|
|
|
|
<!-- NZB Hunt -->
|
|
<div class="nav-group">
|
|
<div class="nav-group-title">NZB Hunt</div>
|
|
<div class="nav-group-items">
|
|
<a href="../nzb-hunt/index.html"><i class="fas fa-newspaper"></i> Overview <span class="nav-badge nav-badge-beta">Beta</span></a>
|
|
</div>
|
|
</div>
|
|
|
|
<!-- Requestarr -->
|
|
<div class="nav-group">
|
|
<div class="nav-group-title">Requests</div>
|
|
<div class="nav-group-items">
|
|
<a href="../requestarr/index.html"><i class="fas fa-hand-paper"></i> Requests</a>
|
|
</div>
|
|
</div>
|
|
|
|
<!-- Settings -->
|
|
<div class="nav-group">
|
|
<div class="nav-group-title">Settings</div>
|
|
<div class="nav-group-items">
|
|
<a href="../settings/index.html"><i class="fas fa-cog"></i> Main Settings</a>
|
|
<a href="../settings/scheduling.html"><i class="fas fa-clock"></i> Scheduling</a>
|
|
<a href="../settings/notifications.html"><i class="fas fa-bell"></i> Notifications</a>
|
|
<a href="../settings/backup-restore.html"><i class="fas fa-database"></i> Backup & Restore</a>
|
|
<a href="../settings/log-settings.html"><i class="fas fa-file-alt"></i> Log Settings</a>
|
|
<a href="../settings/user-account.html"><i class="fas fa-user-shield"></i> User Account</a>
|
|
</div>
|
|
</div>
|
|
|
|
<!-- System -->
|
|
<div class="nav-group">
|
|
<div class="nav-group-title">System</div>
|
|
<div class="nav-group-items">
|
|
<a href="../system/hunt-manager.html"><i class="fas fa-tasks"></i> Hunt Manager</a>
|
|
<a href="../system/logs.html"><i class="fas fa-scroll"></i> Logs</a>
|
|
<a href="../system/api.html"><i class="fas fa-code"></i> API Reference</a>
|
|
</div>
|
|
</div>
|
|
|
|
<!-- Help -->
|
|
<div class="nav-group">
|
|
<div class="nav-group-title">Help</div>
|
|
<div class="nav-group-items">
|
|
<a href="../help/faq.html"><i class="fas fa-question-circle"></i> FAQ</a>
|
|
<a href="../help/community.html"><i class="fas fa-users"></i> Community</a>
|
|
<a href="https://plexguide.github.io/Huntarr.io/donate.html"><i class="fas fa-heart"></i> Donate</a>
|
|
</div>
|
|
</div>
|
|
|
|
</div><!-- /sidebar-scroll -->
|
|
|
|
<div class="sidebar-footer">
|
|
<a href="https://discord.com/invite/PGJJjR5Cww" target="_blank" class="sf-discord" title="Discord"><i class="fab fa-discord"></i></a>
|
|
<a href="https://www.reddit.com/r/huntarr/" target="_blank" class="sf-reddit" title="Reddit"><i class="fab fa-reddit-alien"></i></a>
|
|
<a href="https://github.com/plexguide/Huntarr.io" target="_blank" class="sf-github" title="GitHub"><i class="fab fa-github"></i></a>
|
|
<a href="https://plexguide.github.io/Huntarr.io/donate.html" class="sf-heart" title="Donate"><i class="fas fa-heart"></i></a>
|
|
</div>
|
|
</nav>
|
|
|
|
<!-- ===== MAIN ===== -->
|
|
<main class="docs-main">
|
|
<div class="docs-content">
|
|
|
|
<h1>Swaparr</h1>
|
|
<p class="page-subtitle">Automatically manage stalled and slow downloads.</p>
|
|
|
|
<h2>Overview</h2>
|
|
<ul>
|
|
<li>Swaparr monitors your download clients for stalled or slow downloads</li>
|
|
<li>When a download is stuck, Swaparr can automatically swap it for an alternative</li>
|
|
<li>Reduces manual intervention in managing your download queue</li>
|
|
<li>Works alongside Huntarr's hunting system</li>
|
|
</ul>
|
|
|
|
<h2>How It Works</h2>
|
|
<ol>
|
|
<li>Swaparr monitors active downloads in your configured clients</li>
|
|
<li>Detects downloads that are stalled, very slow, or stuck</li>
|
|
<li>Removes the problematic download</li>
|
|
<li>Triggers a new search for the same media through the appropriate *arr app</li>
|
|
<li>A new, hopefully better, download begins automatically</li>
|
|
</ol>
|
|
|
|
<h2>Configuration</h2>
|
|
|
|
<h3>Instance Settings</h3>
|
|
<p>Standard: URL, API key, name.</p>
|
|
|
|
<h3>Swaparr Settings Table</h3>
|
|
<table>
|
|
<thead>
|
|
<tr><th>Setting</th><th>Default</th><th>Description</th></tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr><td><strong>Enabled</strong></td><td>Yes</td><td>Enable Swaparr monitoring</td></tr>
|
|
<tr><td><strong>Strike Count</strong></td><td>3</td><td>Number of strikes before a download is swapped</td></tr>
|
|
<tr><td><strong>Strike Interval</strong></td><td>5 minutes</td><td>Time between strike checks</td></tr>
|
|
<tr><td><strong>Max Download Speed</strong></td><td>—</td><td>Downloads below this speed get strikes (KB/s)</td></tr>
|
|
<tr><td><strong>Ignore Categories</strong></td><td>—</td><td>Comma-separated categories to exclude</td></tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
<h2>Dashboard Stats</h2>
|
|
<p>Huntarr shows Swaparr statistics on the home page:</p>
|
|
<ul>
|
|
<li>Total swaps performed</li>
|
|
<li>Active strikes</li>
|
|
<li>Downloads being monitored</li>
|
|
<li>Success rate</li>
|
|
</ul>
|
|
|
|
<h2>Tips</h2>
|
|
<ul>
|
|
<li>Set strike count to 3+ to avoid swapping temporarily slow downloads</li>
|
|
<li>Use ignore categories for large downloads that are expected to be slow</li>
|
|
<li>Monitor the Swaparr stats on the dashboard to see if settings need tuning</li>
|
|
<li>Works best with torrent clients (qBittorrent, Deluge, Transmission)</li>
|
|
</ul>
|
|
|
|
<div class="alert alert-warning">
|
|
<strong>Swaparr removes and re-searches downloads.</strong> Make sure your *arr apps have good indexer coverage so alternative downloads can be found.
|
|
</div>
|
|
|
|
</div><!-- /docs-content -->
|
|
|
|
<footer class="docs-footer">
|
|
<p>Huntarr is open source. <a href="https://github.com/plexguide/Huntarr.io" target="_blank">GitHub</a> · <a href="https://discord.com/invite/PGJJjR5Cww" target="_blank">Discord</a> · <a href="https://www.reddit.com/r/huntarr/" target="_blank">Reddit</a></p>
|
|
</footer>
|
|
</main>
|
|
|
|
</div><!-- /docs-layout -->
|
|
|
|
<button class="back-to-top" aria-label="Back to top"><i class="fas fa-arrow-up"></i></button>
|
|
<script src="../js/main.js"></script>
|
|
</body>
|
|
</html>
|