Path Recommendation for TRaSH Guides Users

[tanakrit-d]

Thought I'd drop a note regarding the path setup for individuals who follow the TRaSH Guides setup.

I was having some difficulty identifying why the runs would always fail after getting the webhook call from Sonarr and Radarr.
Initially I thought it was because they were renaming the files after sending the webhook, which resulted it not being found by the time Plex Generate Vid Previews got its hands on it.

The TRaSH guide recommends you follow their standardised path mapping, but what is easy to overlook (if you're a moron like me) is that Plex binds to /data/media, but Sonarr/Radarr are bound to /data as they require access to your download folders (such as /data/usenet or /data/downloads).

The config for Plex Generate Vid Previews is:

Path in Plex	Path in this app	Path from Sonarr/Radarr
/media	/media	/data/media

In hindsight I feel stupid I overlooked this, but for anyone like me - I hope this helps!

[stevezau]

Thanks for posting. When you hit this issue, is there something i can add in the ui to make it more obvious ?

[tanakrit-d]

I think I was a little confused because the path it can't locate is valid, just not from the perspective of the app.

Perhaps some logic that the app can fallback to in order to test and generate the error message given the path is not found.
I'm thinking maybe progressive path stripping (/data/media/tv/... becomes /media/tv/...) up to 1 - 2 times.

This only really accounts for the scenario based on my personal issue however - there may be a better way to achieve this without being too expensive computationally.

Or even a simple base/root path check may be better:

Expected base path: /media | Received base path: /data/media

Anywho, here was how the issue appeared in my logs:

{"ts": "2026-03-28 00:21:01.688", "level": "INFO", "msg": "Querying Plex by file path...", "mod": "plex_client", "func": "get_media_items_by_paths", "line": 806}
{"ts": "2026-03-28 00:21:01.820", "level": "INFO", "msg": "Resolving 1 webhook file(s):", "mod": "plex_client", "func": "get_media_items_by_paths", "line": 852}
{"ts": "2026-03-28 00:21:01.821", "level": "WARNING", "msg": "  [1/1] /data/media/tv/For All Mankind (2019)/Season 05/For All Mankind (2019) - S05E01 - First Light [WEBDL-1080p][EAC3 Atmos 5.1][h264].mkv", "mod": "plex_client", "func": "get_media_items_by_paths", "line": 955}
{"ts": "2026-03-28 00:21:01.821", "level": "WARNING", "msg": "        Direct path not found in Plex", "mod": "plex_client", "func": "get_media_items_by_paths", "line": 956}
{"ts": "2026-03-28 00:21:01.821", "level": "WARNING", "msg": "        Result: not found", "mod": "plex_client", "func": "get_media_items_by_paths", "line": 968}
{"ts": "2026-03-28 00:21:01.821", "level": "INFO", "msg": "Resolution summary: 1 file(s) \u2014 resolved=0, skipped=0, not found=1", "mod": "plex_client", "func": "get_media_items_by_paths", "line": 997}
{"ts": "2026-03-28 00:21:01.821", "level": "WARNING", "msg": "  Unresolved: '/data/media/tv/For All Mankind (2019)/Season 05/For All Mankind (2019) - S05E01 - First Light [WEBDL-1080p][EAC3 Atmos 5.1][h264].mkv'", "mod": "plex_client", "func": "get_media_items_by_paths", "line": 1024}
{"ts": "2026-03-28 00:21:01.821", "level": "INFO", "msg": "If this app, Plex, or Sonarr/Radarr use different paths for the same files, configure Path mapping in Settings.", "mod": "plex_client", "func": "get_media_items_by_paths", "line": 1025}
{"ts": "2026-03-28 00:21:01.822", "level": "INFO", "msg": "Resolved 0 webhook path(s) into 0 Plex item(s)", "mod": "plex_client", "func": "get_media_items_by_paths", "line": 1035}

[stevezau]

I pushed some changes which should make this more obv in the future. Thanks!