Tdarr Next Library Rollout Plan

Updated: 2026-06-11

Anime is intentionally reserved as the final target because it commonly has multiple audio tracks, forced/signs subtitles, ASS/SSA subtitles, and more stream-preservation risk than regular Movies/TV.

Current Status

Already enabled/processed:

• VHNIC Kids TV
• VHNIC Kids Movies
• VHNIC Movies
• VHNIC TV Shows was added on 2026-05-26 and completed the main rollout.
• VHNIC Reality was added on 2026-06-07 and completed the main rollout on

2026-06-10. A Reality-only legacy AVI repair profile was added after 20

Survivor AVI files failed health checks.

• A 2026-06-11 progress snapshot shows a remaining finish-out queue of 112

with 98 active jobs, 0 transcode errors, and stable DB load. Recapture

after this drains before any Anime work.

Current preferred gaming-safe worker posture:

• Transcode GPU: low, usually 1 or 0 while gaming.
• Health Check GPU: low/moderate depending on responsiveness.

Remaining Candidate Libraries

Recommended Order

1. Main rollout is complete for Kids TV, Kids Movies, Movies, TV Shows, and

Reality.

2. Leave Personal completely untouched.

3. Let the 2026-06-11 finish-out queue drain, then capture Tdarr progress and

health before changing anything.

4. Treat Anime as an optional, separate pilot with a custom anime-safe

profile. Do not add it as a normal cloned TV/Movie rollout.

5. Handle any remaining non-HEVC legacy files surgically, not by adding another

broad library target.

2026-06-10 Completion Snapshot

Latest verification:

synology/docker/tdarr/progress/20260610-151023/tdarr-progress.txt

Snapshot highlights:

• Total files tracked: 28,065
• Total transcodes: 19,945
• Space saved: 9,394.1 GB
• Transcode queue: 0
• Transcode errors: 0
• DB load status: Stable
• transcode_success_or_not_required: 28,063
• Follow-up UI review showed visible Tdarr queues/errors at zero; the two

staged processing rows in the raw capture were transient server-side

bookkeeping, not actionable work items.

2026-06-11 Finish-Out Snapshot

Latest local evidence:

synology/docker/tdarr/progress/20260611-143608/tdarr-progress.txt

Snapshot highlights:

• Active jobs: 98
• Transcode queue: 112
• Transcode errors: 0
• DB load status: Stable
• Total files tracked: 28,154
• Total transcodes: 20,075
• Space saved: 9,529.2 GB

Interpretation: this is a remaining finish-out queue after the broad rollout,

not a reason to add a new library. After it finishes, run

Capture-TdarrProgress.ps1 and Capture-TdarrHealthFailures.ps1, then decide

whether any residual legacy files need surgical handling.

TV Shows Rollout Status

VHNIC TV Shows was added directly to the Tdarr database on 2026-05-26.

Library settings:

• Library ID: tvShows01
• Folder: /media/media/tv shows
• Transcodes: enabled
• Health checks: enabled
• Source settings: cloned from the working VHNIC Movies library.

Safety notes:

• A Tdarr SQLite database backup was created before the edit:

/volume2/VM Storage/docker/tdarr/server/Tdarr/DB2/SQL/database.db.codex-backup-add-tvshows-20260526-214500

• An authenticated scan was triggered through Tdarr's local API.
• Early verification showed the tvShows01 scan actively indexing, increasing

from 677 to 3,295 files during follow-up checks. The count is expected to

keep rising while scanning continues.

• Adding the library does not directly modify media files, but Tdarr workers may

begin health checks and transcodes according to the active worker settings.

Reality Rollout Plan

Reality was added on 2026-06-07 because the user wanted it queued while the TV

cleanup was finishing.

Suggested initial settings:

• Start with health checks first if desired:
• Transcode GPU: 0
• Health Check GPU: 1-2
• After health-check pass:
• Transcode GPU: 1
• Health Check GPU: 1
• Increase only if NAS, RDP, gaming, and Plex remain responsive.

Current worker posture at add time:

• VHNIC-Desktop: 0 transcode GPU, 0 transcode CPU, 0 health GPU,

0 health CPU.

• Synology-Healthcheck: also observed at 0/0/0/0 at the time of the

Reality add.

The desktop node was successfully started and registered. Worker counts are

controlled manually by the user from Tdarr depending on whether the desktop is

being used for gaming or other work.

2026-06-07 Reality Legacy AVI Repair

Twenty current health-check failures were captured in:

synology/docker/tdarr/health/20260607-232602/tdarr-health-failures.txt

All current failures were old Survivor AVI files in VHNIC Reality, using

msmpeg4v3 or mpeg4 video and MP3 audio. FFprobe/FFmpeg showed malformed MP3

headers, but short controlled repairs to HEVC MP4 with AAC audio succeeded.

Applied changes:

• tools/synology/Tdarr_Plugin_VHNIC_Safe_NVENC_HEVC_Fallback.js updated to

plugin version 1.3.

• The plugin now accepts h264, mpeg4, msmpeg4v2, and msmpeg4v3.
• synology/docker/tdarr/Set-TdarrRealityLegacyRepairProfile.ps1 deploys the

plugin and updates only reality01.

• reality01 codec filter is now h264,mpeg4,msmpeg4v2,msmpeg4v3.
• reality01 fallback output is mp4 with aac audio.
• Tdarr database backup before the profile change:

/volume2/VM Storage/docker/tdarr/server/Tdarr/DB2/SQL/database.db.codex-before-reality-legacy-repair-20260607-233436

• Requeued current failures through Tdarr API using:

synology/docker/tdarr/health/20260607-232602/current-reality-legacy-failures.tsv

Follow-up capture:

synology/docker/tdarr/health/20260607-233715/tdarr-health-failures.txt

The live current-failure table was empty after requeue. Historical error rows

remain visible in recent job history and should not be treated as active unless

a newer current_file_failure_details section contains rows.

TV Shows Rollout Plan

TV Shows is too large to treat casually even though it has now been added:

• 22T total
• 17,564 video files
• likely the biggest space opportunity
• also the most likely to produce many edge cases

Preferred approach from this point forward:

• Keep worker concurrency conservative while Movies and TV Shows overlap.
• Use health-first behavior where possible before accepting broad transcodes.
• Watch Plex responsiveness, Synology disk pressure, and Tdarr error counts.
• Expect many legacy AVI files to become replacement candidates rather than

transcode candidates.

Personal Library

Hard rule: do not run Tdarr, cleanup scripts, replacement workflows, or bulk automation against the Personal library.

Reason: this library contains the last remaining videos of several relatives who are no longer living. Preservation matters more than storage savings.

Allowed actions:

• Read-only inventory if explicitly requested.
• Backup planning if explicitly requested.

Disallowed actions:

• Transcoding.
• Replacing.
• Deleting.
• Moving.
• Renaming.
• Cleanup.
• Any automated modification workflow.

Anime Library

Anime should use a separate profile:

• Preserve English dub audio.
• Current user preference is to keep English audio when multiple audio tracks

exist; non-English audio does not need to be preserved by default.

• Preserve forced/signs/songs subtitles.
• Avoid dropping subtitle streams.
• Skip HEVC unless there is a compatibility reason.
• Test on Apple TV/iPad before auto-accept.

Preparation inventory was captured in:

synology/docker/tdarr/anime-inventory/20260609-223132/

Dedicated plan:

synology/docker/tdarr/ANIME_PROFILE_PLAN.md

Key findings:

• Files probed: 5,979
• Multi-audio files: 3,800
• H.264 opportunity: 2,780 files / 3,034.3 GiB
• Already HEVC: 2,942 files / 1,530.8 GiB
• ASS/SSA subtitle files: 3,651
• Files with attachments/fonts: 2,666
• Files without tagged English audio: 510; many may simply have unlabeled

audio and should be sampled before any automatic pruning.

Library	Approx size	Video files	Extension mix	Recommendation
Reality	4.1T observed at filesystem level	2,574 observed videos	mixed TV/reality files	Completed main rollout on 2026-06-10. Current queue is zero; remaining non-HEVC legacy/AV1 files are not broad rollout targets.
TV Shows	22T	17,564	14,488 MKV, 1,469 MP4, 1,367 AVI, 240 M4V	Completed main rollout before Reality completion. Remaining non-HEVC legacy files should be handled surgically only.
Personal	64G	27	27 MP4	Off-limits. Do not run Tdarr, cleanup, replacement, or automation against this library.
Plex Dance	0	0	None	Ignore.
Anime	4.55 TiB observed by stream inventory	5,980 observed videos	Multi-audio/subtitle risk	Prep inventory captured 2026-06-09. Last target, custom profile only.