1196 lines
45 KiB
C#
1196 lines
45 KiB
C#
#nullable disable
|
|
|
|
#pragma warning disable CS1591
|
|
|
|
using System;
|
|
using System.Collections.Generic;
|
|
using System.Linq;
|
|
using System.Net.Http;
|
|
using System.Threading;
|
|
using System.Threading.Tasks;
|
|
using Jellyfin.Data.Enums;
|
|
using Jellyfin.Extensions;
|
|
using MediaBrowser.Controller.Configuration;
|
|
using MediaBrowser.Controller.Entities;
|
|
using MediaBrowser.Controller.Entities.Audio;
|
|
using MediaBrowser.Controller.Library;
|
|
using MediaBrowser.Controller.Providers;
|
|
using MediaBrowser.Model.Configuration;
|
|
using MediaBrowser.Model.Entities;
|
|
using MediaBrowser.Model.IO;
|
|
using MediaBrowser.Model.Providers;
|
|
using Microsoft.Extensions.Logging;
|
|
|
|
namespace MediaBrowser.Providers.Manager
|
|
{
|
|
public abstract class MetadataService<TItemType, TIdType> : IMetadataService
|
|
where TItemType : BaseItem, IHasLookupInfo<TIdType>, new()
|
|
where TIdType : ItemLookupInfo, new()
|
|
{
|
|
protected MetadataService(IServerConfigurationManager serverConfigurationManager, ILogger<MetadataService<TItemType, TIdType>> logger, IProviderManager providerManager, IFileSystem fileSystem, ILibraryManager libraryManager)
|
|
{
|
|
ServerConfigurationManager = serverConfigurationManager;
|
|
Logger = logger;
|
|
ProviderManager = providerManager;
|
|
FileSystem = fileSystem;
|
|
LibraryManager = libraryManager;
|
|
ImageProvider = new ItemImageProvider(Logger, ProviderManager, FileSystem);
|
|
}
|
|
|
|
protected ItemImageProvider ImageProvider { get; }
|
|
|
|
protected IServerConfigurationManager ServerConfigurationManager { get; }
|
|
|
|
protected ILogger<MetadataService<TItemType, TIdType>> Logger { get; }
|
|
|
|
protected IProviderManager ProviderManager { get; }
|
|
|
|
protected IFileSystem FileSystem { get; }
|
|
|
|
protected ILibraryManager LibraryManager { get; }
|
|
|
|
protected virtual bool EnableUpdatingPremiereDateFromChildren => false;
|
|
|
|
protected virtual bool EnableUpdatingGenresFromChildren => false;
|
|
|
|
protected virtual bool EnableUpdatingStudiosFromChildren => false;
|
|
|
|
protected virtual bool EnableUpdatingOfficialRatingFromChildren => false;
|
|
|
|
public virtual int Order => 0;
|
|
|
|
private FileSystemMetadata TryGetFile(string path, IDirectoryService directoryService)
|
|
{
|
|
try
|
|
{
|
|
return directoryService.GetFile(path);
|
|
}
|
|
catch (Exception ex)
|
|
{
|
|
Logger.LogError(ex, "Error getting file {Path}", path);
|
|
return null;
|
|
}
|
|
}
|
|
|
|
public virtual async Task<ItemUpdateType> RefreshMetadata(BaseItem item, MetadataRefreshOptions refreshOptions, CancellationToken cancellationToken)
|
|
{
|
|
var itemOfType = (TItemType)item;
|
|
|
|
var updateType = ItemUpdateType.None;
|
|
|
|
var libraryOptions = LibraryManager.GetLibraryOptions(item);
|
|
|
|
var requiresRefresh = libraryOptions.AutomaticRefreshIntervalDays > 0 && (DateTime.UtcNow - item.DateLastRefreshed).TotalDays >= libraryOptions.AutomaticRefreshIntervalDays;
|
|
|
|
if (!requiresRefresh && refreshOptions.MetadataRefreshMode != MetadataRefreshMode.None)
|
|
{
|
|
// TODO: If this returns true, should we instead just change metadata refresh mode to Full?
|
|
requiresRefresh = item.RequiresRefresh();
|
|
|
|
if (requiresRefresh)
|
|
{
|
|
Logger.LogDebug("Refreshing {Type} {Item} because item.RequiresRefresh() returned true", typeof(TItemType).Name, item.Path ?? item.Name);
|
|
}
|
|
}
|
|
|
|
var localImagesFailed = false;
|
|
|
|
var allImageProviders = ProviderManager.GetImageProviders(item, refreshOptions).ToList();
|
|
|
|
if (refreshOptions.RemoveOldMetadata && refreshOptions.ReplaceAllImages)
|
|
{
|
|
if (ImageProvider.RemoveImages(item))
|
|
{
|
|
updateType |= ItemUpdateType.ImageUpdate;
|
|
}
|
|
}
|
|
|
|
// Start by validating images
|
|
try
|
|
{
|
|
// Always validate images and check for new locally stored ones.
|
|
if (ImageProvider.ValidateImages(item, allImageProviders.OfType<ILocalImageProvider>(), refreshOptions))
|
|
{
|
|
updateType |= ItemUpdateType.ImageUpdate;
|
|
}
|
|
}
|
|
catch (Exception ex)
|
|
{
|
|
localImagesFailed = true;
|
|
Logger.LogError(ex, "Error validating images for {Item}", item.Path ?? item.Name ?? "Unknown name");
|
|
}
|
|
|
|
var metadataResult = new MetadataResult<TItemType>
|
|
{
|
|
Item = itemOfType
|
|
};
|
|
|
|
bool hasRefreshedMetadata = true;
|
|
bool hasRefreshedImages = true;
|
|
var isFirstRefresh = item.DateLastRefreshed == default;
|
|
|
|
// Next run metadata providers
|
|
if (refreshOptions.MetadataRefreshMode != MetadataRefreshMode.None)
|
|
{
|
|
var providers = GetProviders(item, libraryOptions, refreshOptions, isFirstRefresh, requiresRefresh)
|
|
.ToList();
|
|
|
|
if (providers.Count > 0 || isFirstRefresh || requiresRefresh)
|
|
{
|
|
if (item.BeforeMetadataRefresh(refreshOptions.ReplaceAllMetadata))
|
|
{
|
|
updateType |= ItemUpdateType.MetadataImport;
|
|
}
|
|
}
|
|
|
|
if (providers.Count > 0)
|
|
{
|
|
var id = itemOfType.GetLookupInfo();
|
|
|
|
if (refreshOptions.SearchResult is not null)
|
|
{
|
|
ApplySearchResult(id, refreshOptions.SearchResult);
|
|
}
|
|
|
|
id.IsAutomated = refreshOptions.IsAutomated;
|
|
|
|
var result = await RefreshWithProviders(metadataResult, id, refreshOptions, providers, ImageProvider, cancellationToken).ConfigureAwait(false);
|
|
|
|
updateType |= result.UpdateType;
|
|
if (result.Failures > 0)
|
|
{
|
|
hasRefreshedMetadata = false;
|
|
}
|
|
}
|
|
}
|
|
|
|
// Next run remote image providers, but only if local image providers didn't throw an exception
|
|
if (!localImagesFailed && refreshOptions.ImageRefreshMode != MetadataRefreshMode.ValidationOnly)
|
|
{
|
|
var providers = GetNonLocalImageProviders(item, allImageProviders, refreshOptions).ToList();
|
|
|
|
if (providers.Count > 0)
|
|
{
|
|
var result = await ImageProvider.RefreshImages(itemOfType, libraryOptions, providers, refreshOptions, cancellationToken).ConfigureAwait(false);
|
|
|
|
updateType |= result.UpdateType;
|
|
if (result.Failures > 0)
|
|
{
|
|
hasRefreshedImages = false;
|
|
}
|
|
}
|
|
}
|
|
|
|
var beforeSaveResult = BeforeSave(itemOfType, isFirstRefresh || refreshOptions.ReplaceAllMetadata || refreshOptions.MetadataRefreshMode == MetadataRefreshMode.FullRefresh || requiresRefresh || refreshOptions.ForceSave, updateType);
|
|
updateType |= beforeSaveResult;
|
|
|
|
// Save if changes were made, or it's never been saved before
|
|
if (refreshOptions.ForceSave || updateType > ItemUpdateType.None || isFirstRefresh || refreshOptions.ReplaceAllMetadata || requiresRefresh)
|
|
{
|
|
if (item.IsFileProtocol)
|
|
{
|
|
var file = TryGetFile(item.Path, refreshOptions.DirectoryService);
|
|
if (file is not null)
|
|
{
|
|
item.DateModified = file.LastWriteTimeUtc;
|
|
}
|
|
}
|
|
|
|
// If any of these properties are set then make sure the updateType is not None, just to force everything to save
|
|
if (refreshOptions.ForceSave || refreshOptions.ReplaceAllMetadata)
|
|
{
|
|
updateType |= ItemUpdateType.MetadataDownload;
|
|
}
|
|
|
|
if (hasRefreshedMetadata && hasRefreshedImages)
|
|
{
|
|
item.DateLastRefreshed = DateTime.UtcNow;
|
|
}
|
|
else
|
|
{
|
|
item.DateLastRefreshed = default;
|
|
}
|
|
|
|
// Save to database
|
|
await SaveItemAsync(metadataResult, updateType, cancellationToken).ConfigureAwait(false);
|
|
}
|
|
|
|
await AfterMetadataRefresh(itemOfType, refreshOptions, cancellationToken).ConfigureAwait(false);
|
|
|
|
return updateType;
|
|
}
|
|
|
|
private void ApplySearchResult(ItemLookupInfo lookupInfo, RemoteSearchResult result)
|
|
{
|
|
// Episode and Season do not support Identify, so the search results are the Series'
|
|
switch (lookupInfo)
|
|
{
|
|
case EpisodeInfo episodeInfo:
|
|
episodeInfo.SeriesProviderIds = result.ProviderIds;
|
|
episodeInfo.ProviderIds.Clear();
|
|
break;
|
|
case SeasonInfo seasonInfo:
|
|
seasonInfo.SeriesProviderIds = result.ProviderIds;
|
|
seasonInfo.ProviderIds.Clear();
|
|
break;
|
|
default:
|
|
lookupInfo.ProviderIds = result.ProviderIds;
|
|
lookupInfo.Name = result.Name;
|
|
lookupInfo.Year = result.ProductionYear;
|
|
break;
|
|
}
|
|
}
|
|
|
|
protected async Task SaveItemAsync(MetadataResult<TItemType> result, ItemUpdateType reason, CancellationToken cancellationToken)
|
|
{
|
|
if (result.Item.SupportsPeople && result.People is not null)
|
|
{
|
|
var baseItem = result.Item;
|
|
|
|
await LibraryManager.UpdatePeopleAsync(baseItem, result.People, cancellationToken).ConfigureAwait(false);
|
|
}
|
|
|
|
await result.Item.UpdateToRepositoryAsync(reason, cancellationToken).ConfigureAwait(false);
|
|
}
|
|
|
|
protected virtual Task AfterMetadataRefresh(TItemType item, MetadataRefreshOptions refreshOptions, CancellationToken cancellationToken)
|
|
{
|
|
item.AfterMetadataRefresh();
|
|
return Task.CompletedTask;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Before the save.
|
|
/// </summary>
|
|
/// <param name="item">The item.</param>
|
|
/// <param name="isFullRefresh">if set to <c>true</c> [is full refresh].</param>
|
|
/// <param name="currentUpdateType">Type of the current update.</param>
|
|
/// <returns>ItemUpdateType.</returns>
|
|
private ItemUpdateType BeforeSave(TItemType item, bool isFullRefresh, ItemUpdateType currentUpdateType)
|
|
{
|
|
var updateType = BeforeSaveInternal(item, isFullRefresh, currentUpdateType);
|
|
|
|
updateType |= item.OnMetadataChanged();
|
|
|
|
return updateType;
|
|
}
|
|
|
|
protected virtual ItemUpdateType BeforeSaveInternal(TItemType item, bool isFullRefresh, ItemUpdateType updateType)
|
|
{
|
|
if (EnableUpdateMetadataFromChildren(item, isFullRefresh, updateType))
|
|
{
|
|
if (isFullRefresh || updateType > ItemUpdateType.None)
|
|
{
|
|
var children = GetChildrenForMetadataUpdates(item);
|
|
|
|
updateType = UpdateMetadataFromChildren(item, children, isFullRefresh, updateType);
|
|
}
|
|
}
|
|
|
|
var presentationUniqueKey = item.CreatePresentationUniqueKey();
|
|
if (!string.Equals(item.PresentationUniqueKey, presentationUniqueKey, StringComparison.Ordinal))
|
|
{
|
|
item.PresentationUniqueKey = presentationUniqueKey;
|
|
updateType |= ItemUpdateType.MetadataImport;
|
|
}
|
|
|
|
return updateType;
|
|
}
|
|
|
|
protected virtual bool EnableUpdateMetadataFromChildren(TItemType item, bool isFullRefresh, ItemUpdateType currentUpdateType)
|
|
{
|
|
if (isFullRefresh || currentUpdateType > ItemUpdateType.None)
|
|
{
|
|
if (EnableUpdatingPremiereDateFromChildren || EnableUpdatingGenresFromChildren || EnableUpdatingStudiosFromChildren || EnableUpdatingOfficialRatingFromChildren)
|
|
{
|
|
return true;
|
|
}
|
|
|
|
if (item is Folder folder)
|
|
{
|
|
return folder.SupportsDateLastMediaAdded || folder.SupportsCumulativeRunTimeTicks;
|
|
}
|
|
}
|
|
|
|
return false;
|
|
}
|
|
|
|
protected virtual IList<BaseItem> GetChildrenForMetadataUpdates(TItemType item)
|
|
{
|
|
if (item is Folder folder)
|
|
{
|
|
return folder.GetRecursiveChildren();
|
|
}
|
|
|
|
return Array.Empty<BaseItem>();
|
|
}
|
|
|
|
protected virtual ItemUpdateType UpdateMetadataFromChildren(TItemType item, IList<BaseItem> children, bool isFullRefresh, ItemUpdateType currentUpdateType)
|
|
{
|
|
var updateType = ItemUpdateType.None;
|
|
|
|
if (isFullRefresh || currentUpdateType > ItemUpdateType.None)
|
|
{
|
|
updateType |= UpdateCumulativeRunTimeTicks(item, children);
|
|
updateType |= UpdateDateLastMediaAdded(item, children);
|
|
|
|
// don't update user-changeable metadata for locked items
|
|
if (item.IsLocked)
|
|
{
|
|
return updateType;
|
|
}
|
|
|
|
if (EnableUpdatingPremiereDateFromChildren)
|
|
{
|
|
updateType |= UpdatePremiereDate(item, children);
|
|
}
|
|
|
|
if (EnableUpdatingGenresFromChildren)
|
|
{
|
|
updateType |= UpdateGenres(item, children);
|
|
}
|
|
|
|
if (EnableUpdatingStudiosFromChildren)
|
|
{
|
|
updateType |= UpdateStudios(item, children);
|
|
}
|
|
|
|
if (EnableUpdatingOfficialRatingFromChildren)
|
|
{
|
|
updateType |= UpdateOfficialRating(item, children);
|
|
}
|
|
}
|
|
|
|
return updateType;
|
|
}
|
|
|
|
private ItemUpdateType UpdateCumulativeRunTimeTicks(TItemType item, IList<BaseItem> children)
|
|
{
|
|
if (item is Folder folder && folder.SupportsCumulativeRunTimeTicks)
|
|
{
|
|
long ticks = 0;
|
|
|
|
foreach (var child in children)
|
|
{
|
|
if (!child.IsFolder)
|
|
{
|
|
ticks += child.RunTimeTicks ?? 0;
|
|
}
|
|
}
|
|
|
|
if (!folder.RunTimeTicks.HasValue || folder.RunTimeTicks.Value != ticks)
|
|
{
|
|
folder.RunTimeTicks = ticks;
|
|
return ItemUpdateType.MetadataImport;
|
|
}
|
|
}
|
|
|
|
return ItemUpdateType.None;
|
|
}
|
|
|
|
private ItemUpdateType UpdateDateLastMediaAdded(TItemType item, IList<BaseItem> children)
|
|
{
|
|
var updateType = ItemUpdateType.None;
|
|
|
|
if (item is Folder folder && folder.SupportsDateLastMediaAdded)
|
|
{
|
|
var dateLastMediaAdded = DateTime.MinValue;
|
|
var any = false;
|
|
|
|
foreach (var child in children)
|
|
{
|
|
if (!child.IsFolder)
|
|
{
|
|
var childDateCreated = child.DateCreated;
|
|
if (childDateCreated > dateLastMediaAdded)
|
|
{
|
|
dateLastMediaAdded = childDateCreated;
|
|
}
|
|
|
|
any = true;
|
|
}
|
|
}
|
|
|
|
if ((!folder.DateLastMediaAdded.HasValue && any) || folder.DateLastMediaAdded != dateLastMediaAdded)
|
|
{
|
|
folder.DateLastMediaAdded = dateLastMediaAdded;
|
|
updateType = ItemUpdateType.MetadataImport;
|
|
}
|
|
}
|
|
|
|
return updateType;
|
|
}
|
|
|
|
private ItemUpdateType UpdatePremiereDate(TItemType item, IList<BaseItem> children)
|
|
{
|
|
var updateType = ItemUpdateType.None;
|
|
|
|
if (children.Count == 0)
|
|
{
|
|
return updateType;
|
|
}
|
|
|
|
var date = children.Select(i => i.PremiereDate ?? DateTime.MaxValue).Min();
|
|
|
|
var originalPremiereDate = item.PremiereDate;
|
|
var originalProductionYear = item.ProductionYear;
|
|
|
|
if (date > DateTime.MinValue && date < DateTime.MaxValue)
|
|
{
|
|
item.PremiereDate = date;
|
|
item.ProductionYear = date.Year;
|
|
}
|
|
else
|
|
{
|
|
var year = children.Select(i => i.ProductionYear ?? 0).Min();
|
|
|
|
if (year > 0)
|
|
{
|
|
item.ProductionYear = year;
|
|
}
|
|
}
|
|
|
|
if ((originalPremiereDate ?? DateTime.MinValue) != (item.PremiereDate ?? DateTime.MinValue)
|
|
|| (originalProductionYear ?? -1) != (item.ProductionYear ?? -1))
|
|
{
|
|
updateType |= ItemUpdateType.MetadataEdit;
|
|
}
|
|
|
|
return updateType;
|
|
}
|
|
|
|
private ItemUpdateType UpdateGenres(TItemType item, IList<BaseItem> children)
|
|
{
|
|
var updateType = ItemUpdateType.None;
|
|
|
|
if (!item.LockedFields.Contains(MetadataField.Genres))
|
|
{
|
|
var currentList = item.Genres;
|
|
|
|
item.Genres = children.SelectMany(i => i.Genres)
|
|
.Distinct(StringComparer.OrdinalIgnoreCase)
|
|
.ToArray();
|
|
|
|
if (currentList.Length != item.Genres.Length || !currentList.Order().SequenceEqual(item.Genres.Order(), StringComparer.OrdinalIgnoreCase))
|
|
{
|
|
updateType |= ItemUpdateType.MetadataEdit;
|
|
}
|
|
}
|
|
|
|
return updateType;
|
|
}
|
|
|
|
private ItemUpdateType UpdateStudios(TItemType item, IList<BaseItem> children)
|
|
{
|
|
var updateType = ItemUpdateType.None;
|
|
|
|
if (!item.LockedFields.Contains(MetadataField.Studios))
|
|
{
|
|
var currentList = item.Studios;
|
|
|
|
item.Studios = children.SelectMany(i => i.Studios)
|
|
.Distinct(StringComparer.OrdinalIgnoreCase)
|
|
.ToArray();
|
|
|
|
if (currentList.Length != item.Studios.Length || !currentList.Order().SequenceEqual(item.Studios.Order(), StringComparer.OrdinalIgnoreCase))
|
|
{
|
|
updateType |= ItemUpdateType.MetadataEdit;
|
|
}
|
|
}
|
|
|
|
return updateType;
|
|
}
|
|
|
|
private ItemUpdateType UpdateOfficialRating(TItemType item, IList<BaseItem> children)
|
|
{
|
|
var updateType = ItemUpdateType.None;
|
|
|
|
if (!item.LockedFields.Contains(MetadataField.OfficialRating))
|
|
{
|
|
if (item.UpdateRatingToItems(children))
|
|
{
|
|
updateType |= ItemUpdateType.MetadataEdit;
|
|
}
|
|
}
|
|
|
|
return updateType;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Gets the providers.
|
|
/// </summary>
|
|
/// <param name="item">A media item.</param>
|
|
/// <param name="libraryOptions">The LibraryOptions to use.</param>
|
|
/// <param name="options">The MetadataRefreshOptions to use.</param>
|
|
/// <param name="isFirstRefresh">Specifies first refresh mode.</param>
|
|
/// <param name="requiresRefresh">Specifies refresh mode.</param>
|
|
/// <returns>IEnumerable{`0}.</returns>
|
|
protected IEnumerable<IMetadataProvider> GetProviders(BaseItem item, LibraryOptions libraryOptions, MetadataRefreshOptions options, bool isFirstRefresh, bool requiresRefresh)
|
|
{
|
|
// Get providers to refresh
|
|
var providers = ProviderManager.GetMetadataProviders<TItemType>(item, libraryOptions).ToList();
|
|
|
|
var metadataRefreshMode = options.MetadataRefreshMode;
|
|
|
|
// Run all if either of these flags are true
|
|
var runAllProviders = options.ReplaceAllMetadata ||
|
|
metadataRefreshMode == MetadataRefreshMode.FullRefresh ||
|
|
(isFirstRefresh && metadataRefreshMode >= MetadataRefreshMode.Default) ||
|
|
(requiresRefresh && metadataRefreshMode >= MetadataRefreshMode.Default);
|
|
|
|
if (!runAllProviders)
|
|
{
|
|
var providersWithChanges = providers
|
|
.Where(i =>
|
|
{
|
|
if (i is IHasItemChangeMonitor hasFileChangeMonitor)
|
|
{
|
|
return HasChanged(item, hasFileChangeMonitor, options.DirectoryService);
|
|
}
|
|
|
|
return false;
|
|
})
|
|
.ToList();
|
|
|
|
if (providersWithChanges.Count == 0)
|
|
{
|
|
providers = new List<IMetadataProvider<TItemType>>();
|
|
}
|
|
else
|
|
{
|
|
var anyRemoteProvidersChanged = providersWithChanges.OfType<IRemoteMetadataProvider>()
|
|
.Any();
|
|
|
|
var anyLocalProvidersChanged = providersWithChanges.OfType<ILocalMetadataProvider>()
|
|
.Any();
|
|
|
|
var anyLocalPreRefreshProvidersChanged = providersWithChanges.OfType<IPreRefreshProvider>()
|
|
.Any();
|
|
|
|
providers = providers.Where(i =>
|
|
{
|
|
// If any provider reports a change, always run local ones as well
|
|
if (i is ILocalMetadataProvider)
|
|
{
|
|
return anyRemoteProvidersChanged || anyLocalProvidersChanged || anyLocalPreRefreshProvidersChanged;
|
|
}
|
|
|
|
// If any remote providers changed, run them all so that priorities can be honored
|
|
if (i is IRemoteMetadataProvider)
|
|
{
|
|
if (options.MetadataRefreshMode == MetadataRefreshMode.ValidationOnly)
|
|
{
|
|
return false;
|
|
}
|
|
|
|
return anyRemoteProvidersChanged;
|
|
}
|
|
|
|
// Run custom refresh providers if they report a change or any remote providers change
|
|
return anyRemoteProvidersChanged || providersWithChanges.Contains(i);
|
|
}).ToList();
|
|
}
|
|
}
|
|
|
|
return providers;
|
|
}
|
|
|
|
protected virtual IEnumerable<IImageProvider> GetNonLocalImageProviders(BaseItem item, IEnumerable<IImageProvider> allImageProviders, ImageRefreshOptions options)
|
|
{
|
|
// Get providers to refresh
|
|
var providers = allImageProviders.Where(i => i is not ILocalImageProvider);
|
|
|
|
var dateLastImageRefresh = item.DateLastRefreshed;
|
|
|
|
// Run all if either of these flags are true
|
|
var runAllProviders = options.ImageRefreshMode == MetadataRefreshMode.FullRefresh || dateLastImageRefresh == default(DateTime);
|
|
|
|
if (!runAllProviders)
|
|
{
|
|
providers = providers
|
|
.Where(i =>
|
|
{
|
|
if (i is IHasItemChangeMonitor hasFileChangeMonitor)
|
|
{
|
|
return HasChanged(item, hasFileChangeMonitor, options.DirectoryService);
|
|
}
|
|
|
|
return false;
|
|
});
|
|
}
|
|
|
|
return providers;
|
|
}
|
|
|
|
public bool CanRefresh(BaseItem item)
|
|
{
|
|
return item is TItemType;
|
|
}
|
|
|
|
public bool CanRefreshPrimary(Type type)
|
|
{
|
|
return type == typeof(TItemType);
|
|
}
|
|
|
|
protected virtual async Task<RefreshResult> RefreshWithProviders(
|
|
MetadataResult<TItemType> metadata,
|
|
TIdType id,
|
|
MetadataRefreshOptions options,
|
|
ICollection<IMetadataProvider> providers,
|
|
ItemImageProvider imageService,
|
|
CancellationToken cancellationToken)
|
|
{
|
|
var refreshResult = new RefreshResult
|
|
{
|
|
UpdateType = ItemUpdateType.None
|
|
};
|
|
|
|
var item = metadata.Item;
|
|
|
|
var customProviders = providers.OfType<ICustomMetadataProvider<TItemType>>().ToList();
|
|
var logName = !item.IsFileProtocol ? item.Name ?? item.Path : item.Path ?? item.Name;
|
|
|
|
foreach (var provider in customProviders.Where(i => i is IPreRefreshProvider))
|
|
{
|
|
await RunCustomProvider(provider, item, logName, options, refreshResult, cancellationToken).ConfigureAwait(false);
|
|
}
|
|
|
|
var temp = new MetadataResult<TItemType>
|
|
{
|
|
Item = CreateNew()
|
|
};
|
|
temp.Item.Path = item.Path;
|
|
|
|
// If replacing all metadata, run internet providers first
|
|
if (options.ReplaceAllMetadata)
|
|
{
|
|
var remoteResult = await ExecuteRemoteProviders(temp, logName, id, providers.OfType<IRemoteMetadataProvider<TItemType, TIdType>>(), cancellationToken)
|
|
.ConfigureAwait(false);
|
|
|
|
refreshResult.UpdateType |= remoteResult.UpdateType;
|
|
refreshResult.ErrorMessage = remoteResult.ErrorMessage;
|
|
refreshResult.Failures += remoteResult.Failures;
|
|
}
|
|
|
|
var hasLocalMetadata = false;
|
|
var foundImageTypes = new List<ImageType>();
|
|
|
|
foreach (var provider in providers.OfType<ILocalMetadataProvider<TItemType>>())
|
|
{
|
|
var providerName = provider.GetType().Name;
|
|
Logger.LogDebug("Running {Provider} for {Item}", providerName, logName);
|
|
|
|
var itemInfo = new ItemInfo(item);
|
|
|
|
try
|
|
{
|
|
var localItem = await provider.GetMetadata(itemInfo, options.DirectoryService, cancellationToken).ConfigureAwait(false);
|
|
|
|
if (localItem.HasMetadata)
|
|
{
|
|
foreach (var remoteImage in localItem.RemoteImages)
|
|
{
|
|
try
|
|
{
|
|
if (item.ImageInfos.Any(x => x.Type == remoteImage.Type)
|
|
&& !options.IsReplacingImage(remoteImage.Type))
|
|
{
|
|
continue;
|
|
}
|
|
|
|
await ProviderManager.SaveImage(item, remoteImage.Url, remoteImage.Type, null, cancellationToken).ConfigureAwait(false);
|
|
refreshResult.UpdateType |= ItemUpdateType.ImageUpdate;
|
|
|
|
// remember imagetype that has just been downloaded
|
|
foundImageTypes.Add(remoteImage.Type);
|
|
}
|
|
catch (HttpRequestException ex)
|
|
{
|
|
Logger.LogError(ex, "Could not save {ImageType} image: {Url}", Enum.GetName(remoteImage.Type), remoteImage.Url);
|
|
}
|
|
}
|
|
|
|
if (foundImageTypes.Count > 0)
|
|
{
|
|
imageService.UpdateReplaceImages(options, foundImageTypes);
|
|
}
|
|
|
|
if (imageService.MergeImages(item, localItem.Images, options))
|
|
{
|
|
refreshResult.UpdateType |= ItemUpdateType.ImageUpdate;
|
|
}
|
|
|
|
MergeData(localItem, temp, Array.Empty<MetadataField>(), options.ReplaceAllMetadata, true);
|
|
refreshResult.UpdateType |= ItemUpdateType.MetadataImport;
|
|
|
|
// Only one local provider allowed per item
|
|
if (item.IsLocked || localItem.Item.IsLocked || IsFullLocalMetadata(localItem.Item))
|
|
{
|
|
hasLocalMetadata = true;
|
|
}
|
|
|
|
break;
|
|
}
|
|
|
|
Logger.LogDebug("{Provider} returned no metadata for {Item}", providerName, logName);
|
|
}
|
|
catch (OperationCanceledException)
|
|
{
|
|
throw;
|
|
}
|
|
catch (Exception ex)
|
|
{
|
|
Logger.LogError(ex, "Error in {Provider}", provider.Name);
|
|
|
|
// If a local provider fails, consider that a failure
|
|
refreshResult.ErrorMessage = ex.Message;
|
|
}
|
|
}
|
|
|
|
// Local metadata is king - if any is found don't run remote providers
|
|
if (!options.ReplaceAllMetadata && (!hasLocalMetadata || options.MetadataRefreshMode == MetadataRefreshMode.FullRefresh || !item.StopRefreshIfLocalMetadataFound))
|
|
{
|
|
var remoteResult = await ExecuteRemoteProviders(temp, logName, id, providers.OfType<IRemoteMetadataProvider<TItemType, TIdType>>(), cancellationToken)
|
|
.ConfigureAwait(false);
|
|
|
|
refreshResult.UpdateType |= remoteResult.UpdateType;
|
|
refreshResult.ErrorMessage = remoteResult.ErrorMessage;
|
|
refreshResult.Failures += remoteResult.Failures;
|
|
}
|
|
|
|
if (providers.Any(i => i is not ICustomMetadataProvider))
|
|
{
|
|
if (refreshResult.UpdateType > ItemUpdateType.None)
|
|
{
|
|
if (hasLocalMetadata)
|
|
{
|
|
MergeData(temp, metadata, item.LockedFields, true, true);
|
|
}
|
|
else
|
|
{
|
|
if (!options.RemoveOldMetadata)
|
|
{
|
|
MergeData(metadata, temp, Array.Empty<MetadataField>(), false, false);
|
|
}
|
|
|
|
// Will always replace all metadata when Scan for new and updated files is used. Else, follow the options.
|
|
MergeData(temp, metadata, item.LockedFields, options.MetadataRefreshMode == MetadataRefreshMode.Default || options.ReplaceAllMetadata, false);
|
|
}
|
|
}
|
|
}
|
|
|
|
foreach (var provider in customProviders.Where(i => i is not IPreRefreshProvider))
|
|
{
|
|
await RunCustomProvider(provider, item, logName, options, refreshResult, cancellationToken).ConfigureAwait(false);
|
|
}
|
|
|
|
return refreshResult;
|
|
}
|
|
|
|
protected virtual bool IsFullLocalMetadata(TItemType item)
|
|
{
|
|
if (string.IsNullOrWhiteSpace(item.Name))
|
|
{
|
|
return false;
|
|
}
|
|
|
|
return true;
|
|
}
|
|
|
|
private async Task RunCustomProvider(ICustomMetadataProvider<TItemType> provider, TItemType item, string logName, MetadataRefreshOptions options, RefreshResult refreshResult, CancellationToken cancellationToken)
|
|
{
|
|
Logger.LogDebug("Running {Provider} for {Item}", provider.GetType().Name, logName);
|
|
|
|
try
|
|
{
|
|
refreshResult.UpdateType |= await provider.FetchAsync(item, options, cancellationToken).ConfigureAwait(false);
|
|
}
|
|
catch (OperationCanceledException)
|
|
{
|
|
throw;
|
|
}
|
|
catch (Exception ex)
|
|
{
|
|
refreshResult.ErrorMessage = ex.Message;
|
|
Logger.LogError(ex, "Error in {Provider}", provider.Name);
|
|
}
|
|
}
|
|
|
|
protected virtual TItemType CreateNew()
|
|
{
|
|
return new TItemType();
|
|
}
|
|
|
|
private async Task<RefreshResult> ExecuteRemoteProviders(MetadataResult<TItemType> temp, string logName, TIdType id, IEnumerable<IRemoteMetadataProvider<TItemType, TIdType>> providers, CancellationToken cancellationToken)
|
|
{
|
|
var refreshResult = new RefreshResult();
|
|
|
|
var tmpDataMerged = false;
|
|
|
|
foreach (var provider in providers)
|
|
{
|
|
var providerName = provider.GetType().Name;
|
|
Logger.LogDebug("Running {Provider} for {Item}", providerName, logName);
|
|
|
|
if (id is not null && !tmpDataMerged)
|
|
{
|
|
MergeNewData(temp.Item, id);
|
|
tmpDataMerged = true;
|
|
}
|
|
|
|
try
|
|
{
|
|
var result = await provider.GetMetadata(id, cancellationToken).ConfigureAwait(false);
|
|
|
|
if (result.HasMetadata)
|
|
{
|
|
result.Provider = provider.Name;
|
|
|
|
MergeData(result, temp, Array.Empty<MetadataField>(), false, false);
|
|
MergeNewData(temp.Item, id);
|
|
|
|
refreshResult.UpdateType |= ItemUpdateType.MetadataDownload;
|
|
}
|
|
else
|
|
{
|
|
Logger.LogDebug("{Provider} returned no metadata for {Item}", providerName, logName);
|
|
}
|
|
}
|
|
catch (OperationCanceledException)
|
|
{
|
|
throw;
|
|
}
|
|
catch (Exception ex)
|
|
{
|
|
refreshResult.Failures++;
|
|
refreshResult.ErrorMessage = ex.Message;
|
|
Logger.LogError(ex, "Error in {Provider}", provider.Name);
|
|
}
|
|
}
|
|
|
|
return refreshResult;
|
|
}
|
|
|
|
private void MergeNewData(TItemType source, TIdType lookupInfo)
|
|
{
|
|
// Copy new provider id's that may have been obtained
|
|
foreach (var providerId in source.ProviderIds)
|
|
{
|
|
var key = providerId.Key;
|
|
|
|
// Don't replace existing Id's.
|
|
lookupInfo.ProviderIds.TryAdd(key, providerId.Value);
|
|
}
|
|
}
|
|
|
|
private bool HasChanged(BaseItem item, IHasItemChangeMonitor changeMonitor, IDirectoryService directoryService)
|
|
{
|
|
try
|
|
{
|
|
var hasChanged = changeMonitor.HasChanged(item, directoryService);
|
|
|
|
if (hasChanged)
|
|
{
|
|
Logger.LogDebug("{Monitor} reports change to {Item}", changeMonitor.GetType().Name, item.Path ?? item.Name);
|
|
}
|
|
|
|
return hasChanged;
|
|
}
|
|
catch (Exception ex)
|
|
{
|
|
Logger.LogError(ex, "Error in {Monitor}.HasChanged", changeMonitor.GetType().Name);
|
|
return false;
|
|
}
|
|
}
|
|
|
|
/// <summary>
|
|
/// Merges metadata from source into target.
|
|
/// </summary>
|
|
/// <param name="source">The source for new metadata.</param>
|
|
/// <param name="target">The target to insert new metadata into.</param>
|
|
/// <param name="lockedFields">The fields that are locked and should not be updated.</param>
|
|
/// <param name="replaceData"><c>true</c> if existing data should be replaced.</param>
|
|
/// <param name="mergeMetadataSettings"><c>true</c> if the metadata settings in target should be updated to match source.</param>
|
|
/// <exception cref="ArgumentException">Thrown if source or target are null.</exception>
|
|
protected virtual void MergeData(
|
|
MetadataResult<TItemType> source,
|
|
MetadataResult<TItemType> target,
|
|
MetadataField[] lockedFields,
|
|
bool replaceData,
|
|
bool mergeMetadataSettings)
|
|
{
|
|
MergeBaseItemData(source, target, lockedFields, replaceData, mergeMetadataSettings);
|
|
}
|
|
|
|
internal static void MergeBaseItemData(
|
|
MetadataResult<TItemType> sourceResult,
|
|
MetadataResult<TItemType> targetResult,
|
|
MetadataField[] lockedFields,
|
|
bool replaceData,
|
|
bool mergeMetadataSettings)
|
|
{
|
|
var source = sourceResult.Item;
|
|
var target = targetResult.Item;
|
|
|
|
ArgumentNullException.ThrowIfNull(sourceResult);
|
|
ArgumentNullException.ThrowIfNull(targetResult);
|
|
|
|
if (!lockedFields.Contains(MetadataField.Name))
|
|
{
|
|
if (replaceData || string.IsNullOrEmpty(target.Name))
|
|
{
|
|
// Safeguard against incoming data having an empty name
|
|
if (!string.IsNullOrWhiteSpace(source.Name))
|
|
{
|
|
target.Name = source.Name;
|
|
}
|
|
}
|
|
}
|
|
|
|
if (replaceData || string.IsNullOrEmpty(target.OriginalTitle))
|
|
{
|
|
// Safeguard against incoming data having an empty name
|
|
if (!string.IsNullOrWhiteSpace(source.OriginalTitle))
|
|
{
|
|
target.OriginalTitle = source.OriginalTitle;
|
|
}
|
|
}
|
|
|
|
if (replaceData || !target.CommunityRating.HasValue)
|
|
{
|
|
target.CommunityRating = source.CommunityRating;
|
|
}
|
|
|
|
if (replaceData || !target.EndDate.HasValue)
|
|
{
|
|
target.EndDate = source.EndDate;
|
|
}
|
|
|
|
if (!lockedFields.Contains(MetadataField.Genres))
|
|
{
|
|
if (replaceData || target.Genres.Length == 0)
|
|
{
|
|
target.Genres = source.Genres;
|
|
}
|
|
}
|
|
|
|
if (replaceData || !target.IndexNumber.HasValue)
|
|
{
|
|
target.IndexNumber = source.IndexNumber;
|
|
}
|
|
|
|
if (!lockedFields.Contains(MetadataField.OfficialRating))
|
|
{
|
|
if (replaceData || string.IsNullOrEmpty(target.OfficialRating))
|
|
{
|
|
target.OfficialRating = source.OfficialRating;
|
|
}
|
|
}
|
|
|
|
if (replaceData || string.IsNullOrEmpty(target.CustomRating))
|
|
{
|
|
target.CustomRating = source.CustomRating;
|
|
}
|
|
|
|
if (replaceData || string.IsNullOrEmpty(target.Tagline))
|
|
{
|
|
target.Tagline = source.Tagline;
|
|
}
|
|
|
|
if (!lockedFields.Contains(MetadataField.Overview))
|
|
{
|
|
if (replaceData || string.IsNullOrEmpty(target.Overview))
|
|
{
|
|
target.Overview = source.Overview;
|
|
}
|
|
}
|
|
|
|
if (replaceData || !target.ParentIndexNumber.HasValue)
|
|
{
|
|
target.ParentIndexNumber = source.ParentIndexNumber;
|
|
}
|
|
|
|
if (!lockedFields.Contains(MetadataField.Cast))
|
|
{
|
|
if (replaceData || targetResult.People is null || targetResult.People.Count == 0)
|
|
{
|
|
targetResult.People = sourceResult.People;
|
|
}
|
|
else if (targetResult.People is not null && sourceResult.People is not null)
|
|
{
|
|
MergePeople(sourceResult.People, targetResult.People);
|
|
}
|
|
}
|
|
|
|
if (replaceData || !target.PremiereDate.HasValue)
|
|
{
|
|
target.PremiereDate = source.PremiereDate;
|
|
}
|
|
|
|
if (replaceData || !target.ProductionYear.HasValue)
|
|
{
|
|
target.ProductionYear = source.ProductionYear;
|
|
}
|
|
|
|
if (!lockedFields.Contains(MetadataField.Runtime))
|
|
{
|
|
if (replaceData || !target.RunTimeTicks.HasValue)
|
|
{
|
|
if (target is not Audio && target is not Video)
|
|
{
|
|
target.RunTimeTicks = source.RunTimeTicks;
|
|
}
|
|
}
|
|
}
|
|
|
|
if (!lockedFields.Contains(MetadataField.Studios))
|
|
{
|
|
if (replaceData || target.Studios.Length == 0)
|
|
{
|
|
target.Studios = source.Studios;
|
|
}
|
|
}
|
|
|
|
if (!lockedFields.Contains(MetadataField.Tags))
|
|
{
|
|
if (replaceData || target.Tags.Length == 0)
|
|
{
|
|
target.Tags = source.Tags;
|
|
}
|
|
}
|
|
|
|
if (!lockedFields.Contains(MetadataField.ProductionLocations))
|
|
{
|
|
if (replaceData || target.ProductionLocations.Length == 0)
|
|
{
|
|
target.ProductionLocations = source.ProductionLocations;
|
|
}
|
|
}
|
|
|
|
foreach (var id in source.ProviderIds)
|
|
{
|
|
var key = id.Key;
|
|
|
|
// Don't replace existing Id's.
|
|
if (replaceData)
|
|
{
|
|
target.ProviderIds[key] = id.Value;
|
|
}
|
|
else
|
|
{
|
|
target.ProviderIds.TryAdd(key, id.Value);
|
|
}
|
|
}
|
|
|
|
MergeAlbumArtist(source, target, replaceData);
|
|
MergeCriticRating(source, target, replaceData);
|
|
MergeTrailers(source, target, replaceData);
|
|
MergeVideoInfo(source, target, replaceData);
|
|
MergeDisplayOrder(source, target, replaceData);
|
|
|
|
if (replaceData || string.IsNullOrEmpty(target.ForcedSortName))
|
|
{
|
|
var forcedSortName = source.ForcedSortName;
|
|
|
|
if (!string.IsNullOrWhiteSpace(forcedSortName))
|
|
{
|
|
target.ForcedSortName = forcedSortName;
|
|
}
|
|
}
|
|
|
|
if (mergeMetadataSettings)
|
|
{
|
|
target.LockedFields = source.LockedFields;
|
|
target.IsLocked = source.IsLocked;
|
|
|
|
// Grab the value if it's there, but if not then don't overwrite with the default
|
|
if (source.DateCreated != default)
|
|
{
|
|
target.DateCreated = source.DateCreated;
|
|
}
|
|
|
|
target.PreferredMetadataCountryCode = source.PreferredMetadataCountryCode;
|
|
target.PreferredMetadataLanguage = source.PreferredMetadataLanguage;
|
|
}
|
|
}
|
|
|
|
private static void MergePeople(List<PersonInfo> source, List<PersonInfo> target)
|
|
{
|
|
foreach (var person in target)
|
|
{
|
|
var normalizedName = person.Name.RemoveDiacritics();
|
|
var personInSource = source.FirstOrDefault(i => string.Equals(i.Name.RemoveDiacritics(), normalizedName, StringComparison.OrdinalIgnoreCase));
|
|
|
|
if (personInSource is not null)
|
|
{
|
|
foreach (var providerId in personInSource.ProviderIds)
|
|
{
|
|
person.ProviderIds.TryAdd(providerId.Key, providerId.Value);
|
|
}
|
|
|
|
if (string.IsNullOrWhiteSpace(person.ImageUrl))
|
|
{
|
|
person.ImageUrl = personInSource.ImageUrl;
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
private static void MergeDisplayOrder(BaseItem source, BaseItem target, bool replaceData)
|
|
{
|
|
if (source is IHasDisplayOrder sourceHasDisplayOrder
|
|
&& target is IHasDisplayOrder targetHasDisplayOrder)
|
|
{
|
|
if (replaceData || string.IsNullOrEmpty(targetHasDisplayOrder.DisplayOrder))
|
|
{
|
|
var displayOrder = sourceHasDisplayOrder.DisplayOrder;
|
|
|
|
if (!string.IsNullOrWhiteSpace(displayOrder))
|
|
{
|
|
targetHasDisplayOrder.DisplayOrder = displayOrder;
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
private static void MergeAlbumArtist(BaseItem source, BaseItem target, bool replaceData)
|
|
{
|
|
if (source is IHasAlbumArtist sourceHasAlbumArtist
|
|
&& target is IHasAlbumArtist targetHasAlbumArtist)
|
|
{
|
|
if (replaceData || targetHasAlbumArtist.AlbumArtists.Count == 0)
|
|
{
|
|
targetHasAlbumArtist.AlbumArtists = sourceHasAlbumArtist.AlbumArtists;
|
|
}
|
|
}
|
|
}
|
|
|
|
private static void MergeCriticRating(BaseItem source, BaseItem target, bool replaceData)
|
|
{
|
|
if (replaceData || !target.CriticRating.HasValue)
|
|
{
|
|
target.CriticRating = source.CriticRating;
|
|
}
|
|
}
|
|
|
|
private static void MergeTrailers(BaseItem source, BaseItem target, bool replaceData)
|
|
{
|
|
if (replaceData || target.RemoteTrailers.Count == 0)
|
|
{
|
|
target.RemoteTrailers = source.RemoteTrailers;
|
|
}
|
|
}
|
|
|
|
private static void MergeVideoInfo(BaseItem source, BaseItem target, bool replaceData)
|
|
{
|
|
if (source is Video sourceCast && target is Video targetCast)
|
|
{
|
|
if (replaceData || targetCast.Video3DFormat is null)
|
|
{
|
|
targetCast.Video3DFormat = sourceCast.Video3DFormat;
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|