digital release logic

README.md

@@ -165,7 +165,74 @@ curl "http://localhost:8080/debug/movie/tt1674782/priority"
 }
 ```
 
-📖 Example Workflow
+## 🐛 Troubleshooting
+
+### Manual Imports Show File Dates Instead of Digital Releases
+
+**Problem**: Movies manually imported show recent file dates like `2025-08-29T12:14:28+00:00`
+
+**Solution**:
+1. Enable TMDB integration:
+   ```bash
+   # Add to your .env file
+   TMDB_API_KEY=your_tmdb_api_key
+   PREFER_DIGITAL_OVER_FILE_DATES=true
+   ```
+
+2. Test the priority logic:
+   ```bash
+   curl "http://localhost:8080/debug/movie/tt0115963/priority"
+   ```
+
+3. Should show digital date selection when reasonable
+
+### "0 Movies Processed" During Manual Scan
+
+**Problem**: Manual scan reports processing 0 movies
+
+**Solution**:
+1. Test directory scanning:
+   ```bash
+   curl -X POST "http://localhost:8080/test/movie-scan"
+   ```
+
+2. Verify paths in your `.env` file match your actual structure:
+   ```bash
+   # Your structure: /media/Movies/movies/
+   MOVIE_PATHS=/media/Movies/movies,/media/Movies/movies6
+   ```
+
+3. Ensure movie directories have IMDb tags:
+   ```
+   Movie Name [imdb-tt1234567] (2023)/
+   ```
+
+### Database Connection Issues
+
+**Problem**: "Radarr database connection failed"
+
+**Solution**:
+1. Test database connectivity:
+   ```bash
+   curl -X POST "http://localhost:8080/test/bulk-update"
+   ```
+
+2. Verify database credentials in `.env`:
+   ```bash
+   RADARR_DB_HOST=radarr-postgres
+   RADARR_DB_PASSWORD=your_actual_password
+   ```
+
+### Digital Dates Not Found
+
+**Problem**: `"external_apis": {"tmdb_enabled": false}`
+
+**Solution**:
+1. Add TMDB API key to `.env`
+2. Restart container: `docker-compose restart`
+3. Verify: `curl "http://localhost:8080/debug/movie/tt0115963/priority"`
+
+## 📖 Example Workflow
 You add The Blacklist in Sonarr.
 
 Sonarr downloads S01E01 → NFOGuard logs the import date in DB and .nfo.