stupid timezones

README.md

@@ -328,7 +328,8 @@ Allstarr can automatically fill your Spotify playlists (like Release Radar and D
 # Enable the feature
 SPOTIFY_IMPORT_ENABLED=true
 
-# Match your Spotify Import plugin schedule (e.g., 4:15 PM daily)
+# Sync window settings (optional - used to prevent fetching too frequently)
+# The fetcher searches backwards from current time for the last 48 hours
 SPOTIFY_IMPORT_SYNC_START_HOUR=16
 SPOTIFY_IMPORT_SYNC_START_MINUTE=15
 SPOTIFY_IMPORT_SYNC_WINDOW_HOURS=2
@@ -350,8 +351,11 @@ SPOTIFY_IMPORT_PLAYLIST_NAMES=Release Radar,Discover Weekly
 
 2. **Allstarr Fetches Missing Tracks** (within sync window)
    - Searches for missing tracks files from the Jellyfin plugin
+   - Searches **+24 hours forward first** (newest files), then **-48 hours backward** if not found
+   - This efficiently finds the most recent file regardless of timezone differences
+   - Example: Server time 12 PM EST, file timestamped 9 PM UTC (same day) → Found in forward search
    - Caches the list of missing tracks in Redis + file cache
-   - Runs automatically on startup and every 5 minutes during the sync window
+   - Runs automatically on startup (if needed) and every 5 minutes during the sync window
 
 3. **Allstarr Matches Tracks** (2 minutes after startup, then every 30 minutes)
    - For each missing track, searches your streaming provider (SquidWTF, Deezer, or Qobuz)
@@ -387,10 +391,24 @@ curl "https://your-jellyfin-proxy.com/spotify/clear-cache?api_key=YOUR_API_KEY"
 #### Startup Behavior
 
 When Allstarr starts with Spotify Import enabled:
-- **T+0s**: Fetches missing tracks from Jellyfin plugin (if configured)
+
+**Smart Cache Check:**
+- Checks if today's sync window has passed (e.g., if sync is at 4 PM + 2 hour window = 6 PM)
+- If before 6 PM and yesterday's cache exists → **Skips fetch** (cache is still current)
+- If after 6 PM or no cache exists → **Fetches missing tracks** from Jellyfin plugin
+
+**Track Matching:**
 - **T+2min**: Matches tracks with streaming provider (with rate limiting)
+- Only matches playlists that don't already have cached matches
 - **Result**: Playlists load instantly when you open them!
 
+**Example Timeline:**
+- Plugin runs daily at 4:15 PM, creates files at ~4:16 PM
+- You restart Allstarr at 12:00 PM (noon) the next day
+- Startup check: "Today's sync window ends at 6 PM, and I have yesterday's 4:16 PM file"
+- **Decision**: Skip fetch, use existing cache
+- At 6:01 PM: Next scheduled check will search for new files
+
 #### Troubleshooting
 
 **Playlists are empty:**