v0.9.9 - Bug Fixes & Stability Improvements

v0.9.9 - July 05, 2026

What's New / Bug Fixes: ✨

• Robust trailer file matching in the files-scan task — Renaming or moving a trailer file (on disk, or via the Rename action in Media Details → Files) is now detected by content hash and updates the existing download record in place, instead of being treated as "deleted + new" and losing its history. Similarly, if a trailer's content changes in place (e.g. re-encoded or edited outside the app) while keeping the same filename, the hash mismatch is detected and the file's metadata (size, resolution, codecs, duration) is automatically refreshed. Two new event types, Trailer Renamed and Trailer Modified, show up in the Events log for these changes.

• Files-scan no longer mislabels trailers as missing when a network drive disconnects — Media stored on a network share (SMB/NFS) that temporarily drops offline could previously have all of its trailers incorrectly marked as missing, since a disconnected drive can look identical to genuinely deleted files. The scan now checks whether the underlying storage is actually reachable before concluding trailers are missing, and skips the scan for that media (logging a clear error) instead of destructively updating it — it will simply retry on the next scheduled run.

• Downloads are now linked to the Trailer Profile that owns them — Trailers found on disk (downloaded outside Trailarr, or downloaded before profile tracking existed) were previously recorded without a profile. A new one-time Attribute Trailer Downloads task runs shortly after startup and links each such download to the matching profile: it checks which of your profiles apply to that media item (by the profile's filters, ignoring state conditions like trailer_exists) and assigns them in priority order. The files-scan task does the same for any new trailer files it finds going forward. This is groundwork for upcoming releases where downloads — not the trailer_exists flag — will determine which profiles still need a trailer for each media item.

• Manually assign a profile to a download — Downloads that couldn't be linked to a profile automatically show their profile as Unknown in Media Details → Downloads. That label is now a dropdown: click it and pick the profile that should own the download. The assignment is recorded as a new Download Attributed event in the Events log.

• Find downloads that need a profile — When any downloads are left without a profile, the media pages show a banner ("N media items have downloads with no profile assigned") with a Review button, and a new Unknown Profile quick filter appears in the filter dropdown. Both disappear automatically once everything is assigned. The attribution log also states why each download couldn't be linked: either no profile's filters match that media (adjust your filters), or all matching profiles already own a download for it (likely an extra/duplicate trailer file — assign it to another profile or delete the file).

• Stale "missing" statuses from pre-Trailarr trailers now heal on one restart — Libraries that had trailers on disk before Trailarr was installed could show those items as Missing forever: their download records had no profile, which made them invisible to the trailer-flag repair job. The repair now runs immediately after profile attribution in the same startup pass, so one upgrade/restart corrects both the profile links and the stale trailer_exists/status flags. The repair also now covers media that is still monitored — together with the network-drive scan fix above, this breaks the endless trailer re-download loop reported for Arr-monitored media on network storage (#591): stuck items are corrected at startup instead of being re-downloaded yet again.

  ℹ️ No action needed — the attribution task runs automatically, changes no files on disk, and doesn't trigger any downloads. You may see a log line per linked download the first time it runs. If a download can't be matched to any profile, it's left as Unknown — use the banner/quick filter to find it and assign a profile from Media Details, or it will be linked automatically later if a matching profile is added.

  ⚠️ Check your logs after upgrading if you manage a large or older library: the task also reports a warning like N media item(s) with trailer_exists=True have no tracked download record. This means those trailers haven't been picked up by the files scan yet — the count should drop to zero after the next Scan All Media Folders run completes. If the warning persists across scans, those media folders may be unreachable (e.g. a disconnected network drive), which is worth resolving before future updates that rely on download records.

Other Changes: ⚡

• Updated frontend to Angular v22.
• Updated relevant docs pages to reflect new changes and features.
• Included a new Roadmap to v1.0.0 page in the docs under References, summarizing the 9-phase plan to reach v1.0.0 and what each phase entails.