137 lines
4.3 KiB
Markdown
137 lines
4.3 KiB
Markdown
# NFOGuard Release Date Priority System - Testing Guide
|
|
|
|
## 🧪 Test Your Configured Priority System
|
|
|
|
### 1. **Test "The Craft (1996)" - Theatrical Fallback**
|
|
```bash
|
|
# Test step-by-step TMDB lookup
|
|
curl "http://localhost:8080/debug/tmdb/tt0115963"
|
|
|
|
# Expected: digital=0, physical=multiple, theatrical=1996-05-03
|
|
# Should show: no digital releases, DVD from 2000, theatrical from 1996
|
|
|
|
# Test priority logic
|
|
curl "http://localhost:8080/debug/movie/tt0115963/priority"
|
|
|
|
# Expected result with your config (digital,physical,theatrical):
|
|
# - digital: not available
|
|
# - physical: 2000-09-12 (too late - DVD release)
|
|
# - theatrical: 1996-05-03 ← SELECTED (best option)
|
|
```
|
|
|
|
### 2. **Test Modern Movie - Digital Priority**
|
|
```bash
|
|
# Test a recent movie like Top Gun Maverick
|
|
curl "http://localhost:8080/debug/tmdb/tt1745960"
|
|
|
|
# Expected: digital, physical, and theatrical dates all available
|
|
# Should show your priority order preference
|
|
|
|
curl "http://localhost:8080/debug/movie/tt1745960/priority"
|
|
|
|
# Expected with your config (digital,physical,theatrical):
|
|
# - digital: 2022-08-23 ← SELECTED (first in priority)
|
|
# - physical: 2022-10-31 (skipped)
|
|
# - theatrical: 2022-05-27 (skipped)
|
|
```
|
|
|
|
### 3. **Test Different Priority Orders**
|
|
|
|
**Your Current Config**: `RELEASE_DATE_PRIORITY=digital,physical,theatrical`
|
|
```bash
|
|
curl "http://localhost:8080/debug/movie/tt1745960/priority"
|
|
# Should select: digital date
|
|
```
|
|
|
|
**Alternative Config** (edit .env temporarily): `RELEASE_DATE_PRIORITY=theatrical,digital,physical`
|
|
```bash
|
|
# Restart container after changing .env
|
|
docker-compose restart
|
|
|
|
curl "http://localhost:8080/debug/movie/tt1745960/priority"
|
|
# Should now select: theatrical date (earliest option)
|
|
```
|
|
|
|
### 4. **Test File Date Fallback Logic**
|
|
|
|
**Movies with manual imports** (showing `radarr:db.file.dateAdded`):
|
|
```bash
|
|
curl "http://localhost:8080/debug/movie/tt0115963/priority"
|
|
|
|
# Expected response:
|
|
# {
|
|
# "release_date_priority": ["digital", "physical", "theatrical"],
|
|
# "date_sources": {
|
|
# "radarr_import": {"date": "2025-08-29...", "source": "radarr:db.file.dateAdded"},
|
|
# "digital_release": {"date": "1996-05-03...", "source": "tmdb:theatrical"}
|
|
# },
|
|
# "file_date_detected": true,
|
|
# "would_prefer_digital": true,
|
|
# "selected_date": "1996-05-03T00:00:00+00:00",
|
|
# "selected_source": "tmdb:theatrical (preferred over file date)"
|
|
# }
|
|
```
|
|
|
|
### 5. **Verify NFO Source Annotations**
|
|
|
|
After processing a movie:
|
|
```bash
|
|
# Process the movie
|
|
curl -X POST "http://localhost:8080/manual/scan?scan_type=movies"
|
|
|
|
# Check the created NFO file
|
|
cat "/media/Movies/movies/The Craft (1996) [imdb-tt0115963]/movie.nfo"
|
|
|
|
# Should contain at the end:
|
|
# <!-- source: Movie; tmdb:theatrical -->
|
|
# <!-- managed by NFOGuard -->
|
|
```
|
|
|
|
## 🎯 Expected Behavior by Movie Type
|
|
|
|
### **Pre-Digital Era Movies (1990s-early 2000s)**
|
|
- **Digital**: ❌ Not available
|
|
- **Physical**: ⚠️ Often years later (DVD era)
|
|
- **Theatrical**: ✅ **Most accurate** (selected)
|
|
- **Example**: The Craft, Titanic, The Matrix
|
|
|
|
### **Transition Era Movies (2000s-2010s)**
|
|
- **Digital**: ⚠️ Limited early VOD
|
|
- **Physical**: ✅ **Often most relevant** (DVD/Blu-ray boom)
|
|
- **Theatrical**: ✅ Available
|
|
- **Example**: Dark Knight, Avatar, Iron Man
|
|
|
|
### **Modern Movies (2010s+)**
|
|
- **Digital**: ✅ **Most relevant** (streaming era)
|
|
- **Physical**: ✅ Available but later
|
|
- **Theatrical**: ✅ Available
|
|
- **Example**: Top Gun Maverick, Avengers, Everything Everywhere
|
|
|
|
## 🔧 Troubleshooting Priority System
|
|
|
|
### No Release Dates Found
|
|
```bash
|
|
curl "http://localhost:8080/debug/tmdb/tt0123456"
|
|
# Check if movie exists in TMDB and what release data is available
|
|
```
|
|
|
|
### Unexpected Date Selection
|
|
```bash
|
|
curl "http://localhost:8080/debug/movie/tt0123456/priority"
|
|
# Shows exactly which dates were found and why one was selected
|
|
```
|
|
|
|
### Priority Order Not Working
|
|
1. Check your `.env` configuration
|
|
2. Restart container: `docker-compose restart`
|
|
3. Verify with debug endpoint: shows `"release_date_priority"` array
|
|
|
|
## 🎉 Success Indicators
|
|
|
|
- ✅ Old movies use theatrical dates instead of file dates
|
|
- ✅ New movies use digital dates per your preference
|
|
- ✅ NFO files show source in comments
|
|
- ✅ Priority order is respected and configurable
|
|
- ✅ Smart fallbacks prevent unrealistic dates
|
|
|
|
Your NFOGuard now has **intelligent, configurable date selection** that adapts to each movie's era and available release data! 🎯 |