Skip to content

Commit 09603f6

Browse files
Admin9705Admin9705
committed
Radarr Updates
1 parent 555eb52 commit 09603f6

File tree

4 files changed

+249
-132
lines changed

4 files changed

+249
-132
lines changed

‎docs/apps/radarr.html‎

Lines changed: 158 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -168,12 +168,147 @@ <h3 id="additional-options"><i class="fas fa-cogs" style="margin-right: 10px; co
168168
<h4><i class="fas fa-eye" style="margin-right: 8px; color: #f1c40f;"></i>Monitored Only</h4>
169169
<p>When enabled, Huntarr will only search for movies that are marked as "Monitored" in Radarr. This prevents searches for movies you've intentionally unmonitored.</p>
170170

171-
<h4><i class="fas fa-calendar" style="margin-right: 8px; color: #e74c3c;"></i>Skip Future Movies</h4>
172-
<p>When enabled, Huntarr will skip movies with future release dates. This prevents unnecessary searches for content that hasn't been released yet.</p>
171+
<h4 id="skip-future-movies"><i class="fas fa-calendar" style="margin-right: 8px; color: #e74c3c;"></i>Skip Future Movies</h4>
172+
<p>When enabled, Huntarr will skip movies with future release dates (based on the Release Date field). When disabled, Huntarr will process all movies regardless of release date.</p>
173+
174+
<div class="alert alert-info">
175+
<strong>📋 Release Date Logic Simplified:</strong> As of Huntarr 7.6.0+, we've simplified release date filtering to only use the <strong>Release Date</strong> field from Radarr. This field is the most reliable and consistently populated date field in the Radarr API.
176+
</div>
177+
178+
<h5>Why We Simplified Release Date Detection</h5>
179+
<p>Previous versions of Huntarr used complex fallback logic that checked multiple date fields (Physical Release, Digital Release, In Cinemas) with confusing priority rules. This approach had several problems:</p>
180+
<ul>
181+
<li><strong>Inconsistent Results:</strong> Movies with partial date information would sometimes be processed incorrectly</li>
182+
<li><strong>Complex Logic:</strong> The fallback system was difficult to understand and debug</li>
183+
<li><strong>User Confusion:</strong> Users couldn't predict which date field would determine future status</li>
184+
<li><strong>API Reliability:</strong> Not all date fields are consistently populated by metadata providers</li>
185+
</ul>
186+
187+
<p>The new simplified approach uses only the <strong>Release Date</strong> field because:</p>
188+
<ul>
189+
<li><strong>Always Present:</strong> This field is consistently populated in the Radarr UI and API</li>
190+
<li><strong>User Visible:</strong> It's the date you see in the main movie list in Radarr</li>
191+
<li><strong>Predictable:</strong> Users can easily see which movies will be skipped</li>
192+
<li><strong>Reliable:</strong> Represents the general availability date for the movie</li>
193+
</ul>
194+
195+
<h5>Release Date Logic Flow</h5>
196+
<p>The simplified logic works as follows:</p>
197+
<ul>
198+
<li><strong>Skip Future Releases = OFF:</strong> Process all movies regardless of release date (useful if you want cam rips, theater recordings, etc.)</li>
199+
<li><strong>Skip Future Releases = ON:</strong> Only process movies with past release dates, with optional control over movies with missing dates</li>
200+
</ul>
201+
202+
<div class="mermaid">
203+
graph TD
204+
A["🎬 Radarr Movie"] --> B["Check Skip Future Releases Setting"]
205+
B -->|Disabled| H["✅ Process All Movies<br/>(May Include Future/Theater Releases)"]
206+
B -->|Enabled| D["Check Release Date Field"]
207+
D -->|Missing/Invalid| E["Check Process No Release Dates"]
208+
D -->|Valid Date| F["Date in Past?"]
209+
F -->|Yes| J["✅ Include in Search"]
210+
F -->|No| K["⏭️ Skip Future Movie"]
211+
E -->|Enabled| L["⚠️ Process Movie<br/>(Unknown Quality Risk)"]
212+
E -->|Disabled| M["⏭️ Skip No Date Movie"]
213+
214+
style A fill:#e3f2fd
215+
style H fill:#fff3e0
216+
style J fill:#c8e6c9
217+
style K fill:#ffcdd2
218+
style L fill:#ffecb3
219+
style M fill:#ffcdd2
220+
</div>
221+
222+
<script src="https://cdn.jsdelivr.net/npm/mermaid/dist/mermaid.min.js"></script>
223+
<script>mermaid.initialize({startOnLoad:true});</script>
224+
225+
<h4 id="process-no-release-dates"><i class="fas fa-question-circle" style="margin-right: 8px; color: #ff6b35;"></i>Process No Release Dates</h4>
226+
<p>In rare cases, some movies in your Radarr library may have missing or invalid release date information. By default, Huntarr will <strong>skip</strong> these movies to avoid potentially downloading unknown or poor quality content.</p>
227+
228+
<p>When this option is enabled, Huntarr will process movies that have:</p>
229+
<ul>
230+
<li><strong>Completely missing Release Date field</strong></li>
231+
<li><strong>Invalid or unparseable release dates</strong></li>
232+
<li><strong>Corrupted date metadata</strong></li>
233+
</ul>
234+
235+
<p><strong style="color: #ff6b35;">Risks of enabling this option:</strong></p>
236+
<ul>
237+
<li><strong>Unknown quality:</strong> Movies without release dates may be unreleased, beta, or test content</li>
238+
<li><strong>Metadata issues:</strong> Missing dates often indicate other metadata problems</li>
239+
<li><strong>Unpredictable results:</strong> Hard to determine what quality or type of content will be found</li>
240+
<li><strong>Waste of resources:</strong> May download content you don't actually want</li>
241+
</ul>
242+
243+
<div class="alert alert-warning">
244+
<strong>⚠️ Rare Case Warning:</strong> This situation is uncommon but can occur with:<br>
245+
• Manually added movies with incomplete metadata<br>
246+
• Movies from unreliable metadata sources<br>
247+
• Test or development content in your library<br>
248+
<br>
249+
<strong>Recommended:</strong> Keep this disabled unless you specifically need to process movies with missing release date information. Check the <a href="#release-date-troubleshooting">troubleshooting section</a> below for better solutions.
250+
</div>
173251

174252
<h4><i class="fas fa-star" style="margin-right: 8px; color: #f39c12;"></i>Minimum Availability</h4>
175253
<p>Respects Radarr's minimum availability setting. Huntarr will only search for movies that meet your configured availability requirements (Announced, In Cinemas, Released, etc.).</p>
176254

255+
<h2 id="release-date-troubleshooting">Release Date Troubleshooting</h2>
256+
257+
<h3>Movies with Missing Release Dates</h3>
258+
<p>If you have movies in your library with missing or invalid release dates, here are better solutions than enabling "Process No Release Dates":</p>
259+
260+
<h4>1. Refresh Movie Metadata</h4>
261+
<p>In Radarr, select the movie(s) and use "Refresh Metadata" to fetch updated information from metadata providers.</p>
262+
263+
<h4>2. Check Metadata Sources</h4>
264+
<p>Verify your metadata provider settings in Radarr Settings > Metadata. TMDb is generally the most reliable source.</p>
265+
266+
<h4>3. Manual Correction</h4>
267+
<p>For manually added movies, edit the movie details in Radarr and set a proper release date.</p>
268+
269+
<h4>4. Remove Invalid Entries</h4>
270+
<p>If movies consistently have metadata issues, consider removing them and re-adding from a more reliable source.</p>
271+
272+
<h3>Understanding Release Date Types</h3>
273+
<p>While Huntarr now only uses the main "Release Date" field, understanding the different dates in Radarr can help you manage your library:</p>
274+
275+
<table>
276+
<tr>
277+
<th>Date Type</th>
278+
<th>Description</th>
279+
<th>Huntarr Usage</th>
280+
<th>Notes</th>
281+
</tr>
282+
<tr>
283+
<td>Release Date</td>
284+
<td>General release date for the movie</td>
285+
<td><strong>Used for filtering</strong></td>
286+
<td>Primary field that appears in movie lists</td>
287+
</tr>
288+
<tr>
289+
<td>In Cinemas</td>
290+
<td>Theatrical release date</td>
291+
<td>Not used</td>
292+
<td>Often earlier than home video release</td>
293+
</tr>
294+
<tr>
295+
<td>Physical Release</td>
296+
<td>DVD/Blu-ray release date</td>
297+
<td>Not used</td>
298+
<td>May be months after theatrical release</td>
299+
</tr>
300+
<tr>
301+
<td>Digital Release</td>
302+
<td>VOD/streaming platform release</td>
303+
<td>Not used</td>
304+
<td>Usually between cinema and physical</td>
305+
</tr>
306+
</table>
307+
308+
<div class="alert alert-info">
309+
<strong>💡 Pro Tip:</strong> If you need more granular control over release dates, consider using multiple Radarr instances with different configurations rather than relying on complex filtering rules.
310+
</div>
311+
177312
<h2 id="troubleshooting">Troubleshooting</h2>
178313

179314
<h3>Common Issues</h3>
@@ -194,9 +329,30 @@ <h4>No Missing Movies Found</h4>
194329
<li>Ensure "Monitored Only" is configured correctly for your needs</li>
195330
<li>Check that movies are marked as "Monitored" in Radarr</li>
196331
<li>Verify "Skip Future Movies" isn't preventing searches for available content</li>
332+
<li>Check if "Process No Release Dates" needs to be enabled for movies with missing metadata</li>
197333
<li>Review your minimum availability settings in both Radarr and Huntarr</li>
198334
</ul>
199335

336+
<h4>Movies Being Skipped Unexpectedly</h4>
337+
<p>If movies you expect to be processed are being skipped:</p>
338+
<ul>
339+
<li>Check the Huntarr logs for specific skip reasons (future release, no release date, etc.)</li>
340+
<li>Verify the Release Date field is properly populated in Radarr for those movies</li>
341+
<li>Ensure the Release Date is in the past if "Skip Future Movies" is enabled</li>
342+
<li>For movies with missing release dates, consider enabling "Process No Release Dates" temporarily</li>
343+
<li>Use Radarr's "Refresh Metadata" to update movie information</li>
344+
</ul>
345+
346+
<h4>Poor Quality Downloads</h4>
347+
<p>If you're getting low quality releases (cam rips, theater recordings):</p>
348+
<ul>
349+
<li>Enable "Skip Future Movies" - this prevents processing movies still in theaters</li>
350+
<li>Disable "Process No Release Dates" - movies without dates often have quality issues</li>
351+
<li>Review your Radarr quality profiles and cutoff settings</li>
352+
<li>Check that your indexers support the quality levels you want</li>
353+
<li>Consider waiting longer after release dates before enabling searches</li>
354+
</ul>
355+
200356
<h4>Large File Downloads</h4>
201357
<p>If movie downloads are overwhelming your system:</p>
202358
<ul>

‎frontend/static/js/settings_forms.js‎

Lines changed: 14 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -323,21 +323,20 @@ const SettingsForms = {
323323
<p class="setting-help">Only search for monitored items</p>
324324
</div>
325325
<div class="setting-item">
326-
<label for="radarr_skip_future_releases"><a href="https://huntarr.io" class="info-icon" title="Learn more about skipping future releases" target="_blank" rel="noopener"><i class="fas fa-info-circle"></i></a>Skip Future Releases:</label>
326+
<label for="radarr_skip_future_releases"><a href="https://plexguide.github.io/Huntarr.io/apps/radarr.html#skip-future-movies" class="info-icon" title="Learn more about skipping future releases" target="_blank" rel="noopener"><i class="fas fa-info-circle"></i></a>Skip Future Releases:</label>
327327
<label class="toggle-switch" style="width:40px; height:20px; display:inline-block; position:relative;">
328328
<input type="checkbox" id="radarr_skip_future_releases" ${settings.skip_future_releases !== false ? 'checked' : ''}>
329329
<span class="toggle-slider" style="position:absolute; cursor:pointer; top:0; left:0; right:0; bottom:0; background-color:#3d4353; border-radius:20px; transition:0.4s;"></span>
330330
</label>
331-
<p class="setting-help">Skip searching for movies with future release dates</p>
332-
</div>
333-
<div class="setting-item" id="future_release_type_container" style="${settings.skip_future_releases !== false ? '' : 'display: none;'}">
334-
<label for="radarr_release_type"><a href="https://huntarr.io/threads/radarr-release-type.24/" class="info-icon" title="Learn more about release type options" target="_blank" rel="noopener"><i class="fas fa-info-circle"></i></a>Release Type for Future Status:</label>
335-
<select id="radarr_release_type">
336-
<option value="digital" ${settings.release_type === 'digital' ? 'selected' : ''}>Digital Release</option>
337-
<option value="physical" ${settings.release_type === 'physical' || !settings.release_type ? 'selected' : ''}>Physical Release</option>
338-
<option value="cinema" ${settings.release_type === 'cinema' ? 'selected' : ''}>Cinema Release</option>
339-
</select>
340-
<p class="setting-help">Select which release date type to use when determining if a movie is considered a future release</p>
331+
<p class="setting-help">Skip searching for movies with future release dates (uses Release Date field)</p>
332+
</div>
333+
<div class="setting-item" id="process_no_release_dates_container" style="${settings.skip_future_releases !== false ? '' : 'display: none;'}">
334+
<label for="radarr_process_no_release_dates"><a href="https://plexguide.github.io/Huntarr.io/apps/radarr.html#process-no-release-dates" class="info-icon" title="Learn more about processing movies with no release dates" target="_blank" rel="noopener"><i class="fas fa-info-circle"></i></a>Process No Release Dates:</label>
335+
<label class="toggle-switch" style="width:40px; height:20px; display:inline-block; position:relative;">
336+
<input type="checkbox" id="radarr_process_no_release_dates" ${settings.process_no_release_dates === true ? 'checked' : ''}>
337+
<span class="toggle-slider" style="position:absolute; cursor:pointer; top:0; left:0; right:0; bottom:0; background-color:#3d4353; border-radius:20px; transition:0.4s;"></span>
338+
</label>
339+
<p class="setting-help" style="color: #ff6b35; font-weight: bold;">⚠️ WARNING: Rare case. Process movies with missing release date information - may result in unknown/poor quality downloads</p>
341340
</div>
342341
<div class="setting-item">
343342
<label for="radarr_tag_processed_items"><a href="https://github.com/plexguide/Huntarr.io/issues/382" class="info-icon" title="Learn more about tagging processed items" target="_blank" rel="noopener"><i class="fas fa-info-circle"></i></a>Tag Processed Items:</label>
@@ -358,14 +357,14 @@ const SettingsForms = {
358357

359358
// Set up event listeners for the skip_future_releases checkbox
360359
const skipFutureCheckbox = container.querySelector('#radarr_skip_future_releases');
361-
const releaseTypeContainer = container.querySelector('#future_release_type_container');
360+
const noReleaseDatesContainer = container.querySelector('#process_no_release_dates_container');
362361

363362
if (skipFutureCheckbox) {
364363
skipFutureCheckbox.addEventListener('change', function() {
365364
if (this.checked) {
366-
releaseTypeContainer.style.display = '';
365+
noReleaseDatesContainer.style.display = '';
367366
} else {
368-
releaseTypeContainer.style.display = 'none';
367+
noReleaseDatesContainer.style.display = 'none';
369368
}
370369
});
371370
}
@@ -1826,9 +1825,8 @@ const SettingsForms = {
18261825
settings.hourly_cap = getInputValue('#radarr_hourly_cap', 20);
18271826
settings.monitored_only = getInputValue('#radarr_monitored_only', true);
18281827
settings.skip_future_releases = getInputValue('#radarr_skip_future_releases', true);
1828+
settings.process_no_release_dates = getInputValue('#radarr_process_no_release_dates', false);
18291829
settings.tag_processed_items = getInputValue('#radarr_tag_processed_items', true);
1830-
1831-
settings.release_type = getInputValue('#radarr_release_type', 'physical');
18321830
}
18331831
else if (appType === 'lidarr') {
18341832
settings.hunt_missing_items = getInputValue('#lidarr_hunt_missing_items', 1);

0 commit comments

Comments
 (0)