Releases · trakt-tools/universal-trakt-scrobbler

04 Mar 11:41

eab0791

Beta (2026-03-04T11:41:04.636Z) Pre-release

Pre-release

Improve episode matching and error handling for Crunchyroll (#459)

* Add isAbsolute field to EpisodeItem model

Add optional isAbsolute boolean field to EpisodeItemValues interface and EpisodeItem class to support tracking episodes that use absolute numbering (e.g., anime episodes numbered sequentially across all seasons rather than per-season).

* Add Cloudflare rate limiting detection and handling

Detect Cloudflare error pages (particularly Error 1015 for rate limiting) in HTML responses and automatically retry requests after an appropriate delay. This improves resilience when the extension encounters Cloudflare protection on streaming services or APIs.

* Add TMDB search methods for TV shows and episodes

Add searchTvShow() method to search for TV shows by title with optional year filtering and special anime prioritization for Crunchyroll. Add findEpisodeByTitle() method to locate episodes within a show by matching episode titles. These methods provide fallback mechanisms for episode matching when primary lookups fail.

* Improve episode search with absolute numbering and TMDB fallback

Refactor findEpisode() to handle absolute episode numbering by:
- Resolving absolute episode numbers to season/episode pairs using Trakt season data
- Detecting when provided season/episode info is relative vs absolute
- Handling edge cases for new seasons not yet in Trakt

Add TMDB fallback for episode matching when Trakt lookup fails:
- Search for show on TMDB using title and year
- Find episode by title within the show
- Use TMDB-provided season/episode numbers for Trakt lookup

Extract logic into private helper methods for improved maintainability.

* Enhance Crunchyroll history parsing for movies and episodes

Improve convertHistoryItems() to distinguish between movies and episodes:
- Detect movies by checking season_title, panel.title, or episode_number fields
- Create MovieItem instances for detected movies
- Use sequence_number as fallback when episode_number is unavailable
- Mark episodes with isAbsolute flag for proper absolute numbering handling
- Strip language suffix (Dub/Sub) from titles for better matching
- Add updateItemFromHistory() stub method (no additional data needed)

Add new optional fields to CrunchyrollHistoryItem interface to support detection.

* Update README: Remove Crunchyroll movie detection limitation

Remove 'Can't identify movies as movies' limitation from Crunchyroll service as this is now fixed by the movie detection logic.

* Improve Crunchyroll episode matching and error handling

Assets 4