< Summary - Jellyfin

Information
Class: MediaBrowser.Providers.Manager.MetadataService<T1, T2>
Assembly: MediaBrowser.Providers
File(s): /srv/git/jellyfin/MediaBrowser.Providers/Manager/MetadataService.cs
Line coverage
65%
Covered lines: 229
Uncovered lines: 119
Coverable lines: 348
Total lines: 1315
Line coverage: 65.8%
Branch coverage
64%
Covered branches: 236
Total branches: 366
Branch coverage: 64.4%
Method coverage

Feature is only available for sponsors

Upgrade to PRO version

Coverage history

Coverage history 0 25 50 75 100 10/13/2025 - 12:11:02 AM Line coverage: 67.9% (233/343) Branch coverage: 67.3% (237/352) Total lines: 128910/28/2025 - 12:11:27 AM Line coverage: 66.1% (227/343) Branch coverage: 66.1% (233/352) Total lines: 128911/4/2025 - 12:11:59 AM Line coverage: 66.1% (227/343) Branch coverage: 66.1% (233/352) Total lines: 129411/18/2025 - 12:11:25 AM Line coverage: 65.8% (229/348) Branch coverage: 64.4% (236/366) Total lines: 13101/19/2026 - 12:13:54 AM Line coverage: 65.8% (229/348) Branch coverage: 64.4% (236/366) Total lines: 1315 10/13/2025 - 12:11:02 AM Line coverage: 67.9% (233/343) Branch coverage: 67.3% (237/352) Total lines: 128910/28/2025 - 12:11:27 AM Line coverage: 66.1% (227/343) Branch coverage: 66.1% (233/352) Total lines: 128911/4/2025 - 12:11:59 AM Line coverage: 66.1% (227/343) Branch coverage: 66.1% (233/352) Total lines: 129411/18/2025 - 12:11:25 AM Line coverage: 65.8% (229/348) Branch coverage: 64.4% (236/366) Total lines: 13101/19/2026 - 12:13:54 AM Line coverage: 65.8% (229/348) Branch coverage: 64.4% (236/366) Total lines: 1315

Metrics

File(s)

/srv/git/jellyfin/MediaBrowser.Providers/Manager/MetadataService.cs

#LineLine coverage
 1#nullable disable
 2
 3#pragma warning disable CS1591
 4
 5using System;
 6using System.Collections.Generic;
 7using System.Linq;
 8using System.Net.Http;
 9using System.Threading;
 10using System.Threading.Tasks;
 11using Jellyfin.Extensions;
 12using MediaBrowser.Controller.Configuration;
 13using MediaBrowser.Controller.Entities;
 14using MediaBrowser.Controller.Entities.Audio;
 15using MediaBrowser.Controller.IO;
 16using MediaBrowser.Controller.Library;
 17using MediaBrowser.Controller.Persistence;
 18using MediaBrowser.Controller.Providers;
 19using MediaBrowser.Model.Configuration;
 20using MediaBrowser.Model.Entities;
 21using MediaBrowser.Model.IO;
 22using MediaBrowser.Model.Providers;
 23using Microsoft.Extensions.Logging;
 24
 25namespace MediaBrowser.Providers.Manager
 26{
 27    public abstract class MetadataService<TItemType, TIdType> : IMetadataService
 28        where TItemType : BaseItem, IHasLookupInfo<TIdType>, new()
 29        where TIdType : ItemLookupInfo, new()
 30    {
 31        protected MetadataService(
 32            IServerConfigurationManager serverConfigurationManager,
 33            ILogger<MetadataService<TItemType, TIdType>> logger,
 34            IProviderManager providerManager,
 35            IFileSystem fileSystem,
 36            ILibraryManager libraryManager,
 37            IExternalDataManager externalDataManager,
 38            IItemRepository itemRepository)
 39        {
 54640            ServerConfigurationManager = serverConfigurationManager;
 54641            Logger = logger;
 54642            ProviderManager = providerManager;
 54643            FileSystem = fileSystem;
 54644            LibraryManager = libraryManager;
 54645            ExternalDataManager = externalDataManager;
 54646            ItemRepository = itemRepository;
 54647            ImageProvider = new ItemImageProvider(Logger, ProviderManager, FileSystem);
 54648        }
 49
 50        protected ItemImageProvider ImageProvider { get; }
 51
 52        protected IServerConfigurationManager ServerConfigurationManager { get; }
 53
 54        protected ILogger<MetadataService<TItemType, TIdType>> Logger { get; }
 55
 56        protected IProviderManager ProviderManager { get; }
 57
 58        protected IFileSystem FileSystem { get; }
 59
 60        protected ILibraryManager LibraryManager { get; }
 61
 62        protected IExternalDataManager ExternalDataManager { get; }
 63
 64        protected IItemRepository ItemRepository { get; }
 65
 3566        protected virtual bool EnableUpdatingPremiereDateFromChildren => false;
 67
 3568        protected virtual bool EnableUpdatingGenresFromChildren => false;
 69
 3570        protected virtual bool EnableUpdatingStudiosFromChildren => false;
 71
 3572        protected virtual bool EnableUpdatingOfficialRatingFromChildren => false;
 73
 50474        public virtual int Order => 0;
 75
 76        private FileSystemMetadata TryGetFileSystemMetadata(string path, IDirectoryService directoryService)
 77        {
 78            try
 79            {
 3580                return directoryService.GetFileSystemEntry(path);
 81            }
 082            catch (Exception ex)
 83            {
 084                Logger.LogError(ex, "Error getting file {Path}", path);
 085                return null;
 86            }
 3587        }
 88
 89        public virtual async Task<ItemUpdateType> RefreshMetadata(BaseItem item, MetadataRefreshOptions refreshOptions, 
 90        {
 91            var itemOfType = (TItemType)item;
 92            var updateType = ItemUpdateType.None;
 93
 94            var libraryOptions = LibraryManager.GetLibraryOptions(item);
 95            var isFirstRefresh = item.DateLastRefreshed == DateTime.MinValue;
 96            var hasRefreshedMetadata = true;
 97            var hasRefreshedImages = true;
 98
 99            var requiresRefresh = libraryOptions.AutomaticRefreshIntervalDays > 0 && (DateTime.UtcNow - item.DateLastRef
 100
 101            if (!requiresRefresh && refreshOptions.MetadataRefreshMode != MetadataRefreshMode.None)
 102            {
 103                // TODO: If this returns true, should we instead just change metadata refresh mode to Full?
 104                requiresRefresh = item.RequiresRefresh();
 105
 106                if (requiresRefresh)
 107                {
 108                    Logger.LogDebug("Refreshing {Type} {Item} because item.RequiresRefresh() returned true", typeof(TIte
 109                }
 110            }
 111
 112            if (refreshOptions.RemoveOldMetadata && refreshOptions.ReplaceAllImages)
 113            {
 114                if (ImageProvider.RemoveImages(item))
 115                {
 116                    updateType |= ItemUpdateType.ImageUpdate;
 117                }
 118            }
 119
 120            var localImagesFailed = false;
 121            var allImageProviders = ProviderManager.GetImageProviders(item, refreshOptions).ToList();
 122
 123            // Only validate already registered images if we are replacing and saving locally
 124            if (item.IsSaveLocalMetadataEnabled() && refreshOptions.ReplaceAllImages)
 125            {
 126                item.ValidateImages();
 127            }
 128            else
 129            {
 130                // Run full image validation and register new local images
 131                try
 132                {
 133                    if (ImageProvider.ValidateImages(item, allImageProviders.OfType<ILocalImageProvider>(), refreshOptio
 134                    {
 135                        updateType |= ItemUpdateType.ImageUpdate;
 136                    }
 137                }
 138                catch (Exception ex)
 139                {
 140                    localImagesFailed = true;
 141                    Logger.LogError(ex, "Error validating images for {Item}", item.Path ?? item.Name ?? "Unknown name");
 142                }
 143            }
 144
 145            var metadataResult = new MetadataResult<TItemType>
 146            {
 147                Item = itemOfType
 148            };
 149
 150            var beforeSaveResult = await BeforeSave(itemOfType, isFirstRefresh || refreshOptions.ReplaceAllMetadata || r
 151                .ConfigureAwait(false);
 152            updateType |= beforeSaveResult;
 153
 154            if (isFirstRefresh)
 155            {
 156                await SaveItemAsync(metadataResult, ItemUpdateType.MetadataImport, false, cancellationToken).ConfigureAw
 157            }
 158
 159            // Next run metadata providers
 160            if (refreshOptions.MetadataRefreshMode != MetadataRefreshMode.None)
 161            {
 162                var providers = GetProviders(item, libraryOptions, refreshOptions, isFirstRefresh, requiresRefresh)
 163                    .ToList();
 164
 165                if (providers.Count > 0 || isFirstRefresh || requiresRefresh)
 166                {
 167                    if (item.BeforeMetadataRefresh(refreshOptions.ReplaceAllMetadata))
 168                    {
 169                        updateType |= ItemUpdateType.MetadataImport;
 170                    }
 171                }
 172
 173                if (providers.Count > 0)
 174                {
 175                    var id = itemOfType.GetLookupInfo();
 176
 177                    if (refreshOptions.SearchResult is not null)
 178                    {
 179                        ApplySearchResult(id, refreshOptions.SearchResult);
 180                    }
 181
 182                    id.IsAutomated = refreshOptions.IsAutomated;
 183
 184                    var hasMetadataSavers = ProviderManager.GetMetadataSavers(item, libraryOptions).Any();
 185                    var result = await RefreshWithProviders(metadataResult, id, refreshOptions, providers, ImageProvider
 186
 187                    updateType |= result.UpdateType;
 188                    if (result.Failures > 0)
 189                    {
 190                        hasRefreshedMetadata = false;
 191                    }
 192                }
 193            }
 194
 195            // Next run remote image providers, but only if local image providers didn't throw an exception
 196            if (!localImagesFailed && refreshOptions.ImageRefreshMode > MetadataRefreshMode.ValidationOnly)
 197            {
 198                var providers = GetNonLocalImageProviders(item, allImageProviders, refreshOptions).ToList();
 199
 200                if (providers.Count > 0)
 201                {
 202                    var result = await ImageProvider.RefreshImages(itemOfType, libraryOptions, providers, refreshOptions
 203
 204                    updateType |= result.UpdateType;
 205                    if (result.Failures > 0)
 206                    {
 207                        hasRefreshedImages = false;
 208                    }
 209                }
 210            }
 211
 212            if (hasRefreshedMetadata && hasRefreshedImages)
 213            {
 214                item.DateLastRefreshed = DateTime.UtcNow;
 215                updateType |= item.OnMetadataChanged();
 216            }
 217
 218            updateType = await SaveInternal(item, refreshOptions, updateType, isFirstRefresh, requiresRefresh, metadataR
 219
 220            await AfterMetadataRefresh(itemOfType, refreshOptions, cancellationToken).ConfigureAwait(false);
 221
 222            return updateType;
 223
 224            async Task<ItemUpdateType> SaveInternal(BaseItem item, MetadataRefreshOptions refreshOptions, ItemUpdateType
 225            {
 226                // Save if changes were made, or it's never been saved before
 227                if (refreshOptions.ForceSave || updateType > ItemUpdateType.None || isFirstRefresh || refreshOptions.Rep
 228                {
 229                    if (item.IsFileProtocol)
 230                    {
 231                        var file = TryGetFileSystemMetadata(item.Path, refreshOptions.DirectoryService);
 232                        if (file is not null)
 233                        {
 234                            item.DateModified = file.LastWriteTimeUtc;
 235
 236                            if (!file.IsDirectory)
 237                            {
 238                                item.Size = file.Length;
 239                            }
 240                        }
 241                    }
 242
 243                    // If any of these properties are set then make sure the updateType is not None, just to force every
 244                    if (refreshOptions.ForceSave || refreshOptions.ReplaceAllMetadata)
 245                    {
 246                        updateType |= ItemUpdateType.MetadataDownload;
 247                    }
 248
 249                    // Save to database
 250                    await SaveItemAsync(metadataResult, updateType, isFirstRefresh, cancellationToken).ConfigureAwait(fa
 251                }
 252
 253                return updateType;
 254            }
 255        }
 256
 257        private void ApplySearchResult(ItemLookupInfo lookupInfo, RemoteSearchResult result)
 258        {
 259            // Episode and Season do not support Identify, so the search results are the Series'
 260            switch (lookupInfo)
 261            {
 262                case EpisodeInfo episodeInfo:
 0263                    episodeInfo.SeriesProviderIds = result.ProviderIds;
 0264                    episodeInfo.ProviderIds.Clear();
 0265                    break;
 266                case SeasonInfo seasonInfo:
 0267                    seasonInfo.SeriesProviderIds = result.ProviderIds;
 0268                    seasonInfo.ProviderIds.Clear();
 0269                    break;
 270                default:
 0271                    lookupInfo.ProviderIds = result.ProviderIds;
 0272                    lookupInfo.Name = result.Name;
 0273                    lookupInfo.Year = result.ProductionYear;
 274                    break;
 275            }
 0276        }
 277
 278        protected async Task SaveItemAsync(MetadataResult<TItemType> result, ItemUpdateType reason, bool reattachUserDat
 279        {
 280            await result.Item.UpdateToRepositoryAsync(reason, cancellationToken).ConfigureAwait(false);
 281            if (reattachUserData)
 282            {
 283                await result.Item.ReattachUserDataAsync(cancellationToken).ConfigureAwait(false);
 284            }
 285
 286            if (result.Item.SupportsPeople && result.People is not null)
 287            {
 288                var baseItem = result.Item;
 289
 290                await LibraryManager.UpdatePeopleAsync(baseItem, result.People, cancellationToken).ConfigureAwait(false)
 291            }
 292        }
 293
 294        protected virtual Task AfterMetadataRefresh(TItemType item, MetadataRefreshOptions refreshOptions, CancellationT
 295        {
 54296            item.AfterMetadataRefresh();
 54297            return Task.CompletedTask;
 298        }
 299
 300        /// <summary>
 301        /// Before the save.
 302        /// </summary>
 303        /// <param name="item">The item.</param>
 304        /// <param name="isFullRefresh">if set to <c>true</c> [is full refresh].</param>
 305        /// <param name="currentUpdateType">Type of the current update.</param>
 306        /// <returns>ItemUpdateType.</returns>
 307        private async Task<ItemUpdateType> BeforeSave(TItemType item, bool isFullRefresh, ItemUpdateType currentUpdateTy
 308        {
 309            var updateType = BeforeSaveInternal(item, isFullRefresh, currentUpdateType);
 310
 311            updateType |= item.OnMetadataChanged();
 312
 313            if (updateType == ItemUpdateType.None)
 314            {
 315                if (!await ItemRepository.ItemExistsAsync(item.Id).ConfigureAwait(false))
 316                {
 317                    return ItemUpdateType.MetadataImport;
 318                }
 319            }
 320
 321            return updateType;
 322        }
 323
 324        protected virtual ItemUpdateType BeforeSaveInternal(TItemType item, bool isFullRefresh, ItemUpdateType updateTyp
 325        {
 55326            if (EnableUpdateMetadataFromChildren(item, isFullRefresh, updateType))
 327            {
 0328                var children = GetChildrenForMetadataUpdates(item);
 0329                updateType = UpdateMetadataFromChildren(item, children, isFullRefresh, updateType);
 330            }
 331
 55332            var presentationUniqueKey = item.CreatePresentationUniqueKey();
 55333            if (!string.Equals(item.PresentationUniqueKey, presentationUniqueKey, StringComparison.Ordinal))
 334            {
 34335                item.PresentationUniqueKey = presentationUniqueKey;
 34336                updateType |= ItemUpdateType.MetadataImport;
 337            }
 338
 339            // Cleanup extracted files if source file was modified
 55340            var itemPath = item.Path;
 55341            if (!string.IsNullOrEmpty(itemPath))
 342            {
 55343                var info = FileSystem.GetFileSystemInfo(itemPath);
 55344                if (info.Exists && item.HasChanged(info.LastWriteTimeUtc))
 345                {
 0346                    Logger.LogDebug("File modification time changed from {Then} to {Now}: {Path}", item.DateModified, in
 347
 0348                    item.DateModified = info.LastWriteTimeUtc;
 0349                    if (ServerConfigurationManager.GetMetadataConfiguration().UseFileCreationTimeForDateAdded)
 350                    {
 0351                        if (info.CreationTimeUtc > DateTime.MinValue)
 352                        {
 0353                            item.DateCreated = info.CreationTimeUtc;
 354                        }
 355                    }
 356
 0357                    if (item is Video video)
 358                    {
 0359                        Logger.LogInformation("File changed, pruning extracted data: {Path}", item.Path);
 0360                        ExternalDataManager.DeleteExternalItemDataAsync(video, CancellationToken.None).GetAwaiter().GetR
 361                    }
 362
 0363                    updateType |= ItemUpdateType.MetadataImport;
 364                }
 365            }
 366
 55367            return updateType;
 368        }
 369
 370        protected virtual bool EnableUpdateMetadataFromChildren(TItemType item, bool isFullRefresh, ItemUpdateType curre
 371        {
 55372            if (item is Folder folder)
 373            {
 55374                if (!isFullRefresh && currentUpdateType == ItemUpdateType.None)
 375                {
 20376                    return folder.SupportsDateLastMediaAdded;
 377                }
 378
 35379                if (isFullRefresh || currentUpdateType > ItemUpdateType.None)
 380                {
 35381                    if (EnableUpdatingPremiereDateFromChildren || EnableUpdatingGenresFromChildren || EnableUpdatingStud
 382                    {
 0383                        return true;
 384                    }
 385
 35386                    if (folder.SupportsDateLastMediaAdded || folder.SupportsCumulativeRunTimeTicks)
 387                    {
 0388                        return true;
 389                    }
 390                }
 391            }
 392
 35393            return false;
 394        }
 395
 396        protected virtual IReadOnlyList<BaseItem> GetChildrenForMetadataUpdates(TItemType item)
 397        {
 0398            if (item is Folder folder)
 399            {
 0400                return folder.GetRecursiveChildren();
 401            }
 402
 0403            return [];
 404        }
 405
 406        protected virtual ItemUpdateType UpdateMetadataFromChildren(TItemType item, IReadOnlyList<BaseItem> children, bo
 407        {
 0408            var updateType = ItemUpdateType.None;
 409
 0410            if (item is Folder folder)
 411            {
 0412                if (folder.SupportsDateLastMediaAdded)
 413                {
 0414                    updateType |= UpdateDateLastMediaAdded(item, children);
 415                }
 416
 0417                if ((isFullRefresh || currentUpdateType > ItemUpdateType.None) && folder.SupportsCumulativeRunTimeTicks)
 418                {
 0419                    updateType |= UpdateCumulativeRunTimeTicks(item, children);
 420                }
 421            }
 422
 0423            if (!(isFullRefresh || currentUpdateType > ItemUpdateType.None) || item.IsLocked)
 424            {
 0425                return updateType;
 426            }
 427
 0428            if (EnableUpdatingPremiereDateFromChildren)
 429            {
 0430                updateType |= UpdatePremiereDate(item, children);
 431            }
 432
 0433            if (EnableUpdatingGenresFromChildren)
 434            {
 0435                updateType |= UpdateGenres(item, children);
 436            }
 437
 0438            if (EnableUpdatingStudiosFromChildren)
 439            {
 0440                updateType |= UpdateStudios(item, children);
 441            }
 442
 0443            if (EnableUpdatingOfficialRatingFromChildren)
 444            {
 0445                updateType |= UpdateOfficialRating(item, children);
 446            }
 447
 0448            return updateType;
 449        }
 450
 451        private ItemUpdateType UpdateCumulativeRunTimeTicks(TItemType item, IReadOnlyList<BaseItem> children)
 452        {
 0453            if (item is Folder folder && folder.SupportsCumulativeRunTimeTicks)
 454            {
 0455                long ticks = 0;
 456
 0457                foreach (var child in children)
 458                {
 0459                    if (!child.IsFolder)
 460                    {
 0461                        ticks += child.RunTimeTicks ?? 0;
 462                    }
 463                }
 464
 0465                if (!folder.RunTimeTicks.HasValue || folder.RunTimeTicks.Value != ticks)
 466                {
 0467                    folder.RunTimeTicks = ticks;
 0468                    return ItemUpdateType.MetadataImport;
 469                }
 470            }
 471
 0472            return ItemUpdateType.None;
 473        }
 474
 475        private ItemUpdateType UpdateDateLastMediaAdded(TItemType item, IReadOnlyList<BaseItem> children)
 476        {
 0477            var updateType = ItemUpdateType.None;
 478
 0479            if (item is Folder folder && folder.SupportsDateLastMediaAdded)
 480            {
 0481                var dateLastMediaAdded = DateTime.MinValue;
 0482                var any = false;
 483
 0484                foreach (var child in children)
 485                {
 486                    // Exclude any folders and virtual items since they are only placeholders
 0487                    if (!child.IsFolder && !child.IsVirtualItem)
 488                    {
 0489                        var childDateCreated = child.DateCreated;
 0490                        if (childDateCreated > dateLastMediaAdded)
 491                        {
 0492                            dateLastMediaAdded = childDateCreated;
 493                        }
 494
 0495                        any = true;
 496                    }
 497                }
 498
 0499                if ((!folder.DateLastMediaAdded.HasValue && any) || folder.DateLastMediaAdded != dateLastMediaAdded)
 500                {
 0501                    folder.DateLastMediaAdded = dateLastMediaAdded;
 0502                    updateType = ItemUpdateType.MetadataImport;
 503                }
 504            }
 505
 0506            return updateType;
 507        }
 508
 509        private ItemUpdateType UpdatePremiereDate(TItemType item, IReadOnlyList<BaseItem> children)
 510        {
 0511            var updateType = ItemUpdateType.None;
 512
 0513            if (children.Count == 0)
 514            {
 0515                return updateType;
 516            }
 517
 0518            var date = children.Select(i => i.PremiereDate ?? DateTime.MaxValue).Min();
 519
 0520            var originalPremiereDate = item.PremiereDate;
 0521            var originalProductionYear = item.ProductionYear;
 522
 0523            if (date > DateTime.MinValue && date < DateTime.MaxValue)
 524            {
 0525                item.PremiereDate = date;
 0526                item.ProductionYear = date.Year;
 527            }
 528            else
 529            {
 0530                var year = children.Select(i => i.ProductionYear ?? 0).Min();
 531
 0532                if (year > 0)
 533                {
 0534                    item.ProductionYear = year;
 535                }
 536            }
 537
 0538            if ((originalPremiereDate ?? DateTime.MinValue) != (item.PremiereDate ?? DateTime.MinValue)
 0539                || (originalProductionYear ?? -1) != (item.ProductionYear ?? -1))
 540            {
 0541                updateType |= ItemUpdateType.MetadataEdit;
 542            }
 543
 0544            return updateType;
 545        }
 546
 547        private ItemUpdateType UpdateGenres(TItemType item, IReadOnlyList<BaseItem> children)
 548        {
 0549            var updateType = ItemUpdateType.None;
 550
 0551            if (!item.LockedFields.Contains(MetadataField.Genres))
 552            {
 0553                var currentList = item.Genres;
 554
 0555                item.Genres = children.SelectMany(i => i.Genres)
 0556                    .Distinct(StringComparer.OrdinalIgnoreCase)
 0557                    .ToArray();
 558
 0559                if (currentList.Length != item.Genres.Length || !currentList.Order().SequenceEqual(item.Genres.Order(), 
 560                {
 0561                    updateType |= ItemUpdateType.MetadataEdit;
 562                }
 563            }
 564
 0565            return updateType;
 566        }
 567
 568        private ItemUpdateType UpdateStudios(TItemType item, IReadOnlyList<BaseItem> children)
 569        {
 0570            var updateType = ItemUpdateType.None;
 571
 0572            if (!item.LockedFields.Contains(MetadataField.Studios))
 573            {
 0574                var currentList = item.Studios;
 575
 0576                item.Studios = children.SelectMany(i => i.Studios)
 0577                    .Distinct(StringComparer.OrdinalIgnoreCase)
 0578                    .ToArray();
 579
 0580                if (currentList.Length != item.Studios.Length || !currentList.Order().SequenceEqual(item.Studios.Order()
 581                {
 0582                    updateType |= ItemUpdateType.MetadataEdit;
 583                }
 584            }
 585
 0586            return updateType;
 587        }
 588
 589        private ItemUpdateType UpdateOfficialRating(TItemType item, IReadOnlyList<BaseItem> children)
 590        {
 0591            var updateType = ItemUpdateType.None;
 592
 0593            if (!item.LockedFields.Contains(MetadataField.OfficialRating))
 594            {
 0595                if (item.UpdateRatingToItems(children))
 596                {
 0597                    updateType |= ItemUpdateType.MetadataEdit;
 598                }
 599            }
 600
 0601            return updateType;
 602        }
 603
 604        /// <summary>
 605        /// Gets the providers.
 606        /// </summary>
 607        /// <param name="item">A media item.</param>
 608        /// <param name="libraryOptions">The LibraryOptions to use.</param>
 609        /// <param name="options">The MetadataRefreshOptions to use.</param>
 610        /// <param name="isFirstRefresh">Specifies first refresh mode.</param>
 611        /// <param name="requiresRefresh">Specifies refresh mode.</param>
 612        /// <returns>IEnumerable{`0}.</returns>
 613        protected IEnumerable<IMetadataProvider> GetProviders(BaseItem item, LibraryOptions libraryOptions, MetadataRefr
 614        {
 615            // Get providers to refresh
 55616            var providers = ProviderManager.GetMetadataProviders<TItemType>(item, libraryOptions).ToList();
 617
 55618            var metadataRefreshMode = options.MetadataRefreshMode;
 619
 620            // Run all if either of these flags are true
 55621            var runAllProviders = options.ReplaceAllMetadata ||
 55622                metadataRefreshMode == MetadataRefreshMode.FullRefresh ||
 55623                (isFirstRefresh && metadataRefreshMode >= MetadataRefreshMode.Default) ||
 55624                (requiresRefresh && metadataRefreshMode >= MetadataRefreshMode.Default);
 625
 55626            if (!runAllProviders)
 627            {
 20628                var providersWithChanges = providers
 20629                    .Where(i =>
 20630                    {
 20631                        if (i is IHasItemChangeMonitor hasFileChangeMonitor)
 20632                        {
 20633                            return HasChanged(item, hasFileChangeMonitor, options.DirectoryService);
 20634                        }
 20635
 20636                        return false;
 20637                    })
 20638                    .ToList();
 639
 20640                if (providersWithChanges.Count == 0)
 641                {
 0642                    providers = new List<IMetadataProvider<TItemType>>();
 643                }
 644                else
 645                {
 20646                    var anyRemoteProvidersChanged = providersWithChanges.OfType<IRemoteMetadataProvider>()
 20647                        .Any();
 648
 20649                    var anyLocalProvidersChanged = providersWithChanges.OfType<ILocalMetadataProvider>()
 20650                        .Any();
 651
 20652                    var anyLocalPreRefreshProvidersChanged = providersWithChanges.OfType<IPreRefreshProvider>()
 20653                        .Any();
 654
 20655                    providers = providers.Where(i =>
 20656                    {
 20657                        // If any provider reports a change, always run local ones as well
 20658                        if (i is ILocalMetadataProvider)
 20659                        {
 20660                            return anyRemoteProvidersChanged || anyLocalProvidersChanged || anyLocalPreRefreshProvidersC
 20661                        }
 20662
 20663                        // If any remote providers changed, run them all so that priorities can be honored
 20664                        if (i is IRemoteMetadataProvider)
 20665                        {
 20666                            if (options.MetadataRefreshMode == MetadataRefreshMode.ValidationOnly)
 20667                            {
 20668                                return false;
 20669                            }
 20670
 20671                            return anyRemoteProvidersChanged;
 20672                        }
 20673
 20674                        // Run custom refresh providers if they report a change or any remote providers change
 20675                        return anyRemoteProvidersChanged || providersWithChanges.Contains(i);
 20676                    }).ToList();
 677                }
 678            }
 679
 55680            return providers;
 681        }
 682
 683        protected virtual IEnumerable<IImageProvider> GetNonLocalImageProviders(BaseItem item, IEnumerable<IImageProvide
 684        {
 685            // Get providers to refresh
 55686            var providers = allImageProviders.Where(i => i is not ILocalImageProvider);
 687
 55688            var dateLastImageRefresh = item.DateLastRefreshed;
 689
 690            // Run all if either of these flags are true
 55691            var runAllProviders = options.ImageRefreshMode == MetadataRefreshMode.FullRefresh || dateLastImageRefresh.Da
 692
 55693            if (!runAllProviders)
 694            {
 21695                providers = providers
 21696                    .Where(i =>
 21697                    {
 21698                        if (i is IHasItemChangeMonitor hasFileChangeMonitor)
 21699                        {
 21700                            return HasChanged(item, hasFileChangeMonitor, options.DirectoryService);
 21701                        }
 21702
 21703                        return false;
 21704                    });
 705            }
 706
 55707            return providers;
 708        }
 709
 710        public bool CanRefresh(BaseItem item)
 711        {
 1144712            return item is TItemType;
 713        }
 714
 715        public bool CanRefreshPrimary(Type type)
 716        {
 1372717            return type == typeof(TItemType);
 718        }
 719
 720        protected virtual async Task<RefreshResult> RefreshWithProviders(
 721            MetadataResult<TItemType> metadata,
 722            TIdType id,
 723            MetadataRefreshOptions options,
 724            ICollection<IMetadataProvider> providers,
 725            ItemImageProvider imageService,
 726            bool isSavingMetadata,
 727            CancellationToken cancellationToken)
 728        {
 729            var refreshResult = new RefreshResult
 730            {
 731                UpdateType = ItemUpdateType.None
 732            };
 733
 734            var item = metadata.Item;
 735
 736            var customProviders = providers.OfType<ICustomMetadataProvider<TItemType>>().ToList();
 737            var logName = !item.IsFileProtocol ? item.Name ?? item.Path : item.Path ?? item.Name;
 738
 739            foreach (var provider in customProviders.Where(i => i is IPreRefreshProvider))
 740            {
 741                await RunCustomProvider(provider, item, logName, options, refreshResult, cancellationToken).ConfigureAwa
 742            }
 743
 744            if (item.IsLocked)
 745            {
 746                return refreshResult;
 747            }
 748
 749            var temp = new MetadataResult<TItemType>
 750            {
 751                Item = CreateNew()
 752            };
 753            temp.Item.Path = item.Path;
 754            temp.Item.Id = item.Id;
 755            temp.Item.ParentIndexNumber = item.ParentIndexNumber;
 756            temp.Item.PreferredMetadataCountryCode = item.PreferredMetadataCountryCode;
 757            temp.Item.PreferredMetadataLanguage = item.PreferredMetadataLanguage;
 758
 759            var foundImageTypes = new List<ImageType>();
 760
 761            // Do not execute local providers if we are identifying or replacing with local metadata saving enabled
 762            if (options.SearchResult is null && !(isSavingMetadata && options.ReplaceAllMetadata))
 763            {
 764                foreach (var provider in providers.OfType<ILocalMetadataProvider<TItemType>>())
 765                {
 766                    var providerName = provider.GetType().Name;
 767                    Logger.LogDebug("Running {Provider} for {Item}", providerName, logName);
 768
 769                    var itemInfo = new ItemInfo(item);
 770
 771                    try
 772                    {
 773                        var localItem = await provider.GetMetadata(itemInfo, options.DirectoryService, cancellationToken
 774
 775                        if (localItem.HasMetadata)
 776                        {
 777                            foreach (var remoteImage in localItem.RemoteImages)
 778                            {
 779                                try
 780                                {
 781                                    if (item.ImageInfos.Any(x => x.Type == remoteImage.Type)
 782                                        && !options.IsReplacingImage(remoteImage.Type))
 783                                    {
 784                                        continue;
 785                                    }
 786
 787                                    await ProviderManager.SaveImage(item, remoteImage.Url, remoteImage.Type, null, cance
 788                                    refreshResult.UpdateType |= ItemUpdateType.ImageUpdate;
 789
 790                                    // remember imagetype that has just been downloaded
 791                                    foundImageTypes.Add(remoteImage.Type);
 792                                }
 793                                catch (HttpRequestException ex)
 794                                {
 795                                    Logger.LogError(ex, "Could not save {ImageType} image: {Url}", Enum.GetName(remoteIm
 796                                }
 797                            }
 798
 799                            if (foundImageTypes.Count > 0)
 800                            {
 801                                imageService.UpdateReplaceImages(options, foundImageTypes);
 802                            }
 803
 804                            if (imageService.MergeImages(item, localItem.Images, options))
 805                            {
 806                                refreshResult.UpdateType |= ItemUpdateType.ImageUpdate;
 807                            }
 808
 809                            MergeData(localItem, temp, [], false, true);
 810                            refreshResult.UpdateType |= ItemUpdateType.MetadataImport;
 811
 812                            break;
 813                        }
 814
 815                        Logger.LogDebug("{Provider} returned no metadata for {Item}", providerName, logName);
 816                    }
 817                    catch (OperationCanceledException)
 818                    {
 819                        throw;
 820                    }
 821                    catch (Exception ex)
 822                    {
 823                        Logger.LogError(ex, "Error in {Provider}", provider.Name);
 824
 825                        // If a local provider fails, consider that a failure
 826                        refreshResult.ErrorMessage = ex.Message;
 827                    }
 828                }
 829            }
 830
 831            var isLocalLocked = temp.Item.IsLocked;
 832            if (!isLocalLocked && (options.ReplaceAllMetadata || options.MetadataRefreshMode > MetadataRefreshMode.Valid
 833            {
 834                var remoteResult = await ExecuteRemoteProviders(temp, logName, false, id, providers.OfType<IRemoteMetada
 835                    .ConfigureAwait(false);
 836
 837                refreshResult.UpdateType |= remoteResult.UpdateType;
 838                refreshResult.ErrorMessage = remoteResult.ErrorMessage;
 839                refreshResult.Failures += remoteResult.Failures;
 840            }
 841
 842            if (providers.Any(i => i is not ICustomMetadataProvider))
 843            {
 844                if (refreshResult.UpdateType > ItemUpdateType.None)
 845                {
 846                    if (!options.RemoveOldMetadata)
 847                    {
 848                        // Add existing metadata to provider result if it does not exist there
 849                        MergeData(metadata, temp, [], false, false);
 850                    }
 851
 852                    if (isLocalLocked)
 853                    {
 854                        MergeData(temp, metadata, item.LockedFields, true, true);
 855                    }
 856                    else
 857                    {
 858                        var shouldReplace = (options.MetadataRefreshMode > MetadataRefreshMode.ValidationOnly && options
 859                            // Case for Scan for new and updated files
 860                            || (options.MetadataRefreshMode == MetadataRefreshMode.Default && !options.ReplaceAllMetadat
 861                        MergeData(temp, metadata, item.LockedFields, shouldReplace, true);
 862                    }
 863                }
 864            }
 865
 866            foreach (var provider in customProviders.Where(i => i is not IPreRefreshProvider))
 867            {
 868                await RunCustomProvider(provider, item, logName, options, refreshResult, cancellationToken).ConfigureAwa
 869            }
 870
 871            return refreshResult;
 872        }
 873
 874        private async Task RunCustomProvider(ICustomMetadataProvider<TItemType> provider, TItemType item, string logName
 875        {
 876            Logger.LogDebug("Running {Provider} for {Item}", provider.GetType().Name, logName);
 877
 878            try
 879            {
 880                refreshResult.UpdateType |= await provider.FetchAsync(item, options, cancellationToken).ConfigureAwait(f
 881            }
 882            catch (OperationCanceledException)
 883            {
 884                throw;
 885            }
 886            catch (Exception ex)
 887            {
 888                refreshResult.ErrorMessage = ex.Message;
 889                Logger.LogError(ex, "Error in {Provider}", provider.Name);
 890            }
 891        }
 892
 893        protected virtual TItemType CreateNew()
 894        {
 55895            return new TItemType();
 896        }
 897
 898        private async Task<RefreshResult> ExecuteRemoteProviders(MetadataResult<TItemType> temp, string logName, bool re
 899        {
 900            var refreshResult = new RefreshResult();
 901
 902            if (id is not null)
 903            {
 904                MergeNewData(temp.Item, id);
 905            }
 906
 907            foreach (var provider in providers)
 908            {
 909                var providerName = provider.GetType().Name;
 910                Logger.LogDebug("Running {Provider} for {Item}", providerName, logName);
 911
 912                try
 913                {
 914                    var result = await provider.GetMetadata(id, cancellationToken).ConfigureAwait(false);
 915
 916                    if (result.HasMetadata)
 917                    {
 918                        result.Provider = provider.Name;
 919
 920                        MergeData(result, temp, [], replaceData, false);
 921                        MergeNewData(temp.Item, id);
 922
 923                        refreshResult.UpdateType |= ItemUpdateType.MetadataDownload;
 924                    }
 925                    else
 926                    {
 927                        Logger.LogDebug("{Provider} returned no metadata for {Item}", providerName, logName);
 928                    }
 929                }
 930                catch (OperationCanceledException)
 931                {
 932                    throw;
 933                }
 934                catch (Exception ex)
 935                {
 936                    refreshResult.Failures++;
 937                    refreshResult.ErrorMessage = ex.Message;
 938                    Logger.LogError(ex, "Error in {Provider}", provider.Name);
 939                }
 940            }
 941
 942            return refreshResult;
 943        }
 944
 945        private void MergeNewData(TItemType source, TIdType lookupInfo)
 946        {
 947            // Copy new provider id's that may have been obtained
 110948            foreach (var providerId in source.ProviderIds)
 949            {
 0950                var key = providerId.Key;
 951
 952                // Don't replace existing Id's.
 0953                lookupInfo.ProviderIds.TryAdd(key, providerId.Value);
 954            }
 55955        }
 956
 957        private bool HasChanged(BaseItem item, IHasItemChangeMonitor changeMonitor, IDirectoryService directoryService)
 958        {
 959            try
 960            {
 20961                var hasChanged = changeMonitor.HasChanged(item, directoryService);
 962
 20963                if (hasChanged)
 964                {
 20965                    Logger.LogDebug("{Monitor} reports change to {Item}", changeMonitor.GetType().Name, item.Path ?? ite
 966                }
 967
 20968                return hasChanged;
 969            }
 0970            catch (Exception ex)
 971            {
 0972                Logger.LogError(ex, "Error in {Monitor}.HasChanged", changeMonitor.GetType().Name);
 0973                return false;
 974            }
 20975        }
 976
 977        /// <summary>
 978        /// Merges metadata from source into target.
 979        /// </summary>
 980        /// <param name="source">The source for new metadata.</param>
 981        /// <param name="target">The target to insert new metadata into.</param>
 982        /// <param name="lockedFields">The fields that are locked and should not be updated.</param>
 983        /// <param name="replaceData"><c>true</c> if existing data should be replaced.</param>
 984        /// <param name="mergeMetadataSettings"><c>true</c> if the metadata settings in target should be updated to matc
 985        /// <exception cref="ArgumentException">Thrown if source or target are null.</exception>
 986        protected virtual void MergeData(
 987            MetadataResult<TItemType> source,
 988            MetadataResult<TItemType> target,
 989            MetadataField[] lockedFields,
 990            bool replaceData,
 991            bool mergeMetadataSettings)
 992        {
 0993            MergeBaseItemData(source, target, lockedFields, replaceData, mergeMetadataSettings);
 0994        }
 995
 996        internal static void MergeBaseItemData(
 997            MetadataResult<TItemType> sourceResult,
 998            MetadataResult<TItemType> targetResult,
 999            MetadataField[] lockedFields,
 1000            bool replaceData,
 1001            bool mergeMetadataSettings)
 1002        {
 1291003            var source = sourceResult.Item;
 1291004            var target = targetResult.Item;
 1005
 1291006            ArgumentNullException.ThrowIfNull(sourceResult);
 1291007            ArgumentNullException.ThrowIfNull(targetResult);
 1008
 1291009            if (!lockedFields.Contains(MetadataField.Name))
 1010            {
 1261011                if (replaceData || string.IsNullOrEmpty(target.Name))
 1012                {
 1013                    // Safeguard against incoming data having an empty name
 1251014                    if (!string.IsNullOrWhiteSpace(source.Name))
 1015                    {
 31016                        target.Name = source.Name;
 1017                    }
 1018                }
 1019            }
 1020
 1291021            if (replaceData || string.IsNullOrEmpty(target.OriginalTitle))
 1022            {
 1281023                target.OriginalTitle = source.OriginalTitle;
 1024            }
 1025
 1291026            if (replaceData || !target.CommunityRating.HasValue)
 1027            {
 1281028                target.CommunityRating = source.CommunityRating;
 1029            }
 1030
 1291031            if (replaceData || !target.EndDate.HasValue)
 1032            {
 1281033                target.EndDate = source.EndDate;
 1034            }
 1035
 1291036            if (!lockedFields.Contains(MetadataField.Genres))
 1037            {
 1271038                if (replaceData || target.Genres.Length == 0)
 1039                {
 1261040                    target.Genres = source.Genres;
 1041                }
 1042            }
 1043
 1291044            if (replaceData || !target.IndexNumber.HasValue)
 1045            {
 1281046                target.IndexNumber = source.IndexNumber;
 1047            }
 1048
 1291049            if (!lockedFields.Contains(MetadataField.OfficialRating))
 1050            {
 1261051                if (replaceData || string.IsNullOrEmpty(target.OfficialRating))
 1052                {
 1251053                    target.OfficialRating = source.OfficialRating;
 1054                }
 1055            }
 1056
 1291057            if (replaceData || string.IsNullOrEmpty(target.CustomRating))
 1058            {
 1281059                target.CustomRating = source.CustomRating;
 1060            }
 1061
 1291062            if (replaceData || string.IsNullOrEmpty(target.Tagline))
 1063            {
 1281064                target.Tagline = source.Tagline;
 1065            }
 1066
 1291067            if (!lockedFields.Contains(MetadataField.Overview))
 1068            {
 1261069                if (replaceData || string.IsNullOrEmpty(target.Overview))
 1070                {
 1251071                    target.Overview = source.Overview;
 1072                }
 1073            }
 1074
 1291075            if (replaceData || !target.ParentIndexNumber.HasValue)
 1076            {
 1281077                target.ParentIndexNumber = source.ParentIndexNumber;
 1078            }
 1079
 1291080            if (!lockedFields.Contains(MetadataField.Cast))
 1081            {
 1281082                if (replaceData || targetResult.People is null || targetResult.People.Count == 0)
 1083                {
 1241084                    targetResult.People = sourceResult.People;
 1085                }
 41086                else if (sourceResult.People is not null && sourceResult.People.Count > 0)
 1087                {
 41088                    MergePeople(sourceResult.People, targetResult.People);
 1089                }
 1090            }
 1091
 1291092            if (replaceData || !target.PremiereDate.HasValue)
 1093            {
 1281094                target.PremiereDate = source.PremiereDate;
 1095            }
 1096
 1291097            if (replaceData || !target.ProductionYear.HasValue)
 1098            {
 1281099                target.ProductionYear = source.ProductionYear;
 1100            }
 1101
 1291102            if (!lockedFields.Contains(MetadataField.Runtime))
 1103            {
 1291104                if (replaceData || !target.RunTimeTicks.HasValue)
 1105                {
 1291106                    if (target is not Audio && target is not Video)
 1107                    {
 491108                        target.RunTimeTicks = source.RunTimeTicks;
 1109                    }
 1110                }
 1111            }
 1112
 1291113            if (!lockedFields.Contains(MetadataField.Studios))
 1114            {
 1271115                if (replaceData || target.Studios.Length == 0)
 1116                {
 1261117                    target.Studios = source.Studios;
 1118                }
 1119                else
 1120                {
 11121                    target.Studios = target.Studios.Concat(source.Studios).Distinct(StringComparer.OrdinalIgnoreCase).To
 1122                }
 1123            }
 1124
 1291125            if (!lockedFields.Contains(MetadataField.Tags))
 1126            {
 1271127                if (replaceData || target.Tags.Length == 0)
 1128                {
 1261129                    target.Tags = source.Tags;
 1130                }
 1131                else
 1132                {
 11133                    target.Tags = target.Tags.Concat(source.Tags).Distinct(StringComparer.OrdinalIgnoreCase).ToArray();
 1134                }
 1135            }
 1136
 1291137            if (!lockedFields.Contains(MetadataField.ProductionLocations))
 1138            {
 1271139                if (replaceData || target.ProductionLocations.Length == 0)
 1140                {
 1261141                    target.ProductionLocations = source.ProductionLocations;
 1142                }
 1143                else
 1144                {
 11145                    target.ProductionLocations = target.ProductionLocations.Concat(source.ProductionLocations).Distinct(
 1146                }
 1147            }
 1148
 2661149            foreach (var id in source.ProviderIds)
 1150            {
 41151                var key = id.Key;
 1152
 1153                // Don't replace existing Id's.
 41154                if (replaceData)
 1155                {
 11156                    target.ProviderIds[key] = id.Value;
 1157                }
 1158                else
 1159                {
 31160                    target.ProviderIds.TryAdd(key, id.Value);
 1161                }
 1162            }
 1163
 1291164            if (replaceData || !target.CriticRating.HasValue)
 1165            {
 1281166                target.CriticRating = source.CriticRating;
 1167            }
 1168
 1291169            if (replaceData || target.RemoteTrailers.Count == 0)
 1170            {
 1281171                target.RemoteTrailers = source.RemoteTrailers;
 1172            }
 1173            else
 1174            {
 11175                target.RemoteTrailers = target.RemoteTrailers.Concat(source.RemoteTrailers).DistinctBy(t => t.Url).ToArr
 1176            }
 1177
 1291178            MergeAlbumArtist(source, target, replaceData);
 1291179            MergeVideoInfo(source, target, replaceData);
 1291180            MergeDisplayOrder(source, target, replaceData);
 1181
 1291182            if (replaceData || string.IsNullOrEmpty(target.ForcedSortName))
 1183            {
 1281184                var forcedSortName = source.ForcedSortName;
 1281185                if (!string.IsNullOrEmpty(forcedSortName))
 1186                {
 31187                    target.ForcedSortName = forcedSortName;
 1188                }
 1189            }
 1190
 1291191            if (mergeMetadataSettings)
 1192            {
 21193                if (replaceData || !target.IsLocked)
 1194                {
 21195                    target.IsLocked = target.IsLocked || source.IsLocked;
 1196                }
 1197
 21198                if (target.LockedFields.Length == 0)
 1199                {
 01200                    target.LockedFields = source.LockedFields;
 1201                }
 1202                else
 1203                {
 21204                    target.LockedFields = target.LockedFields.Concat(source.LockedFields).Distinct().ToArray();
 1205                }
 1206
 21207                if (source.DateCreated != DateTime.MinValue)
 1208                {
 11209                    target.DateCreated = source.DateCreated;
 1210                }
 1211
 21212                if (replaceData || source.DateModified != DateTime.MinValue)
 1213                {
 21214                    target.DateModified = source.DateModified;
 1215                }
 1216
 21217                if (replaceData || string.IsNullOrEmpty(target.PreferredMetadataCountryCode))
 1218                {
 21219                    target.PreferredMetadataCountryCode = source.PreferredMetadataCountryCode;
 1220                }
 1221
 21222                if (replaceData || string.IsNullOrEmpty(target.PreferredMetadataLanguage))
 1223                {
 21224                    target.PreferredMetadataLanguage = source.PreferredMetadataLanguage;
 1225                }
 1226            }
 1291227        }
 1228
 1229        private static void MergePeople(IReadOnlyList<PersonInfo> source, IReadOnlyList<PersonInfo> target)
 1230        {
 41231            var sourceByName = source.ToLookup(p => p.Name.RemoveDiacritics(), StringComparer.OrdinalIgnoreCase);
 41232            var targetByName = target.ToLookup(p => p.Name.RemoveDiacritics(), StringComparer.OrdinalIgnoreCase);
 1233
 161234            foreach (var name in targetByName.Select(g => g.Key))
 1235            {
 41236                var targetPeople = targetByName[name].ToArray();
 41237                var sourcePeople = sourceByName[name].ToArray();
 1238
 41239                if (sourcePeople.Length == 0)
 1240                {
 1241                    continue;
 1242                }
 1243
 121244                for (int i = 0; i < targetPeople.Length; i++)
 1245                {
 31246                    var person = targetPeople[i];
 31247                    var personInSource = i < sourcePeople.Length ? sourcePeople[i] : sourcePeople[0];
 1248
 101249                    foreach (var providerId in personInSource.ProviderIds)
 1250                    {
 21251                        person.ProviderIds.TryAdd(providerId.Key, providerId.Value);
 1252                    }
 1253
 31254                    if (string.IsNullOrWhiteSpace(person.ImageUrl))
 1255                    {
 21256                        person.ImageUrl = personInSource.ImageUrl;
 1257                    }
 1258
 31259                    if (!string.IsNullOrWhiteSpace(personInSource.Role) && string.IsNullOrWhiteSpace(person.Role))
 1260                    {
 01261                        person.Role = personInSource.Role;
 1262                    }
 1263
 31264                    if (personInSource.SortOrder.HasValue && !person.SortOrder.HasValue)
 1265                    {
 01266                        person.SortOrder = personInSource.SortOrder;
 1267                    }
 1268                }
 1269            }
 41270        }
 1271
 1272        private static void MergeDisplayOrder(BaseItem source, BaseItem target, bool replaceData)
 1273        {
 1291274            if (source is IHasDisplayOrder sourceHasDisplayOrder
 1291275                && target is IHasDisplayOrder targetHasDisplayOrder)
 1276            {
 491277                if (replaceData || string.IsNullOrEmpty(targetHasDisplayOrder.DisplayOrder))
 1278                {
 481279                    var displayOrder = sourceHasDisplayOrder.DisplayOrder;
 481280                    if (!string.IsNullOrWhiteSpace(displayOrder))
 1281                    {
 31282                        targetHasDisplayOrder.DisplayOrder = displayOrder;
 1283                    }
 1284                }
 1285            }
 1291286        }
 1287
 1288        private static void MergeAlbumArtist(BaseItem source, BaseItem target, bool replaceData)
 1289        {
 1291290            if (source is IHasAlbumArtist sourceHasAlbumArtist
 1291291                && target is IHasAlbumArtist targetHasAlbumArtist)
 1292            {
 281293                if (replaceData || targetHasAlbumArtist.AlbumArtists.Count == 0)
 1294                {
 271295                    targetHasAlbumArtist.AlbumArtists = sourceHasAlbumArtist.AlbumArtists;
 1296                }
 11297                else if (sourceHasAlbumArtist.AlbumArtists.Count > 0)
 1298                {
 11299                    targetHasAlbumArtist.AlbumArtists = targetHasAlbumArtist.AlbumArtists.Concat(sourceHasAlbumArtist.Al
 1300                }
 1301            }
 1021302        }
 1303
 1304        private static void MergeVideoInfo(BaseItem source, BaseItem target, bool replaceData)
 1305        {
 1291306            if (source is Video sourceCast && target is Video targetCast)
 1307            {
 521308                if (sourceCast.Video3DFormat.HasValue && (replaceData || !targetCast.Video3DFormat.HasValue))
 1309                {
 21310                    targetCast.Video3DFormat = sourceCast.Video3DFormat;
 1311                }
 1312            }
 1291313        }
 1314    }
 1315}

Methods/Properties

.ctor(MediaBrowser.Controller.Configuration.IServerConfigurationManager,Microsoft.Extensions.Logging.ILogger`1<MediaBrowser.Providers.Manager.MetadataService`2<TItemType,TIdType>>,MediaBrowser.Controller.Providers.IProviderManager,MediaBrowser.Model.IO.IFileSystem,MediaBrowser.Controller.Library.ILibraryManager,MediaBrowser.Controller.IO.IExternalDataManager,MediaBrowser.Controller.Persistence.IItemRepository)
get_EnableUpdatingPremiereDateFromChildren()
get_EnableUpdatingGenresFromChildren()
get_EnableUpdatingStudiosFromChildren()
get_EnableUpdatingOfficialRatingFromChildren()
get_Order()
TryGetFileSystemMetadata(System.String,MediaBrowser.Controller.Providers.IDirectoryService)
ApplySearchResult(MediaBrowser.Controller.Providers.ItemLookupInfo,MediaBrowser.Model.Providers.RemoteSearchResult)
AfterMetadataRefresh(TItemType,MediaBrowser.Controller.Providers.MetadataRefreshOptions,System.Threading.CancellationToken)
BeforeSaveInternal(TItemType,System.Boolean,MediaBrowser.Controller.Library.ItemUpdateType)
EnableUpdateMetadataFromChildren(TItemType,System.Boolean,MediaBrowser.Controller.Library.ItemUpdateType)
GetChildrenForMetadataUpdates(TItemType)
UpdateMetadataFromChildren(TItemType,System.Collections.Generic.IReadOnlyList`1<MediaBrowser.Controller.Entities.BaseItem>,System.Boolean,MediaBrowser.Controller.Library.ItemUpdateType)
UpdateCumulativeRunTimeTicks(TItemType,System.Collections.Generic.IReadOnlyList`1<MediaBrowser.Controller.Entities.BaseItem>)
UpdateDateLastMediaAdded(TItemType,System.Collections.Generic.IReadOnlyList`1<MediaBrowser.Controller.Entities.BaseItem>)
UpdatePremiereDate(TItemType,System.Collections.Generic.IReadOnlyList`1<MediaBrowser.Controller.Entities.BaseItem>)
UpdateGenres(TItemType,System.Collections.Generic.IReadOnlyList`1<MediaBrowser.Controller.Entities.BaseItem>)
UpdateStudios(TItemType,System.Collections.Generic.IReadOnlyList`1<MediaBrowser.Controller.Entities.BaseItem>)
UpdateOfficialRating(TItemType,System.Collections.Generic.IReadOnlyList`1<MediaBrowser.Controller.Entities.BaseItem>)
GetProviders(MediaBrowser.Controller.Entities.BaseItem,MediaBrowser.Model.Configuration.LibraryOptions,MediaBrowser.Controller.Providers.MetadataRefreshOptions,System.Boolean,System.Boolean)
GetNonLocalImageProviders(MediaBrowser.Controller.Entities.BaseItem,System.Collections.Generic.IEnumerable`1<MediaBrowser.Controller.Providers.IImageProvider>,MediaBrowser.Controller.Providers.ImageRefreshOptions)
CanRefresh(MediaBrowser.Controller.Entities.BaseItem)
CanRefreshPrimary(System.Type)
CreateNew()
MergeNewData(TItemType,TIdType)
HasChanged(MediaBrowser.Controller.Entities.BaseItem,MediaBrowser.Controller.Providers.IHasItemChangeMonitor,MediaBrowser.Controller.Providers.IDirectoryService)
MergeData(MediaBrowser.Controller.Providers.MetadataResult`1<TItemType>,MediaBrowser.Controller.Providers.MetadataResult`1<TItemType>,MediaBrowser.Model.Entities.MetadataField[],System.Boolean,System.Boolean)
MergeBaseItemData(MediaBrowser.Controller.Providers.MetadataResult`1<TItemType>,MediaBrowser.Controller.Providers.MetadataResult`1<TItemType>,MediaBrowser.Model.Entities.MetadataField[],System.Boolean,System.Boolean)
MergePeople(System.Collections.Generic.IReadOnlyList`1<MediaBrowser.Controller.Entities.PersonInfo>,System.Collections.Generic.IReadOnlyList`1<MediaBrowser.Controller.Entities.PersonInfo>)
MergeDisplayOrder(MediaBrowser.Controller.Entities.BaseItem,MediaBrowser.Controller.Entities.BaseItem,System.Boolean)
MergeAlbumArtist(MediaBrowser.Controller.Entities.BaseItem,MediaBrowser.Controller.Entities.BaseItem,System.Boolean)
MergeVideoInfo(MediaBrowser.Controller.Entities.BaseItem,MediaBrowser.Controller.Entities.BaseItem,System.Boolean)