From e2a86c67ec964cc7ce9801edcececcf51093b063 Mon Sep 17 00:00:00 2001
From: Maximo Piva <mpiva@adventintermodal.com>
Date: Thu, 15 Aug 2024 08:25:39 -0300
Subject: [PATCH 01/30] Add JXL Support.

---
 .../ApplicationServiceExtensions.cs           |  7 ++-
 API/Services/ArchiveService.cs                | 12 ++--
 .../JpegXLImageConverterProvider.cs           | 29 +++++++++
 API/Services/ImageConverterService.cs         | 62 +++++++++++++++++++
 API/Services/ImageService.cs                  |  8 ++-
 API/Services/Tasks/Scanner/Parser/Parser.cs   |  2 +-
 Kavita.Common/EnvironmentInfo/IOsInfo.cs      |  6 +-
 7 files changed, 115 insertions(+), 11 deletions(-)
 create mode 100644 API/Services/ImageConversion/JpegXLImageConverterProvider.cs
 create mode 100644 API/Services/ImageConverterService.cs

diff --git a/API/Extensions/ApplicationServiceExtensions.cs b/API/Extensions/ApplicationServiceExtensions.cs
index f68b4461d..011acffc5 100644
--- a/API/Extensions/ApplicationServiceExtensions.cs
+++ b/API/Extensions/ApplicationServiceExtensions.cs
@@ -1,8 +1,9 @@
-using System.IO.Abstractions;
+using System.IO.Abstractions;
 using API.Constants;
 using API.Data;
 using API.Helpers;
 using API.Services;
+using API.Services.ImageConversion;
 using API.Services.Plus;
 using API.Services.Tasks;
 using API.Services.Tasks.Metadata;
@@ -33,6 +34,10 @@ public static void AddApplicationServices(this IServiceCollection services, ICon
         services.AddScoped<ITaskScheduler, TaskScheduler>();
         services.AddScoped<ICacheService, CacheService>();
         services.AddScoped<IArchiveService, ArchiveService>();
+
+        services.AddScoped<IImageConverterProvider, JpegXLImageConverterProvider>();
+        services.AddScoped<IImageConverterService, ImageConverterService>();
+
         services.AddScoped<IBackupService, BackupService>();
         services.AddScoped<ICleanupService, CleanupService>();
         services.AddScoped<IBookService, BookService>();
diff --git a/API/Services/ArchiveService.cs b/API/Services/ArchiveService.cs
index 120cbf3f7..8a4284402 100644
--- a/API/Services/ArchiveService.cs
+++ b/API/Services/ArchiveService.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Collections.Generic;
 using System.Diagnostics;
 using System.IO;
@@ -58,15 +58,17 @@ public class ArchiveService : IArchiveService
     private readonly IDirectoryService _directoryService;
     private readonly IImageService _imageService;
     private readonly IMediaErrorService _mediaErrorService;
+    private readonly IImageConverterService _converterService;
     private const string ComicInfoFilename = "ComicInfo.xml";
 
     public ArchiveService(ILogger<ArchiveService> logger, IDirectoryService directoryService,
-        IImageService imageService, IMediaErrorService mediaErrorService)
+        IImageService imageService, IMediaErrorService mediaErrorService, IImageConverterService converterService)
     {
         _logger = logger;
         _directoryService = directoryService;
         _imageService = imageService;
         _mediaErrorService = mediaErrorService;
+        _converterService = converterService;
     }
 
     /// <summary>
@@ -231,7 +233,7 @@ public string GetCoverImage(string archivePath, string fileName, string outputDi
                     var entryName = FindCoverImageFilename(archivePath, archive.Entries.Select(e => e.FullName));
                     var entry = archive.Entries.Single(e => e.FullName == entryName);
 
-                    using var stream = entry.Open();
+                    using var stream = _converterService.ConvertStream(entryName, entry.Open());
                     return _imageService.WriteCoverThumbnail(stream, fileName, outputDirectory, format, size);
                 }
                 case ArchiveLibrary.SharpCompress:
@@ -242,7 +244,7 @@ public string GetCoverImage(string archivePath, string fileName, string outputDi
                     var entryName = FindCoverImageFilename(archivePath, entryNames);
                     var entry = archive.Entries.Single(e => e.Key == entryName);
 
-                    using var stream = entry.OpenEntryStream();
+                    using var stream = _converterService.ConvertStream(entryName, entry.OpenEntryStream());
                     return _imageService.WriteCoverThumbnail(stream, fileName, outputDirectory, format, size);
                 }
                 case ArchiveLibrary.NotSupported:
@@ -560,6 +562,7 @@ public void ExtractArchive(string archivePath, string extractPath)
                 {
                     using var archive = ZipFile.OpenRead(archivePath);
                     ExtractArchiveEntries(archive, extractPath);
+                    _converterService.ConvertDirectory(extractPath);
                     break;
                 }
                 case ArchiveLibrary.SharpCompress:
@@ -568,6 +571,7 @@ public void ExtractArchive(string archivePath, string extractPath)
                     ExtractArchiveEntities(archive.Entries.Where(entry => !entry.IsDirectory
                                                                           && !Tasks.Scanner.Parser.Parser.HasBlacklistedFolderInPath(Path.GetDirectoryName(entry.Key) ?? string.Empty)
                                                                           && Tasks.Scanner.Parser.Parser.IsImage(entry.Key)), extractPath);
+                    _converterService.ConvertDirectory(extractPath);
                     break;
                 }
                 case ArchiveLibrary.NotSupported:
diff --git a/API/Services/ImageConversion/JpegXLImageConverterProvider.cs b/API/Services/ImageConversion/JpegXLImageConverterProvider.cs
new file mode 100644
index 000000000..866587d6a
--- /dev/null
+++ b/API/Services/ImageConversion/JpegXLImageConverterProvider.cs
@@ -0,0 +1,29 @@
+using System;
+using System.IO;
+using System.Threading;
+using Kavita.Common.EnvironmentInfo;
+
+namespace API.Services.ImageConversion;
+
+public interface IImageConverterProvider
+{
+    string Extension { get; }
+    bool IsSupported(string filename);
+    string Convert(string filename);
+}
+
+public class JpegXLImageConverterProvider : IImageConverterProvider
+{
+    public bool IsSupported(string filename) => filename.EndsWith(".jxl", StringComparison.InvariantCultureIgnoreCase);
+    public string Extension => ".jxl";
+    public string Convert(string filename)
+    {
+        string exe = "djxl";
+        if (OsInfo.IsWindows)
+            exe = "djxl.exe";
+        string destination = Path.ChangeExtension(filename, "jpg");
+        OsInfo.RunAndCapture(exe, "\"" + filename + "\" \"" + destination + "\"", Timeout.Infinite);
+        File.Delete(filename);
+        return destination;
+    }
+}
diff --git a/API/Services/ImageConverterService.cs b/API/Services/ImageConverterService.cs
new file mode 100644
index 000000000..08cab27a8
--- /dev/null
+++ b/API/Services/ImageConverterService.cs
@@ -0,0 +1,62 @@
+using NetVips;
+using System.Collections;
+using System.Collections.Generic;
+using System.IO;
+using System.IO.Abstractions;
+using System.Linq;
+using API.Services.ImageConversion;
+using static Org.BouncyCastle.Bcpg.Attr.ImageAttrib;
+
+namespace API.Services
+{
+    public interface IImageConverterService
+    {
+        Stream ConvertStream(string filename, Stream source);
+        string ConvertFile(string filename);
+        void ConvertDirectory(string directory);
+    }
+
+    public class ImageConverterService : IImageConverterService
+    {
+        private IEnumerable<IImageConverterProvider> _converters;
+        private readonly IDirectoryService _directoryService;
+        public ImageConverterService(IDirectoryService directoryService, IEnumerable<IImageConverterProvider> converters)
+        {
+            _directoryService = directoryService;
+            _converters = converters;
+        }
+
+
+
+        public Stream ConvertStream(string filename, Stream source)
+        {
+            IImageConverterProvider provider = _converters.FirstOrDefault(a => a.IsSupported(filename));
+            if (provider == null)
+                return source;
+            string tempFile = Path.ChangeExtension(Path.GetFileName(filename), provider.Extension);
+            Stream dest = File.OpenWrite(tempFile);
+            source.CopyTo(dest);
+            source.Close();
+            dest.Close();
+            return File.OpenRead(provider.Convert(tempFile));
+        }
+
+        public string ConvertFile(string filename)
+        {
+            IImageConverterProvider provider = _converters.FirstOrDefault(a => a.IsSupported(filename));
+            if (provider == null)
+                return filename;
+            return provider.Convert(filename);
+        }
+
+        public void ConvertDirectory(string directory)
+        {
+            foreach (string filename in Directory.GetFiles(directory, "*.*", SearchOption.AllDirectories))
+            {
+                IImageConverterProvider provider = _converters.FirstOrDefault(a => a.IsSupported(filename));
+                if (provider != null)
+                    provider.Convert(filename);
+            }
+        }
+    }
+}
diff --git a/API/Services/ImageService.cs b/API/Services/ImageService.cs
index ad6829b7d..9dc31038d 100644
--- a/API/Services/ImageService.cs
+++ b/API/Services/ImageService.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Collections.Generic;
 using System.Drawing;
 using System.IO;
@@ -76,6 +76,7 @@ public class ImageService : IImageService
     private readonly ILogger<ImageService> _logger;
     private readonly IDirectoryService _directoryService;
     private readonly IEasyCachingProviderFactory _cacheFactory;
+    private readonly IImageConverterService _converterService;
     public const string ChapterCoverImageRegex = @"v\d+_c\d+";
     public const string SeriesCoverImageRegex = @"series\d+";
     public const string CollectionTagCoverImageRegex = @"tag\d+";
@@ -114,11 +115,12 @@ public class ImageService : IImageService
         ["https://app.plex.tv"] = "https://plex.tv"
     };
 
-    public ImageService(ILogger<ImageService> logger, IDirectoryService directoryService, IEasyCachingProviderFactory cacheFactory)
+    public ImageService(ILogger<ImageService> logger, IDirectoryService directoryService, IEasyCachingProviderFactory cacheFactory, IImageConverterService converterService)
     {
         _logger = logger;
         _directoryService = directoryService;
         _cacheFactory = cacheFactory;
+        _converterService = converterService;
     }
 
     public void ExtractImages(string? fileFilePath, string targetDirectory, int fileCount = 1)
@@ -134,6 +136,7 @@ public void ExtractImages(string? fileFilePath, string targetDirectory, int file
             _directoryService.CopyDirectoryToDirectory(_directoryService.FileSystem.Path.GetDirectoryName(fileFilePath), targetDirectory,
                 Tasks.Scanner.Parser.Parser.ImageFileExtensions);
         }
+        _converterService.ConvertDirectory(targetDirectory);
     }
 
     /// <summary>
@@ -214,6 +217,7 @@ public string GetCoverImage(string path, string fileName, string outputDirectory
 
         try
         {
+            fileName = _converterService.ConvertFile(fileName);
             var (width, height) = size.GetDimensions();
             using var sourceImage = Image.NewFromFile(path, false, Enums.Access.SequentialUnbuffered);
 
diff --git a/API/Services/Tasks/Scanner/Parser/Parser.cs b/API/Services/Tasks/Scanner/Parser/Parser.cs
index 840e7a6d8..78f784cdd 100644
--- a/API/Services/Tasks/Scanner/Parser/Parser.cs
+++ b/API/Services/Tasks/Scanner/Parser/Parser.cs
@@ -25,7 +25,7 @@ public static class Parser
 
     public static readonly TimeSpan RegexTimeout = TimeSpan.FromMilliseconds(500);
 
-    public const string ImageFileExtensions = @"^(\.png|\.jpeg|\.jpg|\.webp|\.gif|\.avif)"; // Don't forget to update CoverChooser
+    public const string ImageFileExtensions = @"^(\.png|\.jpeg|\.jpg|\.webp|\.gif|\.avif|\.jxl)"; // Don't forget to update CoverChooser
     public const string ArchiveFileExtensions = @"\.cbz|\.zip|\.rar|\.cbr|\.tar.gz|\.7zip|\.7z|\.cb7|\.cbt";
     public const string EpubFileExtension = @"\.epub";
     public const string PdfFileExtension = @"\.pdf";
diff --git a/Kavita.Common/EnvironmentInfo/IOsInfo.cs b/Kavita.Common/EnvironmentInfo/IOsInfo.cs
index d8cc6a070..6b99e0eac 100644
--- a/Kavita.Common/EnvironmentInfo/IOsInfo.cs
+++ b/Kavita.Common/EnvironmentInfo/IOsInfo.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Diagnostics;
 
 namespace Kavita.Common.EnvironmentInfo;
@@ -57,7 +57,7 @@ private static Os GetPosixFlavour()
         }
     }
 
-    private static string RunAndCapture(string filename, string args)
+    public static string RunAndCapture(string filename, string args, int waitInMilliseconds = 1000)
     {
         var p = new Process
         {
@@ -75,7 +75,7 @@ private static string RunAndCapture(string filename, string args)
 
         // To avoid deadlocks, always read the output stream first and then wait.
         var output = p.StandardOutput.ReadToEnd();
-        p.WaitForExit(1000);
+        p.WaitForExit(waitInMilliseconds);
 
         return output;
     }

From cb647ad79086cade5f57446334505491ac9c06eb Mon Sep 17 00:00:00 2001
From: Maximo Piva <mpiva@adventintermodal.com>
Date: Thu, 15 Aug 2024 17:40:47 -0300
Subject: [PATCH 02/30] Make sure if djxl do not exists, continue as usual.
 Fixed test and benchmark DI. Point docker-build to another hub Edit
 dockerfile and include jxl package.

---
 API.Benchmark/ArchiveServiceBenchmark.cs      |   6 +-
 API.Tests/Services/ArchiveServiceTests.cs     |  12 +-
 API.Tests/Services/BookServiceTests.cs        |   4 +-
 .../JpegXLImageConverterProvider.cs           |  38 ++++++-
 Dockerfile                                    |   6 +-
 docker-build-jxl.sh                           | 103 ++++++++++++++++++
 6 files changed, 150 insertions(+), 19 deletions(-)
 create mode 100644 docker-build-jxl.sh

diff --git a/API.Benchmark/ArchiveServiceBenchmark.cs b/API.Benchmark/ArchiveServiceBenchmark.cs
index 9ef8e237b..79ef38b2e 100644
--- a/API.Benchmark/ArchiveServiceBenchmark.cs
+++ b/API.Benchmark/ArchiveServiceBenchmark.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.IO;
 using System.IO.Abstractions;
 using Microsoft.Extensions.Logging.Abstractions;
@@ -32,8 +32,8 @@ public class ArchiveServiceBenchmark
     public ArchiveServiceBenchmark()
     {
         _directoryService = new DirectoryService(null, new FileSystem());
-        _imageService = new ImageService(null, _directoryService, Substitute.For<IEasyCachingProviderFactory>());
-        _archiveService = new ArchiveService(new NullLogger<ArchiveService>(), _directoryService, _imageService, Substitute.For<IMediaErrorService>());
+        _imageService = new ImageService(null, _directoryService, Substitute.For<IEasyCachingProviderFactory>(), Substitute.For<IImageConverterService>());
+        _archiveService = new ArchiveService(new NullLogger<ArchiveService>(), _directoryService, _imageService, Substitute.For<IMediaErrorService>(), Substitute.For<IImageConverterService>());
     }
 
     [Benchmark(Baseline = true)]
diff --git a/API.Tests/Services/ArchiveServiceTests.cs b/API.Tests/Services/ArchiveServiceTests.cs
index 086d99863..27a93ea64 100644
--- a/API.Tests/Services/ArchiveServiceTests.cs
+++ b/API.Tests/Services/ArchiveServiceTests.cs
@@ -1,4 +1,4 @@
-using System.Diagnostics;
+using System.Diagnostics;
 using System.IO;
 using System.IO.Abstractions;
 using System.IO.Abstractions.TestingHelpers;
@@ -29,8 +29,8 @@ public ArchiveServiceTests(ITestOutputHelper testOutputHelper)
     {
         _testOutputHelper = testOutputHelper;
         _archiveService = new ArchiveService(_logger, _directoryService,
-            new ImageService(Substitute.For<ILogger<ImageService>>(), _directoryService, Substitute.For<IEasyCachingProviderFactory>()),
-            Substitute.For<IMediaErrorService>());
+            new ImageService(Substitute.For<ILogger<ImageService>>(), _directoryService, Substitute.For<IEasyCachingProviderFactory>(), Substitute.For<IImageConverterService>()),
+            Substitute.For<IMediaErrorService>(), Substitute.For<IImageConverterService>());
     }
 
     [Theory]
@@ -167,7 +167,7 @@ public void FindFirstEntry(string[] files, string expected)
     public void GetCoverImage_Default_Test(string inputFile, string expectedOutputFile)
     {
         var ds = Substitute.For<DirectoryService>(_directoryServiceLogger, new FileSystem());
-        var imageService = new ImageService(Substitute.For<ILogger<ImageService>>(), ds, Substitute.For<IEasyCachingProviderFactory>());
+        var imageService = new ImageService(Substitute.For<ILogger<ImageService>>(), ds, Substitute.For<IEasyCachingProviderFactory>(), Substitute.For<IImageConverterService>());
         var archiveService =  Substitute.For<ArchiveService>(_logger, ds, imageService, Substitute.For<IMediaErrorService>());
 
         var testDirectory = Path.GetFullPath(Path.Join(Directory.GetCurrentDirectory(), "../../../Services/Test Data/ArchiveService/CoverImages"));
@@ -198,7 +198,7 @@ public void GetCoverImage_Default_Test(string inputFile, string expectedOutputFi
     [InlineData("sorting.zip", "sorting.expected.png")]
     public void GetCoverImage_SharpCompress_Test(string inputFile, string expectedOutputFile)
     {
-        var imageService = new ImageService(Substitute.For<ILogger<ImageService>>(), _directoryService, Substitute.For<IEasyCachingProviderFactory>());
+        var imageService = new ImageService(Substitute.For<ILogger<ImageService>>(), _directoryService, Substitute.For<IEasyCachingProviderFactory>(), Substitute.For<IImageConverterService>());
         var archiveService =  Substitute.For<ArchiveService>(_logger,
             new DirectoryService(_directoryServiceLogger, new FileSystem()), imageService,
             Substitute.For<IMediaErrorService>());
@@ -226,7 +226,7 @@ public void CanParseCoverImage(string inputFile)
         var imageService = Substitute.For<IImageService>();
         imageService.WriteCoverThumbnail(Arg.Any<Stream>(), Arg.Any<string>(), Arg.Any<string>(), Arg.Any<EncodeFormat>())
             .Returns(x => "cover.jpg");
-        var archiveService = new ArchiveService(_logger, _directoryService, imageService, Substitute.For<IMediaErrorService>());
+        var archiveService = new ArchiveService(_logger, _directoryService, imageService, Substitute.For<IMediaErrorService>(),Substitute.For<IImageConverterService>());
         var testDirectory = Path.Join(Directory.GetCurrentDirectory(), "../../../Services/Test Data/ArchiveService/");
         var inputPath = Path.GetFullPath(Path.Join(testDirectory, inputFile));
         var outputPath = Path.Join(testDirectory, Path.GetFileNameWithoutExtension(inputFile) + "_output");
diff --git a/API.Tests/Services/BookServiceTests.cs b/API.Tests/Services/BookServiceTests.cs
index e4647524e..2fc1e18d1 100644
--- a/API.Tests/Services/BookServiceTests.cs
+++ b/API.Tests/Services/BookServiceTests.cs
@@ -1,4 +1,4 @@
-using System.IO;
+using System.IO;
 using System.IO.Abstractions;
 using API.Services;
 using EasyCaching.Core;
@@ -17,7 +17,7 @@ public BookServiceTests()
     {
         var directoryService = new DirectoryService(Substitute.For<ILogger<DirectoryService>>(), new FileSystem());
         _bookService = new BookService(_logger, directoryService,
-            new ImageService(Substitute.For<ILogger<ImageService>>(), directoryService, Substitute.For<IEasyCachingProviderFactory>())
+            new ImageService(Substitute.For<ILogger<ImageService>>(), directoryService, Substitute.For<IEasyCachingProviderFactory>(), Substitute.For<IImageConverterService>())
             , Substitute.For<IMediaErrorService>());
     }
 
diff --git a/API/Services/ImageConversion/JpegXLImageConverterProvider.cs b/API/Services/ImageConversion/JpegXLImageConverterProvider.cs
index 866587d6a..95b399afd 100644
--- a/API/Services/ImageConversion/JpegXLImageConverterProvider.cs
+++ b/API/Services/ImageConversion/JpegXLImageConverterProvider.cs
@@ -14,15 +14,43 @@ public interface IImageConverterProvider
 
 public class JpegXLImageConverterProvider : IImageConverterProvider
 {
-    public bool IsSupported(string filename) => filename.EndsWith(".jxl", StringComparison.InvariantCultureIgnoreCase);
+    private bool? _appFound = null;
+
+    internal bool AppFound
+    {
+        get
+        {
+            if (_appFound == null)
+            {
+                try
+                {
+                    _appFound = OsInfo.RunAndCapture(exeFile, "--version", Timeout.Infinite).Contains("JPEG XL");
+                }
+                catch (Exception e)
+                {
+                    //Eat it
+                    _appFound = false;
+                }
+            }
+            return _appFound.Value;
+        }
+    }
+    private string exeFile => OsInfo.IsWindows ? "djxl.exe" : "djxl";
+
+    public bool IsSupported(string filename)
+    {
+        if (AppFound)
+            return filename.EndsWith(".jxl", StringComparison.InvariantCultureIgnoreCase);
+        return false;
+    }
+
     public string Extension => ".jxl";
     public string Convert(string filename)
     {
-        string exe = "djxl";
-        if (OsInfo.IsWindows)
-            exe = "djxl.exe";
+        if (!AppFound)
+            return filename;
         string destination = Path.ChangeExtension(filename, "jpg");
-        OsInfo.RunAndCapture(exe, "\"" + filename + "\" \"" + destination + "\"", Timeout.Infinite);
+        OsInfo.RunAndCapture(exeFile, "\"" + filename + "\" \"" + destination + "\"", Timeout.Infinite);
         File.Delete(filename);
         return destination;
     }
diff --git a/Dockerfile b/Dockerfile
index 6d52acaba..3eb3417c5 100644
--- a/Dockerfile
+++ b/Dockerfile
@@ -1,7 +1,7 @@
 #This Dockerfile creates a build for all architectures
 
 #Image that copies in the files and passes them to the main image
-FROM ubuntu:focal AS copytask
+FROM ubuntu:oracular AS copytask
 
 ARG TARGETPLATFORM
 
@@ -14,7 +14,7 @@ RUN /copy_runtime.sh
 RUN chmod +x /Kavita/Kavita
 
 #Production image
-FROM ubuntu:focal
+FROM ubuntu:oracular
 
 COPY --from=copytask /Kavita /kavita
 COPY --from=copytask /files/wwwroot /kavita/wwwroot
@@ -22,7 +22,7 @@ COPY API/config/appsettings.json /tmp/config/appsettings.json
 
 #Installs program dependencies
 RUN apt-get update \
-  && apt-get install -y libicu-dev libssl1.1 libgdiplus curl \
+  && apt-get install -y libicu-dev libssl3t64 libgdiplus curl libjxl-tools \
   && rm -rf /var/lib/apt/lists/*
 
 COPY entrypoint.sh /entrypoint.sh
diff --git a/docker-build-jxl.sh b/docker-build-jxl.sh
new file mode 100644
index 000000000..206b97f0b
--- /dev/null
+++ b/docker-build-jxl.sh
@@ -0,0 +1,103 @@
+#! /bin/bash
+set -e
+
+outputFolder='_output'
+
+ProgressStart()
+{
+    echo "Start '$1'"
+}
+
+ProgressEnd()
+{
+    echo "Finish '$1'"
+}
+
+Build()
+{
+	local RID="$1"
+
+    ProgressStart "Build for $RID"
+
+    slnFile=Kavita.sln
+
+    dotnet clean $slnFile -c Release
+
+	  dotnet msbuild -restore $slnFile -p:Configuration=Release -p:Platform="Any CPU" -p:RuntimeIdentifiers=$RID
+
+    ProgressEnd "Build for $RID"
+}
+
+BuildUI()
+{
+    ProgressStart 'Building UI'
+    echo 'Removing old wwwroot'
+    rm -rf API/wwwroot/*
+    cd UI/Web/ || exit
+    echo 'Installing web dependencies'
+    npm install --legacy-peer-deps
+    echo 'Building UI'
+    npm run prod
+    echo 'Copying back to Kavita wwwroot'
+    mkdir -p ../../API/wwwroot
+    cp -R dist/browser/* ../../API/wwwroot
+    cd ../../ || exit
+    ProgressEnd 'Building UI'
+}
+
+Package()
+{
+    local runtime="$1"
+    local lOutputFolder=../_output/"$runtime"/Kavita
+
+    ProgressStart "Creating $runtime Package"
+
+    # TODO: Use no-restore? Because Build should have already done it for us
+    echo "Building"
+    cd API
+    echo dotnet publish -c Release --no-restore --self-contained --runtime $runtime -o "$lOutputFolder"
+    dotnet publish -c Release --no-restore --self-contained --runtime $runtime -o "$lOutputFolder"
+
+    echo "Copying Install information"
+    cp ../INSTALL.txt "$lOutputFolder"/README.txt
+
+    echo "Copying LICENSE"
+    cp ../LICENSE "$lOutputFolder"/LICENSE.txt
+
+    echo "Renaming API -> Kavita"
+    mv "$lOutputFolder"/API "$lOutputFolder"/Kavita
+
+    echo "Creating tar"
+    cd ../$outputFolder/"$runtime"/
+    tar -czvf ../kavita-$runtime.tar.gz Kavita
+
+    ProgressEnd "Creating $runtime Package"
+
+}
+
+dir=$PWD
+
+if [ -d _output ]
+then
+	rm -r _output/
+fi
+
+BuildUI
+
+#Build for x64
+Build "linux-x64"
+Package "linux-x64"
+cd "$dir"
+
+#Build for arm
+Build "linux-arm"
+Package "linux-arm"
+cd "$dir"
+
+#Build for arm64
+Build "linux-arm64"
+Package "linux-arm64"
+cd "$dir"
+
+#Builds Docker images
+docker buildx build -t maxpiva/kavita:nightly --platform linux/amd64,linux/arm/v7,linux/arm64 . --push

From 7f6db2439cfe00e6051ea3237b621ed0ec64054f Mon Sep 17 00:00:00 2001
From: Maximo Piva <mpiva@adventintermodal.com>
Date: Fri, 23 Aug 2024 18:34:58 -0300
Subject: [PATCH 03/30] Changed the way conversion happens. 1. Supported Image
 Formats came in the accept flag from the browser. 2. If jxl (or future
 formats, ie browser not supported AVIF, HEIF, etc) are not supported, Kavita
 will convert it to a suitable display format via conversion providers. 3. if
 it supported it will return the image as is, no conversion needed. 4.
 Thumbnails are always converted.

---
 API.Tests/Services/ArchiveServiceTests.cs     |  6 ++--
 API.Tests/Services/CacheServiceTests.cs       | 16 ++++-----
 API/API.csproj                                |  3 +-
 API/Controllers/OPDSController.cs             |  4 +--
 API/Controllers/ReaderController.cs           | 13 ++++---
 API/Extensions/FileTypeGroupExtensions.cs     | 12 ++++++-
 API/Extensions/HttpExtensions.cs              | 32 ++++++++++++++++-
 API/Services/ArchiveService.cs                | 15 ++++----
 API/Services/BookService.cs                   |  6 ++--
 API/Services/CacheService.cs                  | 36 ++++++++++++-------
 .../JpegXLImageConverterProvider.cs           | 16 +++++++++
 API/Services/ImageConverterService.cs         | 24 +++++++++++--
 API/Services/ImageService.cs                  |  9 +++--
 13 files changed, 140 insertions(+), 52 deletions(-)

diff --git a/API.Tests/Services/ArchiveServiceTests.cs b/API.Tests/Services/ArchiveServiceTests.cs
index 27a93ea64..530affbf3 100644
--- a/API.Tests/Services/ArchiveServiceTests.cs
+++ b/API.Tests/Services/ArchiveServiceTests.cs
@@ -30,7 +30,7 @@ public ArchiveServiceTests(ITestOutputHelper testOutputHelper)
         _testOutputHelper = testOutputHelper;
         _archiveService = new ArchiveService(_logger, _directoryService,
             new ImageService(Substitute.For<ILogger<ImageService>>(), _directoryService, Substitute.For<IEasyCachingProviderFactory>(), Substitute.For<IImageConverterService>()),
-            Substitute.For<IMediaErrorService>(), Substitute.For<IImageConverterService>());
+            Substitute.For<IMediaErrorService>());
     }
 
     [Theory]
@@ -224,9 +224,9 @@ public void GetCoverImage_SharpCompress_Test(string inputFile, string expectedOu
     public void CanParseCoverImage(string inputFile)
     {
         var imageService = Substitute.For<IImageService>();
-        imageService.WriteCoverThumbnail(Arg.Any<Stream>(), Arg.Any<string>(), Arg.Any<string>(), Arg.Any<EncodeFormat>())
+        imageService.WriteCoverThumbnail(Arg.Any<string>(), Arg.Any<Stream>(), Arg.Any<string>(), Arg.Any<string>(), Arg.Any<EncodeFormat>())
             .Returns(x => "cover.jpg");
-        var archiveService = new ArchiveService(_logger, _directoryService, imageService, Substitute.For<IMediaErrorService>(),Substitute.For<IImageConverterService>());
+        var archiveService = new ArchiveService(_logger, _directoryService, imageService, Substitute.For<IMediaErrorService>());
         var testDirectory = Path.Join(Directory.GetCurrentDirectory(), "../../../Services/Test Data/ArchiveService/");
         var inputPath = Path.GetFullPath(Path.Join(testDirectory, inputFile));
         var outputPath = Path.Join(testDirectory, Path.GetFileNameWithoutExtension(inputFile) + "_output");
diff --git a/API.Tests/Services/CacheServiceTests.cs b/API.Tests/Services/CacheServiceTests.cs
index ba06525a3..c5ae07bee 100644
--- a/API.Tests/Services/CacheServiceTests.cs
+++ b/API.Tests/Services/CacheServiceTests.cs
@@ -1,4 +1,4 @@
-using System.Collections.Generic;
+using System.Collections.Generic;
 using System.Data.Common;
 using System.IO;
 using System.IO.Abstractions.TestingHelpers;
@@ -158,7 +158,7 @@ public async Task Ensure_DirectoryAlreadyExists_DontExtractAnything()
             new ReadingItemService(Substitute.For<IArchiveService>(),
                 Substitute.For<IBookService>(),
                 Substitute.For<IImageService>(), ds, Substitute.For<ILogger<ReadingItemService>>()),
-            Substitute.For<IBookmarkService>());
+            Substitute.For<IBookmarkService>(), Substitute.For<IImageConverterService>());
 
         await ResetDB();
         var s = new SeriesBuilder("Test").Build();
@@ -234,7 +234,7 @@ public void CleanupChapters_AllFilesShouldBeDeleted()
         var cleanupService = new CacheService(_logger, _unitOfWork, ds,
             new ReadingItemService(Substitute.For<IArchiveService>(),
                 Substitute.For<IBookService>(), Substitute.For<IImageService>(), ds, Substitute.For<ILogger<ReadingItemService>>()),
-            Substitute.For<IBookmarkService>());
+            Substitute.For<IBookmarkService>(), Substitute.For<IImageConverterService>());
 
         cleanupService.CleanupChapters(new []{1, 3});
         Assert.Empty(ds.GetFiles(CacheDirectory, searchOption:SearchOption.AllDirectories));
@@ -256,7 +256,7 @@ public void GetCachedEpubFile_ShouldReturnFirstEpub()
         var cs = new CacheService(_logger, _unitOfWork, ds,
             new ReadingItemService(Substitute.For<IArchiveService>(),
                 Substitute.For<IBookService>(), Substitute.For<IImageService>(), ds, Substitute.For<ILogger<ReadingItemService>>()),
-            Substitute.For<IBookmarkService>());
+            Substitute.For<IBookmarkService>(), Substitute.For<IImageConverterService>());
 
         var c = new ChapterBuilder("1")
             .WithFile(new MangaFileBuilder($"{DataDirectory}1.epub", MangaFormat.Epub).Build())
@@ -297,7 +297,7 @@ public void GetCachedPagePath_ReturnNullIfNoFiles()
         var cs = new CacheService(_logger, _unitOfWork, ds,
             new ReadingItemService(Substitute.For<IArchiveService>(),
                 Substitute.For<IBookService>(), Substitute.For<IImageService>(), ds, Substitute.For<ILogger<ReadingItemService>>()),
-            Substitute.For<IBookmarkService>());
+            Substitute.For<IBookmarkService>(),Substitute.For<IImageConverterService>());
 
         // Flatten to prepare for how GetFullPath expects
         ds.Flatten($"{CacheDirectory}1/");
@@ -341,7 +341,7 @@ public void GetCachedPagePath_GetFileFromFirstFile()
         var cs = new CacheService(_logger, _unitOfWork, ds,
             new ReadingItemService(Substitute.For<IArchiveService>(),
                 Substitute.For<IBookService>(), Substitute.For<IImageService>(), ds, Substitute.For<ILogger<ReadingItemService>>()),
-            Substitute.For<IBookmarkService>());
+            Substitute.For<IBookmarkService>(), Substitute.For<IImageConverterService>());
 
         // Flatten to prepare for how GetFullPath expects
         ds.Flatten($"{CacheDirectory}1/");
@@ -382,7 +382,7 @@ public void GetCachedPagePath_GetLastPageFromSingleFile()
         var cs = new CacheService(_logger, _unitOfWork, ds,
             new ReadingItemService(Substitute.For<IArchiveService>(),
                 Substitute.For<IBookService>(), Substitute.For<IImageService>(), ds, Substitute.For<ILogger<ReadingItemService>>()),
-            Substitute.For<IBookmarkService>());
+            Substitute.For<IBookmarkService>(), Substitute.For<IImageConverterService>());
 
         // Flatten to prepare for how GetFullPath expects
         ds.Flatten($"{CacheDirectory}1/");
@@ -427,7 +427,7 @@ public void GetCachedPagePath_GetFileFromSecondFile()
         var cs = new CacheService(_logger, _unitOfWork, ds,
             new ReadingItemService(Substitute.For<IArchiveService>(),
                 Substitute.For<IBookService>(), Substitute.For<IImageService>(), ds, Substitute.For<ILogger<ReadingItemService>>()),
-            Substitute.For<IBookmarkService>());
+            Substitute.For<IBookmarkService>(), Substitute.For<IImageConverterService>());
 
         // Flatten to prepare for how GetFullPath expects
         ds.Flatten($"{CacheDirectory}1/");
diff --git a/API/API.csproj b/API/API.csproj
index d25705269..ea886732b 100644
--- a/API/API.csproj
+++ b/API/API.csproj
@@ -13,8 +13,7 @@
   </PropertyGroup>
 
   <Target Name="PostBuild" AfterTargets="Build" Condition=" '$(Configuration)' == 'Debug' ">
-      <Delete Files="../openapi.json" />
-      <Exec Command="swagger tofile --output ../openapi.json bin/$(Configuration)/$(TargetFramework)/$(AssemblyName).dll v1" />
+
   </Target>
 
   <PropertyGroup Condition=" '$(Configuration)' == 'Release' ">
diff --git a/API/Controllers/OPDSController.cs b/API/Controllers/OPDSController.cs
index 6d0f7e8dd..2df6e5ea7 100644
--- a/API/Controllers/OPDSController.cs
+++ b/API/Controllers/OPDSController.cs
@@ -1227,7 +1227,7 @@ public async Task<ActionResult> GetPageStreamedImage(string apiKey, [FromQuery]
 
         try
         {
-            var path = _cacheService.GetCachedPagePath(chapter.Id, pageNumber);
+            var path = _cacheService.GetCachedPagePath(chapter.Id, pageNumber, Request.SupportedImageTypesFromRequest());
             if (string.IsNullOrEmpty(path) || !System.IO.File.Exists(path))
                 return BadRequest(await _localizationService.Translate(userId, "no-image-for-page", pageNumber));
 
@@ -1251,7 +1251,7 @@ await _readerService.SaveReadingProgress(new ProgressDto()
                 }, userId);
             }
 
-            return File(content, MimeTypeMap.GetMimeType(format));
+            return File(content, format.GetMimeType());
         }
         catch (Exception)
         {
diff --git a/API/Controllers/ReaderController.cs b/API/Controllers/ReaderController.cs
index 159c8c922..99d096f74 100644
--- a/API/Controllers/ReaderController.cs
+++ b/API/Controllers/ReaderController.cs
@@ -23,6 +23,7 @@
 using Microsoft.Extensions.Logging;
 using Microsoft.IdentityModel.Tokens;
 using MimeTypes;
+using Org.BouncyCastle.Ocsp;
 
 namespace API.Controllers;
 
@@ -118,12 +119,12 @@ public async Task<ActionResult> GetImage(int chapterId, int page, string apiKey,
             var chapter = await _cacheService.Ensure(chapterId, extractPdf);
             if (chapter == null) return NoContent();
             _logger.LogInformation("Fetching Page {PageNum} on Chapter {ChapterId}", page, chapterId);
-            var path = _cacheService.GetCachedPagePath(chapter.Id, page);
+            var path = _cacheService.GetCachedPagePath(chapter.Id, page, Request.SupportedImageTypesFromRequest());
             if (string.IsNullOrEmpty(path) || !System.IO.File.Exists(path))
                 return BadRequest(await _localizationService.Translate(userId, "no-image-for-page", page));
             var format = Path.GetExtension(path);
 
-            return PhysicalFile(path, MimeTypeMap.GetMimeType(format), Path.GetFileName(path), true);
+            return PhysicalFile(path, format.GetMimeType(), Path.GetFileName(path), true);
         }
         catch (Exception)
         {
@@ -132,6 +133,8 @@ public async Task<ActionResult> GetImage(int chapterId, int page, string apiKey,
         }
     }
 
+
+
     /// <summary>
     /// Returns a thumbnail for the given page number
     /// </summary>
@@ -180,11 +183,11 @@ public async Task<ActionResult> GetBookmarkImage(int seriesId, string apiKey, in
 
         try
         {
-            var path = _cacheService.GetCachedBookmarkPagePath(seriesId, page);
+            var path = _cacheService.GetCachedBookmarkPagePath(seriesId, page, Request.SupportedImageTypesFromRequest());
             if (string.IsNullOrEmpty(path) || !System.IO.File.Exists(path)) return BadRequest(await _localizationService.Translate(userId, "no-image-for-page", page));
             var format = Path.GetExtension(path);
 
-            return PhysicalFile(path, MimeTypeMap.GetMimeType(format), Path.GetFileName(path));
+            return PhysicalFile(path, format.GetMimeType(), Path.GetFileName(path));
         }
         catch (Exception)
         {
@@ -729,7 +732,7 @@ public async Task<ActionResult> BookmarkPage(BookmarkDto bookmarkDto)
         if (chapter == null) return BadRequest(await _localizationService.Translate(User.GetUserId(), "cache-file-find"));
 
         bookmarkDto.Page = _readerService.CapPageToChapter(chapter, bookmarkDto.Page);
-        var path = _cacheService.GetCachedPagePath(chapter.Id, bookmarkDto.Page);
+        var path = _cacheService.GetCachedPagePath(chapter.Id, bookmarkDto.Page, Request.SupportedImageTypesFromRequest());
 
         if (!await _bookmarkService.BookmarkPage(user, bookmarkDto, path))
             return BadRequest(await _localizationService.Translate(User.GetUserId(), "bookmark-save"));
diff --git a/API/Extensions/FileTypeGroupExtensions.cs b/API/Extensions/FileTypeGroupExtensions.cs
index 24073f642..9cbd33098 100644
--- a/API/Extensions/FileTypeGroupExtensions.cs
+++ b/API/Extensions/FileTypeGroupExtensions.cs
@@ -1,6 +1,7 @@
-using System;
+using System;
 using API.Entities.Enums;
 using API.Services.Tasks.Scanner.Parser;
+using MimeTypes;
 
 namespace API.Extensions;
 
@@ -22,4 +23,13 @@ public static string GetRegex(this FileTypeGroup fileTypeGroup)
                 throw new ArgumentOutOfRangeException(nameof(fileTypeGroup), fileTypeGroup, null);
         }
     }
+    public static string GetMimeType(this string format)
+    {
+        //Add jxl format
+        format = format.ToLowerInvariant();
+        if (format == ".jxl")
+            return "image/jxl";
+        return MimeTypeMap.GetMimeType(format);
+    }
+
 }
diff --git a/API/Extensions/HttpExtensions.cs b/API/Extensions/HttpExtensions.cs
index fbf828104..6287f31f8 100644
--- a/API/Extensions/HttpExtensions.cs
+++ b/API/Extensions/HttpExtensions.cs
@@ -1,5 +1,8 @@
-using System.IO;
+using System;
+using System.Collections.Generic;
+using System.IO;
 using System.Linq;
+using System.Net.NetworkInformation;
 using System.Security.Cryptography;
 using System.Text;
 using System.Text.Json;
@@ -53,4 +56,31 @@ public static void AddCacheHeader(this HttpResponse response, string filename, i
             response.Headers.CacheControl =  $"max-age={maxAge}";
         }
     }
+
+    public static List<string> SupportedImageTypesFromRequest(this HttpRequest request)
+    {
+        var acceptHeader = request.Headers["Accept"];
+        string[] spl1 = acceptHeader.ToString().Split(';');
+        acceptHeader = spl1[0];
+        string[] split = acceptHeader.ToString().Split(',');
+        List<string> defaultExtensions = new List<string>();
+        defaultExtensions.Add("jpeg");
+        defaultExtensions.Add("jpg");
+        defaultExtensions.Add("png");
+        defaultExtensions.Add("gif");
+
+        foreach (string v in split)
+        {
+            if (v.StartsWith("image/", StringComparison.InvariantCultureIgnoreCase))
+            {
+                string n = v.Substring(6);
+                if (n == "svg+xml")
+                    n = "svg";
+                if (n.StartsWith("*"))
+                    continue;
+                defaultExtensions.Add(n.ToLowerInvariant());
+            }
+        }
+        return defaultExtensions;
+    }
 }
diff --git a/API/Services/ArchiveService.cs b/API/Services/ArchiveService.cs
index 8a4284402..641c25c0d 100644
--- a/API/Services/ArchiveService.cs
+++ b/API/Services/ArchiveService.cs
@@ -58,17 +58,16 @@ public class ArchiveService : IArchiveService
     private readonly IDirectoryService _directoryService;
     private readonly IImageService _imageService;
     private readonly IMediaErrorService _mediaErrorService;
-    private readonly IImageConverterService _converterService;
+
     private const string ComicInfoFilename = "ComicInfo.xml";
 
     public ArchiveService(ILogger<ArchiveService> logger, IDirectoryService directoryService,
-        IImageService imageService, IMediaErrorService mediaErrorService, IImageConverterService converterService)
+        IImageService imageService, IMediaErrorService mediaErrorService)
     {
         _logger = logger;
         _directoryService = directoryService;
         _imageService = imageService;
         _mediaErrorService = mediaErrorService;
-        _converterService = converterService;
     }
 
     /// <summary>
@@ -233,8 +232,8 @@ public string GetCoverImage(string archivePath, string fileName, string outputDi
                     var entryName = FindCoverImageFilename(archivePath, archive.Entries.Select(e => e.FullName));
                     var entry = archive.Entries.Single(e => e.FullName == entryName);
 
-                    using var stream = _converterService.ConvertStream(entryName, entry.Open());
-                    return _imageService.WriteCoverThumbnail(stream, fileName, outputDirectory, format, size);
+                    using var stream = entry.Open();
+                    return _imageService.WriteCoverThumbnail(entryName, stream, fileName, outputDirectory, format, size);
                 }
                 case ArchiveLibrary.SharpCompress:
                 {
@@ -244,8 +243,8 @@ public string GetCoverImage(string archivePath, string fileName, string outputDi
                     var entryName = FindCoverImageFilename(archivePath, entryNames);
                     var entry = archive.Entries.Single(e => e.Key == entryName);
 
-                    using var stream = _converterService.ConvertStream(entryName, entry.OpenEntryStream());
-                    return _imageService.WriteCoverThumbnail(stream, fileName, outputDirectory, format, size);
+                    using var stream = entry.OpenEntryStream();
+                    return _imageService.WriteCoverThumbnail(entryName, stream, fileName, outputDirectory, format, size);
                 }
                 case ArchiveLibrary.NotSupported:
                     _logger.LogWarning("[GetCoverImage] This archive cannot be read: {ArchivePath}. Defaulting to no cover image", archivePath);
@@ -562,7 +561,6 @@ public void ExtractArchive(string archivePath, string extractPath)
                 {
                     using var archive = ZipFile.OpenRead(archivePath);
                     ExtractArchiveEntries(archive, extractPath);
-                    _converterService.ConvertDirectory(extractPath);
                     break;
                 }
                 case ArchiveLibrary.SharpCompress:
@@ -571,7 +569,6 @@ public void ExtractArchive(string archivePath, string extractPath)
                     ExtractArchiveEntities(archive.Entries.Where(entry => !entry.IsDirectory
                                                                           && !Tasks.Scanner.Parser.Parser.HasBlacklistedFolderInPath(Path.GetDirectoryName(entry.Key) ?? string.Empty)
                                                                           && Tasks.Scanner.Parser.Parser.IsImage(entry.Key)), extractPath);
-                    _converterService.ConvertDirectory(extractPath);
                     break;
                 }
                 case ArchiveLibrary.NotSupported:
diff --git a/API/Services/BookService.cs b/API/Services/BookService.cs
index e4ed92047..cb22f24d6 100644
--- a/API/Services/BookService.cs
+++ b/API/Services/BookService.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Collections.Generic;
 using System.Globalization;
 using System.IO;
@@ -1229,7 +1229,7 @@ public string GetCoverImage(string fileFilePath, string fileName, string outputD
             if (coverImageContent == null) return string.Empty;
             using var stream = coverImageContent.GetContentStream();
 
-            return _imageService.WriteCoverThumbnail(stream, fileName, outputDirectory, encodeFormat, size);
+            return _imageService.WriteCoverThumbnail(fileFilePath, stream, fileName, outputDirectory, encodeFormat, size);
         }
         catch (Exception ex)
         {
@@ -1252,7 +1252,7 @@ private string GetPdfCoverImage(string fileFilePath, string fileName, string out
             using var stream = StreamManager.GetStream("BookService.GetPdfPage");
             GetPdfPage(docReader, 0, stream);
 
-            return _imageService.WriteCoverThumbnail(stream, fileName, outputDirectory, encodeFormat, size);
+            return _imageService.WriteCoverThumbnail(fileFilePath, stream, fileName, outputDirectory, encodeFormat, size);
 
         }
         catch (Exception ex)
diff --git a/API/Services/CacheService.cs b/API/Services/CacheService.cs
index c6e539348..a00df5879 100644
--- a/API/Services/CacheService.cs
+++ b/API/Services/CacheService.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Collections.Concurrent;
 using System.Collections.Generic;
 using System.Diagnostics;
@@ -13,6 +13,7 @@
 using API.Extensions;
 using Kavita.Common;
 using Microsoft.Extensions.Logging;
+using MimeKit.Tnef;
 using NetVips;
 
 namespace API.Services;
@@ -34,12 +35,12 @@ public interface ICacheService
     /// <param name="chapterIds">Volumes that belong to that library. Assume the library might have been deleted before this invocation.</param>
     void CleanupChapters(IEnumerable<int> chapterIds);
     void CleanupBookmarks(IEnumerable<int> seriesIds);
-    string GetCachedPagePath(int chapterId, int page);
+    string GetCachedPagePath(int chapterId, int page, List<string> supportedImageFormats = null);
     string GetCachePath(int chapterId);
     string GetBookmarkCachePath(int seriesId);
     IEnumerable<string> GetCachedPages(int chapterId);
     IEnumerable<FileDimensionDto> GetCachedFileDimensions(string cachePath);
-    string GetCachedBookmarkPagePath(int seriesId, int page);
+    string GetCachedBookmarkPagePath(int seriesId, int page, List<string> supportedImageFormats = null);
     string GetCachedFile(Chapter chapter);
     public void ExtractChapterFiles(string extractPath, IReadOnlyList<MangaFile> files, bool extractPdfImages = false);
     Task<int> CacheBookmarkForSeries(int userId, int seriesId);
@@ -52,18 +53,19 @@ public class CacheService : ICacheService
     private readonly IDirectoryService _directoryService;
     private readonly IReadingItemService _readingItemService;
     private readonly IBookmarkService _bookmarkService;
-
+    private readonly IImageConverterService _converterService;
     private static readonly ConcurrentDictionary<int, SemaphoreSlim> ExtractLocks = new();
 
     public CacheService(ILogger<CacheService> logger, IUnitOfWork unitOfWork,
         IDirectoryService directoryService, IReadingItemService readingItemService,
-        IBookmarkService bookmarkService)
+        IBookmarkService bookmarkService, IImageConverterService converterService)
     {
         _logger = logger;
         _unitOfWork = unitOfWork;
         _directoryService = directoryService;
         _readingItemService = readingItemService;
         _bookmarkService = bookmarkService;
+        _converterService = converterService;
     }
 
     public IEnumerable<string> GetCachedPages(int chapterId)
@@ -98,13 +100,19 @@ public IEnumerable<FileDimensionDto> GetCachedFileDimensions(string cachePath)
             for (var i = 0; i < files.Length; i++)
             {
                 var file = files[i];
-                using var image = Image.NewFromFile(file, memory: false, access: Enums.Access.SequentialUnbuffered);
+                var dimension = _converterService.GetDimensions(file, i);
+                if (dimension == null)
+                {
+                    using var image = Image.NewFromFile(file, memory: false, access: Enums.Access.SequentialUnbuffered);
+                    dimension = (image.Width, image.Height);
+                }
+                
                 dimensions.Add(new FileDimensionDto()
                 {
                     PageNumber = i,
-                    Height = image.Height,
-                    Width = image.Width,
-                    IsWide = image.Width > image.Height,
+                    Height = dimension.Value.Height,
+                    Width = dimension.Value.Width,
+                    IsWide = dimension.Value.Width > dimension.Value.Height,
                     FileName = file.Replace(cachePath, string.Empty)
                 });
             }
@@ -122,7 +130,7 @@ public IEnumerable<FileDimensionDto> GetCachedFileDimensions(string cachePath)
         return dimensions;
     }
 
-    public string GetCachedBookmarkPagePath(int seriesId, int page)
+    public string GetCachedBookmarkPagePath(int seriesId, int page, List<string> supportedImageFormats = null)
     {
         // Calculate what chapter the page belongs to
         var path = GetBookmarkCachePath(seriesId);
@@ -138,7 +146,8 @@ public string GetCachedBookmarkPagePath(int seriesId, int page)
         }
 
         // Since array is 0 based, we need to keep that in account (only affects last image)
-        return page == files.Length ? files[page - 1] : files[page];
+        string file=page == files.Length ? files[page - 1] : files[page];
+        return _converterService.ConvertFile(file, supportedImageFormats);
     }
 
     /// <summary>
@@ -316,7 +325,7 @@ public string GetBookmarkCachePath(int seriesId)
     /// <param name="chapterId">Chapter id with Files populated.</param>
     /// <param name="page">Page number to look for</param>
     /// <returns>Page filepath or empty if no files found.</returns>
-    public string GetCachedPagePath(int chapterId, int page)
+    public string GetCachedPagePath(int chapterId, int page, List<string> supportedImageFormats = null)
     {
         // Calculate what chapter the page belongs to
         var path = GetCachePath(chapterId);
@@ -325,7 +334,8 @@ public string GetCachedPagePath(int chapterId, int page)
             //.OrderByNatural(Path.GetFileNameWithoutExtension) // This is already done in GetPageFromFiles
             .ToArray();
 
-        return GetPageFromFiles(files, page);
+        string file = GetPageFromFiles(files, page);
+        return _converterService.ConvertFile(file, supportedImageFormats);
     }
 
     public async Task<int> CacheBookmarkForSeries(int userId, int seriesId)
diff --git a/API/Services/ImageConversion/JpegXLImageConverterProvider.cs b/API/Services/ImageConversion/JpegXLImageConverterProvider.cs
index 95b399afd..3bd1a2f11 100644
--- a/API/Services/ImageConversion/JpegXLImageConverterProvider.cs
+++ b/API/Services/ImageConversion/JpegXLImageConverterProvider.cs
@@ -1,5 +1,6 @@
 using System;
 using System.IO;
+using System.Text.RegularExpressions;
 using System.Threading;
 using Kavita.Common.EnvironmentInfo;
 
@@ -10,6 +11,7 @@ public interface IImageConverterProvider
     string Extension { get; }
     bool IsSupported(string filename);
     string Convert(string filename);
+    (int Width, int Height)? GetDimensions(string fileName, int pageNumber);
 }
 
 public class JpegXLImageConverterProvider : IImageConverterProvider
@@ -37,6 +39,8 @@ internal bool AppFound
     }
     private string exeFile => OsInfo.IsWindows ? "djxl.exe" : "djxl";
 
+    private string infoFile => OsInfo.IsWindows ? "jxlinfo.exe" : "jxlinfo";
+
     public bool IsSupported(string filename)
     {
         if (AppFound)
@@ -44,6 +48,18 @@ public bool IsSupported(string filename)
         return false;
     }
 
+    private static Regex dimensions = new Regex(@",\s?(\d+)x(\d+),", RegexOptions.Compiled);
+    public (int Width, int Height)? GetDimensions(string fileName, int pageNumber)
+    {
+        if (!AppFound)
+            return null;
+        string output = OsInfo.RunAndCapture(infoFile, "\"" + fileName + "\"", Timeout.Infinite);
+        Match m= dimensions.Match(output);
+        if (!m.Success)
+            return null;
+        return (int.Parse(m.Groups[1].Value), int.Parse(m.Groups[2].Value));
+    }
+
     public string Extension => ".jxl";
     public string Convert(string filename)
     {
diff --git a/API/Services/ImageConverterService.cs b/API/Services/ImageConverterService.cs
index 08cab27a8..e2f61dd7a 100644
--- a/API/Services/ImageConverterService.cs
+++ b/API/Services/ImageConverterService.cs
@@ -6,14 +6,16 @@
 using System.Linq;
 using API.Services.ImageConversion;
 using static Org.BouncyCastle.Bcpg.Attr.ImageAttrib;
+using API.DTOs.Reader;
 
 namespace API.Services
 {
     public interface IImageConverterService
     {
         Stream ConvertStream(string filename, Stream source);
-        string ConvertFile(string filename);
+        string ConvertFile(string filename, List<string> supportedImageFormats);
         void ConvertDirectory(string directory);
+        (int Width, int Height)? GetDimensions(string fileName, int pageNumber);
     }
 
     public class ImageConverterService : IImageConverterService
@@ -41,8 +43,18 @@ public Stream ConvertStream(string filename, Stream source)
             return File.OpenRead(provider.Convert(tempFile));
         }
 
-        public string ConvertFile(string filename)
+        private bool CheckDirectSupport(string filename, List<string> supportedImageFormats)
         {
+            if (supportedImageFormats == null)
+                return false;
+            string ext = Path.GetExtension(filename).ToLowerInvariant().Substring(1);
+            return supportedImageFormats.Contains(ext);
+        }
+
+        public string ConvertFile(string filename, List<string> supportedImageFormats)
+        {
+            if (CheckDirectSupport(filename, supportedImageFormats))
+                return filename;
             IImageConverterProvider provider = _converters.FirstOrDefault(a => a.IsSupported(filename));
             if (provider == null)
                 return filename;
@@ -58,5 +70,13 @@ public void ConvertDirectory(string directory)
                     provider.Convert(filename);
             }
         }
+
+        public (int Width, int Height)? GetDimensions(string fileName, int pageNumber)
+        {
+            IImageConverterProvider provider = _converters.FirstOrDefault(a => a.IsSupported(fileName));
+            if (provider == null)
+                return null;
+            return provider.GetDimensions(fileName, pageNumber);
+        }
     }
 }
diff --git a/API/Services/ImageService.cs b/API/Services/ImageService.cs
index 9dc31038d..2656c8446 100644
--- a/API/Services/ImageService.cs
+++ b/API/Services/ImageService.cs
@@ -47,7 +47,7 @@ public interface IImageService
     /// <param name="outputDirectory"></param>
     /// <param name="encodeFormat"></param>
     /// <returns></returns>
-    string WriteCoverThumbnail(Stream stream, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size = CoverImageSize.Default);
+    string WriteCoverThumbnail(string sourceFile, Stream stream, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size = CoverImageSize.Default);
     /// <summary>
     /// Writes out a thumbnail by file path input
     /// </summary>
@@ -217,7 +217,7 @@ public string GetCoverImage(string path, string fileName, string outputDirectory
 
         try
         {
-            fileName = _converterService.ConvertFile(fileName);
+            fileName = _converterService.ConvertFile(fileName, null);
             var (width, height) = size.GetDimensions();
             using var sourceImage = Image.NewFromFile(path, false, Enums.Access.SequentialUnbuffered);
 
@@ -245,8 +245,9 @@ public string GetCoverImage(string path, string fileName, string outputDirectory
     /// <param name="outputDirectory">Where to output the file, defaults to covers directory</param>
     /// <param name="encodeFormat">Export the file as the passed encoding</param>
     /// <returns>File name with extension of the file. This will always write to <see cref="DirectoryService.CoverImageDirectory"/></returns>
-    public string WriteCoverThumbnail(Stream stream, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size = CoverImageSize.Default)
+    public string WriteCoverThumbnail(string sourceFile, Stream stream, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size = CoverImageSize.Default)
     {
+        stream = _converterService.ConvertStream(sourceFile, stream);
         var (targetWidth, targetHeight) = size.GetDimensions();
         if (stream.CanSeek) stream.Position = 0;
         using var sourceImage = Image.NewFromStream(stream);
@@ -289,6 +290,8 @@ public string WriteCoverThumbnail(Stream stream, string fileName, string outputD
 
     public string WriteCoverThumbnail(string sourceFile, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size = CoverImageSize.Default)
     {
+        sourceFile = _converterService.ConvertFile(sourceFile,null);
+
         var (width, height) = size.GetDimensions();
         using var sourceImage = Image.NewFromFile(sourceFile, false, Enums.Access.SequentialUnbuffered);
 

From dd0021a7566fe08626bbf569c964e32388a88fb6 Mon Sep 17 00:00:00 2001
From: Maximo Piva <mpiva@adventintermodal.com>
Date: Fri, 23 Aug 2024 18:35:37 -0300
Subject: [PATCH 04/30] Missing file

---
 API.Benchmark/ArchiveServiceBenchmark.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/API.Benchmark/ArchiveServiceBenchmark.cs b/API.Benchmark/ArchiveServiceBenchmark.cs
index 79ef38b2e..fd82ee87d 100644
--- a/API.Benchmark/ArchiveServiceBenchmark.cs
+++ b/API.Benchmark/ArchiveServiceBenchmark.cs
@@ -33,7 +33,7 @@ public ArchiveServiceBenchmark()
     {
         _directoryService = new DirectoryService(null, new FileSystem());
         _imageService = new ImageService(null, _directoryService, Substitute.For<IEasyCachingProviderFactory>(), Substitute.For<IImageConverterService>());
-        _archiveService = new ArchiveService(new NullLogger<ArchiveService>(), _directoryService, _imageService, Substitute.For<IMediaErrorService>(), Substitute.For<IImageConverterService>());
+        _archiveService = new ArchiveService(new NullLogger<ArchiveService>(), _directoryService, _imageService, Substitute.For<IMediaErrorService>());
     }
 
     [Benchmark(Baseline = true)]

From 9d48664b08f01303f1527bc1c577e1d4376f89ff Mon Sep 17 00:00:00 2001
From: Maximo Piva <mpiva@adventintermodal.com>
Date: Mon, 26 Aug 2024 00:22:34 -0300
Subject: [PATCH 05/30] Revert "Changed the way conversion happens."

This reverts commit 7f6db2439cfe00e6051ea3237b621ed0ec64054f.
---
 API.Tests/Services/ArchiveServiceTests.cs     |  6 ++--
 API.Tests/Services/CacheServiceTests.cs       | 16 ++++-----
 API/API.csproj                                |  3 +-
 API/Controllers/OPDSController.cs             |  4 +--
 API/Controllers/ReaderController.cs           | 13 +++----
 API/Extensions/FileTypeGroupExtensions.cs     | 12 +------
 API/Extensions/HttpExtensions.cs              | 32 +----------------
 API/Services/ArchiveService.cs                | 15 ++++----
 API/Services/BookService.cs                   |  6 ++--
 API/Services/CacheService.cs                  | 36 +++++++------------
 .../JpegXLImageConverterProvider.cs           | 16 ---------
 API/Services/ImageConverterService.cs         | 24 ++-----------
 API/Services/ImageService.cs                  |  9 ++---
 13 files changed, 52 insertions(+), 140 deletions(-)

diff --git a/API.Tests/Services/ArchiveServiceTests.cs b/API.Tests/Services/ArchiveServiceTests.cs
index 530affbf3..27a93ea64 100644
--- a/API.Tests/Services/ArchiveServiceTests.cs
+++ b/API.Tests/Services/ArchiveServiceTests.cs
@@ -30,7 +30,7 @@ public ArchiveServiceTests(ITestOutputHelper testOutputHelper)
         _testOutputHelper = testOutputHelper;
         _archiveService = new ArchiveService(_logger, _directoryService,
             new ImageService(Substitute.For<ILogger<ImageService>>(), _directoryService, Substitute.For<IEasyCachingProviderFactory>(), Substitute.For<IImageConverterService>()),
-            Substitute.For<IMediaErrorService>());
+            Substitute.For<IMediaErrorService>(), Substitute.For<IImageConverterService>());
     }
 
     [Theory]
@@ -224,9 +224,9 @@ public void GetCoverImage_SharpCompress_Test(string inputFile, string expectedOu
     public void CanParseCoverImage(string inputFile)
     {
         var imageService = Substitute.For<IImageService>();
-        imageService.WriteCoverThumbnail(Arg.Any<string>(), Arg.Any<Stream>(), Arg.Any<string>(), Arg.Any<string>(), Arg.Any<EncodeFormat>())
+        imageService.WriteCoverThumbnail(Arg.Any<Stream>(), Arg.Any<string>(), Arg.Any<string>(), Arg.Any<EncodeFormat>())
             .Returns(x => "cover.jpg");
-        var archiveService = new ArchiveService(_logger, _directoryService, imageService, Substitute.For<IMediaErrorService>());
+        var archiveService = new ArchiveService(_logger, _directoryService, imageService, Substitute.For<IMediaErrorService>(),Substitute.For<IImageConverterService>());
         var testDirectory = Path.Join(Directory.GetCurrentDirectory(), "../../../Services/Test Data/ArchiveService/");
         var inputPath = Path.GetFullPath(Path.Join(testDirectory, inputFile));
         var outputPath = Path.Join(testDirectory, Path.GetFileNameWithoutExtension(inputFile) + "_output");
diff --git a/API.Tests/Services/CacheServiceTests.cs b/API.Tests/Services/CacheServiceTests.cs
index c5ae07bee..ba06525a3 100644
--- a/API.Tests/Services/CacheServiceTests.cs
+++ b/API.Tests/Services/CacheServiceTests.cs
@@ -1,4 +1,4 @@
-using System.Collections.Generic;
+using System.Collections.Generic;
 using System.Data.Common;
 using System.IO;
 using System.IO.Abstractions.TestingHelpers;
@@ -158,7 +158,7 @@ public async Task Ensure_DirectoryAlreadyExists_DontExtractAnything()
             new ReadingItemService(Substitute.For<IArchiveService>(),
                 Substitute.For<IBookService>(),
                 Substitute.For<IImageService>(), ds, Substitute.For<ILogger<ReadingItemService>>()),
-            Substitute.For<IBookmarkService>(), Substitute.For<IImageConverterService>());
+            Substitute.For<IBookmarkService>());
 
         await ResetDB();
         var s = new SeriesBuilder("Test").Build();
@@ -234,7 +234,7 @@ public void CleanupChapters_AllFilesShouldBeDeleted()
         var cleanupService = new CacheService(_logger, _unitOfWork, ds,
             new ReadingItemService(Substitute.For<IArchiveService>(),
                 Substitute.For<IBookService>(), Substitute.For<IImageService>(), ds, Substitute.For<ILogger<ReadingItemService>>()),
-            Substitute.For<IBookmarkService>(), Substitute.For<IImageConverterService>());
+            Substitute.For<IBookmarkService>());
 
         cleanupService.CleanupChapters(new []{1, 3});
         Assert.Empty(ds.GetFiles(CacheDirectory, searchOption:SearchOption.AllDirectories));
@@ -256,7 +256,7 @@ public void GetCachedEpubFile_ShouldReturnFirstEpub()
         var cs = new CacheService(_logger, _unitOfWork, ds,
             new ReadingItemService(Substitute.For<IArchiveService>(),
                 Substitute.For<IBookService>(), Substitute.For<IImageService>(), ds, Substitute.For<ILogger<ReadingItemService>>()),
-            Substitute.For<IBookmarkService>(), Substitute.For<IImageConverterService>());
+            Substitute.For<IBookmarkService>());
 
         var c = new ChapterBuilder("1")
             .WithFile(new MangaFileBuilder($"{DataDirectory}1.epub", MangaFormat.Epub).Build())
@@ -297,7 +297,7 @@ public void GetCachedPagePath_ReturnNullIfNoFiles()
         var cs = new CacheService(_logger, _unitOfWork, ds,
             new ReadingItemService(Substitute.For<IArchiveService>(),
                 Substitute.For<IBookService>(), Substitute.For<IImageService>(), ds, Substitute.For<ILogger<ReadingItemService>>()),
-            Substitute.For<IBookmarkService>(),Substitute.For<IImageConverterService>());
+            Substitute.For<IBookmarkService>());
 
         // Flatten to prepare for how GetFullPath expects
         ds.Flatten($"{CacheDirectory}1/");
@@ -341,7 +341,7 @@ public void GetCachedPagePath_GetFileFromFirstFile()
         var cs = new CacheService(_logger, _unitOfWork, ds,
             new ReadingItemService(Substitute.For<IArchiveService>(),
                 Substitute.For<IBookService>(), Substitute.For<IImageService>(), ds, Substitute.For<ILogger<ReadingItemService>>()),
-            Substitute.For<IBookmarkService>(), Substitute.For<IImageConverterService>());
+            Substitute.For<IBookmarkService>());
 
         // Flatten to prepare for how GetFullPath expects
         ds.Flatten($"{CacheDirectory}1/");
@@ -382,7 +382,7 @@ public void GetCachedPagePath_GetLastPageFromSingleFile()
         var cs = new CacheService(_logger, _unitOfWork, ds,
             new ReadingItemService(Substitute.For<IArchiveService>(),
                 Substitute.For<IBookService>(), Substitute.For<IImageService>(), ds, Substitute.For<ILogger<ReadingItemService>>()),
-            Substitute.For<IBookmarkService>(), Substitute.For<IImageConverterService>());
+            Substitute.For<IBookmarkService>());
 
         // Flatten to prepare for how GetFullPath expects
         ds.Flatten($"{CacheDirectory}1/");
@@ -427,7 +427,7 @@ public void GetCachedPagePath_GetFileFromSecondFile()
         var cs = new CacheService(_logger, _unitOfWork, ds,
             new ReadingItemService(Substitute.For<IArchiveService>(),
                 Substitute.For<IBookService>(), Substitute.For<IImageService>(), ds, Substitute.For<ILogger<ReadingItemService>>()),
-            Substitute.For<IBookmarkService>(), Substitute.For<IImageConverterService>());
+            Substitute.For<IBookmarkService>());
 
         // Flatten to prepare for how GetFullPath expects
         ds.Flatten($"{CacheDirectory}1/");
diff --git a/API/API.csproj b/API/API.csproj
index 1755146ff..9cdecc8d1 100644
--- a/API/API.csproj
+++ b/API/API.csproj
@@ -13,7 +13,8 @@
   </PropertyGroup>
 
   <Target Name="PostBuild" AfterTargets="Build" Condition=" '$(Configuration)' == 'Debug' ">
-
+      <Delete Files="../openapi.json" />
+      <Exec Command="swagger tofile --output ../openapi.json bin/$(Configuration)/$(TargetFramework)/$(AssemblyName).dll v1" />
   </Target>
 
   <PropertyGroup Condition=" '$(Configuration)' == 'Release' ">
diff --git a/API/Controllers/OPDSController.cs b/API/Controllers/OPDSController.cs
index 0b260a537..d25321ad8 100644
--- a/API/Controllers/OPDSController.cs
+++ b/API/Controllers/OPDSController.cs
@@ -1228,7 +1228,7 @@ public async Task<ActionResult> GetPageStreamedImage(string apiKey, [FromQuery]
 
         try
         {
-            var path = _cacheService.GetCachedPagePath(chapter.Id, pageNumber, Request.SupportedImageTypesFromRequest());
+            var path = _cacheService.GetCachedPagePath(chapter.Id, pageNumber);
             if (string.IsNullOrEmpty(path) || !System.IO.File.Exists(path))
                 return BadRequest(await _localizationService.Translate(userId, "no-image-for-page", pageNumber));
 
@@ -1252,7 +1252,7 @@ await _readerService.SaveReadingProgress(new ProgressDto()
                 }, userId);
             }
 
-            return File(content, format.GetMimeType());
+            return File(content, MimeTypeMap.GetMimeType(format));
         }
         catch (Exception)
         {
diff --git a/API/Controllers/ReaderController.cs b/API/Controllers/ReaderController.cs
index 99d096f74..159c8c922 100644
--- a/API/Controllers/ReaderController.cs
+++ b/API/Controllers/ReaderController.cs
@@ -23,7 +23,6 @@
 using Microsoft.Extensions.Logging;
 using Microsoft.IdentityModel.Tokens;
 using MimeTypes;
-using Org.BouncyCastle.Ocsp;
 
 namespace API.Controllers;
 
@@ -119,12 +118,12 @@ public async Task<ActionResult> GetImage(int chapterId, int page, string apiKey,
             var chapter = await _cacheService.Ensure(chapterId, extractPdf);
             if (chapter == null) return NoContent();
             _logger.LogInformation("Fetching Page {PageNum} on Chapter {ChapterId}", page, chapterId);
-            var path = _cacheService.GetCachedPagePath(chapter.Id, page, Request.SupportedImageTypesFromRequest());
+            var path = _cacheService.GetCachedPagePath(chapter.Id, page);
             if (string.IsNullOrEmpty(path) || !System.IO.File.Exists(path))
                 return BadRequest(await _localizationService.Translate(userId, "no-image-for-page", page));
             var format = Path.GetExtension(path);
 
-            return PhysicalFile(path, format.GetMimeType(), Path.GetFileName(path), true);
+            return PhysicalFile(path, MimeTypeMap.GetMimeType(format), Path.GetFileName(path), true);
         }
         catch (Exception)
         {
@@ -133,8 +132,6 @@ public async Task<ActionResult> GetImage(int chapterId, int page, string apiKey,
         }
     }
 
-
-
     /// <summary>
     /// Returns a thumbnail for the given page number
     /// </summary>
@@ -183,11 +180,11 @@ public async Task<ActionResult> GetBookmarkImage(int seriesId, string apiKey, in
 
         try
         {
-            var path = _cacheService.GetCachedBookmarkPagePath(seriesId, page, Request.SupportedImageTypesFromRequest());
+            var path = _cacheService.GetCachedBookmarkPagePath(seriesId, page);
             if (string.IsNullOrEmpty(path) || !System.IO.File.Exists(path)) return BadRequest(await _localizationService.Translate(userId, "no-image-for-page", page));
             var format = Path.GetExtension(path);
 
-            return PhysicalFile(path, format.GetMimeType(), Path.GetFileName(path));
+            return PhysicalFile(path, MimeTypeMap.GetMimeType(format), Path.GetFileName(path));
         }
         catch (Exception)
         {
@@ -732,7 +729,7 @@ public async Task<ActionResult> BookmarkPage(BookmarkDto bookmarkDto)
         if (chapter == null) return BadRequest(await _localizationService.Translate(User.GetUserId(), "cache-file-find"));
 
         bookmarkDto.Page = _readerService.CapPageToChapter(chapter, bookmarkDto.Page);
-        var path = _cacheService.GetCachedPagePath(chapter.Id, bookmarkDto.Page, Request.SupportedImageTypesFromRequest());
+        var path = _cacheService.GetCachedPagePath(chapter.Id, bookmarkDto.Page);
 
         if (!await _bookmarkService.BookmarkPage(user, bookmarkDto, path))
             return BadRequest(await _localizationService.Translate(User.GetUserId(), "bookmark-save"));
diff --git a/API/Extensions/FileTypeGroupExtensions.cs b/API/Extensions/FileTypeGroupExtensions.cs
index 9cbd33098..24073f642 100644
--- a/API/Extensions/FileTypeGroupExtensions.cs
+++ b/API/Extensions/FileTypeGroupExtensions.cs
@@ -1,7 +1,6 @@
-using System;
+using System;
 using API.Entities.Enums;
 using API.Services.Tasks.Scanner.Parser;
-using MimeTypes;
 
 namespace API.Extensions;
 
@@ -23,13 +22,4 @@ public static string GetRegex(this FileTypeGroup fileTypeGroup)
                 throw new ArgumentOutOfRangeException(nameof(fileTypeGroup), fileTypeGroup, null);
         }
     }
-    public static string GetMimeType(this string format)
-    {
-        //Add jxl format
-        format = format.ToLowerInvariant();
-        if (format == ".jxl")
-            return "image/jxl";
-        return MimeTypeMap.GetMimeType(format);
-    }
-
 }
diff --git a/API/Extensions/HttpExtensions.cs b/API/Extensions/HttpExtensions.cs
index 6287f31f8..fbf828104 100644
--- a/API/Extensions/HttpExtensions.cs
+++ b/API/Extensions/HttpExtensions.cs
@@ -1,8 +1,5 @@
-using System;
-using System.Collections.Generic;
-using System.IO;
+using System.IO;
 using System.Linq;
-using System.Net.NetworkInformation;
 using System.Security.Cryptography;
 using System.Text;
 using System.Text.Json;
@@ -56,31 +53,4 @@ public static void AddCacheHeader(this HttpResponse response, string filename, i
             response.Headers.CacheControl =  $"max-age={maxAge}";
         }
     }
-
-    public static List<string> SupportedImageTypesFromRequest(this HttpRequest request)
-    {
-        var acceptHeader = request.Headers["Accept"];
-        string[] spl1 = acceptHeader.ToString().Split(';');
-        acceptHeader = spl1[0];
-        string[] split = acceptHeader.ToString().Split(',');
-        List<string> defaultExtensions = new List<string>();
-        defaultExtensions.Add("jpeg");
-        defaultExtensions.Add("jpg");
-        defaultExtensions.Add("png");
-        defaultExtensions.Add("gif");
-
-        foreach (string v in split)
-        {
-            if (v.StartsWith("image/", StringComparison.InvariantCultureIgnoreCase))
-            {
-                string n = v.Substring(6);
-                if (n == "svg+xml")
-                    n = "svg";
-                if (n.StartsWith("*"))
-                    continue;
-                defaultExtensions.Add(n.ToLowerInvariant());
-            }
-        }
-        return defaultExtensions;
-    }
 }
diff --git a/API/Services/ArchiveService.cs b/API/Services/ArchiveService.cs
index 641c25c0d..8a4284402 100644
--- a/API/Services/ArchiveService.cs
+++ b/API/Services/ArchiveService.cs
@@ -58,16 +58,17 @@ public class ArchiveService : IArchiveService
     private readonly IDirectoryService _directoryService;
     private readonly IImageService _imageService;
     private readonly IMediaErrorService _mediaErrorService;
-
+    private readonly IImageConverterService _converterService;
     private const string ComicInfoFilename = "ComicInfo.xml";
 
     public ArchiveService(ILogger<ArchiveService> logger, IDirectoryService directoryService,
-        IImageService imageService, IMediaErrorService mediaErrorService)
+        IImageService imageService, IMediaErrorService mediaErrorService, IImageConverterService converterService)
     {
         _logger = logger;
         _directoryService = directoryService;
         _imageService = imageService;
         _mediaErrorService = mediaErrorService;
+        _converterService = converterService;
     }
 
     /// <summary>
@@ -232,8 +233,8 @@ public string GetCoverImage(string archivePath, string fileName, string outputDi
                     var entryName = FindCoverImageFilename(archivePath, archive.Entries.Select(e => e.FullName));
                     var entry = archive.Entries.Single(e => e.FullName == entryName);
 
-                    using var stream = entry.Open();
-                    return _imageService.WriteCoverThumbnail(entryName, stream, fileName, outputDirectory, format, size);
+                    using var stream = _converterService.ConvertStream(entryName, entry.Open());
+                    return _imageService.WriteCoverThumbnail(stream, fileName, outputDirectory, format, size);
                 }
                 case ArchiveLibrary.SharpCompress:
                 {
@@ -243,8 +244,8 @@ public string GetCoverImage(string archivePath, string fileName, string outputDi
                     var entryName = FindCoverImageFilename(archivePath, entryNames);
                     var entry = archive.Entries.Single(e => e.Key == entryName);
 
-                    using var stream = entry.OpenEntryStream();
-                    return _imageService.WriteCoverThumbnail(entryName, stream, fileName, outputDirectory, format, size);
+                    using var stream = _converterService.ConvertStream(entryName, entry.OpenEntryStream());
+                    return _imageService.WriteCoverThumbnail(stream, fileName, outputDirectory, format, size);
                 }
                 case ArchiveLibrary.NotSupported:
                     _logger.LogWarning("[GetCoverImage] This archive cannot be read: {ArchivePath}. Defaulting to no cover image", archivePath);
@@ -561,6 +562,7 @@ public void ExtractArchive(string archivePath, string extractPath)
                 {
                     using var archive = ZipFile.OpenRead(archivePath);
                     ExtractArchiveEntries(archive, extractPath);
+                    _converterService.ConvertDirectory(extractPath);
                     break;
                 }
                 case ArchiveLibrary.SharpCompress:
@@ -569,6 +571,7 @@ public void ExtractArchive(string archivePath, string extractPath)
                     ExtractArchiveEntities(archive.Entries.Where(entry => !entry.IsDirectory
                                                                           && !Tasks.Scanner.Parser.Parser.HasBlacklistedFolderInPath(Path.GetDirectoryName(entry.Key) ?? string.Empty)
                                                                           && Tasks.Scanner.Parser.Parser.IsImage(entry.Key)), extractPath);
+                    _converterService.ConvertDirectory(extractPath);
                     break;
                 }
                 case ArchiveLibrary.NotSupported:
diff --git a/API/Services/BookService.cs b/API/Services/BookService.cs
index cb22f24d6..e4ed92047 100644
--- a/API/Services/BookService.cs
+++ b/API/Services/BookService.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Collections.Generic;
 using System.Globalization;
 using System.IO;
@@ -1229,7 +1229,7 @@ public string GetCoverImage(string fileFilePath, string fileName, string outputD
             if (coverImageContent == null) return string.Empty;
             using var stream = coverImageContent.GetContentStream();
 
-            return _imageService.WriteCoverThumbnail(fileFilePath, stream, fileName, outputDirectory, encodeFormat, size);
+            return _imageService.WriteCoverThumbnail(stream, fileName, outputDirectory, encodeFormat, size);
         }
         catch (Exception ex)
         {
@@ -1252,7 +1252,7 @@ private string GetPdfCoverImage(string fileFilePath, string fileName, string out
             using var stream = StreamManager.GetStream("BookService.GetPdfPage");
             GetPdfPage(docReader, 0, stream);
 
-            return _imageService.WriteCoverThumbnail(fileFilePath, stream, fileName, outputDirectory, encodeFormat, size);
+            return _imageService.WriteCoverThumbnail(stream, fileName, outputDirectory, encodeFormat, size);
 
         }
         catch (Exception ex)
diff --git a/API/Services/CacheService.cs b/API/Services/CacheService.cs
index a00df5879..c6e539348 100644
--- a/API/Services/CacheService.cs
+++ b/API/Services/CacheService.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Collections.Concurrent;
 using System.Collections.Generic;
 using System.Diagnostics;
@@ -13,7 +13,6 @@
 using API.Extensions;
 using Kavita.Common;
 using Microsoft.Extensions.Logging;
-using MimeKit.Tnef;
 using NetVips;
 
 namespace API.Services;
@@ -35,12 +34,12 @@ public interface ICacheService
     /// <param name="chapterIds">Volumes that belong to that library. Assume the library might have been deleted before this invocation.</param>
     void CleanupChapters(IEnumerable<int> chapterIds);
     void CleanupBookmarks(IEnumerable<int> seriesIds);
-    string GetCachedPagePath(int chapterId, int page, List<string> supportedImageFormats = null);
+    string GetCachedPagePath(int chapterId, int page);
     string GetCachePath(int chapterId);
     string GetBookmarkCachePath(int seriesId);
     IEnumerable<string> GetCachedPages(int chapterId);
     IEnumerable<FileDimensionDto> GetCachedFileDimensions(string cachePath);
-    string GetCachedBookmarkPagePath(int seriesId, int page, List<string> supportedImageFormats = null);
+    string GetCachedBookmarkPagePath(int seriesId, int page);
     string GetCachedFile(Chapter chapter);
     public void ExtractChapterFiles(string extractPath, IReadOnlyList<MangaFile> files, bool extractPdfImages = false);
     Task<int> CacheBookmarkForSeries(int userId, int seriesId);
@@ -53,19 +52,18 @@ public class CacheService : ICacheService
     private readonly IDirectoryService _directoryService;
     private readonly IReadingItemService _readingItemService;
     private readonly IBookmarkService _bookmarkService;
-    private readonly IImageConverterService _converterService;
+
     private static readonly ConcurrentDictionary<int, SemaphoreSlim> ExtractLocks = new();
 
     public CacheService(ILogger<CacheService> logger, IUnitOfWork unitOfWork,
         IDirectoryService directoryService, IReadingItemService readingItemService,
-        IBookmarkService bookmarkService, IImageConverterService converterService)
+        IBookmarkService bookmarkService)
     {
         _logger = logger;
         _unitOfWork = unitOfWork;
         _directoryService = directoryService;
         _readingItemService = readingItemService;
         _bookmarkService = bookmarkService;
-        _converterService = converterService;
     }
 
     public IEnumerable<string> GetCachedPages(int chapterId)
@@ -100,19 +98,13 @@ public IEnumerable<FileDimensionDto> GetCachedFileDimensions(string cachePath)
             for (var i = 0; i < files.Length; i++)
             {
                 var file = files[i];
-                var dimension = _converterService.GetDimensions(file, i);
-                if (dimension == null)
-                {
-                    using var image = Image.NewFromFile(file, memory: false, access: Enums.Access.SequentialUnbuffered);
-                    dimension = (image.Width, image.Height);
-                }
-                
+                using var image = Image.NewFromFile(file, memory: false, access: Enums.Access.SequentialUnbuffered);
                 dimensions.Add(new FileDimensionDto()
                 {
                     PageNumber = i,
-                    Height = dimension.Value.Height,
-                    Width = dimension.Value.Width,
-                    IsWide = dimension.Value.Width > dimension.Value.Height,
+                    Height = image.Height,
+                    Width = image.Width,
+                    IsWide = image.Width > image.Height,
                     FileName = file.Replace(cachePath, string.Empty)
                 });
             }
@@ -130,7 +122,7 @@ public IEnumerable<FileDimensionDto> GetCachedFileDimensions(string cachePath)
         return dimensions;
     }
 
-    public string GetCachedBookmarkPagePath(int seriesId, int page, List<string> supportedImageFormats = null)
+    public string GetCachedBookmarkPagePath(int seriesId, int page)
     {
         // Calculate what chapter the page belongs to
         var path = GetBookmarkCachePath(seriesId);
@@ -146,8 +138,7 @@ public string GetCachedBookmarkPagePath(int seriesId, int page, List<string> sup
         }
 
         // Since array is 0 based, we need to keep that in account (only affects last image)
-        string file=page == files.Length ? files[page - 1] : files[page];
-        return _converterService.ConvertFile(file, supportedImageFormats);
+        return page == files.Length ? files[page - 1] : files[page];
     }
 
     /// <summary>
@@ -325,7 +316,7 @@ public string GetBookmarkCachePath(int seriesId)
     /// <param name="chapterId">Chapter id with Files populated.</param>
     /// <param name="page">Page number to look for</param>
     /// <returns>Page filepath or empty if no files found.</returns>
-    public string GetCachedPagePath(int chapterId, int page, List<string> supportedImageFormats = null)
+    public string GetCachedPagePath(int chapterId, int page)
     {
         // Calculate what chapter the page belongs to
         var path = GetCachePath(chapterId);
@@ -334,8 +325,7 @@ public string GetCachedPagePath(int chapterId, int page, List<string> supportedI
             //.OrderByNatural(Path.GetFileNameWithoutExtension) // This is already done in GetPageFromFiles
             .ToArray();
 
-        string file = GetPageFromFiles(files, page);
-        return _converterService.ConvertFile(file, supportedImageFormats);
+        return GetPageFromFiles(files, page);
     }
 
     public async Task<int> CacheBookmarkForSeries(int userId, int seriesId)
diff --git a/API/Services/ImageConversion/JpegXLImageConverterProvider.cs b/API/Services/ImageConversion/JpegXLImageConverterProvider.cs
index 3bd1a2f11..95b399afd 100644
--- a/API/Services/ImageConversion/JpegXLImageConverterProvider.cs
+++ b/API/Services/ImageConversion/JpegXLImageConverterProvider.cs
@@ -1,6 +1,5 @@
 using System;
 using System.IO;
-using System.Text.RegularExpressions;
 using System.Threading;
 using Kavita.Common.EnvironmentInfo;
 
@@ -11,7 +10,6 @@ public interface IImageConverterProvider
     string Extension { get; }
     bool IsSupported(string filename);
     string Convert(string filename);
-    (int Width, int Height)? GetDimensions(string fileName, int pageNumber);
 }
 
 public class JpegXLImageConverterProvider : IImageConverterProvider
@@ -39,8 +37,6 @@ internal bool AppFound
     }
     private string exeFile => OsInfo.IsWindows ? "djxl.exe" : "djxl";
 
-    private string infoFile => OsInfo.IsWindows ? "jxlinfo.exe" : "jxlinfo";
-
     public bool IsSupported(string filename)
     {
         if (AppFound)
@@ -48,18 +44,6 @@ public bool IsSupported(string filename)
         return false;
     }
 
-    private static Regex dimensions = new Regex(@",\s?(\d+)x(\d+),", RegexOptions.Compiled);
-    public (int Width, int Height)? GetDimensions(string fileName, int pageNumber)
-    {
-        if (!AppFound)
-            return null;
-        string output = OsInfo.RunAndCapture(infoFile, "\"" + fileName + "\"", Timeout.Infinite);
-        Match m= dimensions.Match(output);
-        if (!m.Success)
-            return null;
-        return (int.Parse(m.Groups[1].Value), int.Parse(m.Groups[2].Value));
-    }
-
     public string Extension => ".jxl";
     public string Convert(string filename)
     {
diff --git a/API/Services/ImageConverterService.cs b/API/Services/ImageConverterService.cs
index e2f61dd7a..08cab27a8 100644
--- a/API/Services/ImageConverterService.cs
+++ b/API/Services/ImageConverterService.cs
@@ -6,16 +6,14 @@
 using System.Linq;
 using API.Services.ImageConversion;
 using static Org.BouncyCastle.Bcpg.Attr.ImageAttrib;
-using API.DTOs.Reader;
 
 namespace API.Services
 {
     public interface IImageConverterService
     {
         Stream ConvertStream(string filename, Stream source);
-        string ConvertFile(string filename, List<string> supportedImageFormats);
+        string ConvertFile(string filename);
         void ConvertDirectory(string directory);
-        (int Width, int Height)? GetDimensions(string fileName, int pageNumber);
     }
 
     public class ImageConverterService : IImageConverterService
@@ -43,18 +41,8 @@ public Stream ConvertStream(string filename, Stream source)
             return File.OpenRead(provider.Convert(tempFile));
         }
 
-        private bool CheckDirectSupport(string filename, List<string> supportedImageFormats)
+        public string ConvertFile(string filename)
         {
-            if (supportedImageFormats == null)
-                return false;
-            string ext = Path.GetExtension(filename).ToLowerInvariant().Substring(1);
-            return supportedImageFormats.Contains(ext);
-        }
-
-        public string ConvertFile(string filename, List<string> supportedImageFormats)
-        {
-            if (CheckDirectSupport(filename, supportedImageFormats))
-                return filename;
             IImageConverterProvider provider = _converters.FirstOrDefault(a => a.IsSupported(filename));
             if (provider == null)
                 return filename;
@@ -70,13 +58,5 @@ public void ConvertDirectory(string directory)
                     provider.Convert(filename);
             }
         }
-
-        public (int Width, int Height)? GetDimensions(string fileName, int pageNumber)
-        {
-            IImageConverterProvider provider = _converters.FirstOrDefault(a => a.IsSupported(fileName));
-            if (provider == null)
-                return null;
-            return provider.GetDimensions(fileName, pageNumber);
-        }
     }
 }
diff --git a/API/Services/ImageService.cs b/API/Services/ImageService.cs
index 6d9eb2b26..f8b10388e 100644
--- a/API/Services/ImageService.cs
+++ b/API/Services/ImageService.cs
@@ -47,7 +47,7 @@ public interface IImageService
     /// <param name="outputDirectory"></param>
     /// <param name="encodeFormat"></param>
     /// <returns></returns>
-    string WriteCoverThumbnail(string sourceFile, Stream stream, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size = CoverImageSize.Default);
+    string WriteCoverThumbnail(Stream stream, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size = CoverImageSize.Default);
     /// <summary>
     /// Writes out a thumbnail by file path input
     /// </summary>
@@ -218,7 +218,7 @@ public string GetCoverImage(string path, string fileName, string outputDirectory
 
         try
         {
-            fileName = _converterService.ConvertFile(fileName, null);
+            fileName = _converterService.ConvertFile(fileName);
             var (width, height) = size.GetDimensions();
             using var sourceImage = Image.NewFromFile(path, false, Enums.Access.SequentialUnbuffered);
 
@@ -246,9 +246,8 @@ public string GetCoverImage(string path, string fileName, string outputDirectory
     /// <param name="outputDirectory">Where to output the file, defaults to covers directory</param>
     /// <param name="encodeFormat">Export the file as the passed encoding</param>
     /// <returns>File name with extension of the file. This will always write to <see cref="DirectoryService.CoverImageDirectory"/></returns>
-    public string WriteCoverThumbnail(string sourceFile, Stream stream, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size = CoverImageSize.Default)
+    public string WriteCoverThumbnail(Stream stream, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size = CoverImageSize.Default)
     {
-        stream = _converterService.ConvertStream(sourceFile, stream);
         var (targetWidth, targetHeight) = size.GetDimensions();
         if (stream.CanSeek) stream.Position = 0;
         using var sourceImage = Image.NewFromStream(stream);
@@ -291,8 +290,6 @@ public string WriteCoverThumbnail(string sourceFile, Stream stream, string fileN
 
     public string WriteCoverThumbnail(string sourceFile, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size = CoverImageSize.Default)
     {
-        sourceFile = _converterService.ConvertFile(sourceFile,null);
-
         var (width, height) = size.GetDimensions();
         using var sourceImage = Image.NewFromFile(sourceFile, false, Enums.Access.SequentialUnbuffered);
 

From cf05e5f36eb6550c2da531f9b215ba5348054a5e Mon Sep 17 00:00:00 2001
From: Maximo Piva <mpiva@adventintermodal.com>
Date: Mon, 26 Aug 2024 00:27:21 -0300
Subject: [PATCH 06/30] Reapply "Changed the way conversion happens."

This reverts commit 9d48664b08f01303f1527bc1c577e1d4376f89ff.
---
 API.Tests/Services/ArchiveServiceTests.cs     |  6 ++--
 API.Tests/Services/CacheServiceTests.cs       | 16 ++++-----
 API/API.csproj                                |  3 +-
 API/Controllers/OPDSController.cs             |  4 +--
 API/Controllers/ReaderController.cs           | 13 ++++---
 API/Extensions/FileTypeGroupExtensions.cs     | 12 ++++++-
 API/Extensions/HttpExtensions.cs              | 32 ++++++++++++++++-
 API/Services/ArchiveService.cs                | 15 ++++----
 API/Services/BookService.cs                   |  6 ++--
 API/Services/CacheService.cs                  | 36 ++++++++++++-------
 .../JpegXLImageConverterProvider.cs           | 16 +++++++++
 API/Services/ImageConverterService.cs         | 24 +++++++++++--
 API/Services/ImageService.cs                  |  9 +++--
 13 files changed, 140 insertions(+), 52 deletions(-)

diff --git a/API.Tests/Services/ArchiveServiceTests.cs b/API.Tests/Services/ArchiveServiceTests.cs
index 27a93ea64..530affbf3 100644
--- a/API.Tests/Services/ArchiveServiceTests.cs
+++ b/API.Tests/Services/ArchiveServiceTests.cs
@@ -30,7 +30,7 @@ public ArchiveServiceTests(ITestOutputHelper testOutputHelper)
         _testOutputHelper = testOutputHelper;
         _archiveService = new ArchiveService(_logger, _directoryService,
             new ImageService(Substitute.For<ILogger<ImageService>>(), _directoryService, Substitute.For<IEasyCachingProviderFactory>(), Substitute.For<IImageConverterService>()),
-            Substitute.For<IMediaErrorService>(), Substitute.For<IImageConverterService>());
+            Substitute.For<IMediaErrorService>());
     }
 
     [Theory]
@@ -224,9 +224,9 @@ public void GetCoverImage_SharpCompress_Test(string inputFile, string expectedOu
     public void CanParseCoverImage(string inputFile)
     {
         var imageService = Substitute.For<IImageService>();
-        imageService.WriteCoverThumbnail(Arg.Any<Stream>(), Arg.Any<string>(), Arg.Any<string>(), Arg.Any<EncodeFormat>())
+        imageService.WriteCoverThumbnail(Arg.Any<string>(), Arg.Any<Stream>(), Arg.Any<string>(), Arg.Any<string>(), Arg.Any<EncodeFormat>())
             .Returns(x => "cover.jpg");
-        var archiveService = new ArchiveService(_logger, _directoryService, imageService, Substitute.For<IMediaErrorService>(),Substitute.For<IImageConverterService>());
+        var archiveService = new ArchiveService(_logger, _directoryService, imageService, Substitute.For<IMediaErrorService>());
         var testDirectory = Path.Join(Directory.GetCurrentDirectory(), "../../../Services/Test Data/ArchiveService/");
         var inputPath = Path.GetFullPath(Path.Join(testDirectory, inputFile));
         var outputPath = Path.Join(testDirectory, Path.GetFileNameWithoutExtension(inputFile) + "_output");
diff --git a/API.Tests/Services/CacheServiceTests.cs b/API.Tests/Services/CacheServiceTests.cs
index ba06525a3..c5ae07bee 100644
--- a/API.Tests/Services/CacheServiceTests.cs
+++ b/API.Tests/Services/CacheServiceTests.cs
@@ -1,4 +1,4 @@
-using System.Collections.Generic;
+using System.Collections.Generic;
 using System.Data.Common;
 using System.IO;
 using System.IO.Abstractions.TestingHelpers;
@@ -158,7 +158,7 @@ public async Task Ensure_DirectoryAlreadyExists_DontExtractAnything()
             new ReadingItemService(Substitute.For<IArchiveService>(),
                 Substitute.For<IBookService>(),
                 Substitute.For<IImageService>(), ds, Substitute.For<ILogger<ReadingItemService>>()),
-            Substitute.For<IBookmarkService>());
+            Substitute.For<IBookmarkService>(), Substitute.For<IImageConverterService>());
 
         await ResetDB();
         var s = new SeriesBuilder("Test").Build();
@@ -234,7 +234,7 @@ public void CleanupChapters_AllFilesShouldBeDeleted()
         var cleanupService = new CacheService(_logger, _unitOfWork, ds,
             new ReadingItemService(Substitute.For<IArchiveService>(),
                 Substitute.For<IBookService>(), Substitute.For<IImageService>(), ds, Substitute.For<ILogger<ReadingItemService>>()),
-            Substitute.For<IBookmarkService>());
+            Substitute.For<IBookmarkService>(), Substitute.For<IImageConverterService>());
 
         cleanupService.CleanupChapters(new []{1, 3});
         Assert.Empty(ds.GetFiles(CacheDirectory, searchOption:SearchOption.AllDirectories));
@@ -256,7 +256,7 @@ public void GetCachedEpubFile_ShouldReturnFirstEpub()
         var cs = new CacheService(_logger, _unitOfWork, ds,
             new ReadingItemService(Substitute.For<IArchiveService>(),
                 Substitute.For<IBookService>(), Substitute.For<IImageService>(), ds, Substitute.For<ILogger<ReadingItemService>>()),
-            Substitute.For<IBookmarkService>());
+            Substitute.For<IBookmarkService>(), Substitute.For<IImageConverterService>());
 
         var c = new ChapterBuilder("1")
             .WithFile(new MangaFileBuilder($"{DataDirectory}1.epub", MangaFormat.Epub).Build())
@@ -297,7 +297,7 @@ public void GetCachedPagePath_ReturnNullIfNoFiles()
         var cs = new CacheService(_logger, _unitOfWork, ds,
             new ReadingItemService(Substitute.For<IArchiveService>(),
                 Substitute.For<IBookService>(), Substitute.For<IImageService>(), ds, Substitute.For<ILogger<ReadingItemService>>()),
-            Substitute.For<IBookmarkService>());
+            Substitute.For<IBookmarkService>(),Substitute.For<IImageConverterService>());
 
         // Flatten to prepare for how GetFullPath expects
         ds.Flatten($"{CacheDirectory}1/");
@@ -341,7 +341,7 @@ public void GetCachedPagePath_GetFileFromFirstFile()
         var cs = new CacheService(_logger, _unitOfWork, ds,
             new ReadingItemService(Substitute.For<IArchiveService>(),
                 Substitute.For<IBookService>(), Substitute.For<IImageService>(), ds, Substitute.For<ILogger<ReadingItemService>>()),
-            Substitute.For<IBookmarkService>());
+            Substitute.For<IBookmarkService>(), Substitute.For<IImageConverterService>());
 
         // Flatten to prepare for how GetFullPath expects
         ds.Flatten($"{CacheDirectory}1/");
@@ -382,7 +382,7 @@ public void GetCachedPagePath_GetLastPageFromSingleFile()
         var cs = new CacheService(_logger, _unitOfWork, ds,
             new ReadingItemService(Substitute.For<IArchiveService>(),
                 Substitute.For<IBookService>(), Substitute.For<IImageService>(), ds, Substitute.For<ILogger<ReadingItemService>>()),
-            Substitute.For<IBookmarkService>());
+            Substitute.For<IBookmarkService>(), Substitute.For<IImageConverterService>());
 
         // Flatten to prepare for how GetFullPath expects
         ds.Flatten($"{CacheDirectory}1/");
@@ -427,7 +427,7 @@ public void GetCachedPagePath_GetFileFromSecondFile()
         var cs = new CacheService(_logger, _unitOfWork, ds,
             new ReadingItemService(Substitute.For<IArchiveService>(),
                 Substitute.For<IBookService>(), Substitute.For<IImageService>(), ds, Substitute.For<ILogger<ReadingItemService>>()),
-            Substitute.For<IBookmarkService>());
+            Substitute.For<IBookmarkService>(), Substitute.For<IImageConverterService>());
 
         // Flatten to prepare for how GetFullPath expects
         ds.Flatten($"{CacheDirectory}1/");
diff --git a/API/API.csproj b/API/API.csproj
index 9cdecc8d1..1755146ff 100644
--- a/API/API.csproj
+++ b/API/API.csproj
@@ -13,8 +13,7 @@
   </PropertyGroup>
 
   <Target Name="PostBuild" AfterTargets="Build" Condition=" '$(Configuration)' == 'Debug' ">
-      <Delete Files="../openapi.json" />
-      <Exec Command="swagger tofile --output ../openapi.json bin/$(Configuration)/$(TargetFramework)/$(AssemblyName).dll v1" />
+
   </Target>
 
   <PropertyGroup Condition=" '$(Configuration)' == 'Release' ">
diff --git a/API/Controllers/OPDSController.cs b/API/Controllers/OPDSController.cs
index d25321ad8..0b260a537 100644
--- a/API/Controllers/OPDSController.cs
+++ b/API/Controllers/OPDSController.cs
@@ -1228,7 +1228,7 @@ public async Task<ActionResult> GetPageStreamedImage(string apiKey, [FromQuery]
 
         try
         {
-            var path = _cacheService.GetCachedPagePath(chapter.Id, pageNumber);
+            var path = _cacheService.GetCachedPagePath(chapter.Id, pageNumber, Request.SupportedImageTypesFromRequest());
             if (string.IsNullOrEmpty(path) || !System.IO.File.Exists(path))
                 return BadRequest(await _localizationService.Translate(userId, "no-image-for-page", pageNumber));
 
@@ -1252,7 +1252,7 @@ await _readerService.SaveReadingProgress(new ProgressDto()
                 }, userId);
             }
 
-            return File(content, MimeTypeMap.GetMimeType(format));
+            return File(content, format.GetMimeType());
         }
         catch (Exception)
         {
diff --git a/API/Controllers/ReaderController.cs b/API/Controllers/ReaderController.cs
index 159c8c922..99d096f74 100644
--- a/API/Controllers/ReaderController.cs
+++ b/API/Controllers/ReaderController.cs
@@ -23,6 +23,7 @@
 using Microsoft.Extensions.Logging;
 using Microsoft.IdentityModel.Tokens;
 using MimeTypes;
+using Org.BouncyCastle.Ocsp;
 
 namespace API.Controllers;
 
@@ -118,12 +119,12 @@ public async Task<ActionResult> GetImage(int chapterId, int page, string apiKey,
             var chapter = await _cacheService.Ensure(chapterId, extractPdf);
             if (chapter == null) return NoContent();
             _logger.LogInformation("Fetching Page {PageNum} on Chapter {ChapterId}", page, chapterId);
-            var path = _cacheService.GetCachedPagePath(chapter.Id, page);
+            var path = _cacheService.GetCachedPagePath(chapter.Id, page, Request.SupportedImageTypesFromRequest());
             if (string.IsNullOrEmpty(path) || !System.IO.File.Exists(path))
                 return BadRequest(await _localizationService.Translate(userId, "no-image-for-page", page));
             var format = Path.GetExtension(path);
 
-            return PhysicalFile(path, MimeTypeMap.GetMimeType(format), Path.GetFileName(path), true);
+            return PhysicalFile(path, format.GetMimeType(), Path.GetFileName(path), true);
         }
         catch (Exception)
         {
@@ -132,6 +133,8 @@ public async Task<ActionResult> GetImage(int chapterId, int page, string apiKey,
         }
     }
 
+
+
     /// <summary>
     /// Returns a thumbnail for the given page number
     /// </summary>
@@ -180,11 +183,11 @@ public async Task<ActionResult> GetBookmarkImage(int seriesId, string apiKey, in
 
         try
         {
-            var path = _cacheService.GetCachedBookmarkPagePath(seriesId, page);
+            var path = _cacheService.GetCachedBookmarkPagePath(seriesId, page, Request.SupportedImageTypesFromRequest());
             if (string.IsNullOrEmpty(path) || !System.IO.File.Exists(path)) return BadRequest(await _localizationService.Translate(userId, "no-image-for-page", page));
             var format = Path.GetExtension(path);
 
-            return PhysicalFile(path, MimeTypeMap.GetMimeType(format), Path.GetFileName(path));
+            return PhysicalFile(path, format.GetMimeType(), Path.GetFileName(path));
         }
         catch (Exception)
         {
@@ -729,7 +732,7 @@ public async Task<ActionResult> BookmarkPage(BookmarkDto bookmarkDto)
         if (chapter == null) return BadRequest(await _localizationService.Translate(User.GetUserId(), "cache-file-find"));
 
         bookmarkDto.Page = _readerService.CapPageToChapter(chapter, bookmarkDto.Page);
-        var path = _cacheService.GetCachedPagePath(chapter.Id, bookmarkDto.Page);
+        var path = _cacheService.GetCachedPagePath(chapter.Id, bookmarkDto.Page, Request.SupportedImageTypesFromRequest());
 
         if (!await _bookmarkService.BookmarkPage(user, bookmarkDto, path))
             return BadRequest(await _localizationService.Translate(User.GetUserId(), "bookmark-save"));
diff --git a/API/Extensions/FileTypeGroupExtensions.cs b/API/Extensions/FileTypeGroupExtensions.cs
index 24073f642..9cbd33098 100644
--- a/API/Extensions/FileTypeGroupExtensions.cs
+++ b/API/Extensions/FileTypeGroupExtensions.cs
@@ -1,6 +1,7 @@
-using System;
+using System;
 using API.Entities.Enums;
 using API.Services.Tasks.Scanner.Parser;
+using MimeTypes;
 
 namespace API.Extensions;
 
@@ -22,4 +23,13 @@ public static string GetRegex(this FileTypeGroup fileTypeGroup)
                 throw new ArgumentOutOfRangeException(nameof(fileTypeGroup), fileTypeGroup, null);
         }
     }
+    public static string GetMimeType(this string format)
+    {
+        //Add jxl format
+        format = format.ToLowerInvariant();
+        if (format == ".jxl")
+            return "image/jxl";
+        return MimeTypeMap.GetMimeType(format);
+    }
+
 }
diff --git a/API/Extensions/HttpExtensions.cs b/API/Extensions/HttpExtensions.cs
index fbf828104..6287f31f8 100644
--- a/API/Extensions/HttpExtensions.cs
+++ b/API/Extensions/HttpExtensions.cs
@@ -1,5 +1,8 @@
-using System.IO;
+using System;
+using System.Collections.Generic;
+using System.IO;
 using System.Linq;
+using System.Net.NetworkInformation;
 using System.Security.Cryptography;
 using System.Text;
 using System.Text.Json;
@@ -53,4 +56,31 @@ public static void AddCacheHeader(this HttpResponse response, string filename, i
             response.Headers.CacheControl =  $"max-age={maxAge}";
         }
     }
+
+    public static List<string> SupportedImageTypesFromRequest(this HttpRequest request)
+    {
+        var acceptHeader = request.Headers["Accept"];
+        string[] spl1 = acceptHeader.ToString().Split(';');
+        acceptHeader = spl1[0];
+        string[] split = acceptHeader.ToString().Split(',');
+        List<string> defaultExtensions = new List<string>();
+        defaultExtensions.Add("jpeg");
+        defaultExtensions.Add("jpg");
+        defaultExtensions.Add("png");
+        defaultExtensions.Add("gif");
+
+        foreach (string v in split)
+        {
+            if (v.StartsWith("image/", StringComparison.InvariantCultureIgnoreCase))
+            {
+                string n = v.Substring(6);
+                if (n == "svg+xml")
+                    n = "svg";
+                if (n.StartsWith("*"))
+                    continue;
+                defaultExtensions.Add(n.ToLowerInvariant());
+            }
+        }
+        return defaultExtensions;
+    }
 }
diff --git a/API/Services/ArchiveService.cs b/API/Services/ArchiveService.cs
index 8a4284402..641c25c0d 100644
--- a/API/Services/ArchiveService.cs
+++ b/API/Services/ArchiveService.cs
@@ -58,17 +58,16 @@ public class ArchiveService : IArchiveService
     private readonly IDirectoryService _directoryService;
     private readonly IImageService _imageService;
     private readonly IMediaErrorService _mediaErrorService;
-    private readonly IImageConverterService _converterService;
+
     private const string ComicInfoFilename = "ComicInfo.xml";
 
     public ArchiveService(ILogger<ArchiveService> logger, IDirectoryService directoryService,
-        IImageService imageService, IMediaErrorService mediaErrorService, IImageConverterService converterService)
+        IImageService imageService, IMediaErrorService mediaErrorService)
     {
         _logger = logger;
         _directoryService = directoryService;
         _imageService = imageService;
         _mediaErrorService = mediaErrorService;
-        _converterService = converterService;
     }
 
     /// <summary>
@@ -233,8 +232,8 @@ public string GetCoverImage(string archivePath, string fileName, string outputDi
                     var entryName = FindCoverImageFilename(archivePath, archive.Entries.Select(e => e.FullName));
                     var entry = archive.Entries.Single(e => e.FullName == entryName);
 
-                    using var stream = _converterService.ConvertStream(entryName, entry.Open());
-                    return _imageService.WriteCoverThumbnail(stream, fileName, outputDirectory, format, size);
+                    using var stream = entry.Open();
+                    return _imageService.WriteCoverThumbnail(entryName, stream, fileName, outputDirectory, format, size);
                 }
                 case ArchiveLibrary.SharpCompress:
                 {
@@ -244,8 +243,8 @@ public string GetCoverImage(string archivePath, string fileName, string outputDi
                     var entryName = FindCoverImageFilename(archivePath, entryNames);
                     var entry = archive.Entries.Single(e => e.Key == entryName);
 
-                    using var stream = _converterService.ConvertStream(entryName, entry.OpenEntryStream());
-                    return _imageService.WriteCoverThumbnail(stream, fileName, outputDirectory, format, size);
+                    using var stream = entry.OpenEntryStream();
+                    return _imageService.WriteCoverThumbnail(entryName, stream, fileName, outputDirectory, format, size);
                 }
                 case ArchiveLibrary.NotSupported:
                     _logger.LogWarning("[GetCoverImage] This archive cannot be read: {ArchivePath}. Defaulting to no cover image", archivePath);
@@ -562,7 +561,6 @@ public void ExtractArchive(string archivePath, string extractPath)
                 {
                     using var archive = ZipFile.OpenRead(archivePath);
                     ExtractArchiveEntries(archive, extractPath);
-                    _converterService.ConvertDirectory(extractPath);
                     break;
                 }
                 case ArchiveLibrary.SharpCompress:
@@ -571,7 +569,6 @@ public void ExtractArchive(string archivePath, string extractPath)
                     ExtractArchiveEntities(archive.Entries.Where(entry => !entry.IsDirectory
                                                                           && !Tasks.Scanner.Parser.Parser.HasBlacklistedFolderInPath(Path.GetDirectoryName(entry.Key) ?? string.Empty)
                                                                           && Tasks.Scanner.Parser.Parser.IsImage(entry.Key)), extractPath);
-                    _converterService.ConvertDirectory(extractPath);
                     break;
                 }
                 case ArchiveLibrary.NotSupported:
diff --git a/API/Services/BookService.cs b/API/Services/BookService.cs
index e4ed92047..cb22f24d6 100644
--- a/API/Services/BookService.cs
+++ b/API/Services/BookService.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Collections.Generic;
 using System.Globalization;
 using System.IO;
@@ -1229,7 +1229,7 @@ public string GetCoverImage(string fileFilePath, string fileName, string outputD
             if (coverImageContent == null) return string.Empty;
             using var stream = coverImageContent.GetContentStream();
 
-            return _imageService.WriteCoverThumbnail(stream, fileName, outputDirectory, encodeFormat, size);
+            return _imageService.WriteCoverThumbnail(fileFilePath, stream, fileName, outputDirectory, encodeFormat, size);
         }
         catch (Exception ex)
         {
@@ -1252,7 +1252,7 @@ private string GetPdfCoverImage(string fileFilePath, string fileName, string out
             using var stream = StreamManager.GetStream("BookService.GetPdfPage");
             GetPdfPage(docReader, 0, stream);
 
-            return _imageService.WriteCoverThumbnail(stream, fileName, outputDirectory, encodeFormat, size);
+            return _imageService.WriteCoverThumbnail(fileFilePath, stream, fileName, outputDirectory, encodeFormat, size);
 
         }
         catch (Exception ex)
diff --git a/API/Services/CacheService.cs b/API/Services/CacheService.cs
index c6e539348..a00df5879 100644
--- a/API/Services/CacheService.cs
+++ b/API/Services/CacheService.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Collections.Concurrent;
 using System.Collections.Generic;
 using System.Diagnostics;
@@ -13,6 +13,7 @@
 using API.Extensions;
 using Kavita.Common;
 using Microsoft.Extensions.Logging;
+using MimeKit.Tnef;
 using NetVips;
 
 namespace API.Services;
@@ -34,12 +35,12 @@ public interface ICacheService
     /// <param name="chapterIds">Volumes that belong to that library. Assume the library might have been deleted before this invocation.</param>
     void CleanupChapters(IEnumerable<int> chapterIds);
     void CleanupBookmarks(IEnumerable<int> seriesIds);
-    string GetCachedPagePath(int chapterId, int page);
+    string GetCachedPagePath(int chapterId, int page, List<string> supportedImageFormats = null);
     string GetCachePath(int chapterId);
     string GetBookmarkCachePath(int seriesId);
     IEnumerable<string> GetCachedPages(int chapterId);
     IEnumerable<FileDimensionDto> GetCachedFileDimensions(string cachePath);
-    string GetCachedBookmarkPagePath(int seriesId, int page);
+    string GetCachedBookmarkPagePath(int seriesId, int page, List<string> supportedImageFormats = null);
     string GetCachedFile(Chapter chapter);
     public void ExtractChapterFiles(string extractPath, IReadOnlyList<MangaFile> files, bool extractPdfImages = false);
     Task<int> CacheBookmarkForSeries(int userId, int seriesId);
@@ -52,18 +53,19 @@ public class CacheService : ICacheService
     private readonly IDirectoryService _directoryService;
     private readonly IReadingItemService _readingItemService;
     private readonly IBookmarkService _bookmarkService;
-
+    private readonly IImageConverterService _converterService;
     private static readonly ConcurrentDictionary<int, SemaphoreSlim> ExtractLocks = new();
 
     public CacheService(ILogger<CacheService> logger, IUnitOfWork unitOfWork,
         IDirectoryService directoryService, IReadingItemService readingItemService,
-        IBookmarkService bookmarkService)
+        IBookmarkService bookmarkService, IImageConverterService converterService)
     {
         _logger = logger;
         _unitOfWork = unitOfWork;
         _directoryService = directoryService;
         _readingItemService = readingItemService;
         _bookmarkService = bookmarkService;
+        _converterService = converterService;
     }
 
     public IEnumerable<string> GetCachedPages(int chapterId)
@@ -98,13 +100,19 @@ public IEnumerable<FileDimensionDto> GetCachedFileDimensions(string cachePath)
             for (var i = 0; i < files.Length; i++)
             {
                 var file = files[i];
-                using var image = Image.NewFromFile(file, memory: false, access: Enums.Access.SequentialUnbuffered);
+                var dimension = _converterService.GetDimensions(file, i);
+                if (dimension == null)
+                {
+                    using var image = Image.NewFromFile(file, memory: false, access: Enums.Access.SequentialUnbuffered);
+                    dimension = (image.Width, image.Height);
+                }
+                
                 dimensions.Add(new FileDimensionDto()
                 {
                     PageNumber = i,
-                    Height = image.Height,
-                    Width = image.Width,
-                    IsWide = image.Width > image.Height,
+                    Height = dimension.Value.Height,
+                    Width = dimension.Value.Width,
+                    IsWide = dimension.Value.Width > dimension.Value.Height,
                     FileName = file.Replace(cachePath, string.Empty)
                 });
             }
@@ -122,7 +130,7 @@ public IEnumerable<FileDimensionDto> GetCachedFileDimensions(string cachePath)
         return dimensions;
     }
 
-    public string GetCachedBookmarkPagePath(int seriesId, int page)
+    public string GetCachedBookmarkPagePath(int seriesId, int page, List<string> supportedImageFormats = null)
     {
         // Calculate what chapter the page belongs to
         var path = GetBookmarkCachePath(seriesId);
@@ -138,7 +146,8 @@ public string GetCachedBookmarkPagePath(int seriesId, int page)
         }
 
         // Since array is 0 based, we need to keep that in account (only affects last image)
-        return page == files.Length ? files[page - 1] : files[page];
+        string file=page == files.Length ? files[page - 1] : files[page];
+        return _converterService.ConvertFile(file, supportedImageFormats);
     }
 
     /// <summary>
@@ -316,7 +325,7 @@ public string GetBookmarkCachePath(int seriesId)
     /// <param name="chapterId">Chapter id with Files populated.</param>
     /// <param name="page">Page number to look for</param>
     /// <returns>Page filepath or empty if no files found.</returns>
-    public string GetCachedPagePath(int chapterId, int page)
+    public string GetCachedPagePath(int chapterId, int page, List<string> supportedImageFormats = null)
     {
         // Calculate what chapter the page belongs to
         var path = GetCachePath(chapterId);
@@ -325,7 +334,8 @@ public string GetCachedPagePath(int chapterId, int page)
             //.OrderByNatural(Path.GetFileNameWithoutExtension) // This is already done in GetPageFromFiles
             .ToArray();
 
-        return GetPageFromFiles(files, page);
+        string file = GetPageFromFiles(files, page);
+        return _converterService.ConvertFile(file, supportedImageFormats);
     }
 
     public async Task<int> CacheBookmarkForSeries(int userId, int seriesId)
diff --git a/API/Services/ImageConversion/JpegXLImageConverterProvider.cs b/API/Services/ImageConversion/JpegXLImageConverterProvider.cs
index 95b399afd..3bd1a2f11 100644
--- a/API/Services/ImageConversion/JpegXLImageConverterProvider.cs
+++ b/API/Services/ImageConversion/JpegXLImageConverterProvider.cs
@@ -1,5 +1,6 @@
 using System;
 using System.IO;
+using System.Text.RegularExpressions;
 using System.Threading;
 using Kavita.Common.EnvironmentInfo;
 
@@ -10,6 +11,7 @@ public interface IImageConverterProvider
     string Extension { get; }
     bool IsSupported(string filename);
     string Convert(string filename);
+    (int Width, int Height)? GetDimensions(string fileName, int pageNumber);
 }
 
 public class JpegXLImageConverterProvider : IImageConverterProvider
@@ -37,6 +39,8 @@ internal bool AppFound
     }
     private string exeFile => OsInfo.IsWindows ? "djxl.exe" : "djxl";
 
+    private string infoFile => OsInfo.IsWindows ? "jxlinfo.exe" : "jxlinfo";
+
     public bool IsSupported(string filename)
     {
         if (AppFound)
@@ -44,6 +48,18 @@ public bool IsSupported(string filename)
         return false;
     }
 
+    private static Regex dimensions = new Regex(@",\s?(\d+)x(\d+),", RegexOptions.Compiled);
+    public (int Width, int Height)? GetDimensions(string fileName, int pageNumber)
+    {
+        if (!AppFound)
+            return null;
+        string output = OsInfo.RunAndCapture(infoFile, "\"" + fileName + "\"", Timeout.Infinite);
+        Match m= dimensions.Match(output);
+        if (!m.Success)
+            return null;
+        return (int.Parse(m.Groups[1].Value), int.Parse(m.Groups[2].Value));
+    }
+
     public string Extension => ".jxl";
     public string Convert(string filename)
     {
diff --git a/API/Services/ImageConverterService.cs b/API/Services/ImageConverterService.cs
index 08cab27a8..e2f61dd7a 100644
--- a/API/Services/ImageConverterService.cs
+++ b/API/Services/ImageConverterService.cs
@@ -6,14 +6,16 @@
 using System.Linq;
 using API.Services.ImageConversion;
 using static Org.BouncyCastle.Bcpg.Attr.ImageAttrib;
+using API.DTOs.Reader;
 
 namespace API.Services
 {
     public interface IImageConverterService
     {
         Stream ConvertStream(string filename, Stream source);
-        string ConvertFile(string filename);
+        string ConvertFile(string filename, List<string> supportedImageFormats);
         void ConvertDirectory(string directory);
+        (int Width, int Height)? GetDimensions(string fileName, int pageNumber);
     }
 
     public class ImageConverterService : IImageConverterService
@@ -41,8 +43,18 @@ public Stream ConvertStream(string filename, Stream source)
             return File.OpenRead(provider.Convert(tempFile));
         }
 
-        public string ConvertFile(string filename)
+        private bool CheckDirectSupport(string filename, List<string> supportedImageFormats)
         {
+            if (supportedImageFormats == null)
+                return false;
+            string ext = Path.GetExtension(filename).ToLowerInvariant().Substring(1);
+            return supportedImageFormats.Contains(ext);
+        }
+
+        public string ConvertFile(string filename, List<string> supportedImageFormats)
+        {
+            if (CheckDirectSupport(filename, supportedImageFormats))
+                return filename;
             IImageConverterProvider provider = _converters.FirstOrDefault(a => a.IsSupported(filename));
             if (provider == null)
                 return filename;
@@ -58,5 +70,13 @@ public void ConvertDirectory(string directory)
                     provider.Convert(filename);
             }
         }
+
+        public (int Width, int Height)? GetDimensions(string fileName, int pageNumber)
+        {
+            IImageConverterProvider provider = _converters.FirstOrDefault(a => a.IsSupported(fileName));
+            if (provider == null)
+                return null;
+            return provider.GetDimensions(fileName, pageNumber);
+        }
     }
 }
diff --git a/API/Services/ImageService.cs b/API/Services/ImageService.cs
index f8b10388e..6d9eb2b26 100644
--- a/API/Services/ImageService.cs
+++ b/API/Services/ImageService.cs
@@ -47,7 +47,7 @@ public interface IImageService
     /// <param name="outputDirectory"></param>
     /// <param name="encodeFormat"></param>
     /// <returns></returns>
-    string WriteCoverThumbnail(Stream stream, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size = CoverImageSize.Default);
+    string WriteCoverThumbnail(string sourceFile, Stream stream, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size = CoverImageSize.Default);
     /// <summary>
     /// Writes out a thumbnail by file path input
     /// </summary>
@@ -218,7 +218,7 @@ public string GetCoverImage(string path, string fileName, string outputDirectory
 
         try
         {
-            fileName = _converterService.ConvertFile(fileName);
+            fileName = _converterService.ConvertFile(fileName, null);
             var (width, height) = size.GetDimensions();
             using var sourceImage = Image.NewFromFile(path, false, Enums.Access.SequentialUnbuffered);
 
@@ -246,8 +246,9 @@ public string GetCoverImage(string path, string fileName, string outputDirectory
     /// <param name="outputDirectory">Where to output the file, defaults to covers directory</param>
     /// <param name="encodeFormat">Export the file as the passed encoding</param>
     /// <returns>File name with extension of the file. This will always write to <see cref="DirectoryService.CoverImageDirectory"/></returns>
-    public string WriteCoverThumbnail(Stream stream, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size = CoverImageSize.Default)
+    public string WriteCoverThumbnail(string sourceFile, Stream stream, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size = CoverImageSize.Default)
     {
+        stream = _converterService.ConvertStream(sourceFile, stream);
         var (targetWidth, targetHeight) = size.GetDimensions();
         if (stream.CanSeek) stream.Position = 0;
         using var sourceImage = Image.NewFromStream(stream);
@@ -290,6 +291,8 @@ public string WriteCoverThumbnail(Stream stream, string fileName, string outputD
 
     public string WriteCoverThumbnail(string sourceFile, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size = CoverImageSize.Default)
     {
+        sourceFile = _converterService.ConvertFile(sourceFile,null);
+
         var (width, height) = size.GetDimensions();
         using var sourceImage = Image.NewFromFile(sourceFile, false, Enums.Access.SequentialUnbuffered);
 

From 4902a74dddd25f591e37b6794f7fc358e6895523 Mon Sep 17 00:00:00 2001
From: Maximo Piva <mpiva@adventintermodal.com>
Date: Fri, 23 Aug 2024 18:34:58 -0300
Subject: [PATCH 07/30] Changed the way conversion happens. 1. Supported Image
 Formats came in the accept flag from the browser. 2. If jxl (or future
 formats, ie browser not supported AVIF, HEIF, etc) are not supported, Kavita
 will convert it to a suitable display format via conversion providers. 3. if
 it supported it will return the image as is, no conversion needed. 4.
 Thumbnails are always converted.

---
 API.Tests/API.Tests.csproj                    |  2 +-
 API/API.csproj                                | 22 +++---
 API/Controllers/OPDSController.cs             |  7 +-
 API/Controllers/ReaderController.cs           | 13 +++-
 .../ApplicationServiceExtensions.cs           |  3 +
 API/Extensions/HttpExtensions.cs              | 15 +++-
 API/Services/CacheService.cs                  | 50 ++++++------
 .../AvifImageConverterProvider.cs             | 44 +++++++++++
 .../HeifImageConverterProvider.cs             | 27 +++++++
 .../Jpeg2000ImageConverterProvider.cs         | 25 ++++++
 .../JpegXLImageConverterProvider.cs           | 76 ++++++++-----------
 API/Services/ImageConverterService.cs         | 35 ++++-----
 API/Services/ImageService.cs                  | 11 +--
 API/Services/Plus/ExternalMetadataService.cs  |  6 +-
 API/Services/Plus/RecommendationService.cs    |  5 +-
 API/Services/Plus/ScrobblingService.cs        |  5 +-
 API/Services/Tasks/Scanner/Parser/Parser.cs   |  2 +-
 API/Services/Tasks/StatsService.cs            |  5 +-
 API/Services/Tasks/VersionUpdaterService.cs   |  8 +-
 Dockerfile                                    |  2 +-
 Kavita.Common/Helpers/FlurlConfiguration.cs   | 30 ++++++++
 .../Helpers/UntrustedCertClientFactory.cs     | 13 ----
 Kavita.Common/Kavita.Common.csproj            |  2 +-
 ...uild-jxl.sh => docker-build-wconvertion.sh |  0
 24 files changed, 258 insertions(+), 150 deletions(-)
 create mode 100644 API/Services/ImageConversion/AvifImageConverterProvider.cs
 create mode 100644 API/Services/ImageConversion/HeifImageConverterProvider.cs
 create mode 100644 API/Services/ImageConversion/Jpeg2000ImageConverterProvider.cs
 create mode 100644 Kavita.Common/Helpers/FlurlConfiguration.cs
 delete mode 100644 Kavita.Common/Helpers/UntrustedCertClientFactory.cs
 rename docker-build-jxl.sh => docker-build-wconvertion.sh (100%)

diff --git a/API.Tests/API.Tests.csproj b/API.Tests/API.Tests.csproj
index edf1af5eb..7f2a97e25 100644
--- a/API.Tests/API.Tests.csproj
+++ b/API.Tests/API.Tests.csproj
@@ -7,7 +7,7 @@
 
     <ItemGroup>
         <PackageReference Include="Microsoft.EntityFrameworkCore.InMemory" Version="8.0.8" />
-        <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.10.0" />
+        <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.11.0" />
         <PackageReference Include="NSubstitute" Version="5.1.0" />
         <PackageReference Include="System.IO.Abstractions.TestingHelpers" Version="21.0.29" />
         <PackageReference Include="TestableIO.System.IO.Abstractions.Wrappers" Version="21.0.29" />
diff --git a/API/API.csproj b/API/API.csproj
index 1755146ff..d05217223 100644
--- a/API/API.csproj
+++ b/API/API.csproj
@@ -12,10 +12,11 @@
     <LangVersion>latestmajor</LangVersion>
   </PropertyGroup>
 
-  <Target Name="PostBuild" AfterTargets="Build" Condition=" '$(Configuration)' == 'Debug' ">
-
-  </Target>
-
+  <!--  <Target Name="PostBuild" AfterTargets="Build" Condition=" '$(Configuration)' == 'Debug' ">-->
+  <!--      <Delete Files="../openapi.json" />-->
+  <!--      <Exec Command="swagger tofile &#45;&#45;output ../openapi.json bin/$(Configuration)/$(TargetFramework)/$(AssemblyName).dll v1" />-->
+  <!--  </Target>-->
+  
   <PropertyGroup Condition=" '$(Configuration)' == 'Release' ">
     <DebugSymbols>false</DebugSymbols>
     <ApplicationIcon>../favicon.ico</ApplicationIcon>
@@ -53,23 +54,24 @@
   </PropertyGroup>
 
   <ItemGroup>
+      <PackageReference Include="AutoMapper" Version="13.0.1" />
       <PackageReference Include="CsvHelper" Version="33.0.1" />
+      <PackageReference Include="Magick.NET-Q16-HDRI-AnyCPU" Version="13.10.0" />
       <PackageReference Include="MailKit" Version="4.7.1.1" />
       <PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="8.0.8">
           <PrivateAssets>all</PrivateAssets>
           <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
       </PackageReference>
-    <PackageReference Include="AutoMapper.Extensions.Microsoft.DependencyInjection" Version="12.0.1" />
     <PackageReference Include="Docnet.Core" Version="2.6.0" />
     <PackageReference Include="EasyCaching.InMemory" Version="1.9.2" />
     <PackageReference Include="ExCSS" Version="4.2.5" />
-    <PackageReference Include="Flurl" Version="3.0.7" />
-    <PackageReference Include="Flurl.Http" Version="3.2.4" />
+    <PackageReference Include="Flurl" Version="4.0.0" />
+    <PackageReference Include="Flurl.Http" Version="4.0.2" />
     <PackageReference Include="Hangfire" Version="1.8.14" />
     <PackageReference Include="Hangfire.InMemory" Version="0.10.3" />
     <PackageReference Include="Hangfire.MaximumConcurrentExecutions" Version="1.1.0" />
     <PackageReference Include="Hangfire.Storage.SQLite" Version="0.4.2" />
-    <PackageReference Include="HtmlAgilityPack" Version="1.11.63" />
+    <PackageReference Include="HtmlAgilityPack" Version="1.11.64" />
     <PackageReference Include="MarkdownDeep.NET.Core" Version="1.5.0.4" />
     <PackageReference Include="Hangfire.AspNetCore" Version="1.8.14" />
     <PackageReference Include="Microsoft.AspNetCore.SignalR" Version="1.1.0" />
@@ -99,9 +101,9 @@
       <PrivateAssets>all</PrivateAssets>
       <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
     </PackageReference>
-    <PackageReference Include="Swashbuckle.AspNetCore" Version="6.7.1" />
+    <PackageReference Include="Swashbuckle.AspNetCore" Version="6.7.3" />
     <PackageReference Include="Swashbuckle.AspNetCore.Filters" Version="8.0.2" />
-    <PackageReference Include="System.IdentityModel.Tokens.Jwt" Version="8.0.1" />
+    <PackageReference Include="System.IdentityModel.Tokens.Jwt" Version="8.0.2" />
     <PackageReference Include="System.IO.Abstractions" Version="21.0.29" />
     <PackageReference Include="System.Drawing.Common" Version="8.0.8" />
     <PackageReference Include="VersOne.Epub" Version="3.3.2" />
diff --git a/API/Controllers/OPDSController.cs b/API/Controllers/OPDSController.cs
index 0b260a537..8082691a2 100644
--- a/API/Controllers/OPDSController.cs
+++ b/API/Controllers/OPDSController.cs
@@ -43,6 +43,7 @@ public class OpdsController : BaseApiController
     private readonly ISeriesService _seriesService;
     private readonly IAccountService _accountService;
     private readonly ILocalizationService _localizationService;
+    private readonly IImageConverterService _converterService;
     private readonly IMapper _mapper;
 
 
@@ -81,6 +82,7 @@ public OpdsController(IUnitOfWork unitOfWork, IDownloadService downloadService,
         IDirectoryService directoryService, ICacheService cacheService,
         IReaderService readerService, ISeriesService seriesService,
         IAccountService accountService, ILocalizationService localizationService,
+        IImageConverterService converterService,
         IMapper mapper)
     {
         _unitOfWork = unitOfWork;
@@ -91,6 +93,7 @@ public OpdsController(IUnitOfWork unitOfWork, IDownloadService downloadService,
         _seriesService = seriesService;
         _accountService = accountService;
         _localizationService = localizationService;
+        _converterService = converterService;
         _mapper = mapper;
 
         _xmlSerializer = new XmlSerializer(typeof(Feed));
@@ -1228,10 +1231,10 @@ public async Task<ActionResult> GetPageStreamedImage(string apiKey, [FromQuery]
 
         try
         {
-            var path = _cacheService.GetCachedPagePath(chapter.Id, pageNumber, Request.SupportedImageTypesFromRequest());
+            var path = _cacheService.GetCachedPagePath(chapter.Id, pageNumber);
             if (string.IsNullOrEmpty(path) || !System.IO.File.Exists(path))
                 return BadRequest(await _localizationService.Translate(userId, "no-image-for-page", pageNumber));
-
+            path = _converterService.ConvertFile(path, Request.SupportedImageTypesFromRequest());
             var content = await _directoryService.ReadFileAsync(path);
             var format = Path.GetExtension(path);
 
diff --git a/API/Controllers/ReaderController.cs b/API/Controllers/ReaderController.cs
index 99d096f74..fe5303036 100644
--- a/API/Controllers/ReaderController.cs
+++ b/API/Controllers/ReaderController.cs
@@ -43,6 +43,7 @@ public class ReaderController : BaseApiController
     private readonly IEventHub _eventHub;
     private readonly IScrobblingService _scrobblingService;
     private readonly ILocalizationService _localizationService;
+    private readonly IImageConverterService _converterService;
 
     /// <inheritdoc />
     public ReaderController(ICacheService cacheService,
@@ -50,7 +51,8 @@ public ReaderController(ICacheService cacheService,
         IReaderService readerService, IBookmarkService bookmarkService,
         IAccountService accountService, IEventHub eventHub,
         IScrobblingService scrobblingService,
-        ILocalizationService localizationService)
+        ILocalizationService localizationService,
+        IImageConverterService converterService)
     {
         _cacheService = cacheService;
         _unitOfWork = unitOfWork;
@@ -61,6 +63,7 @@ public ReaderController(ICacheService cacheService,
         _eventHub = eventHub;
         _scrobblingService = scrobblingService;
         _localizationService = localizationService;
+        _converterService = converterService;
     }
 
     /// <summary>
@@ -119,9 +122,10 @@ public async Task<ActionResult> GetImage(int chapterId, int page, string apiKey,
             var chapter = await _cacheService.Ensure(chapterId, extractPdf);
             if (chapter == null) return NoContent();
             _logger.LogInformation("Fetching Page {PageNum} on Chapter {ChapterId}", page, chapterId);
-            var path = _cacheService.GetCachedPagePath(chapter.Id, page, Request.SupportedImageTypesFromRequest());
+            var path = _cacheService.GetCachedPagePath(chapter.Id, page);
             if (string.IsNullOrEmpty(path) || !System.IO.File.Exists(path))
                 return BadRequest(await _localizationService.Translate(userId, "no-image-for-page", page));
+            path = _converterService.ConvertFile(path, Request.SupportedImageTypesFromRequest());
             var format = Path.GetExtension(path);
 
             return PhysicalFile(path, format.GetMimeType(), Path.GetFileName(path), true);
@@ -183,8 +187,9 @@ public async Task<ActionResult> GetBookmarkImage(int seriesId, string apiKey, in
 
         try
         {
-            var path = _cacheService.GetCachedBookmarkPagePath(seriesId, page, Request.SupportedImageTypesFromRequest());
+            var path = _cacheService.GetCachedBookmarkPagePath(seriesId, page);
             if (string.IsNullOrEmpty(path) || !System.IO.File.Exists(path)) return BadRequest(await _localizationService.Translate(userId, "no-image-for-page", page));
+            path = _converterService.ConvertFile(path, Request.SupportedImageTypesFromRequest());
             var format = Path.GetExtension(path);
 
             return PhysicalFile(path, format.GetMimeType(), Path.GetFileName(path));
@@ -732,7 +737,7 @@ public async Task<ActionResult> BookmarkPage(BookmarkDto bookmarkDto)
         if (chapter == null) return BadRequest(await _localizationService.Translate(User.GetUserId(), "cache-file-find"));
 
         bookmarkDto.Page = _readerService.CapPageToChapter(chapter, bookmarkDto.Page);
-        var path = _cacheService.GetCachedPagePath(chapter.Id, bookmarkDto.Page, Request.SupportedImageTypesFromRequest());
+        var path = _cacheService.GetCachedPagePath(chapter.Id, bookmarkDto.Page);
 
         if (!await _bookmarkService.BookmarkPage(user, bookmarkDto, path))
             return BadRequest(await _localizationService.Translate(User.GetUserId(), "bookmark-save"));
diff --git a/API/Extensions/ApplicationServiceExtensions.cs b/API/Extensions/ApplicationServiceExtensions.cs
index 011acffc5..33085263e 100644
--- a/API/Extensions/ApplicationServiceExtensions.cs
+++ b/API/Extensions/ApplicationServiceExtensions.cs
@@ -36,6 +36,9 @@ public static void AddApplicationServices(this IServiceCollection services, ICon
         services.AddScoped<IArchiveService, ArchiveService>();
 
         services.AddScoped<IImageConverterProvider, JpegXLImageConverterProvider>();
+        services.AddScoped<IImageConverterProvider, Jpeg2000ImageConverterProvider>();
+        services.AddScoped<IImageConverterProvider, AvifImageConverterProvider>();
+        services.AddScoped<IImageConverterProvider, HeifImageConverterProvider>();
         services.AddScoped<IImageConverterService, ImageConverterService>();
 
         services.AddScoped<IBackupService, BackupService>();
diff --git a/API/Extensions/HttpExtensions.cs b/API/Extensions/HttpExtensions.cs
index 6287f31f8..67ffbc14b 100644
--- a/API/Extensions/HttpExtensions.cs
+++ b/API/Extensions/HttpExtensions.cs
@@ -68,17 +68,26 @@ public static List<string> SupportedImageTypesFromRequest(this HttpRequest reque
         defaultExtensions.Add("jpg");
         defaultExtensions.Add("png");
         defaultExtensions.Add("gif");
-
+        defaultExtensions.Add("webp");
         foreach (string v in split)
         {
             if (v.StartsWith("image/", StringComparison.InvariantCultureIgnoreCase))
             {
-                string n = v.Substring(6);
+                string n = v.Substring(6).ToLowerInvariant();
                 if (n == "svg+xml")
                     n = "svg";
+                if (n=="jp2")
+                    defaultExtensions.Add("j2k");
+                if (n == "j2k")
+                    defaultExtensions.Add("jp2");
+                if (n=="heif")
+                    defaultExtensions.Add("heic");
+                if (n == "heic")
+                    defaultExtensions.Add("heif");
                 if (n.StartsWith("*"))
                     continue;
-                defaultExtensions.Add(n.ToLowerInvariant());
+                if (!defaultExtensions.Contains(n))
+                   defaultExtensions.Add(n);
             }
         }
         return defaultExtensions;
diff --git a/API/Services/CacheService.cs b/API/Services/CacheService.cs
index a00df5879..d5f9cc971 100644
--- a/API/Services/CacheService.cs
+++ b/API/Services/CacheService.cs
@@ -13,8 +13,9 @@
 using API.Extensions;
 using Kavita.Common;
 using Microsoft.Extensions.Logging;
-using MimeKit.Tnef;
 using NetVips;
+using static System.Net.Mime.MediaTypeNames;
+using Image = NetVips.Image;
 
 namespace API.Services;
 #nullable enable
@@ -35,12 +36,12 @@ public interface ICacheService
     /// <param name="chapterIds">Volumes that belong to that library. Assume the library might have been deleted before this invocation.</param>
     void CleanupChapters(IEnumerable<int> chapterIds);
     void CleanupBookmarks(IEnumerable<int> seriesIds);
-    string GetCachedPagePath(int chapterId, int page, List<string> supportedImageFormats = null);
+    string GetCachedPagePath(int chapterId, int page);
     string GetCachePath(int chapterId);
     string GetBookmarkCachePath(int seriesId);
     IEnumerable<string> GetCachedPages(int chapterId);
     IEnumerable<FileDimensionDto> GetCachedFileDimensions(string cachePath);
-    string GetCachedBookmarkPagePath(int seriesId, int page, List<string> supportedImageFormats = null);
+    string GetCachedBookmarkPagePath(int seriesId, int page);
     string GetCachedFile(Chapter chapter);
     public void ExtractChapterFiles(string extractPath, IReadOnlyList<MangaFile> files, bool extractPdfImages = false);
     Task<int> CacheBookmarkForSeries(int userId, int seriesId);
@@ -54,6 +55,7 @@ public class CacheService : ICacheService
     private readonly IReadingItemService _readingItemService;
     private readonly IBookmarkService _bookmarkService;
     private readonly IImageConverterService _converterService;
+
     private static readonly ConcurrentDictionary<int, SemaphoreSlim> ExtractLocks = new();
 
     public CacheService(ILogger<CacheService> logger, IUnitOfWork unitOfWork,
@@ -100,13 +102,13 @@ public IEnumerable<FileDimensionDto> GetCachedFileDimensions(string cachePath)
             for (var i = 0; i < files.Length; i++)
             {
                 var file = files[i];
-                var dimension = _converterService.GetDimensions(file, i);
+                var dimension = _converterService.GetDimensions(file);
                 if (dimension == null)
                 {
                     using var image = Image.NewFromFile(file, memory: false, access: Enums.Access.SequentialUnbuffered);
                     dimension = (image.Width, image.Height);
                 }
-                
+
                 dimensions.Add(new FileDimensionDto()
                 {
                     PageNumber = i,
@@ -130,7 +132,7 @@ public IEnumerable<FileDimensionDto> GetCachedFileDimensions(string cachePath)
         return dimensions;
     }
 
-    public string GetCachedBookmarkPagePath(int seriesId, int page, List<string> supportedImageFormats = null)
+    public string GetCachedBookmarkPagePath(int seriesId, int page)
     {
         // Calculate what chapter the page belongs to
         var path = GetBookmarkCachePath(seriesId);
@@ -146,8 +148,7 @@ public string GetCachedBookmarkPagePath(int seriesId, int page, List<string> sup
         }
 
         // Since array is 0 based, we need to keep that in account (only affects last image)
-        string file=page == files.Length ? files[page - 1] : files[page];
-        return _converterService.ConvertFile(file, supportedImageFormats);
+        return page == files.Length ? files[page - 1] : files[page];
     }
 
     /// <summary>
@@ -247,23 +248,23 @@ public void ExtractChapterFiles(string extractPath, IReadOnlyList<MangaFile>? fi
                     break;
                 case MangaFormat.Epub:
                 case MangaFormat.Pdf:
-                {
-                    if (!_directoryService.FileSystem.File.Exists(files[0].FilePath))
-                    {
-                        _logger.LogError("{File} does not exist on disk", files[0].FilePath);
-                        throw new KavitaException($"{files[0].FilePath} does not exist on disk");
-                    }
-                    if (extractPdfImages)
                     {
-                        _readingItemService.Extract(file.FilePath, Path.Join(extractPath, extraPath), file.Format);
+                        if (!_directoryService.FileSystem.File.Exists(files[0].FilePath))
+                        {
+                            _logger.LogError("{File} does not exist on disk", files[0].FilePath);
+                            throw new KavitaException($"{files[0].FilePath} does not exist on disk");
+                        }
+                        if (extractPdfImages)
+                        {
+                            _readingItemService.Extract(file.FilePath, Path.Join(extractPath, extraPath), file.Format);
+                            break;
+                        }
+                        removeNonImages = false;
+
+                        _directoryService.ExistOrCreate(extractPath);
+                        _directoryService.CopyFileToDirectory(files[0].FilePath, extractPath);
                         break;
                     }
-                    removeNonImages = false;
-
-                    _directoryService.ExistOrCreate(extractPath);
-                    _directoryService.CopyFileToDirectory(files[0].FilePath, extractPath);
-                    break;
-                }
             }
         }
 
@@ -325,7 +326,7 @@ public string GetBookmarkCachePath(int seriesId)
     /// <param name="chapterId">Chapter id with Files populated.</param>
     /// <param name="page">Page number to look for</param>
     /// <returns>Page filepath or empty if no files found.</returns>
-    public string GetCachedPagePath(int chapterId, int page, List<string> supportedImageFormats = null)
+    public string GetCachedPagePath(int chapterId, int page)
     {
         // Calculate what chapter the page belongs to
         var path = GetCachePath(chapterId);
@@ -334,8 +335,7 @@ public string GetCachedPagePath(int chapterId, int page, List<string> supportedI
             //.OrderByNatural(Path.GetFileNameWithoutExtension) // This is already done in GetPageFromFiles
             .ToArray();
 
-        string file = GetPageFromFiles(files, page);
-        return _converterService.ConvertFile(file, supportedImageFormats);
+        return GetPageFromFiles(files, page);
     }
 
     public async Task<int> CacheBookmarkForSeries(int userId, int seriesId)
diff --git a/API/Services/ImageConversion/AvifImageConverterProvider.cs b/API/Services/ImageConversion/AvifImageConverterProvider.cs
new file mode 100644
index 000000000..c90120f0f
--- /dev/null
+++ b/API/Services/ImageConversion/AvifImageConverterProvider.cs
@@ -0,0 +1,44 @@
+using Kavita.Common.EnvironmentInfo;
+using Microsoft.Extensions.Logging;
+using System.Threading;
+using System;
+using System.IO;
+using NetVips;
+
+namespace API.Services.ImageConversion
+{
+    //AVIF & HEIF are supported by netvips.
+
+    public class AvifImageConverterProvider : IImageConverterProvider
+    {
+        private readonly ILogger<AvifImageConverterProvider> _logger;
+        public bool IsVipsSupported => true;
+
+        public AvifImageConverterProvider(ILogger<AvifImageConverterProvider> logger)
+        {
+            _logger = logger;
+        }
+
+        public bool IsSupported(string filename)
+        {
+            return filename.EndsWith(".avif", StringComparison.InvariantCultureIgnoreCase);
+
+        }
+
+        public string Convert(string filename)
+        {
+            string destination = Path.ChangeExtension(filename, "jpg");
+            using var sourceImage = Image.NewFromFile(filename, false, Enums.Access.SequentialUnbuffered);
+            sourceImage.WriteToFile(destination + "[Q=99]");
+            File.Delete(filename);
+            return destination;
+        }
+
+        public (int Width, int Height)? GetDimensions(string fileName)
+        {
+            using var image = Image.NewFromFile(fileName, memory: false, access: Enums.Access.SequentialUnbuffered);
+            return (image.Width, image.Height);
+        }
+
+    }
+}
diff --git a/API/Services/ImageConversion/HeifImageConverterProvider.cs b/API/Services/ImageConversion/HeifImageConverterProvider.cs
new file mode 100644
index 000000000..a7d97606e
--- /dev/null
+++ b/API/Services/ImageConversion/HeifImageConverterProvider.cs
@@ -0,0 +1,27 @@
+using Microsoft.Extensions.Logging;
+using NetVips;
+using System.IO;
+using System;
+using ImageMagick;
+
+namespace API.Services.ImageConversion
+{
+    public class HeifImageConverterProvider : ImageMagickConverterProvider, IImageConverterProvider
+    {
+        private readonly ILogger<HeifImageConverterProvider> _logger;
+        public bool IsVipsSupported => false;
+
+        public HeifImageConverterProvider(ILogger<HeifImageConverterProvider> logger)
+        {
+            _logger = logger;
+        }
+
+        public bool IsSupported(string filename)
+        {
+            return filename.EndsWith(".heif", StringComparison.InvariantCultureIgnoreCase)
+                   || filename.EndsWith(".heic", StringComparison.InvariantCultureIgnoreCase);
+
+        }
+
+    }
+}
diff --git a/API/Services/ImageConversion/Jpeg2000ImageConverterProvider.cs b/API/Services/ImageConversion/Jpeg2000ImageConverterProvider.cs
new file mode 100644
index 000000000..16131d2a3
--- /dev/null
+++ b/API/Services/ImageConversion/Jpeg2000ImageConverterProvider.cs
@@ -0,0 +1,25 @@
+using Kavita.Common.EnvironmentInfo;
+using Microsoft.Extensions.Logging;
+using System.IO;
+using System.Text.RegularExpressions;
+using System.Threading;
+using System;
+
+namespace API.Services.ImageConversion
+{
+    //NetVips do not support Jpeg2000, Vips does but generate the right bindings is a pain in the ass
+    public class Jpeg2000ImageConverterProvider : ImageMagickConverterProvider, IImageConverterProvider
+    {
+        private readonly ILogger<Jpeg2000ImageConverterProvider> _logger;
+        public Jpeg2000ImageConverterProvider(ILogger<Jpeg2000ImageConverterProvider> logger)
+        {
+            _logger = logger;
+        }
+
+        public bool IsVipsSupported => false;
+        public bool IsSupported(string filename)
+        {
+            return filename.EndsWith(".jp2", StringComparison.InvariantCultureIgnoreCase) || filename.EndsWith(".j2k", StringComparison.InvariantCultureIgnoreCase);
+        }
+    }
+}
diff --git a/API/Services/ImageConversion/JpegXLImageConverterProvider.cs b/API/Services/ImageConversion/JpegXLImageConverterProvider.cs
index 3bd1a2f11..2b4c41a5c 100644
--- a/API/Services/ImageConversion/JpegXLImageConverterProvider.cs
+++ b/API/Services/ImageConversion/JpegXLImageConverterProvider.cs
@@ -1,73 +1,57 @@
 using System;
 using System.IO;
+using System.IO.Abstractions;
 using System.Text.RegularExpressions;
 using System.Threading;
+using ImageMagick;
 using Kavita.Common.EnvironmentInfo;
+using Microsoft.Extensions.Logging;
+using NetVips;
 
 namespace API.Services.ImageConversion;
 
 public interface IImageConverterProvider
 {
-    string Extension { get; }
     bool IsSupported(string filename);
     string Convert(string filename);
-    (int Width, int Height)? GetDimensions(string fileName, int pageNumber);
+    (int Width, int Height)? GetDimensions(string fileName);
+
+    bool IsVipsSupported { get; }
 }
 
-public class JpegXLImageConverterProvider : IImageConverterProvider
+public class ImageMagickConverterProvider
 {
-    private bool? _appFound = null;
-
-    internal bool AppFound
+    public virtual string Convert(string filename)
     {
-        get
-        {
-            if (_appFound == null)
-            {
-                try
-                {
-                    _appFound = OsInfo.RunAndCapture(exeFile, "--version", Timeout.Infinite).Contains("JPEG XL");
-                }
-                catch (Exception e)
-                {
-                    //Eat it
-                    _appFound = false;
-                }
-            }
-            return _appFound.Value;
-        }
+        string destination = Path.ChangeExtension(filename, "jpg");
+        using var sourceImage = new MagickImage(filename);
+        sourceImage.Quality = 99;
+        sourceImage.Write(destination);
+        File.Delete(filename);
+        return destination;
     }
-    private string exeFile => OsInfo.IsWindows ? "djxl.exe" : "djxl";
-
-    private string infoFile => OsInfo.IsWindows ? "jxlinfo.exe" : "jxlinfo";
 
-    public bool IsSupported(string filename)
+    public virtual (int Width, int Height)? GetDimensions(string filename)
     {
-        if (AppFound)
-            return filename.EndsWith(".jxl", StringComparison.InvariantCultureIgnoreCase);
-        return false;
+        var info = new MagickImageInfo(filename);
+        return (info.Width, info.Height);
     }
+}
 
-    private static Regex dimensions = new Regex(@",\s?(\d+)x(\d+),", RegexOptions.Compiled);
-    public (int Width, int Height)? GetDimensions(string fileName, int pageNumber)
+//NetVips do not support Jpeg-XL, Vips does but generate the right bindings is a pain in the ass
+public class JpegXLImageConverterProvider : ImageMagickConverterProvider, IImageConverterProvider
+{
+    private readonly ILogger<JpegXLImageConverterProvider> _logger;
+    public JpegXLImageConverterProvider(ILogger<JpegXLImageConverterProvider> logger)
     {
-        if (!AppFound)
-            return null;
-        string output = OsInfo.RunAndCapture(infoFile, "\"" + fileName + "\"", Timeout.Infinite);
-        Match m= dimensions.Match(output);
-        if (!m.Success)
-            return null;
-        return (int.Parse(m.Groups[1].Value), int.Parse(m.Groups[2].Value));
+        _logger = logger;
     }
+    public bool IsVipsSupported => false;
 
-    public string Extension => ".jxl";
-    public string Convert(string filename)
+    public bool IsSupported(string filename)
     {
-        if (!AppFound)
-            return filename;
-        string destination = Path.ChangeExtension(filename, "jpg");
-        OsInfo.RunAndCapture(exeFile, "\"" + filename + "\" \"" + destination + "\"", Timeout.Infinite);
-        File.Delete(filename);
-        return destination;
+        return filename.EndsWith(".jxl", StringComparison.InvariantCultureIgnoreCase);
     }
+
+  
 }
diff --git a/API/Services/ImageConverterService.cs b/API/Services/ImageConverterService.cs
index e2f61dd7a..35a21b510 100644
--- a/API/Services/ImageConverterService.cs
+++ b/API/Services/ImageConverterService.cs
@@ -1,12 +1,9 @@
-using NetVips;
 using System.Collections;
 using System.Collections.Generic;
 using System.IO;
 using System.IO.Abstractions;
 using System.Linq;
 using API.Services.ImageConversion;
-using static Org.BouncyCastle.Bcpg.Attr.ImageAttrib;
-using API.DTOs.Reader;
 
 namespace API.Services
 {
@@ -14,17 +11,16 @@ public interface IImageConverterService
     {
         Stream ConvertStream(string filename, Stream source);
         string ConvertFile(string filename, List<string> supportedImageFormats);
-        void ConvertDirectory(string directory);
-        (int Width, int Height)? GetDimensions(string fileName, int pageNumber);
+        (int Width, int Height)? GetDimensions(string fileName);
+
+        public bool IsVipsSupported(string filename);
     }
 
     public class ImageConverterService : IImageConverterService
     {
         private IEnumerable<IImageConverterProvider> _converters;
-        private readonly IDirectoryService _directoryService;
-        public ImageConverterService(IDirectoryService directoryService, IEnumerable<IImageConverterProvider> converters)
+        public ImageConverterService(IEnumerable<IImageConverterProvider> converters)
         {
-            _directoryService = directoryService;
             _converters = converters;
         }
 
@@ -35,7 +31,7 @@ public Stream ConvertStream(string filename, Stream source)
             IImageConverterProvider provider = _converters.FirstOrDefault(a => a.IsSupported(filename));
             if (provider == null)
                 return source;
-            string tempFile = Path.ChangeExtension(Path.GetFileName(filename), provider.Extension);
+            string tempFile = Path.GetFileName(filename);
             Stream dest = File.OpenWrite(tempFile);
             source.CopyTo(dest);
             source.Close();
@@ -61,22 +57,21 @@ public string ConvertFile(string filename, List<string> supportedImageFormats)
             return provider.Convert(filename);
         }
 
-        public void ConvertDirectory(string directory)
-        {
-            foreach (string filename in Directory.GetFiles(directory, "*.*", SearchOption.AllDirectories))
-            {
-                IImageConverterProvider provider = _converters.FirstOrDefault(a => a.IsSupported(filename));
-                if (provider != null)
-                    provider.Convert(filename);
-            }
-        }
 
-        public (int Width, int Height)? GetDimensions(string fileName, int pageNumber)
+        public (int Width, int Height)? GetDimensions(string fileName)
         {
             IImageConverterProvider provider = _converters.FirstOrDefault(a => a.IsSupported(fileName));
             if (provider == null)
                 return null;
-            return provider.GetDimensions(fileName, pageNumber);
+            return provider.GetDimensions(fileName);
+        }
+
+        public bool IsVipsSupported(string filename)
+        {
+            IImageConverterProvider provider = _converters.FirstOrDefault(a => a.IsSupported(filename));
+            if (provider == null)
+                return true;
+            return provider.IsVipsSupported;
         }
     }
 }
diff --git a/API/Services/ImageService.cs b/API/Services/ImageService.cs
index 6d9eb2b26..bd4506068 100644
--- a/API/Services/ImageService.cs
+++ b/API/Services/ImageService.cs
@@ -137,7 +137,6 @@ public void ExtractImages(string? fileFilePath, string targetDirectory, int file
             _directoryService.CopyDirectoryToDirectory(_directoryService.FileSystem.Path.GetDirectoryName(fileFilePath), targetDirectory,
                 Tasks.Scanner.Parser.Parser.ImageFileExtensions);
         }
-        _converterService.ConvertDirectory(targetDirectory);
     }
 
     /// <summary>
@@ -218,7 +217,8 @@ public string GetCoverImage(string path, string fileName, string outputDirectory
 
         try
         {
-            fileName = _converterService.ConvertFile(fileName, null);
+            if (!_converterService.IsVipsSupported(fileName))
+                fileName = _converterService.ConvertFile(fileName, null);
             var (width, height) = size.GetDimensions();
             using var sourceImage = Image.NewFromFile(path, false, Enums.Access.SequentialUnbuffered);
 
@@ -248,7 +248,8 @@ public string GetCoverImage(string path, string fileName, string outputDirectory
     /// <returns>File name with extension of the file. This will always write to <see cref="DirectoryService.CoverImageDirectory"/></returns>
     public string WriteCoverThumbnail(string sourceFile, Stream stream, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size = CoverImageSize.Default)
     {
-        stream = _converterService.ConvertStream(sourceFile, stream);
+        if (!_converterService.IsVipsSupported(sourceFile))
+            stream = _converterService.ConvertStream(sourceFile, stream);
         var (targetWidth, targetHeight) = size.GetDimensions();
         if (stream.CanSeek) stream.Position = 0;
         using var sourceImage = Image.NewFromStream(stream);
@@ -291,8 +292,8 @@ public string WriteCoverThumbnail(string sourceFile, Stream stream, string fileN
 
     public string WriteCoverThumbnail(string sourceFile, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size = CoverImageSize.Default)
     {
-        sourceFile = _converterService.ConvertFile(sourceFile,null);
-
+        if (!_converterService.IsVipsSupported(sourceFile))
+            sourceFile = _converterService.ConvertFile(sourceFile, null);
         var (width, height) = size.GetDimensions();
         using var sourceImage = Image.NewFromFile(sourceFile, false, Enums.Access.SequentialUnbuffered);
 
diff --git a/API/Services/Plus/ExternalMetadataService.cs b/API/Services/Plus/ExternalMetadataService.cs
index 4bc55eb88..a453239ca 100644
--- a/API/Services/Plus/ExternalMetadataService.cs
+++ b/API/Services/Plus/ExternalMetadataService.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Collections.Generic;
 using System.Collections.Immutable;
 using System.Linq;
@@ -91,9 +91,7 @@ public ExternalMetadataService(IUnitOfWork unitOfWork, ILogger<ExternalMetadataS
         _mapper = mapper;
         _licenseService = licenseService;
 
-
-        FlurlHttp.ConfigureClient(Configuration.KavitaPlusApiUrl, cli =>
-            cli.Settings.HttpClientFactory = new UntrustedCertClientFactory());
+        FlurlConfiguration.ConfigureClientForUrl(Configuration.KavitaPlusApiUrl);
     }
 
     /// <summary>
diff --git a/API/Services/Plus/RecommendationService.cs b/API/Services/Plus/RecommendationService.cs
index 24cb1445b..da96f1fef 100644
--- a/API/Services/Plus/RecommendationService.cs
+++ b/API/Services/Plus/RecommendationService.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Collections.Generic;
 using System.Linq;
 using System.Threading.Tasks;
@@ -37,8 +37,7 @@ public RecommendationService(IUnitOfWork unitOfWork, ILogger<RecommendationServi
         _unitOfWork = unitOfWork;
         _logger = logger;
 
-        FlurlHttp.ConfigureClient(Configuration.KavitaPlusApiUrl, cli =>
-            cli.Settings.HttpClientFactory = new UntrustedCertClientFactory());
+        FlurlConfiguration.ConfigureClientForUrl(Configuration.KavitaPlusApiUrl);
     }
 
     public async Task<RecommendationDto> GetRecommendationsForSeries(int userId, int seriesId)
diff --git a/API/Services/Plus/ScrobblingService.cs b/API/Services/Plus/ScrobblingService.cs
index 51939198b..c24a3d314 100644
--- a/API/Services/Plus/ScrobblingService.cs
+++ b/API/Services/Plus/ScrobblingService.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Collections.Generic;
 using System.Collections.Immutable;
 using System.Linq;
@@ -107,8 +107,7 @@ public ScrobblingService(IUnitOfWork unitOfWork, IEventHub eventHub, ILogger<Scr
         _licenseService = licenseService;
         _localizationService = localizationService;
 
-        FlurlHttp.ConfigureClient(Configuration.KavitaPlusApiUrl, cli =>
-            cli.Settings.HttpClientFactory = new UntrustedCertClientFactory());
+        FlurlConfiguration.ConfigureClientForUrl(Configuration.KavitaPlusApiUrl);
     }
 
 
diff --git a/API/Services/Tasks/Scanner/Parser/Parser.cs b/API/Services/Tasks/Scanner/Parser/Parser.cs
index 78f784cdd..a22c1b903 100644
--- a/API/Services/Tasks/Scanner/Parser/Parser.cs
+++ b/API/Services/Tasks/Scanner/Parser/Parser.cs
@@ -25,7 +25,7 @@ public static class Parser
 
     public static readonly TimeSpan RegexTimeout = TimeSpan.FromMilliseconds(500);
 
-    public const string ImageFileExtensions = @"^(\.png|\.jpeg|\.jpg|\.webp|\.gif|\.avif|\.jxl)"; // Don't forget to update CoverChooser
+    public const string ImageFileExtensions = @"^(\.png|\.jpeg|\.jpg|\.webp|\.gif|\.avif|\.jxl|\.heif|\.heic|\.j2k|\.jp2)"; // Don't forget to update CoverChooser
     public const string ArchiveFileExtensions = @"\.cbz|\.zip|\.rar|\.cbr|\.tar.gz|\.7zip|\.7z|\.cb7|\.cbt";
     public const string EpubFileExtension = @"\.epub";
     public const string PdfFileExtension = @"\.pdf";
diff --git a/API/Services/Tasks/StatsService.cs b/API/Services/Tasks/StatsService.cs
index 9cc93fefd..f9bfff2b6 100644
--- a/API/Services/Tasks/StatsService.cs
+++ b/API/Services/Tasks/StatsService.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Collections.Generic;
 using System.IO;
 using System.Linq;
@@ -46,8 +46,7 @@ public StatsService(ILogger<StatsService> logger, IUnitOfWork unitOfWork, DataCo
         _context = context;
         _statisticService = statisticService;
 
-        FlurlHttp.ConfigureClient(ApiUrl, cli =>
-            cli.Settings.HttpClientFactory = new UntrustedCertClientFactory());
+        FlurlConfiguration.ConfigureClientForUrl(ApiUrl);
     }
 
     /// <summary>
diff --git a/API/Services/Tasks/VersionUpdaterService.cs b/API/Services/Tasks/VersionUpdaterService.cs
index f1a6eb383..3f1d40f7f 100644
--- a/API/Services/Tasks/VersionUpdaterService.cs
+++ b/API/Services/Tasks/VersionUpdaterService.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Collections.Generic;
 using System.Linq;
 using System.Threading.Tasks;
@@ -64,10 +64,8 @@ public VersionUpdaterService(ILogger<VersionUpdaterService> logger, IEventHub ev
         _logger = logger;
         _eventHub = eventHub;
 
-        FlurlHttp.ConfigureClient(GithubLatestReleasesUrl, cli =>
-            cli.Settings.HttpClientFactory = new UntrustedCertClientFactory());
-        FlurlHttp.ConfigureClient(GithubAllReleasesUrl, cli =>
-            cli.Settings.HttpClientFactory = new UntrustedCertClientFactory());
+        FlurlConfiguration.ConfigureClientForUrl(GithubLatestReleasesUrl);
+        FlurlConfiguration.ConfigureClientForUrl(GithubAllReleasesUrl);
     }
 
     /// <summary>
diff --git a/Dockerfile b/Dockerfile
index 3eb3417c5..3e531ff0b 100644
--- a/Dockerfile
+++ b/Dockerfile
@@ -22,7 +22,7 @@ COPY API/config/appsettings.json /tmp/config/appsettings.json
 
 #Installs program dependencies
 RUN apt-get update \
-  && apt-get install -y libicu-dev libssl3t64 libgdiplus curl libjxl-tools \
+  && apt-get install -y libicu-dev libssl3t64 libgdiplus curl libjxl0.10 libavif-bin libheif1 libopenjp2-7 \
   && rm -rf /var/lib/apt/lists/*
 
 COPY entrypoint.sh /entrypoint.sh
diff --git a/Kavita.Common/Helpers/FlurlConfiguration.cs b/Kavita.Common/Helpers/FlurlConfiguration.cs
new file mode 100644
index 000000000..7d43d8ec5
--- /dev/null
+++ b/Kavita.Common/Helpers/FlurlConfiguration.cs
@@ -0,0 +1,30 @@
+using System;
+using System.Collections.Generic;
+using System.Net.Http;
+using Flurl.Http;
+
+
+namespace Kavita.Common.Helpers;
+
+public static class FlurlConfiguration
+{
+    private static readonly List<string> _configuredClients = new List<string>();
+    private static readonly object _lock = new object();
+
+    public static void ConfigureClientForUrl(string url)
+    {
+        lock (_lock)
+        {
+            Uri ur = new Uri(url);
+            string host = ur.Host+":"+ur.Port;
+            if (_configuredClients.Contains(host))
+            {
+                return;
+            }
+            FlurlHttp.ConfigureClientForUrl(url).ConfigureInnerHandler(cli =>
+                cli.ServerCertificateCustomValidationCallback = (_, _, _, _) => true);
+            _configuredClients.Add(host);
+        }
+    }
+
+}
diff --git a/Kavita.Common/Helpers/UntrustedCertClientFactory.cs b/Kavita.Common/Helpers/UntrustedCertClientFactory.cs
deleted file mode 100644
index 6ddb2a9f3..000000000
--- a/Kavita.Common/Helpers/UntrustedCertClientFactory.cs
+++ /dev/null
@@ -1,13 +0,0 @@
-using System.Net.Http;
-using Flurl.Http.Configuration;
-
-namespace Kavita.Common.Helpers;
-
-public class UntrustedCertClientFactory : DefaultHttpClientFactory
-{
-    public override HttpMessageHandler CreateMessageHandler() {
-        return new HttpClientHandler {
-            ServerCertificateCustomValidationCallback = (_, _, _, _) => true
-        };
-    }
-}
diff --git a/Kavita.Common/Kavita.Common.csproj b/Kavita.Common/Kavita.Common.csproj
index c4d23536d..a4e840197 100644
--- a/Kavita.Common/Kavita.Common.csproj
+++ b/Kavita.Common/Kavita.Common.csproj
@@ -11,7 +11,7 @@
     <ItemGroup>
       <PackageReference Include="Cronos" Version="0.8.4" />
       <PackageReference Include="DotNet.Glob" Version="3.1.3" />
-      <PackageReference Include="Flurl.Http" Version="3.2.4" />
+      <PackageReference Include="Flurl.Http" Version="4.0.2" />
       <PackageReference Include="Microsoft.Extensions.Configuration.Abstractions" Version="8.0.0" />
       <PackageReference Include="Microsoft.Extensions.Hosting" Version="8.0.0" />
       <PackageReference Include="SonarAnalyzer.CSharp" Version="9.32.0.97167">
diff --git a/docker-build-jxl.sh b/docker-build-wconvertion.sh
similarity index 100%
rename from docker-build-jxl.sh
rename to docker-build-wconvertion.sh

From 7d48f6ec1002592dd8e8103397466a02a3c9a993 Mon Sep 17 00:00:00 2001
From: Maximo Piva <mpiva@adventintermodal.com>
Date: Mon, 26 Aug 2024 21:55:16 -0300
Subject: [PATCH 08/30] Add Documentation

---
 API/Extensions/FileTypeGroupExtensions.cs     | 14 ++++-
 API/Extensions/HttpExtensions.cs              | 11 ++--
 .../AvifImageConverterProvider.cs             | 30 +++++++++--
 .../HeifImageConverterProvider.cs             | 18 ++++++-
 .../Jpeg2000ImageConverterProvider.cs         | 18 ++++++-
 .../JpegXLImageConverterProvider.cs           | 53 +++++++++++++++++--
 API/Services/ImageConverterService.cs         | 44 +++++++++++++--
 Kavita.Common/Helpers/FlurlConfiguration.cs   | 14 +++--
 8 files changed, 179 insertions(+), 23 deletions(-)

diff --git a/API/Extensions/FileTypeGroupExtensions.cs b/API/Extensions/FileTypeGroupExtensions.cs
index 9cbd33098..ca6c1c187 100644
--- a/API/Extensions/FileTypeGroupExtensions.cs
+++ b/API/Extensions/FileTypeGroupExtensions.cs
@@ -7,6 +7,11 @@ namespace API.Extensions;
 
 public static class FileTypeGroupExtensions
 {
+    /// <summary>
+    /// Gets the regular expression pattern for the specified FileTypeGroup.
+    /// </summary>
+    /// <param name="fileTypeGroup">The FileTypeGroup.</param>
+    /// <returns>The regular expression pattern.</returns>
     public static string GetRegex(this FileTypeGroup fileTypeGroup)
     {
         switch (fileTypeGroup)
@@ -23,13 +28,18 @@ public static string GetRegex(this FileTypeGroup fileTypeGroup)
                 throw new ArgumentOutOfRangeException(nameof(fileTypeGroup), fileTypeGroup, null);
         }
     }
+
+    /// <summary>
+    /// Gets the MIME type for the specified file format. Extends original MimeTypeMap adding non supported extensions by the nuget.
+    /// </summary>
+    /// <param name="format">The file format.</param>
+    /// <returns>The MIME type.</returns>
     public static string GetMimeType(this string format)
     {
-        //Add jxl format
+        // Add jxl format
         format = format.ToLowerInvariant();
         if (format == ".jxl")
             return "image/jxl";
         return MimeTypeMap.GetMimeType(format);
     }
-
 }
diff --git a/API/Extensions/HttpExtensions.cs b/API/Extensions/HttpExtensions.cs
index 67ffbc14b..3c7ac456c 100644
--- a/API/Extensions/HttpExtensions.cs
+++ b/API/Extensions/HttpExtensions.cs
@@ -57,6 +57,11 @@ public static void AddCacheHeader(this HttpResponse response, string filename, i
         }
     }
 
+    /// <summary>
+    /// Retrieves the supported image types extensions from the Accept header of the HTTP request.
+    /// </summary>
+    /// <param name="request">The HTTP request.</param>
+    /// <returns>A list of supported image types extensions.</returns>
     public static List<string> SupportedImageTypesFromRequest(this HttpRequest request)
     {
         var acceptHeader = request.Headers["Accept"];
@@ -76,18 +81,18 @@ public static List<string> SupportedImageTypesFromRequest(this HttpRequest reque
                 string n = v.Substring(6).ToLowerInvariant();
                 if (n == "svg+xml")
                     n = "svg";
-                if (n=="jp2")
+                if (n == "jp2")
                     defaultExtensions.Add("j2k");
                 if (n == "j2k")
                     defaultExtensions.Add("jp2");
-                if (n=="heif")
+                if (n == "heif")
                     defaultExtensions.Add("heic");
                 if (n == "heic")
                     defaultExtensions.Add("heif");
                 if (n.StartsWith("*"))
                     continue;
                 if (!defaultExtensions.Contains(n))
-                   defaultExtensions.Add(n);
+                    defaultExtensions.Add(n);
             }
         }
         return defaultExtensions;
diff --git a/API/Services/ImageConversion/AvifImageConverterProvider.cs b/API/Services/ImageConversion/AvifImageConverterProvider.cs
index c90120f0f..59b060177 100644
--- a/API/Services/ImageConversion/AvifImageConverterProvider.cs
+++ b/API/Services/ImageConversion/AvifImageConverterProvider.cs
@@ -7,24 +7,42 @@
 
 namespace API.Services.ImageConversion
 {
-    //AVIF & HEIF are supported by netvips.
-
+    /// <summary>
+    /// Provides image conversion functionality for AVIF format using netvips library.
+    /// </summary>
     public class AvifImageConverterProvider : IImageConverterProvider
     {
         private readonly ILogger<AvifImageConverterProvider> _logger;
+
+        /// <summary>
+        /// Gets a value indicating whether Vips supports AVIF.
+        /// </summary>
         public bool IsVipsSupported => true;
 
+        /// <summary>
+        /// Initializes a new instance of the <see cref="AvifImageConverterProvider"/> class.
+        /// </summary>
+        /// <param name="logger">The logger.</param>
         public AvifImageConverterProvider(ILogger<AvifImageConverterProvider> logger)
         {
             _logger = logger;
         }
 
+        /// <summary>
+        /// Checks if the filename has the AVIF extension.
+        /// </summary>
+        /// <param name="filename">The filename of the image file.</param>
+        /// <returns>True if the image is AVIF image type; otherwise, false.</returns>
         public bool IsSupported(string filename)
         {
             return filename.EndsWith(".avif", StringComparison.InvariantCultureIgnoreCase);
-
         }
 
+        /// <summary>
+        /// Converts the specified AVIF file to JPEG format.
+        /// </summary>
+        /// <param name="filename">The filename of the AVIF file.</param>
+        /// <returns>The filename of the converted JPEG file.</returns>
         public string Convert(string filename)
         {
             string destination = Path.ChangeExtension(filename, "jpg");
@@ -34,11 +52,15 @@ public string Convert(string filename)
             return destination;
         }
 
+        /// <summary>
+        /// Gets the dimensions (width and height) of the specified image file.
+        /// </summary>
+        /// <param name="fileName">The filename of the image file.</param>
+        /// <returns>The dimensions of the image file as a tuple of width and height.</returns>
         public (int Width, int Height)? GetDimensions(string fileName)
         {
             using var image = Image.NewFromFile(fileName, memory: false, access: Enums.Access.SequentialUnbuffered);
             return (image.Width, image.Height);
         }
-
     }
 }
diff --git a/API/Services/ImageConversion/HeifImageConverterProvider.cs b/API/Services/ImageConversion/HeifImageConverterProvider.cs
index a7d97606e..2e5565a94 100644
--- a/API/Services/ImageConversion/HeifImageConverterProvider.cs
+++ b/API/Services/ImageConversion/HeifImageConverterProvider.cs
@@ -6,22 +6,36 @@
 
 namespace API.Services.ImageConversion
 {
+    /// <summary>
+    /// Provides image conversion functionality for HEIF and HEIC file formats using ImageMagick.
+    /// </summary>
     public class HeifImageConverterProvider : ImageMagickConverterProvider, IImageConverterProvider
     {
         private readonly ILogger<HeifImageConverterProvider> _logger;
+
+        /// <summary>
+        /// Gets a value indicating whether Vips supports HEIF.
+        /// </summary>
         public bool IsVipsSupported => false;
 
+        /// <summary>
+        /// Initializes a new instance of the <see cref="HeifImageConverterProvider"/> class.
+        /// </summary>
+        /// <param name="logger">The logger.</param>
         public HeifImageConverterProvider(ILogger<HeifImageConverterProvider> logger)
         {
             _logger = logger;
         }
 
+        /// <summary>
+        /// Checks if the filename has the HEIF/HEIC extension.
+        /// </summary>
+        /// <param name="filename">The filename of the image file.</param>
+        /// <returns>True if the image is HEIF/HEIC image type; otherwise, false.</returns>
         public bool IsSupported(string filename)
         {
             return filename.EndsWith(".heif", StringComparison.InvariantCultureIgnoreCase)
                    || filename.EndsWith(".heic", StringComparison.InvariantCultureIgnoreCase);
-
         }
-
     }
 }
diff --git a/API/Services/ImageConversion/Jpeg2000ImageConverterProvider.cs b/API/Services/ImageConversion/Jpeg2000ImageConverterProvider.cs
index 16131d2a3..6c9e8f5dd 100644
--- a/API/Services/ImageConversion/Jpeg2000ImageConverterProvider.cs
+++ b/API/Services/ImageConversion/Jpeg2000ImageConverterProvider.cs
@@ -7,16 +7,32 @@
 
 namespace API.Services.ImageConversion
 {
-    //NetVips do not support Jpeg2000, Vips does but generate the right bindings is a pain in the ass
+    /// <summary>
+    /// Provides image conversion functionality for JPEG2000 images.
+    /// </summary>
     public class Jpeg2000ImageConverterProvider : ImageMagickConverterProvider, IImageConverterProvider
     {
         private readonly ILogger<Jpeg2000ImageConverterProvider> _logger;
+
+        /// <summary>
+        /// Initializes a new instance of the <see cref="Jpeg2000ImageConverterProvider"/> class.
+        /// </summary>
+        /// <param name="logger">The logger.</param>
         public Jpeg2000ImageConverterProvider(ILogger<Jpeg2000ImageConverterProvider> logger)
         {
             _logger = logger;
         }
 
+        /// <summary>
+        /// Gets a value indicating whether Vips supports JPEG 2000.
+        /// </summary>
         public bool IsVipsSupported => false;
+
+        /// <summary>
+        /// Checks if the filename has the JPEG 2000 extension.
+        /// </summary>
+        /// <param name="filename">The filename of the image file.</param>
+        /// <returns>True if the image is JPEG 2000 image type; otherwise, false.</returns>
         public bool IsSupported(string filename)
         {
             return filename.EndsWith(".jp2", StringComparison.InvariantCultureIgnoreCase) || filename.EndsWith(".j2k", StringComparison.InvariantCultureIgnoreCase);
diff --git a/API/Services/ImageConversion/JpegXLImageConverterProvider.cs b/API/Services/ImageConversion/JpegXLImageConverterProvider.cs
index 2b4c41a5c..3e23d46d4 100644
--- a/API/Services/ImageConversion/JpegXLImageConverterProvider.cs
+++ b/API/Services/ImageConversion/JpegXLImageConverterProvider.cs
@@ -10,17 +10,45 @@
 
 namespace API.Services.ImageConversion;
 
+/// <summary>
+/// Represents an image converter provider.
+/// </summary>
 public interface IImageConverterProvider
 {
+    /// <summary>
+    /// Checks if the image converter supports the image format.
+    /// </summary>
+    /// <param name="filename">The filename of the image file.</param>
+    /// <returns>True if the image converter supports the image type; otherwise, false.</returns>
     bool IsSupported(string filename);
+
+    /// <summary>
+    /// Converts the specified image to JPG.
+    /// </summary>
+    /// <param name="filename">The filename of the image file.</param>
+    /// <returns>The converted image file.</returns>
     string Convert(string filename);
+
+    /// <summary>
+    /// Gets the dimensions of the specified image file.
+    /// </summary>
+    /// <param name="fileName">The filename of the image file.</param>
+    /// <returns>The dimensions of the image file as a tuple of width and height, or null if the dimensions cannot be determined.</returns>
     (int Width, int Height)? GetDimensions(string fileName);
 
+    /// <summary>
+    /// Gets a value indicating whether the image type supports Vips.
+    /// </summary>
     bool IsVipsSupported { get; }
 }
 
 public class ImageMagickConverterProvider
 {
+    /// <summary>
+    /// Converts the specified image to JPG.
+    /// </summary>
+    /// <param name="filename">The filename of the image file.</param>
+    /// <returns>The converted image file.</returns>
     public virtual string Convert(string filename)
     {
         string destination = Path.ChangeExtension(filename, "jpg");
@@ -31,6 +59,11 @@ public virtual string Convert(string filename)
         return destination;
     }
 
+    /// <summary>
+    /// Gets the dimensions of the specified image file.
+    /// </summary>
+    /// <param name="filename">The filename of the image file.</param>
+    /// <returns>The dimensions of the image file as a tuple of width and height, or null if the dimensions cannot be determined.</returns>
     public virtual (int Width, int Height)? GetDimensions(string filename)
     {
         var info = new MagickImageInfo(filename);
@@ -38,20 +71,34 @@ public virtual (int Width, int Height)? GetDimensions(string filename)
     }
 }
 
-//NetVips do not support Jpeg-XL, Vips does but generate the right bindings is a pain in the ass
+/// <summary>
+/// Represents a JPEG-XL image converter provider.
+/// </summary>
 public class JpegXLImageConverterProvider : ImageMagickConverterProvider, IImageConverterProvider
 {
     private readonly ILogger<JpegXLImageConverterProvider> _logger;
+
+    /// <summary>
+    /// Initializes a new instance of the <see cref="JpegXLImageConverterProvider"/> class.
+    /// </summary>
+    /// <param name="logger">The logger.</param>
     public JpegXLImageConverterProvider(ILogger<JpegXLImageConverterProvider> logger)
     {
         _logger = logger;
     }
+
+    /// <summary>
+    /// Gets a value indicating whether Vips supports JPEG-XL.
+    /// </summary>
     public bool IsVipsSupported => false;
 
+    /// <summary>
+    /// Checks if the filename has the JPEG-XL extension.
+    /// </summary>
+    /// <param name="filename">The filename of the image file.</param>
+    /// <returns>True if the image is JPEG-XL image type; otherwise, false.</returns>
     public bool IsSupported(string filename)
     {
         return filename.EndsWith(".jxl", StringComparison.InvariantCultureIgnoreCase);
     }
-
-  
 }
diff --git a/API/Services/ImageConverterService.cs b/API/Services/ImageConverterService.cs
index 35a21b510..dc9546058 100644
--- a/API/Services/ImageConverterService.cs
+++ b/API/Services/ImageConverterService.cs
@@ -7,25 +7,59 @@
 
 namespace API.Services
 {
+    /// <summary>
+    /// Represents an image converter service.
+    /// </summary>
     public interface IImageConverterService
     {
+        /// <summary>
+        /// Converts the input stream to jpg image format.
+        /// </summary>
+        /// <param name="filename">The filename of the image.</param>
+        /// <param name="source">The input stream of the image.</param>
+        /// <returns>The converted image stream.</returns>
         Stream ConvertStream(string filename, Stream source);
+
+        /// <summary>
+        /// Converts the specified image file to jpg image format.
+        /// </summary>
+        /// <param name="filename">The filename of the image.</param>
+        /// <param name="supportedImageFormats">The list of supported image formats by the client from the Accept Header.</param>
+        /// <returns>The converted image file path if conversion is required.</returns>
         string ConvertFile(string filename, List<string> supportedImageFormats);
+
+        /// <summary>
+        /// Gets the dimensions (width and height) of the specified image file.
+        /// </summary>
+        /// <param name="fileName">The filename of the image.</param>
+        /// <returns>The dimensions of the image (width and height).</returns>
         (int Width, int Height)? GetDimensions(string fileName);
 
-        public bool IsVipsSupported(string filename);
+        /// <summary>
+        /// Checks if the VIPS library supports for the specified image type.
+        /// </summary>
+        /// <param name="filename">The filename of the image.</param>
+        /// <returns>True if the VIPS library support it; otherwise, false.</returns>
+        bool IsVipsSupported(string filename);
     }
 
+    /// <summary>
+    /// Represents an implementation of the image converter service.
+    /// </summary>
     public class ImageConverterService : IImageConverterService
     {
         private IEnumerable<IImageConverterProvider> _converters;
+
+        /// <summary>
+        /// Initializes a new instance of the <see cref="ImageConverterService"/> class.
+        /// </summary>
+        /// <param name="converters">The collection of image converter providers.</param>
         public ImageConverterService(IEnumerable<IImageConverterProvider> converters)
         {
             _converters = converters;
         }
 
-
-
+        /// <inheritdoc/>
         public Stream ConvertStream(string filename, Stream source)
         {
             IImageConverterProvider provider = _converters.FirstOrDefault(a => a.IsSupported(filename));
@@ -47,6 +81,7 @@ private bool CheckDirectSupport(string filename, List<string> supportedImageForm
             return supportedImageFormats.Contains(ext);
         }
 
+        /// <inheritdoc/>
         public string ConvertFile(string filename, List<string> supportedImageFormats)
         {
             if (CheckDirectSupport(filename, supportedImageFormats))
@@ -57,7 +92,7 @@ public string ConvertFile(string filename, List<string> supportedImageFormats)
             return provider.Convert(filename);
         }
 
-
+        /// <inheritdoc/>
         public (int Width, int Height)? GetDimensions(string fileName)
         {
             IImageConverterProvider provider = _converters.FirstOrDefault(a => a.IsSupported(fileName));
@@ -66,6 +101,7 @@ public string ConvertFile(string filename, List<string> supportedImageFormats)
             return provider.GetDimensions(fileName);
         }
 
+        /// <inheritdoc/>
         public bool IsVipsSupported(string filename)
         {
             IImageConverterProvider provider = _converters.FirstOrDefault(a => a.IsSupported(filename));
diff --git a/Kavita.Common/Helpers/FlurlConfiguration.cs b/Kavita.Common/Helpers/FlurlConfiguration.cs
index 7d43d8ec5..44aed280b 100644
--- a/Kavita.Common/Helpers/FlurlConfiguration.cs
+++ b/Kavita.Common/Helpers/FlurlConfiguration.cs
@@ -6,25 +6,31 @@
 
 namespace Kavita.Common.Helpers;
 
+/// <summary>
+/// Helper class for configuring Flurl client for a specific URL.
+/// </summary>
 public static class FlurlConfiguration
 {
     private static readonly List<string> _configuredClients = new List<string>();
     private static readonly object _lock = new object();
 
+    /// <summary>
+    /// Configures the Flurl client for the specified URL.
+    /// </summary>
+    /// <param name="url">The URL to configure the client for.</param>
     public static void ConfigureClientForUrl(string url)
     {
+        //Important client are mapped without path, per example two urls pointing to the same host:port but different path, will use the same client.
         lock (_lock)
         {
             Uri ur = new Uri(url);
-            string host = ur.Host+":"+ur.Port;
+            //key is host:port
+            string host = ur.Host + ":" + ur.Port;
             if (_configuredClients.Contains(host))
-            {
                 return;
-            }
             FlurlHttp.ConfigureClientForUrl(url).ConfigureInnerHandler(cli =>
                 cli.ServerCertificateCustomValidationCallback = (_, _, _, _) => true);
             _configuredClients.Add(host);
         }
     }
-
 }

From a4a12a1c58eebc65a723c58f15cb12e721cd20b5 Mon Sep 17 00:00:00 2001
From: Maximo Piva <mpiva@adventintermodal.com>
Date: Wed, 28 Aug 2024 18:17:56 -0300
Subject: [PATCH 09/30] FIX BOMS

---
 API.Benchmark/ArchiveServiceBenchmark.cs       | 2 +-
 API.Tests/Services/ArchiveServiceTests.cs      | 2 +-
 API.Tests/Services/BookServiceTests.cs         | 2 +-
 API.Tests/Services/CacheServiceTests.cs        | 2 +-
 API/Extensions/ApplicationServiceExtensions.cs | 2 +-
 API/Extensions/FileTypeGroupExtensions.cs      | 2 +-
 API/Extensions/HttpExtensions.cs               | 2 +-
 API/Services/ArchiveService.cs                 | 2 +-
 API/Services/BookService.cs                    | 2 +-
 API/Services/CacheService.cs                   | 2 +-
 API/Services/ImageService.cs                   | 2 +-
 API/Services/Plus/ExternalMetadataService.cs   | 2 +-
 API/Services/Plus/RecommendationService.cs     | 2 +-
 API/Services/Plus/ScrobblingService.cs         | 2 +-
 API/Services/Tasks/Scanner/Parser/Parser.cs    | 2 +-
 API/Services/Tasks/StatsService.cs             | 2 +-
 API/Services/Tasks/VersionUpdaterService.cs    | 2 +-
 Kavita.Common/EnvironmentInfo/IOsInfo.cs       | 2 +-
 18 files changed, 18 insertions(+), 18 deletions(-)

diff --git a/API.Benchmark/ArchiveServiceBenchmark.cs b/API.Benchmark/ArchiveServiceBenchmark.cs
index fd82ee87d..10dc367a4 100644
--- a/API.Benchmark/ArchiveServiceBenchmark.cs
+++ b/API.Benchmark/ArchiveServiceBenchmark.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.IO;
 using System.IO.Abstractions;
 using Microsoft.Extensions.Logging.Abstractions;
diff --git a/API.Tests/Services/ArchiveServiceTests.cs b/API.Tests/Services/ArchiveServiceTests.cs
index 530affbf3..982fa2606 100644
--- a/API.Tests/Services/ArchiveServiceTests.cs
+++ b/API.Tests/Services/ArchiveServiceTests.cs
@@ -1,4 +1,4 @@
-using System.Diagnostics;
+using System.Diagnostics;
 using System.IO;
 using System.IO.Abstractions;
 using System.IO.Abstractions.TestingHelpers;
diff --git a/API.Tests/Services/BookServiceTests.cs b/API.Tests/Services/BookServiceTests.cs
index 2fc1e18d1..b24085bde 100644
--- a/API.Tests/Services/BookServiceTests.cs
+++ b/API.Tests/Services/BookServiceTests.cs
@@ -1,4 +1,4 @@
-using System.IO;
+using System.IO;
 using System.IO.Abstractions;
 using API.Services;
 using EasyCaching.Core;
diff --git a/API.Tests/Services/CacheServiceTests.cs b/API.Tests/Services/CacheServiceTests.cs
index c5ae07bee..45a86d04f 100644
--- a/API.Tests/Services/CacheServiceTests.cs
+++ b/API.Tests/Services/CacheServiceTests.cs
@@ -1,4 +1,4 @@
-using System.Collections.Generic;
+using System.Collections.Generic;
 using System.Data.Common;
 using System.IO;
 using System.IO.Abstractions.TestingHelpers;
diff --git a/API/Extensions/ApplicationServiceExtensions.cs b/API/Extensions/ApplicationServiceExtensions.cs
index 33085263e..b6154710b 100644
--- a/API/Extensions/ApplicationServiceExtensions.cs
+++ b/API/Extensions/ApplicationServiceExtensions.cs
@@ -1,4 +1,4 @@
-using System.IO.Abstractions;
+using System.IO.Abstractions;
 using API.Constants;
 using API.Data;
 using API.Helpers;
diff --git a/API/Extensions/FileTypeGroupExtensions.cs b/API/Extensions/FileTypeGroupExtensions.cs
index ca6c1c187..87eac43bb 100644
--- a/API/Extensions/FileTypeGroupExtensions.cs
+++ b/API/Extensions/FileTypeGroupExtensions.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using API.Entities.Enums;
 using API.Services.Tasks.Scanner.Parser;
 using MimeTypes;
diff --git a/API/Extensions/HttpExtensions.cs b/API/Extensions/HttpExtensions.cs
index 3c7ac456c..8cd1c7b77 100644
--- a/API/Extensions/HttpExtensions.cs
+++ b/API/Extensions/HttpExtensions.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Collections.Generic;
 using System.IO;
 using System.Linq;
diff --git a/API/Services/ArchiveService.cs b/API/Services/ArchiveService.cs
index 641c25c0d..5ce662bed 100644
--- a/API/Services/ArchiveService.cs
+++ b/API/Services/ArchiveService.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Collections.Generic;
 using System.Diagnostics;
 using System.IO;
diff --git a/API/Services/BookService.cs b/API/Services/BookService.cs
index cb22f24d6..5e339b210 100644
--- a/API/Services/BookService.cs
+++ b/API/Services/BookService.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Collections.Generic;
 using System.Globalization;
 using System.IO;
diff --git a/API/Services/CacheService.cs b/API/Services/CacheService.cs
index d5f9cc971..c8e48d4c3 100644
--- a/API/Services/CacheService.cs
+++ b/API/Services/CacheService.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Collections.Concurrent;
 using System.Collections.Generic;
 using System.Diagnostics;
diff --git a/API/Services/ImageService.cs b/API/Services/ImageService.cs
index 717619868..0960b2a7a 100644
--- a/API/Services/ImageService.cs
+++ b/API/Services/ImageService.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Collections.Generic;
 using System.Drawing;
 using System.IO;
diff --git a/API/Services/Plus/ExternalMetadataService.cs b/API/Services/Plus/ExternalMetadataService.cs
index a453239ca..e9759f26f 100644
--- a/API/Services/Plus/ExternalMetadataService.cs
+++ b/API/Services/Plus/ExternalMetadataService.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Collections.Generic;
 using System.Collections.Immutable;
 using System.Linq;
diff --git a/API/Services/Plus/RecommendationService.cs b/API/Services/Plus/RecommendationService.cs
index da96f1fef..5b38a943b 100644
--- a/API/Services/Plus/RecommendationService.cs
+++ b/API/Services/Plus/RecommendationService.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Collections.Generic;
 using System.Linq;
 using System.Threading.Tasks;
diff --git a/API/Services/Plus/ScrobblingService.cs b/API/Services/Plus/ScrobblingService.cs
index c24a3d314..2efd9ea26 100644
--- a/API/Services/Plus/ScrobblingService.cs
+++ b/API/Services/Plus/ScrobblingService.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Collections.Generic;
 using System.Collections.Immutable;
 using System.Linq;
diff --git a/API/Services/Tasks/Scanner/Parser/Parser.cs b/API/Services/Tasks/Scanner/Parser/Parser.cs
index a22c1b903..ef6fe2e9b 100644
--- a/API/Services/Tasks/Scanner/Parser/Parser.cs
+++ b/API/Services/Tasks/Scanner/Parser/Parser.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Collections.Immutable;
 using System.Globalization;
 using System.IO;
diff --git a/API/Services/Tasks/StatsService.cs b/API/Services/Tasks/StatsService.cs
index f9bfff2b6..8c1d46179 100644
--- a/API/Services/Tasks/StatsService.cs
+++ b/API/Services/Tasks/StatsService.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Collections.Generic;
 using System.IO;
 using System.Linq;
diff --git a/API/Services/Tasks/VersionUpdaterService.cs b/API/Services/Tasks/VersionUpdaterService.cs
index 3f1d40f7f..4a42a34eb 100644
--- a/API/Services/Tasks/VersionUpdaterService.cs
+++ b/API/Services/Tasks/VersionUpdaterService.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Collections.Generic;
 using System.Linq;
 using System.Threading.Tasks;
diff --git a/Kavita.Common/EnvironmentInfo/IOsInfo.cs b/Kavita.Common/EnvironmentInfo/IOsInfo.cs
index 6b99e0eac..a015e60ec 100644
--- a/Kavita.Common/EnvironmentInfo/IOsInfo.cs
+++ b/Kavita.Common/EnvironmentInfo/IOsInfo.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Diagnostics;
 
 namespace Kavita.Common.EnvironmentInfo;

From 0f98d7507a30d96e462c1d4e3c236ded336ef6c5 Mon Sep 17 00:00:00 2001
From: Maximo Piva <mpiva@adventintermodal.com>
Date: Wed, 28 Aug 2024 18:29:51 -0300
Subject: [PATCH 10/30] Recode SupportedImageTypesFromRequest removing possible
 errors.

---
 API/Extensions/HttpExtensions.cs | 49 +++++++++++++++++++-------------
 1 file changed, 30 insertions(+), 19 deletions(-)

diff --git a/API/Extensions/HttpExtensions.cs b/API/Extensions/HttpExtensions.cs
index 8cd1c7b77..2394db2c0 100644
--- a/API/Extensions/HttpExtensions.cs
+++ b/API/Extensions/HttpExtensions.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Collections.Generic;
 using System.IO;
 using System.Linq;
@@ -57,6 +57,14 @@ public static void AddCacheHeader(this HttpResponse response, string filename, i
         }
     }
 
+    private static void AddExtension(List<string> extensions, string extension)
+    {
+        if (string.IsNullOrEmpty(extension))
+            return;
+        if (!extensions.Contains(extension))
+            extensions.Add(extension);
+    }
+
     /// <summary>
     /// Retrieves the supported image types extensions from the Accept header of the HTTP request.
     /// </summary>
@@ -64,37 +72,40 @@ public static void AddCacheHeader(this HttpResponse response, string filename, i
     /// <returns>A list of supported image types extensions.</returns>
     public static List<string> SupportedImageTypesFromRequest(this HttpRequest request)
     {
-        var acceptHeader = request.Headers["Accept"];
-        string[] spl1 = acceptHeader.ToString().Split(';');
+        var acceptHeader = request.Headers["Accept"].ToString();
+        string[] spl1 = acceptHeader.Split(';');
         acceptHeader = spl1[0];
-        string[] split = acceptHeader.ToString().Split(',');
-        List<string> defaultExtensions = new List<string>();
-        defaultExtensions.Add("jpeg");
-        defaultExtensions.Add("jpg");
-        defaultExtensions.Add("png");
-        defaultExtensions.Add("gif");
-        defaultExtensions.Add("webp");
+        string[] split = acceptHeader.Split(',');
+        List<string> supportedExtensions = new List<string>();
+
+        //Add default extensions supported by all browsers.
+        supportedExtensions.Add("jpeg");
+        supportedExtensions.Add("jpg");
+        supportedExtensions.Add("png");
+        supportedExtensions.Add("gif");
+        supportedExtensions.Add("webp");
+        //Browser add specific image mime types, when the image type is not a global standard.
+        //Let's reuse that to identify the additional image types supported by the browser.
         foreach (string v in split)
         {
             if (v.StartsWith("image/", StringComparison.InvariantCultureIgnoreCase))
             {
                 string n = v.Substring(6).ToLowerInvariant();
+                if (n.StartsWith("*"))
+                    continue;
                 if (n == "svg+xml")
                     n = "svg";
                 if (n == "jp2")
-                    defaultExtensions.Add("j2k");
+                    AddExtension(supportedExtensions, "j2k");
                 if (n == "j2k")
-                    defaultExtensions.Add("jp2");
+                    AddExtension(supportedExtensions, "jp2");
                 if (n == "heif")
-                    defaultExtensions.Add("heic");
+                    AddExtension(supportedExtensions, "heic");
                 if (n == "heic")
-                    defaultExtensions.Add("heif");
-                if (n.StartsWith("*"))
-                    continue;
-                if (!defaultExtensions.Contains(n))
-                    defaultExtensions.Add(n);
+                    AddExtension(supportedExtensions, "heif");
+                AddExtension(supportedExtensions, n);
             }
         }
-        return defaultExtensions;
+        return supportedExtensions;
     }
 }

From 937f89cbfdad1a8eefa5a8a6fbc35830ef20cf97 Mon Sep 17 00:00:00 2001
From: Maximo Piva <mpiva@adventintermodal.com>
Date: Wed, 28 Aug 2024 18:46:34 -0300
Subject: [PATCH 11/30] Remove own docker build

---
 docker-build-wconvertion.sh | 103 ------------------------------------
 1 file changed, 103 deletions(-)
 delete mode 100644 docker-build-wconvertion.sh

diff --git a/docker-build-wconvertion.sh b/docker-build-wconvertion.sh
deleted file mode 100644
index 206b97f0b..000000000
--- a/docker-build-wconvertion.sh
+++ /dev/null
@@ -1,103 +0,0 @@
-#! /bin/bash
-set -e
-
-outputFolder='_output'
-
-ProgressStart()
-{
-    echo "Start '$1'"
-}
-
-ProgressEnd()
-{
-    echo "Finish '$1'"
-}
-
-Build()
-{
-	local RID="$1"
-
-    ProgressStart "Build for $RID"
-
-    slnFile=Kavita.sln
-
-    dotnet clean $slnFile -c Release
-
-	  dotnet msbuild -restore $slnFile -p:Configuration=Release -p:Platform="Any CPU" -p:RuntimeIdentifiers=$RID
-
-    ProgressEnd "Build for $RID"
-}
-
-BuildUI()
-{
-    ProgressStart 'Building UI'
-    echo 'Removing old wwwroot'
-    rm -rf API/wwwroot/*
-    cd UI/Web/ || exit
-    echo 'Installing web dependencies'
-    npm install --legacy-peer-deps
-    echo 'Building UI'
-    npm run prod
-    echo 'Copying back to Kavita wwwroot'
-    mkdir -p ../../API/wwwroot
-    cp -R dist/browser/* ../../API/wwwroot
-    cd ../../ || exit
-    ProgressEnd 'Building UI'
-}
-
-Package()
-{
-    local runtime="$1"
-    local lOutputFolder=../_output/"$runtime"/Kavita
-
-    ProgressStart "Creating $runtime Package"
-
-    # TODO: Use no-restore? Because Build should have already done it for us
-    echo "Building"
-    cd API
-    echo dotnet publish -c Release --no-restore --self-contained --runtime $runtime -o "$lOutputFolder"
-    dotnet publish -c Release --no-restore --self-contained --runtime $runtime -o "$lOutputFolder"
-
-    echo "Copying Install information"
-    cp ../INSTALL.txt "$lOutputFolder"/README.txt
-
-    echo "Copying LICENSE"
-    cp ../LICENSE "$lOutputFolder"/LICENSE.txt
-
-    echo "Renaming API -> Kavita"
-    mv "$lOutputFolder"/API "$lOutputFolder"/Kavita
-
-    echo "Creating tar"
-    cd ../$outputFolder/"$runtime"/
-    tar -czvf ../kavita-$runtime.tar.gz Kavita
-
-    ProgressEnd "Creating $runtime Package"
-
-}
-
-dir=$PWD
-
-if [ -d _output ]
-then
-	rm -r _output/
-fi
-
-BuildUI
-
-#Build for x64
-Build "linux-x64"
-Package "linux-x64"
-cd "$dir"
-
-#Build for arm
-Build "linux-arm"
-Package "linux-arm"
-cd "$dir"
-
-#Build for arm64
-Build "linux-arm64"
-Package "linux-arm64"
-cd "$dir"
-
-#Builds Docker images
-docker buildx build -t maxpiva/kavita:nightly --platform linux/amd64,linux/arm/v7,linux/arm64 . --push

From a08a7957aa092494668b1277195a7be8d0a84400 Mon Sep 17 00:00:00 2001
From: Maximo Piva <mpiva@adventintermodal.com>
Date: Wed, 28 Aug 2024 20:06:30 -0300
Subject: [PATCH 12/30] Shell Call no longer used, since swapped image
 conversion to Image Magick. Rollback IOsInfo.cs

---
 Kavita.Common/EnvironmentInfo/IOsInfo.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/Kavita.Common/EnvironmentInfo/IOsInfo.cs b/Kavita.Common/EnvironmentInfo/IOsInfo.cs
index a015e60ec..d8cc6a070 100644
--- a/Kavita.Common/EnvironmentInfo/IOsInfo.cs
+++ b/Kavita.Common/EnvironmentInfo/IOsInfo.cs
@@ -57,7 +57,7 @@ private static Os GetPosixFlavour()
         }
     }
 
-    public static string RunAndCapture(string filename, string args, int waitInMilliseconds = 1000)
+    private static string RunAndCapture(string filename, string args)
     {
         var p = new Process
         {
@@ -75,7 +75,7 @@ public static string RunAndCapture(string filename, string args, int waitInMilli
 
         // To avoid deadlocks, always read the output stream first and then wait.
         var output = p.StandardOutput.ReadToEnd();
-        p.WaitForExit(waitInMilliseconds);
+        p.WaitForExit(1000);
 
         return output;
     }

From e7f021a5634be185be2fca0d5372b853d234112d Mon Sep 17 00:00:00 2001
From: Maximo Piva <mpiva@adventintermodal.com>
Date: Thu, 29 Aug 2024 19:22:04 -0300
Subject: [PATCH 13/30] Edit CodeStyle Fix GetCoverImage, trying to create a
 temporary image in current directory, and rename the parameter field name,
 that generates a wrong asumption.

---
 API/Controllers/ReaderController.cs       |   1 -
 API/Extensions/FileTypeGroupExtensions.cs |   7 +-
 API/Extensions/HttpExtensions.cs          |  46 +++++++---
 API/Services/CacheService.cs              |   7 +-
 API/Services/ImageConverterService.cs     |  28 +++---
 API/Services/ImageService.cs              |  12 +--
 docker-build-wconvertion.sh               | 103 ++++++++++++++++++++++
 7 files changed, 166 insertions(+), 38 deletions(-)
 create mode 100644 docker-build-wconvertion.sh

diff --git a/API/Controllers/ReaderController.cs b/API/Controllers/ReaderController.cs
index d951c3eaa..973085c02 100644
--- a/API/Controllers/ReaderController.cs
+++ b/API/Controllers/ReaderController.cs
@@ -23,7 +23,6 @@
 using Microsoft.Extensions.Logging;
 using Microsoft.IdentityModel.Tokens;
 using MimeTypes;
-using Org.BouncyCastle.Ocsp;
 
 namespace API.Controllers;
 
diff --git a/API/Extensions/FileTypeGroupExtensions.cs b/API/Extensions/FileTypeGroupExtensions.cs
index 87eac43bb..254ff400d 100644
--- a/API/Extensions/FileTypeGroupExtensions.cs
+++ b/API/Extensions/FileTypeGroupExtensions.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using API.Entities.Enums;
 using API.Services.Tasks.Scanner.Parser;
 using MimeTypes;
@@ -38,8 +38,9 @@ public static string GetMimeType(this string format)
     {
         // Add jxl format
         format = format.ToLowerInvariant();
-        if (format == ".jxl")
-            return "image/jxl";
+
+        if (format == ".jxl") return "image/jxl";
+
         return MimeTypeMap.GetMimeType(format);
     }
 }
diff --git a/API/Extensions/HttpExtensions.cs b/API/Extensions/HttpExtensions.cs
index 2394db2c0..d7bef8479 100644
--- a/API/Extensions/HttpExtensions.cs
+++ b/API/Extensions/HttpExtensions.cs
@@ -73,12 +73,16 @@ private static void AddExtension(List<string> extensions, string extension)
     public static List<string> SupportedImageTypesFromRequest(this HttpRequest request)
     {
         var acceptHeader = request.Headers["Accept"].ToString();
-        string[] spl1 = acceptHeader.Split(';');
-        acceptHeader = spl1[0];
-        string[] split = acceptHeader.Split(',');
+        var split = acceptHeader.Split(';');
+        acceptHeader = split[0];
+        split = acceptHeader.Split(',');
+
         List<string> supportedExtensions = new List<string>();
 
         //Add default extensions supported by all browsers.
+
+        //NOTE: Will user parser, instead of this list, but first fixing low-hanging fruits, and showstopper issues.
+
         supportedExtensions.Add("jpeg");
         supportedExtensions.Add("jpg");
         supportedExtensions.Add("png");
@@ -90,22 +94,38 @@ public static List<string> SupportedImageTypesFromRequest(this HttpRequest reque
         {
             if (v.StartsWith("image/", StringComparison.InvariantCultureIgnoreCase))
             {
-                string n = v.Substring(6).ToLowerInvariant();
-                if (n.StartsWith("*"))
-                    continue;
-                if (n == "svg+xml")
-                    n = "svg";
-                if (n == "jp2")
+                string mimeimagepart = v.Substring(6).ToLowerInvariant();
+                if (mimeimagepart.StartsWith("*")) continue;
+
+                if (mimeimagepart == "svg+xml")
+                {
+                    mimeimagepart = "svg";
+                }
+
+                if (mimeimagepart == "jp2")
+                {
                     AddExtension(supportedExtensions, "j2k");
-                if (n == "j2k")
+                }
+
+                if (mimeimagepart == "j2k")
+                {
                     AddExtension(supportedExtensions, "jp2");
-                if (n == "heif")
+                }
+
+                if (mimeimagepart == "heif")
+                {
                     AddExtension(supportedExtensions, "heic");
-                if (n == "heic")
+                }
+
+                if (mimeimagepart == "heic")
+                {
                     AddExtension(supportedExtensions, "heif");
-                AddExtension(supportedExtensions, n);
+                }
+
+                AddExtension(supportedExtensions, mimeimagepart);
             }
         }
+
         return supportedExtensions;
     }
 }
diff --git a/API/Services/CacheService.cs b/API/Services/CacheService.cs
index c8e48d4c3..040acf38a 100644
--- a/API/Services/CacheService.cs
+++ b/API/Services/CacheService.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Collections.Concurrent;
 using System.Collections.Generic;
 using System.Diagnostics;
@@ -103,11 +103,6 @@ public IEnumerable<FileDimensionDto> GetCachedFileDimensions(string cachePath)
             {
                 var file = files[i];
                 var dimension = _converterService.GetDimensions(file);
-                if (dimension == null)
-                {
-                    using var image = Image.NewFromFile(file, memory: false, access: Enums.Access.SequentialUnbuffered);
-                    dimension = (image.Width, image.Height);
-                }
 
                 dimensions.Add(new FileDimensionDto()
                 {
diff --git a/API/Services/ImageConverterService.cs b/API/Services/ImageConverterService.cs
index dc9546058..050b1cc63 100644
--- a/API/Services/ImageConverterService.cs
+++ b/API/Services/ImageConverterService.cs
@@ -4,6 +4,7 @@
 using System.IO.Abstractions;
 using System.Linq;
 using API.Services.ImageConversion;
+using NetVips;
 
 namespace API.Services
 {
@@ -15,10 +16,11 @@ public interface IImageConverterService
         /// <summary>
         /// Converts the input stream to jpg image format.
         /// </summary>
-        /// <param name="filename">The filename of the image.</param>
+        /// <param name="originalNameWithExtension">The OriginalNameWithExtension of the image
+        /// (Not a file,  only the name, if it came from the filesystem or an archive entry).</param>
         /// <param name="source">The input stream of the image.</param>
         /// <returns>The converted image stream.</returns>
-        Stream ConvertStream(string filename, Stream source);
+        Stream ConvertStream(string originalNameWithExtension, Stream source);
 
         /// <summary>
         /// Converts the specified image file to jpg image format.
@@ -60,17 +62,19 @@ public ImageConverterService(IEnumerable<IImageConverterProvider> converters)
         }
 
         /// <inheritdoc/>
-        public Stream ConvertStream(string filename, Stream source)
+        public Stream ConvertStream(string originalNameWithExtension, Stream source)
         {
-            IImageConverterProvider provider = _converters.FirstOrDefault(a => a.IsSupported(filename));
+            //Check if the name have one of our supported extensions.
+            IImageConverterProvider provider = _converters.FirstOrDefault(a => a.IsSupported(originalNameWithExtension));
             if (provider == null)
                 return source;
-            string tempFile = Path.GetFileName(filename);
-            Stream dest = File.OpenWrite(tempFile);
+            //We support it, create a temp file, and write the original content, so it can be transcoded into another stream.
+            string tempFileName = Path.ChangeExtension(Path.GetTempFileName(), Path.GetExtension(originalNameWithExtension));
+            Stream dest = File.OpenWrite(tempFileName);
             source.CopyTo(dest);
             source.Close();
             dest.Close();
-            return File.OpenRead(provider.Convert(tempFile));
+            return File.OpenRead(provider.Convert(tempFileName));
         }
 
         private bool CheckDirectSupport(string filename, List<string> supportedImageFormats)
@@ -95,10 +99,14 @@ public string ConvertFile(string filename, List<string> supportedImageFormats)
         /// <inheritdoc/>
         public (int Width, int Height)? GetDimensions(string fileName)
         {
+            //Provider supported
             IImageConverterProvider provider = _converters.FirstOrDefault(a => a.IsSupported(fileName));
-            if (provider == null)
-                return null;
-            return provider.GetDimensions(fileName);
+            if (provider != null)
+                return provider.GetDimensions(fileName);
+
+            //No provider for this image type, so, is a common image format, use netvips and original code.
+            using var image = Image.NewFromFile(fileName, memory: false, access: Enums.Access.SequentialUnbuffered);
+            return (image.Width, image.Height);
         }
 
         /// <inheritdoc/>
diff --git a/API/Services/ImageService.cs b/API/Services/ImageService.cs
index 0960b2a7a..775af8d38 100644
--- a/API/Services/ImageService.cs
+++ b/API/Services/ImageService.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Collections.Generic;
 using System.Drawing;
 using System.IO;
@@ -47,7 +47,7 @@ public interface IImageService
     /// <param name="outputDirectory"></param>
     /// <param name="encodeFormat"></param>
     /// <returns></returns>
-    string WriteCoverThumbnail(string sourceFile, Stream stream, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size = CoverImageSize.Default);
+    string WriteCoverThumbnail(string originalNameWithExtension, Stream stream, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size = CoverImageSize.Default);
     /// <summary>
     /// Writes out a thumbnail by file path input
     /// </summary>
@@ -241,15 +241,17 @@ public string GetCoverImage(string path, string fileName, string outputDirectory
     /// Creates a thumbnail out of a memory stream and saves to <see cref="DirectoryService.CoverImageDirectory"/> with the passed
     /// fileName and the appropriate extension.
     /// </summary>
+    /// <param name="originalNameWithExtension">The OriginalNameWithExtension of the image
+    /// (Not a file,  only the name, if it came from the filesystem or an archive entry).</param>
     /// <param name="stream">Stream to write to disk. Ensure this is rewinded.</param>
     /// <param name="fileName">filename to save as without extension</param>
     /// <param name="outputDirectory">Where to output the file, defaults to covers directory</param>
     /// <param name="encodeFormat">Export the file as the passed encoding</param>
     /// <returns>File name with extension of the file. This will always write to <see cref="DirectoryService.CoverImageDirectory"/></returns>
-    public string WriteCoverThumbnail(string sourceFile, Stream stream, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size = CoverImageSize.Default)
+    public string WriteCoverThumbnail(string originalNameWithExtension, Stream stream, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size = CoverImageSize.Default)
     {
-        if (!_converterService.IsVipsSupported(sourceFile))
-            stream = _converterService.ConvertStream(sourceFile, stream);
+        if (!_converterService.IsVipsSupported(originalNameWithExtension))
+            stream = _converterService.ConvertStream(originalNameWithExtension, stream);
         var (targetWidth, targetHeight) = size.GetDimensions();
         if (stream.CanSeek) stream.Position = 0;
         using var sourceImage = Image.NewFromStream(stream);
diff --git a/docker-build-wconvertion.sh b/docker-build-wconvertion.sh
new file mode 100644
index 000000000..206b97f0b
--- /dev/null
+++ b/docker-build-wconvertion.sh
@@ -0,0 +1,103 @@
+#! /bin/bash
+set -e
+
+outputFolder='_output'
+
+ProgressStart()
+{
+    echo "Start '$1'"
+}
+
+ProgressEnd()
+{
+    echo "Finish '$1'"
+}
+
+Build()
+{
+	local RID="$1"
+
+    ProgressStart "Build for $RID"
+
+    slnFile=Kavita.sln
+
+    dotnet clean $slnFile -c Release
+
+	  dotnet msbuild -restore $slnFile -p:Configuration=Release -p:Platform="Any CPU" -p:RuntimeIdentifiers=$RID
+
+    ProgressEnd "Build for $RID"
+}
+
+BuildUI()
+{
+    ProgressStart 'Building UI'
+    echo 'Removing old wwwroot'
+    rm -rf API/wwwroot/*
+    cd UI/Web/ || exit
+    echo 'Installing web dependencies'
+    npm install --legacy-peer-deps
+    echo 'Building UI'
+    npm run prod
+    echo 'Copying back to Kavita wwwroot'
+    mkdir -p ../../API/wwwroot
+    cp -R dist/browser/* ../../API/wwwroot
+    cd ../../ || exit
+    ProgressEnd 'Building UI'
+}
+
+Package()
+{
+    local runtime="$1"
+    local lOutputFolder=../_output/"$runtime"/Kavita
+
+    ProgressStart "Creating $runtime Package"
+
+    # TODO: Use no-restore? Because Build should have already done it for us
+    echo "Building"
+    cd API
+    echo dotnet publish -c Release --no-restore --self-contained --runtime $runtime -o "$lOutputFolder"
+    dotnet publish -c Release --no-restore --self-contained --runtime $runtime -o "$lOutputFolder"
+
+    echo "Copying Install information"
+    cp ../INSTALL.txt "$lOutputFolder"/README.txt
+
+    echo "Copying LICENSE"
+    cp ../LICENSE "$lOutputFolder"/LICENSE.txt
+
+    echo "Renaming API -> Kavita"
+    mv "$lOutputFolder"/API "$lOutputFolder"/Kavita
+
+    echo "Creating tar"
+    cd ../$outputFolder/"$runtime"/
+    tar -czvf ../kavita-$runtime.tar.gz Kavita
+
+    ProgressEnd "Creating $runtime Package"
+
+}
+
+dir=$PWD
+
+if [ -d _output ]
+then
+	rm -r _output/
+fi
+
+BuildUI
+
+#Build for x64
+Build "linux-x64"
+Package "linux-x64"
+cd "$dir"
+
+#Build for arm
+Build "linux-arm"
+Package "linux-arm"
+cd "$dir"
+
+#Build for arm64
+Build "linux-arm64"
+Package "linux-arm64"
+cd "$dir"
+
+#Builds Docker images
+docker buildx build -t maxpiva/kavita:nightly --platform linux/amd64,linux/arm/v7,linux/arm64 . --push

From c624287b444770a55c242ee59b30a44781803443 Mon Sep 17 00:00:00 2001
From: Maximo Piva <mpiva@adventintermodal.com>
Date: Thu, 29 Aug 2024 19:26:13 -0300
Subject: [PATCH 14/30] Remove custom docker builder

---
 docker-build-wconvertion.sh | 103 ------------------------------------
 1 file changed, 103 deletions(-)
 delete mode 100644 docker-build-wconvertion.sh

diff --git a/docker-build-wconvertion.sh b/docker-build-wconvertion.sh
deleted file mode 100644
index 206b97f0b..000000000
--- a/docker-build-wconvertion.sh
+++ /dev/null
@@ -1,103 +0,0 @@
-#! /bin/bash
-set -e
-
-outputFolder='_output'
-
-ProgressStart()
-{
-    echo "Start '$1'"
-}
-
-ProgressEnd()
-{
-    echo "Finish '$1'"
-}
-
-Build()
-{
-	local RID="$1"
-
-    ProgressStart "Build for $RID"
-
-    slnFile=Kavita.sln
-
-    dotnet clean $slnFile -c Release
-
-	  dotnet msbuild -restore $slnFile -p:Configuration=Release -p:Platform="Any CPU" -p:RuntimeIdentifiers=$RID
-
-    ProgressEnd "Build for $RID"
-}
-
-BuildUI()
-{
-    ProgressStart 'Building UI'
-    echo 'Removing old wwwroot'
-    rm -rf API/wwwroot/*
-    cd UI/Web/ || exit
-    echo 'Installing web dependencies'
-    npm install --legacy-peer-deps
-    echo 'Building UI'
-    npm run prod
-    echo 'Copying back to Kavita wwwroot'
-    mkdir -p ../../API/wwwroot
-    cp -R dist/browser/* ../../API/wwwroot
-    cd ../../ || exit
-    ProgressEnd 'Building UI'
-}
-
-Package()
-{
-    local runtime="$1"
-    local lOutputFolder=../_output/"$runtime"/Kavita
-
-    ProgressStart "Creating $runtime Package"
-
-    # TODO: Use no-restore? Because Build should have already done it for us
-    echo "Building"
-    cd API
-    echo dotnet publish -c Release --no-restore --self-contained --runtime $runtime -o "$lOutputFolder"
-    dotnet publish -c Release --no-restore --self-contained --runtime $runtime -o "$lOutputFolder"
-
-    echo "Copying Install information"
-    cp ../INSTALL.txt "$lOutputFolder"/README.txt
-
-    echo "Copying LICENSE"
-    cp ../LICENSE "$lOutputFolder"/LICENSE.txt
-
-    echo "Renaming API -> Kavita"
-    mv "$lOutputFolder"/API "$lOutputFolder"/Kavita
-
-    echo "Creating tar"
-    cd ../$outputFolder/"$runtime"/
-    tar -czvf ../kavita-$runtime.tar.gz Kavita
-
-    ProgressEnd "Creating $runtime Package"
-
-}
-
-dir=$PWD
-
-if [ -d _output ]
-then
-	rm -r _output/
-fi
-
-BuildUI
-
-#Build for x64
-Build "linux-x64"
-Package "linux-x64"
-cd "$dir"
-
-#Build for arm
-Build "linux-arm"
-Package "linux-arm"
-cd "$dir"
-
-#Build for arm64
-Build "linux-arm64"
-Package "linux-arm64"
-cd "$dir"
-
-#Builds Docker images
-docker buildx build -t maxpiva/kavita:nightly --platform linux/amd64,linux/arm/v7,linux/arm64 . --push

From 6dbeaf1f76d928f59282de2c39044b682288d518 Mon Sep 17 00:00:00 2001
From: Maximo Piva <mpiva@adventintermodal.com>
Date: Fri, 30 Aug 2024 17:59:52 -0300
Subject: [PATCH 15/30] Fixed discovered issues. Optimize Cover Creation

---
 .../AvifImageConverterProvider.cs             | 10 ++++
 .../JpegXLImageConverterProvider.cs           | 33 ++++++++++++
 API/Services/ImageConverterService.cs         | 52 +++++++++++--------
 API/Services/ImageService.cs                  | 15 +++---
 4 files changed, 80 insertions(+), 30 deletions(-)

diff --git a/API/Services/ImageConversion/AvifImageConverterProvider.cs b/API/Services/ImageConversion/AvifImageConverterProvider.cs
index 59b060177..607f7ca1e 100644
--- a/API/Services/ImageConversion/AvifImageConverterProvider.cs
+++ b/API/Services/ImageConversion/AvifImageConverterProvider.cs
@@ -4,6 +4,7 @@
 using System;
 using System.IO;
 using NetVips;
+using System.IO.Abstractions;
 
 namespace API.Services.ImageConversion
 {
@@ -51,6 +52,15 @@ public string Convert(string filename)
             File.Delete(filename);
             return destination;
         }
+        /// <summary>
+        /// Creates a NetVips Image object from the specified image stream.
+        /// </summary>
+        /// <param name="source">The source image stream.</param>
+        /// <returns>The NetVips Image object created from the image stream.</returns>
+        public virtual Image ImageFromStream(Stream source)
+        {
+            return Image.NewFromStream(source);
+        }
 
         /// <summary>
         /// Gets the dimensions (width and height) of the specified image file.
diff --git a/API/Services/ImageConversion/JpegXLImageConverterProvider.cs b/API/Services/ImageConversion/JpegXLImageConverterProvider.cs
index 3e23d46d4..60d73ce17 100644
--- a/API/Services/ImageConversion/JpegXLImageConverterProvider.cs
+++ b/API/Services/ImageConversion/JpegXLImageConverterProvider.cs
@@ -1,6 +1,8 @@
 using System;
 using System.IO;
 using System.IO.Abstractions;
+using System.Linq;
+using System.Runtime.InteropServices;
 using System.Text.RegularExpressions;
 using System.Threading;
 using ImageMagick;
@@ -40,6 +42,13 @@ public interface IImageConverterProvider
     /// Gets a value indicating whether the image type supports Vips.
     /// </summary>
     bool IsVipsSupported { get; }
+
+    /// <summary>
+    /// Creates a NetVips Image object from the specified image stream.
+    /// </summary>
+    /// <param name="source">The source image stream.</param>
+    /// <returns>The NetVips Image object created from the image stream.</returns>
+    Image ImageFromStream(Stream source);
 }
 
 public class ImageMagickConverterProvider
@@ -59,6 +68,30 @@ public virtual string Convert(string filename)
         return destination;
     }
 
+    /// <summary>
+    /// Creates a NetVips Image object from the specified image stream.
+    /// </summary>
+    /// <param name="source">The source image stream.</param>
+    /// <returns>The NetVips Image object created from the image stream.</returns>
+    public virtual Image ImageFromStream(Stream source)
+    {
+        var settings = new MagickReadSettings
+        {
+            ColorSpace = ColorSpace.sRGB
+        };
+        using var sourceImage = new MagickImage(source, settings);
+        float[] pixels = sourceImage.GetPixels().ToArray();
+        float mul = 1F / 255F;
+        for (int x = 0; x < pixels.Length; x++)
+            pixels[x] *= mul;
+        GCHandle handle = GCHandle.Alloc(pixels, GCHandleType.Pinned);
+        IntPtr pointer = handle.AddrOfPinnedObject();
+        ulong size = (ulong)(Marshal.SizeOf<float>() * pixels.Length);
+        Image im = Image.NewFromMemoryCopy(pointer, size, sourceImage.Width, sourceImage.Height,3, Enums.BandFormat.Float);
+        handle.Free();
+        return im;
+    }
+
     /// <summary>
     /// Gets the dimensions of the specified image file.
     /// </summary>
diff --git a/API/Services/ImageConverterService.cs b/API/Services/ImageConverterService.cs
index 050b1cc63..4fa98d4e0 100644
--- a/API/Services/ImageConverterService.cs
+++ b/API/Services/ImageConverterService.cs
@@ -1,9 +1,11 @@
 using System.Collections;
 using System.Collections.Generic;
+using System.Diagnostics;
 using System.IO;
 using System.IO.Abstractions;
 using System.Linq;
 using API.Services.ImageConversion;
+using Microsoft.Extensions.Logging;
 using NetVips;
 
 namespace API.Services
@@ -14,24 +16,24 @@ namespace API.Services
     public interface IImageConverterService
     {
         /// <summary>
-        /// Converts the input stream to jpg image format.
+        /// Converts the input stream into a Vips Image.
         /// </summary>
         /// <param name="originalNameWithExtension">The OriginalNameWithExtension of the image
-        /// (Not a file,  only the name, if it came from the filesystem or an archive entry).</param>
+        /// (Not a file,  only the name, if it came from the filesystem or an archive entry to identify the image type).</param>
         /// <param name="source">The input stream of the image.</param>
-        /// <returns>The converted image stream.</returns>
-        Stream ConvertStream(string originalNameWithExtension, Stream source);
+        /// <returns>NetVips Image from the input Stream.</returns>
+        Image GetImageFromStream(string originalNameWithExtension, Stream source);
 
         /// <summary>
         /// Converts the specified image file to jpg image format.
         /// </summary>
         /// <param name="filename">The filename of the image.</param>
-        /// <param name="supportedImageFormats">The list of supported image formats by the client from the Accept Header.</param>
-        /// <returns>The converted image file path if conversion is required.</returns>
-        string ConvertFile(string filename, List<string> supportedImageFormats);
+        /// <param name="supportedImageFormats">The list of supported image formats by the client from the Accept Header. If null is passed, the conversion will execute if the image requires conversion.</param>
+        /// <returns>The converted image file path if conversion is required. Note: original filename is deleted if conversion is executed</returns>
+        string ConvertFile(string filename, List<string> supportedImageFormats = null);
 
         /// <summary>
-        /// Gets the dimensions (width and height) of the specified image file.
+        /// Gets the dimensions (width and height) of the specified image file without read the whole image.
         /// </summary>
         /// <param name="fileName">The filename of the image.</param>
         /// <returns>The dimensions of the image (width and height).</returns>
@@ -50,31 +52,32 @@ public interface IImageConverterService
     /// </summary>
     public class ImageConverterService : IImageConverterService
     {
-        private IEnumerable<IImageConverterProvider> _converters;
+        private readonly IEnumerable<IImageConverterProvider> _converters;
+        private readonly ILogger<ImageConverterService> _logger;
 
         /// <summary>
         /// Initializes a new instance of the <see cref="ImageConverterService"/> class.
         /// </summary>
+        /// <param name="logger">The logger instance.</param>
         /// <param name="converters">The collection of image converter providers.</param>
-        public ImageConverterService(IEnumerable<IImageConverterProvider> converters)
+        public ImageConverterService(ILogger<ImageConverterService> logger, IEnumerable<IImageConverterProvider> converters)
         {
+            _logger = logger;
             _converters = converters;
         }
 
         /// <inheritdoc/>
-        public Stream ConvertStream(string originalNameWithExtension, Stream source)
+        public Image GetImageFromStream(string originalNameWithExtension, Stream source)
         {
             //Check if the name have one of our supported extensions.
             IImageConverterProvider provider = _converters.FirstOrDefault(a => a.IsSupported(originalNameWithExtension));
-            if (provider == null)
-                return source;
-            //We support it, create a temp file, and write the original content, so it can be transcoded into another stream.
-            string tempFileName = Path.ChangeExtension(Path.GetTempFileName(), Path.GetExtension(originalNameWithExtension));
-            Stream dest = File.OpenWrite(tempFileName);
-            source.CopyTo(dest);
-            source.Close();
-            dest.Close();
-            return File.OpenRead(provider.Convert(tempFileName));
+
+            if (provider == null || provider.IsVipsSupported) return Image.NewFromStream(source); //No need to transform, Vips supports the format.
+
+            var sw = Stopwatch.StartNew();
+            Image image = provider.ImageFromStream(source);
+            _logger.LogDebug("Image converted from '{Extension}' to '.jpg' in {ElapsedMilliseconds} milliseconds", Path.GetExtension(originalNameWithExtension), sw.ElapsedMilliseconds);
+            return image;
         }
 
         private bool CheckDirectSupport(string filename, List<string> supportedImageFormats)
@@ -86,14 +89,17 @@ private bool CheckDirectSupport(string filename, List<string> supportedImageForm
         }
 
         /// <inheritdoc/>
-        public string ConvertFile(string filename, List<string> supportedImageFormats)
+        public string ConvertFile(string filename, List<string> supportedImageFormats = null)
         {
             if (CheckDirectSupport(filename, supportedImageFormats))
                 return filename;
             IImageConverterProvider provider = _converters.FirstOrDefault(a => a.IsSupported(filename));
-            if (provider == null)
+            if (provider == null) //No provider for this image type, so, is a common image format.
                 return filename;
-            return provider.Convert(filename);
+            var sw = Stopwatch.StartNew();
+            filename = provider.Convert(filename);
+            _logger.LogDebug("Image converted from '{Extension}' to '.jpg' in {ElapsedMilliseconds} milliseconds", Path.GetExtension(filename), sw.ElapsedMilliseconds);
+            return filename;
         }
 
         /// <inheritdoc/>
diff --git a/API/Services/ImageService.cs b/API/Services/ImageService.cs
index 775af8d38..56811c785 100644
--- a/API/Services/ImageService.cs
+++ b/API/Services/ImageService.cs
@@ -217,8 +217,9 @@ public string GetCoverImage(string path, string fileName, string outputDirectory
 
         try
         {
-            if (!_converterService.IsVipsSupported(fileName))
-                fileName = _converterService.ConvertFile(fileName, null);
+            if (!_converterService.IsVipsSupported(path)) //If Vips supports the format, there is no need to convert the image, since in this case the consumer is not the browser.
+                path = _converterService.ConvertFile(path);
+
             var (width, height) = size.GetDimensions();
             using var sourceImage = Image.NewFromFile(path, false, Enums.Access.SequentialUnbuffered);
 
@@ -250,11 +251,10 @@ public string GetCoverImage(string path, string fileName, string outputDirectory
     /// <returns>File name with extension of the file. This will always write to <see cref="DirectoryService.CoverImageDirectory"/></returns>
     public string WriteCoverThumbnail(string originalNameWithExtension, Stream stream, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size = CoverImageSize.Default)
     {
-        if (!_converterService.IsVipsSupported(originalNameWithExtension))
-            stream = _converterService.ConvertStream(originalNameWithExtension, stream);
         var (targetWidth, targetHeight) = size.GetDimensions();
         if (stream.CanSeek) stream.Position = 0;
-        using var sourceImage = Image.NewFromStream(stream);
+
+        using var sourceImage = _converterService.GetImageFromStream(originalNameWithExtension, stream);
 
         var scalingSize = GetSizeForDimensions(sourceImage, targetWidth, targetHeight);
         var scalingCrop = GetCropForDimensions(sourceImage, targetWidth, targetHeight);
@@ -294,8 +294,9 @@ public string WriteCoverThumbnail(string originalNameWithExtension, Stream strea
 
     public string WriteCoverThumbnail(string sourceFile, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size = CoverImageSize.Default)
     {
-        if (!_converterService.IsVipsSupported(sourceFile))
-            sourceFile = _converterService.ConvertFile(sourceFile, null);
+        if (!_converterService.IsVipsSupported(sourceFile)) //If Vips supports the format, there is no need to convert the image, since in this case the consumer is not the browser.
+            sourceFile = _converterService.ConvertFile(sourceFile);
+
         var (width, height) = size.GetDimensions();
         using var sourceImage = Image.NewFromFile(sourceFile, false, Enums.Access.SequentialUnbuffered);
 

From 0cc4803401fc0c530cbb462de9927c6fdd65a2a4 Mon Sep 17 00:00:00 2001
From: Maximo Piva <mpiva@adventintermodal.com>
Date: Fri, 27 Sep 2024 22:37:06 -0300
Subject: [PATCH 16/30] Removed NetVips and ImageSharp (Use only ImageMagick)
 Removing ImageConvertors (No Longer Needed) Refactored mime types and
 extensions constants

---
 API.Benchmark/ArchiveServiceBenchmark.cs      |  41 +++--
 API.Tests/Services/ArchiveServiceTests.cs     |  12 +-
 API.Tests/Services/ImageServiceTests.cs       |  30 ++--
 API/API.csproj                                |   5 +-
 .../ApplicationServiceExtensions.cs           |   8 +-
 API/Extensions/HttpExtensions.cs              |  44 ++---
 API/Services/BookService.cs                   |  13 +-
 API/Services/CacheService.cs                  |  14 +-
 .../AvifImageConverterProvider.cs             |  76 --------
 .../HeifImageConverterProvider.cs             |  41 -----
 .../Jpeg2000ImageConverterProvider.cs         |  41 -----
 .../JpegXLImageConverterProvider.cs           | 137 ---------------
 API/Services/ImageConverterService.cs         |  79 ++-------
 API/Services/ImageService.cs                  | 166 ++++++++----------
 API/Services/Tasks/Scanner/Parser/Parser.cs   |  21 ++-
 15 files changed, 180 insertions(+), 548 deletions(-)
 delete mode 100644 API/Services/ImageConversion/AvifImageConverterProvider.cs
 delete mode 100644 API/Services/ImageConversion/HeifImageConverterProvider.cs
 delete mode 100644 API/Services/ImageConversion/Jpeg2000ImageConverterProvider.cs
 delete mode 100644 API/Services/ImageConversion/JpegXLImageConverterProvider.cs

diff --git a/API.Benchmark/ArchiveServiceBenchmark.cs b/API.Benchmark/ArchiveServiceBenchmark.cs
index 10dc367a4..f21d21347 100644
--- a/API.Benchmark/ArchiveServiceBenchmark.cs
+++ b/API.Benchmark/ArchiveServiceBenchmark.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.IO;
 using System.IO.Abstractions;
 using Microsoft.Extensions.Logging.Abstractions;
@@ -6,11 +6,9 @@
 using BenchmarkDotNet.Attributes;
 using BenchmarkDotNet.Order;
 using EasyCaching.Core;
+using ImageMagick;
 using NSubstitute;
-using SixLabors.ImageSharp;
-using SixLabors.ImageSharp.Formats.Png;
-using SixLabors.ImageSharp.Formats.Webp;
-using SixLabors.ImageSharp.Processing;
+
 
 namespace API.Benchmark;
 
@@ -24,8 +22,7 @@ public class ArchiveServiceBenchmark
     private readonly ArchiveService _archiveService;
     private readonly IDirectoryService _directoryService;
     private readonly IImageService _imageService;
-    private readonly PngEncoder _pngEncoder = new PngEncoder();
-    private readonly WebpEncoder _webPEncoder = new WebpEncoder();
+
     private const string SourceImage = "C:/Users/josep/Pictures/obey_by_grrsa-d6llkaa_colored_by_me.png";
 
 
@@ -67,9 +64,11 @@ public void ImageSharp_ExtractImage_PNG()
         _directoryService.ExistOrCreate(outputDirectory);
 
         using var stream = new FileStream(SourceImage, FileMode.Open);
-        using var thumbnail2 = SixLabors.ImageSharp.Image.Load(stream);
-        thumbnail2.Mutate(x => x.Resize(320, 0));
-        thumbnail2.Save(_directoryService.FileSystem.Path.Join(outputDirectory, "imagesharp.png"), _pngEncoder);
+        using var thumbnail2 = new MagickImage(stream);
+        int width = 320;
+        int height = (int)(thumbnail2.Height * (width / (double)thumbnail2.Width));
+        thumbnail2.Thumbnail(width, height);
+        thumbnail2.Write(_directoryService.FileSystem.Path.Join(outputDirectory, "imagesharp.png"));
     }
 
     [Benchmark]
@@ -79,9 +78,11 @@ public void ImageSharp_ExtractImage_WebP()
         _directoryService.ExistOrCreate(outputDirectory);
 
         using var stream = new FileStream(SourceImage, FileMode.Open);
-        using var thumbnail2 = SixLabors.ImageSharp.Image.Load(stream);
-        thumbnail2.Mutate(x => x.Resize(320, 0));
-        thumbnail2.Save(_directoryService.FileSystem.Path.Join(outputDirectory, "imagesharp.webp"), _webPEncoder);
+        using var thumbnail2 = new MagickImage(stream);
+        int width = 320;
+        int height = (int)(thumbnail2.Height * (width / (double)thumbnail2.Width));
+        thumbnail2.Thumbnail(width, height);
+        thumbnail2.Write(_directoryService.FileSystem.Path.Join(outputDirectory, "imagesharp.webp"));
     }
 
     [Benchmark]
@@ -91,8 +92,11 @@ public void NetVips_ExtractImage_PNG()
         _directoryService.ExistOrCreate(outputDirectory);
 
         using var stream = new FileStream(SourceImage, FileMode.Open);
-        using var thumbnail = NetVips.Image.ThumbnailStream(stream, 320);
-        thumbnail.WriteToFile(_directoryService.FileSystem.Path.Join(outputDirectory, "netvips.png"));
+        using var thumbnail = new MagickImage(stream);
+        int width = 320;
+        int height = (int)(thumbnail.Height * (width / (double)thumbnail.Width));
+        thumbnail.Thumbnail(width, height);
+        thumbnail.Write(_directoryService.FileSystem.Path.Join(outputDirectory, "netvips.png"));
     }
 
     [Benchmark]
@@ -102,8 +106,11 @@ public void NetVips_ExtractImage_WebP()
         _directoryService.ExistOrCreate(outputDirectory);
 
         using var stream = new FileStream(SourceImage, FileMode.Open);
-        using var thumbnail = NetVips.Image.ThumbnailStream(stream, 320);
-        thumbnail.WriteToFile(_directoryService.FileSystem.Path.Join(outputDirectory, "netvips.webp"));
+        using var thumbnail = new MagickImage(stream);
+        int width = 320;
+        int height = (int)(thumbnail.Height * (width / (double)thumbnail.Width));
+        thumbnail.Thumbnail(width, height);
+        thumbnail.Write(_directoryService.FileSystem.Path.Join(outputDirectory, "netvips.webp"));
     }
 
     // Benchmark to test default GetNumberOfPages from archive
diff --git a/API.Tests/Services/ArchiveServiceTests.cs b/API.Tests/Services/ArchiveServiceTests.cs
index 982fa2606..9d3d06b0a 100644
--- a/API.Tests/Services/ArchiveServiceTests.cs
+++ b/API.Tests/Services/ArchiveServiceTests.cs
@@ -1,4 +1,4 @@
-using System.Diagnostics;
+using System.Diagnostics;
 using System.IO;
 using System.IO.Abstractions;
 using System.IO.Abstractions.TestingHelpers;
@@ -8,8 +8,8 @@
 using API.Entities.Enums;
 using API.Services;
 using EasyCaching.Core;
+using ImageMagick;
 using Microsoft.Extensions.Logging;
-using NetVips;
 using NSubstitute;
 using NSubstitute.Extensions;
 using Xunit;
@@ -171,7 +171,13 @@ public void GetCoverImage_Default_Test(string inputFile, string expectedOutputFi
         var archiveService =  Substitute.For<ArchiveService>(_logger, ds, imageService, Substitute.For<IMediaErrorService>());
 
         var testDirectory = Path.GetFullPath(Path.Join(Directory.GetCurrentDirectory(), "../../../Services/Test Data/ArchiveService/CoverImages"));
-        var expectedBytes = Image.Thumbnail(Path.Join(testDirectory, expectedOutputFile), 320).WriteToBuffer(".png");
+        using var thumbnail = new MagickImage(Path.Join(testDirectory, expectedOutputFile));
+        int width = 320;
+        int height = (int)(thumbnail.Height * (width / (double)thumbnail.Width));
+        thumbnail.Thumbnail(width, height);
+        using MemoryStream stream = new MemoryStream();
+        thumbnail.Write(stream, MagickFormat.Png32);
+        var expectedBytes = stream.ToArray();
 
         archiveService.Configure().CanOpen(Path.Join(testDirectory, inputFile)).Returns(ArchiveLibrary.Default);
 
diff --git a/API.Tests/Services/ImageServiceTests.cs b/API.Tests/Services/ImageServiceTests.cs
index ac3c3157f..66ef037e0 100644
--- a/API.Tests/Services/ImageServiceTests.cs
+++ b/API.Tests/Services/ImageServiceTests.cs
@@ -1,4 +1,4 @@
-using System.Drawing;
+using System.Drawing;
 using System.IO;
 using System.IO.Abstractions;
 using System.Linq;
@@ -6,11 +6,12 @@
 using API.Entities.Enums;
 using API.Services;
 using EasyCaching.Core;
+using ImageMagick;
 using Microsoft.Extensions.Logging;
-using NetVips;
+
 using NSubstitute;
 using Xunit;
-using Image = NetVips.Image;
+
 
 namespace API.Tests.Services;
 
@@ -60,17 +61,16 @@ private void GenerateFiles(string outputExtension)
         {
             var fileName = Path.GetFileNameWithoutExtension(imagePath);
             var dims = CoverImageSize.Default.GetDimensions();
-            using var sourceImage = Image.NewFromFile(imagePath, false, Enums.Access.SequentialUnbuffered);
-
-            var size = ImageService.GetSizeForDimensions(sourceImage, dims.Width, dims.Height);
-            var crop = ImageService.GetCropForDimensions(sourceImage, dims.Width, dims.Height);
+            using var thumbnail = new MagickImage(imagePath);
 
-            using var thumbnail = Image.Thumbnail(imagePath, dims.Width, dims.Height,
-                size: size,
-                crop: crop);
+            var size = ImageService.GetSizeForDimensions(thumbnail, dims.Width, dims.Height);
+            var crop = ImageService.GetCropForDimensions(thumbnail, dims.Width, dims.Height);
+            thumbnail.Thumbnail(size);
+            if (crop)
+                thumbnail.Crop(dims.Width, dims.Height, Gravity.Center);
 
             var outputFileName = fileName + outputExtension + ".png";
-            thumbnail.WriteToFile(Path.Join(_testDirectory, outputFileName));
+            thumbnail.Write(Path.Join(_testDirectory, outputFileName));
         }
     }
 
@@ -105,7 +105,7 @@ private void GenerateHtmlFile()
             var outputPath = Path.Combine(_testDirectory, fileName + "_output.png");
             var dims = CoverImageSize.Default.GetDimensions();
 
-            using var sourceImage = Image.NewFromFile(imagePath, false, Enums.Access.SequentialUnbuffered);
+            using var sourceImage = new MagickImage(imagePath);
             htmlBuilder.AppendLine("<div class=\"image-row\">");
             htmlBuilder.AppendLine($"<p>{fileName} ({((double) sourceImage.Width / sourceImage.Height).ToString("F2")}) - {ImageService.WillScaleWell(sourceImage, dims.Width, dims.Height)}</p>");
             htmlBuilder.AppendLine($"<img src=\"./{Path.GetFileName(imagePath)}\" alt=\"{fileName}\">");
@@ -165,9 +165,9 @@ public void TestColorScapes()
     private static void GenerateColorImage(string hexColor, string outputPath)
     {
         var color = ImageService.HexToRgb(hexColor);
-        using var colorImage = Image.Black(200, 100);
-        using var output = colorImage + new[] { color.R / 255.0, color.G / 255.0, color.B / 255.0 };
-        output.WriteToFile(outputPath);
+        using var colorImage =
+            new MagickImage(MagickColor.FromRgb(color.R, color.G, color.B), 200, 100);
+        colorImage.Write(outputPath);
     }
 
     private void GenerateHtmlFileForColorScape()
diff --git a/API/API.csproj b/API/API.csproj
index 8aa619457..169ddfab9 100644
--- a/API/API.csproj
+++ b/API/API.csproj
@@ -1,4 +1,4 @@
-<Project Sdk="Microsoft.NET.Sdk.Web">
+<Project Sdk="Microsoft.NET.Sdk.Web">
 
   <PropertyGroup>
     <AnalysisMode>Default</AnalysisMode>
@@ -83,8 +83,6 @@
     <PackageReference Include="Microsoft.IO.RecyclableMemoryStream" Version="3.0.1" />
     <PackageReference Include="MimeTypeMapOfficial" Version="1.0.17" />
     <PackageReference Include="Nager.ArticleNumber" Version="1.0.7" />
-    <PackageReference Include="NetVips" Version="2.4.1" />
-    <PackageReference Include="NetVips.Native" Version="8.15.3" />
     <PackageReference Include="NReco.Logging.File" Version="1.2.1" />
     <PackageReference Include="Serilog" Version="4.0.1" />
     <PackageReference Include="Serilog.AspNetCore" Version="8.0.2" />
@@ -96,7 +94,6 @@
     <PackageReference Include="Serilog.Sinks.File" Version="6.0.0" />
     <PackageReference Include="Serilog.Sinks.SignalR.Core" Version="0.1.2" />
     <PackageReference Include="SharpCompress" Version="0.38.0" />
-    <PackageReference Include="SixLabors.ImageSharp" Version="3.1.5" />
     <PackageReference Include="SonarAnalyzer.CSharp" Version="9.32.0.97167">
       <PrivateAssets>all</PrivateAssets>
       <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
diff --git a/API/Extensions/ApplicationServiceExtensions.cs b/API/Extensions/ApplicationServiceExtensions.cs
index b6154710b..2f774f3e9 100644
--- a/API/Extensions/ApplicationServiceExtensions.cs
+++ b/API/Extensions/ApplicationServiceExtensions.cs
@@ -1,9 +1,9 @@
-using System.IO.Abstractions;
+using System.IO.Abstractions;
 using API.Constants;
 using API.Data;
 using API.Helpers;
 using API.Services;
-using API.Services.ImageConversion;
+
 using API.Services.Plus;
 using API.Services.Tasks;
 using API.Services.Tasks.Metadata;
@@ -35,10 +35,6 @@ public static void AddApplicationServices(this IServiceCollection services, ICon
         services.AddScoped<ICacheService, CacheService>();
         services.AddScoped<IArchiveService, ArchiveService>();
 
-        services.AddScoped<IImageConverterProvider, JpegXLImageConverterProvider>();
-        services.AddScoped<IImageConverterProvider, Jpeg2000ImageConverterProvider>();
-        services.AddScoped<IImageConverterProvider, AvifImageConverterProvider>();
-        services.AddScoped<IImageConverterProvider, HeifImageConverterProvider>();
         services.AddScoped<IImageConverterService, ImageConverterService>();
 
         services.AddScoped<IBackupService, BackupService>();
diff --git a/API/Extensions/HttpExtensions.cs b/API/Extensions/HttpExtensions.cs
index d7bef8479..715fd0b1b 100644
--- a/API/Extensions/HttpExtensions.cs
+++ b/API/Extensions/HttpExtensions.cs
@@ -7,6 +7,7 @@
 using System.Text;
 using System.Text.Json;
 using API.Helpers;
+using API.Services.Tasks.Scanner.Parser;
 using Microsoft.AspNetCore.Http;
 using Microsoft.Net.Http.Headers;
 
@@ -69,7 +70,7 @@ private static void AddExtension(List<string> extensions, string extension)
     /// Retrieves the supported image types extensions from the Accept header of the HTTP request.
     /// </summary>
     /// <param name="request">The HTTP request.</param>
-    /// <returns>A list of supported image types extensions.</returns>
+    /// <returns>A list of supported image types extensions by the Browser.</returns>
     public static List<string> SupportedImageTypesFromRequest(this HttpRequest request)
     {
         var acceptHeader = request.Headers["Accept"].ToString();
@@ -80,15 +81,8 @@ public static List<string> SupportedImageTypesFromRequest(this HttpRequest reque
         List<string> supportedExtensions = new List<string>();
 
         //Add default extensions supported by all browsers.
-
-        //NOTE: Will user parser, instead of this list, but first fixing low-hanging fruits, and showstopper issues.
-
-        supportedExtensions.Add("jpeg");
-        supportedExtensions.Add("jpg");
-        supportedExtensions.Add("png");
-        supportedExtensions.Add("gif");
-        supportedExtensions.Add("webp");
-        //Browser add specific image mime types, when the image type is not a global standard.
+        supportedExtensions.AddRange(Parser.UniversalFileImageExtensionArray);
+        //Browser add specific image mime types, when the image type is not a global standard, browser specify the specific image type in the accept header.
         //Let's reuse that to identify the additional image types supported by the browser.
         foreach (string v in split)
         {
@@ -96,36 +90,18 @@ public static List<string> SupportedImageTypesFromRequest(this HttpRequest reque
             {
                 string mimeimagepart = v.Substring(6).ToLowerInvariant();
                 if (mimeimagepart.StartsWith("*")) continue;
-
-                if (mimeimagepart == "svg+xml")
-                {
-                    mimeimagepart = "svg";
-                }
-
-                if (mimeimagepart == "jp2")
+                if (Parser.NonUniversalSupportedMimeMappings.ContainsKey(mimeimagepart))
                 {
-                    AddExtension(supportedExtensions, "j2k");
+                    Parser.NonUniversalSupportedMimeMappings[mimeimagepart].ForEach(x => AddExtension(supportedExtensions, x));
                 }
-
-                if (mimeimagepart == "j2k")
+                else if (mimeimagepart == "svg+xml")
                 {
-                    AddExtension(supportedExtensions, "jp2");
+                    AddExtension(supportedExtensions, "svg");
                 }
-
-                if (mimeimagepart == "heif")
-                {
-                    AddExtension(supportedExtensions, "heic");
-                }
-
-                if (mimeimagepart == "heic")
-                {
-                    AddExtension(supportedExtensions, "heif");
-                }
-
-                AddExtension(supportedExtensions, mimeimagepart);
+                else
+                    AddExtension(supportedExtensions, mimeimagepart);
             }
         }
-
         return supportedExtensions;
     }
 }
diff --git a/API/Services/BookService.cs b/API/Services/BookService.cs
index 5e339b210..88f3cd11b 100644
--- a/API/Services/BookService.cs
+++ b/API/Services/BookService.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Collections.Generic;
 using System.Globalization;
 using System.IO;
@@ -18,12 +18,11 @@
 using Docnet.Core.Readers;
 using ExCSS;
 using HtmlAgilityPack;
+using ImageMagick;
 using Kavita.Common;
 using Microsoft.Extensions.Logging;
 using Microsoft.IO;
 using Nager.ArticleNumber;
-using SixLabors.ImageSharp;
-using SixLabors.ImageSharp.PixelFormats;
 using VersOne.Epub;
 using VersOne.Epub.Options;
 using VersOne.Epub.Schema;
@@ -1277,12 +1276,14 @@ private static void GetPdfPage(IDocReader docReader, int pageNumber, Stream stre
     {
         using var pageReader = docReader.GetPageReader(pageNumber);
         var rawBytes = pageReader.GetImage(new NaiveTransparencyRemover());
+        var floats = rawBytes.Select(a=> (float)a*256F).ToArray();
         var width = pageReader.GetPageWidth();
         var height = pageReader.GetPageHeight();
-        var image = Image.LoadPixelData<Bgra32>(rawBytes, width, height);
-
+        using MagickImage image = new MagickImage(rawBytes, width, height,MagickFormat.Bgra);
+        using var pixels = image.GetPixels();
+        pixels.SetArea(0,0,width, height, floats);
         stream.Seek(0, SeekOrigin.Begin);
-        image.SaveAsPng(stream);
+        image.Write(stream, MagickFormat.Png);
         stream.Seek(0, SeekOrigin.Begin);
     }
 
diff --git a/API/Services/CacheService.cs b/API/Services/CacheService.cs
index 6e66e48b9..82ad11b0e 100644
--- a/API/Services/CacheService.cs
+++ b/API/Services/CacheService.cs
@@ -11,11 +11,10 @@
 using API.Entities;
 using API.Entities.Enums;
 using API.Extensions;
+using ImageMagick;
 using Kavita.Common;
 using Microsoft.Extensions.Logging;
-using NetVips;
 using static System.Net.Mime.MediaTypeNames;
-using Image = NetVips.Image;
 
 namespace API.Services;
 #nullable enable
@@ -95,21 +94,19 @@ public IEnumerable<FileDimensionDto> GetCachedFileDimensions(string cachePath)
         }
 
         var dimensions = new List<FileDimensionDto>();
-        var originalCacheSize = Cache.MaxFiles;
         try
         {
-            Cache.MaxFiles = 0;
             for (var i = 0; i < files.Length; i++)
             {
                 var file = files[i];
-                var dimension = _converterService.GetDimensions(file);
+                MagickImageInfo info = new MagickImageInfo(file);
 
                 dimensions.Add(new FileDimensionDto()
                 {
                     PageNumber = i,
-                    Height = dimension.Value.Height,
-                    Width = dimension.Value.Width,
-                    IsWide = dimension.Value.Width > dimension.Value.Height,
+                    Height = info.Height,
+                    Width = info.Width,
+                    IsWide = info.Width > info.Height,
                     FileName = file.Replace(cachePath, string.Empty)
                 });
             }
@@ -120,7 +117,6 @@ public IEnumerable<FileDimensionDto> GetCachedFileDimensions(string cachePath)
         }
         finally
         {
-            Cache.MaxFiles = originalCacheSize;
         }
 
         _logger.LogDebug("File Dimensions call for {Length} images took {Time}ms", dimensions.Count, sw.ElapsedMilliseconds);
diff --git a/API/Services/ImageConversion/AvifImageConverterProvider.cs b/API/Services/ImageConversion/AvifImageConverterProvider.cs
deleted file mode 100644
index 607f7ca1e..000000000
--- a/API/Services/ImageConversion/AvifImageConverterProvider.cs
+++ /dev/null
@@ -1,76 +0,0 @@
-using Kavita.Common.EnvironmentInfo;
-using Microsoft.Extensions.Logging;
-using System.Threading;
-using System;
-using System.IO;
-using NetVips;
-using System.IO.Abstractions;
-
-namespace API.Services.ImageConversion
-{
-    /// <summary>
-    /// Provides image conversion functionality for AVIF format using netvips library.
-    /// </summary>
-    public class AvifImageConverterProvider : IImageConverterProvider
-    {
-        private readonly ILogger<AvifImageConverterProvider> _logger;
-
-        /// <summary>
-        /// Gets a value indicating whether Vips supports AVIF.
-        /// </summary>
-        public bool IsVipsSupported => true;
-
-        /// <summary>
-        /// Initializes a new instance of the <see cref="AvifImageConverterProvider"/> class.
-        /// </summary>
-        /// <param name="logger">The logger.</param>
-        public AvifImageConverterProvider(ILogger<AvifImageConverterProvider> logger)
-        {
-            _logger = logger;
-        }
-
-        /// <summary>
-        /// Checks if the filename has the AVIF extension.
-        /// </summary>
-        /// <param name="filename">The filename of the image file.</param>
-        /// <returns>True if the image is AVIF image type; otherwise, false.</returns>
-        public bool IsSupported(string filename)
-        {
-            return filename.EndsWith(".avif", StringComparison.InvariantCultureIgnoreCase);
-        }
-
-        /// <summary>
-        /// Converts the specified AVIF file to JPEG format.
-        /// </summary>
-        /// <param name="filename">The filename of the AVIF file.</param>
-        /// <returns>The filename of the converted JPEG file.</returns>
-        public string Convert(string filename)
-        {
-            string destination = Path.ChangeExtension(filename, "jpg");
-            using var sourceImage = Image.NewFromFile(filename, false, Enums.Access.SequentialUnbuffered);
-            sourceImage.WriteToFile(destination + "[Q=99]");
-            File.Delete(filename);
-            return destination;
-        }
-        /// <summary>
-        /// Creates a NetVips Image object from the specified image stream.
-        /// </summary>
-        /// <param name="source">The source image stream.</param>
-        /// <returns>The NetVips Image object created from the image stream.</returns>
-        public virtual Image ImageFromStream(Stream source)
-        {
-            return Image.NewFromStream(source);
-        }
-
-        /// <summary>
-        /// Gets the dimensions (width and height) of the specified image file.
-        /// </summary>
-        /// <param name="fileName">The filename of the image file.</param>
-        /// <returns>The dimensions of the image file as a tuple of width and height.</returns>
-        public (int Width, int Height)? GetDimensions(string fileName)
-        {
-            using var image = Image.NewFromFile(fileName, memory: false, access: Enums.Access.SequentialUnbuffered);
-            return (image.Width, image.Height);
-        }
-    }
-}
diff --git a/API/Services/ImageConversion/HeifImageConverterProvider.cs b/API/Services/ImageConversion/HeifImageConverterProvider.cs
deleted file mode 100644
index 2e5565a94..000000000
--- a/API/Services/ImageConversion/HeifImageConverterProvider.cs
+++ /dev/null
@@ -1,41 +0,0 @@
-using Microsoft.Extensions.Logging;
-using NetVips;
-using System.IO;
-using System;
-using ImageMagick;
-
-namespace API.Services.ImageConversion
-{
-    /// <summary>
-    /// Provides image conversion functionality for HEIF and HEIC file formats using ImageMagick.
-    /// </summary>
-    public class HeifImageConverterProvider : ImageMagickConverterProvider, IImageConverterProvider
-    {
-        private readonly ILogger<HeifImageConverterProvider> _logger;
-
-        /// <summary>
-        /// Gets a value indicating whether Vips supports HEIF.
-        /// </summary>
-        public bool IsVipsSupported => false;
-
-        /// <summary>
-        /// Initializes a new instance of the <see cref="HeifImageConverterProvider"/> class.
-        /// </summary>
-        /// <param name="logger">The logger.</param>
-        public HeifImageConverterProvider(ILogger<HeifImageConverterProvider> logger)
-        {
-            _logger = logger;
-        }
-
-        /// <summary>
-        /// Checks if the filename has the HEIF/HEIC extension.
-        /// </summary>
-        /// <param name="filename">The filename of the image file.</param>
-        /// <returns>True if the image is HEIF/HEIC image type; otherwise, false.</returns>
-        public bool IsSupported(string filename)
-        {
-            return filename.EndsWith(".heif", StringComparison.InvariantCultureIgnoreCase)
-                   || filename.EndsWith(".heic", StringComparison.InvariantCultureIgnoreCase);
-        }
-    }
-}
diff --git a/API/Services/ImageConversion/Jpeg2000ImageConverterProvider.cs b/API/Services/ImageConversion/Jpeg2000ImageConverterProvider.cs
deleted file mode 100644
index 6c9e8f5dd..000000000
--- a/API/Services/ImageConversion/Jpeg2000ImageConverterProvider.cs
+++ /dev/null
@@ -1,41 +0,0 @@
-using Kavita.Common.EnvironmentInfo;
-using Microsoft.Extensions.Logging;
-using System.IO;
-using System.Text.RegularExpressions;
-using System.Threading;
-using System;
-
-namespace API.Services.ImageConversion
-{
-    /// <summary>
-    /// Provides image conversion functionality for JPEG2000 images.
-    /// </summary>
-    public class Jpeg2000ImageConverterProvider : ImageMagickConverterProvider, IImageConverterProvider
-    {
-        private readonly ILogger<Jpeg2000ImageConverterProvider> _logger;
-
-        /// <summary>
-        /// Initializes a new instance of the <see cref="Jpeg2000ImageConverterProvider"/> class.
-        /// </summary>
-        /// <param name="logger">The logger.</param>
-        public Jpeg2000ImageConverterProvider(ILogger<Jpeg2000ImageConverterProvider> logger)
-        {
-            _logger = logger;
-        }
-
-        /// <summary>
-        /// Gets a value indicating whether Vips supports JPEG 2000.
-        /// </summary>
-        public bool IsVipsSupported => false;
-
-        /// <summary>
-        /// Checks if the filename has the JPEG 2000 extension.
-        /// </summary>
-        /// <param name="filename">The filename of the image file.</param>
-        /// <returns>True if the image is JPEG 2000 image type; otherwise, false.</returns>
-        public bool IsSupported(string filename)
-        {
-            return filename.EndsWith(".jp2", StringComparison.InvariantCultureIgnoreCase) || filename.EndsWith(".j2k", StringComparison.InvariantCultureIgnoreCase);
-        }
-    }
-}
diff --git a/API/Services/ImageConversion/JpegXLImageConverterProvider.cs b/API/Services/ImageConversion/JpegXLImageConverterProvider.cs
deleted file mode 100644
index 60d73ce17..000000000
--- a/API/Services/ImageConversion/JpegXLImageConverterProvider.cs
+++ /dev/null
@@ -1,137 +0,0 @@
-using System;
-using System.IO;
-using System.IO.Abstractions;
-using System.Linq;
-using System.Runtime.InteropServices;
-using System.Text.RegularExpressions;
-using System.Threading;
-using ImageMagick;
-using Kavita.Common.EnvironmentInfo;
-using Microsoft.Extensions.Logging;
-using NetVips;
-
-namespace API.Services.ImageConversion;
-
-/// <summary>
-/// Represents an image converter provider.
-/// </summary>
-public interface IImageConverterProvider
-{
-    /// <summary>
-    /// Checks if the image converter supports the image format.
-    /// </summary>
-    /// <param name="filename">The filename of the image file.</param>
-    /// <returns>True if the image converter supports the image type; otherwise, false.</returns>
-    bool IsSupported(string filename);
-
-    /// <summary>
-    /// Converts the specified image to JPG.
-    /// </summary>
-    /// <param name="filename">The filename of the image file.</param>
-    /// <returns>The converted image file.</returns>
-    string Convert(string filename);
-
-    /// <summary>
-    /// Gets the dimensions of the specified image file.
-    /// </summary>
-    /// <param name="fileName">The filename of the image file.</param>
-    /// <returns>The dimensions of the image file as a tuple of width and height, or null if the dimensions cannot be determined.</returns>
-    (int Width, int Height)? GetDimensions(string fileName);
-
-    /// <summary>
-    /// Gets a value indicating whether the image type supports Vips.
-    /// </summary>
-    bool IsVipsSupported { get; }
-
-    /// <summary>
-    /// Creates a NetVips Image object from the specified image stream.
-    /// </summary>
-    /// <param name="source">The source image stream.</param>
-    /// <returns>The NetVips Image object created from the image stream.</returns>
-    Image ImageFromStream(Stream source);
-}
-
-public class ImageMagickConverterProvider
-{
-    /// <summary>
-    /// Converts the specified image to JPG.
-    /// </summary>
-    /// <param name="filename">The filename of the image file.</param>
-    /// <returns>The converted image file.</returns>
-    public virtual string Convert(string filename)
-    {
-        string destination = Path.ChangeExtension(filename, "jpg");
-        using var sourceImage = new MagickImage(filename);
-        sourceImage.Quality = 99;
-        sourceImage.Write(destination);
-        File.Delete(filename);
-        return destination;
-    }
-
-    /// <summary>
-    /// Creates a NetVips Image object from the specified image stream.
-    /// </summary>
-    /// <param name="source">The source image stream.</param>
-    /// <returns>The NetVips Image object created from the image stream.</returns>
-    public virtual Image ImageFromStream(Stream source)
-    {
-        var settings = new MagickReadSettings
-        {
-            ColorSpace = ColorSpace.sRGB
-        };
-        using var sourceImage = new MagickImage(source, settings);
-        float[] pixels = sourceImage.GetPixels().ToArray();
-        float mul = 1F / 255F;
-        for (int x = 0; x < pixels.Length; x++)
-            pixels[x] *= mul;
-        GCHandle handle = GCHandle.Alloc(pixels, GCHandleType.Pinned);
-        IntPtr pointer = handle.AddrOfPinnedObject();
-        ulong size = (ulong)(Marshal.SizeOf<float>() * pixels.Length);
-        Image im = Image.NewFromMemoryCopy(pointer, size, sourceImage.Width, sourceImage.Height,3, Enums.BandFormat.Float);
-        handle.Free();
-        return im;
-    }
-
-    /// <summary>
-    /// Gets the dimensions of the specified image file.
-    /// </summary>
-    /// <param name="filename">The filename of the image file.</param>
-    /// <returns>The dimensions of the image file as a tuple of width and height, or null if the dimensions cannot be determined.</returns>
-    public virtual (int Width, int Height)? GetDimensions(string filename)
-    {
-        var info = new MagickImageInfo(filename);
-        return (info.Width, info.Height);
-    }
-}
-
-/// <summary>
-/// Represents a JPEG-XL image converter provider.
-/// </summary>
-public class JpegXLImageConverterProvider : ImageMagickConverterProvider, IImageConverterProvider
-{
-    private readonly ILogger<JpegXLImageConverterProvider> _logger;
-
-    /// <summary>
-    /// Initializes a new instance of the <see cref="JpegXLImageConverterProvider"/> class.
-    /// </summary>
-    /// <param name="logger">The logger.</param>
-    public JpegXLImageConverterProvider(ILogger<JpegXLImageConverterProvider> logger)
-    {
-        _logger = logger;
-    }
-
-    /// <summary>
-    /// Gets a value indicating whether Vips supports JPEG-XL.
-    /// </summary>
-    public bool IsVipsSupported => false;
-
-    /// <summary>
-    /// Checks if the filename has the JPEG-XL extension.
-    /// </summary>
-    /// <param name="filename">The filename of the image file.</param>
-    /// <returns>True if the image is JPEG-XL image type; otherwise, false.</returns>
-    public bool IsSupported(string filename)
-    {
-        return filename.EndsWith(".jxl", StringComparison.InvariantCultureIgnoreCase);
-    }
-}
diff --git a/API/Services/ImageConverterService.cs b/API/Services/ImageConverterService.cs
index 4fa98d4e0..7345d81be 100644
--- a/API/Services/ImageConverterService.cs
+++ b/API/Services/ImageConverterService.cs
@@ -4,9 +4,11 @@
 using System.IO;
 using System.IO.Abstractions;
 using System.Linq;
-using API.Services.ImageConversion;
+using System.Text.RegularExpressions;
+using API.Services.Tasks.Scanner.Parser;
+using ImageMagick;
 using Microsoft.Extensions.Logging;
-using NetVips;
+
 
 namespace API.Services
 {
@@ -15,14 +17,6 @@ namespace API.Services
     /// </summary>
     public interface IImageConverterService
     {
-        /// <summary>
-        /// Converts the input stream into a Vips Image.
-        /// </summary>
-        /// <param name="originalNameWithExtension">The OriginalNameWithExtension of the image
-        /// (Not a file,  only the name, if it came from the filesystem or an archive entry to identify the image type).</param>
-        /// <param name="source">The input stream of the image.</param>
-        /// <returns>NetVips Image from the input Stream.</returns>
-        Image GetImageFromStream(string originalNameWithExtension, Stream source);
 
         /// <summary>
         /// Converts the specified image file to jpg image format.
@@ -32,19 +26,6 @@ public interface IImageConverterService
         /// <returns>The converted image file path if conversion is required. Note: original filename is deleted if conversion is executed</returns>
         string ConvertFile(string filename, List<string> supportedImageFormats = null);
 
-        /// <summary>
-        /// Gets the dimensions (width and height) of the specified image file without read the whole image.
-        /// </summary>
-        /// <param name="fileName">The filename of the image.</param>
-        /// <returns>The dimensions of the image (width and height).</returns>
-        (int Width, int Height)? GetDimensions(string fileName);
-
-        /// <summary>
-        /// Checks if the VIPS library supports for the specified image type.
-        /// </summary>
-        /// <param name="filename">The filename of the image.</param>
-        /// <returns>True if the VIPS library support it; otherwise, false.</returns>
-        bool IsVipsSupported(string filename);
     }
 
     /// <summary>
@@ -52,7 +33,7 @@ public interface IImageConverterService
     /// </summary>
     public class ImageConverterService : IImageConverterService
     {
-        private readonly IEnumerable<IImageConverterProvider> _converters;
+
         private readonly ILogger<ImageConverterService> _logger;
 
         /// <summary>
@@ -60,26 +41,14 @@ public class ImageConverterService : IImageConverterService
         /// </summary>
         /// <param name="logger">The logger instance.</param>
         /// <param name="converters">The collection of image converter providers.</param>
-        public ImageConverterService(ILogger<ImageConverterService> logger, IEnumerable<IImageConverterProvider> converters)
+        public ImageConverterService(ILogger<ImageConverterService> logger)
         {
             _logger = logger;
-            _converters = converters;
-        }
-
-        /// <inheritdoc/>
-        public Image GetImageFromStream(string originalNameWithExtension, Stream source)
-        {
-            //Check if the name have one of our supported extensions.
-            IImageConverterProvider provider = _converters.FirstOrDefault(a => a.IsSupported(originalNameWithExtension));
-
-            if (provider == null || provider.IsVipsSupported) return Image.NewFromStream(source); //No need to transform, Vips supports the format.
 
-            var sw = Stopwatch.StartNew();
-            Image image = provider.ImageFromStream(source);
-            _logger.LogDebug("Image converted from '{Extension}' to '.jpg' in {ElapsedMilliseconds} milliseconds", Path.GetExtension(originalNameWithExtension), sw.ElapsedMilliseconds);
-            return image;
         }
 
+    
+
         private bool CheckDirectSupport(string filename, List<string> supportedImageFormats)
         {
             if (supportedImageFormats == null)
@@ -93,35 +62,21 @@ public string ConvertFile(string filename, List<string> supportedImageFormats =
         {
             if (CheckDirectSupport(filename, supportedImageFormats))
                 return filename;
-            IImageConverterProvider provider = _converters.FirstOrDefault(a => a.IsSupported(filename));
-            if (provider == null) //No provider for this image type, so, is a common image format.
+            Match m = Regex.Match(Path.GetExtension(filename), Parser.NonUniversalFileImageExtensions, RegexOptions.IgnoreCase, Tasks.Scanner.Parser.Parser.RegexTimeout);
+            if (!m.Success)
                 return filename;
             var sw = Stopwatch.StartNew();
-            filename = provider.Convert(filename);
+            string destination = Path.ChangeExtension(filename, "jpg");
+            using var sourceImage = new MagickImage(filename);
+            sourceImage.Quality = 99;
+            sourceImage.Write(destination);
+            File.Delete(filename);
             _logger.LogDebug("Image converted from '{Extension}' to '.jpg' in {ElapsedMilliseconds} milliseconds", Path.GetExtension(filename), sw.ElapsedMilliseconds);
-            return filename;
+            return destination;
         }
 
-        /// <inheritdoc/>
-        public (int Width, int Height)? GetDimensions(string fileName)
-        {
-            //Provider supported
-            IImageConverterProvider provider = _converters.FirstOrDefault(a => a.IsSupported(fileName));
-            if (provider != null)
-                return provider.GetDimensions(fileName);
 
-            //No provider for this image type, so, is a common image format, use netvips and original code.
-            using var image = Image.NewFromFile(fileName, memory: false, access: Enums.Access.SequentialUnbuffered);
-            return (image.Width, image.Height);
-        }
 
-        /// <inheritdoc/>
-        public bool IsVipsSupported(string filename)
-        {
-            IImageConverterProvider provider = _converters.FirstOrDefault(a => a.IsSupported(filename));
-            if (provider == null)
-                return true;
-            return provider.IsVipsSupported;
-        }
+
     }
 }
diff --git a/API/Services/ImageService.cs b/API/Services/ImageService.cs
index 56811c785..f2e1c7256 100644
--- a/API/Services/ImageService.cs
+++ b/API/Services/ImageService.cs
@@ -14,13 +14,9 @@
 using Flurl;
 using Flurl.Http;
 using HtmlAgilityPack;
+using ImageMagick;
 using Kavita.Common;
 using Microsoft.Extensions.Logging;
-using NetVips;
-using SixLabors.ImageSharp.PixelFormats;
-using SixLabors.ImageSharp.Processing;
-using SixLabors.ImageSharp.Processing.Processors.Quantization;
-using Image = NetVips.Image;
 
 namespace API.Services;
 #nullable enable
@@ -146,13 +142,13 @@ public void ExtractImages(string? fileFilePath, string targetDirectory, int file
     /// <param name="targetWidth"></param>
     /// <param name="targetHeight"></param>
     /// <returns></returns>
-    public static Enums.Size GetSizeForDimensions(Image image, int targetWidth, int targetHeight)
+    public static MagickGeometry GetSizeForDimensions(MagickImage image, int targetWidth, int targetHeight)
     {
         try
         {
             if (WillScaleWell(image, targetWidth, targetHeight) || IsLikelyWideImage(image.Width, image.Height))
             {
-                return Enums.Size.Force;
+                return new MagickGeometry(targetWidth, targetHeight) { IgnoreAspectRatio = true };
             }
         }
         catch (Exception)
@@ -160,27 +156,27 @@ public static Enums.Size GetSizeForDimensions(Image image, int targetWidth, int
             /* Swallow */
         }
 
-        return Enums.Size.Both;
+        return new MagickGeometry(targetWidth, targetHeight) { IgnoreAspectRatio = true, FillArea = true };
     }
 
-    public static Enums.Interesting? GetCropForDimensions(Image image, int targetWidth, int targetHeight)
+    public static bool GetCropForDimensions(MagickImage image, int targetWidth, int targetHeight)
     {
         try
         {
             if (WillScaleWell(image, targetWidth, targetHeight) || IsLikelyWideImage(image.Width, image.Height))
             {
-                return null;
+                return false;
             }
         } catch (Exception)
         {
             /* Swallow */
-            return null;
+            return false;
         }
 
-        return Enums.Interesting.Attention;
+        return true; //crop
     }
 
-    public static bool WillScaleWell(Image sourceImage, int targetWidth, int targetHeight, double tolerance = 0.1)
+    public static bool WillScaleWell(MagickImage sourceImage, int targetWidth, int targetHeight, double tolerance = 0.1)
     {
         // Calculate the aspect ratios
         var sourceAspectRatio = (double) sourceImage.Width / sourceImage.Height;
@@ -211,23 +207,30 @@ private static bool IsLikelyWideImage(int width, int height)
         return aspectRatio > 1.25;
     }
 
+    private MagickImage Thumbnail(string path, int width, int height)
+    {
+        var sourceImage = new MagickImage(path);
+        return Thumbnail(sourceImage, width, height);
+    }
+    private MagickImage Thumbnail(MagickImage sourceImage, int width, int height)
+    {
+        var geometry = GetSizeForDimensions(sourceImage, width, height);
+        bool crop = GetCropForDimensions(sourceImage, width, height);
+        sourceImage.Thumbnail(geometry);
+        if (crop)
+            sourceImage.Crop(width, height, Gravity.Center);
+        return sourceImage;
+    }
     public string GetCoverImage(string path, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size)
     {
         if (string.IsNullOrEmpty(path)) return string.Empty;
 
         try
         {
-            if (!_converterService.IsVipsSupported(path)) //If Vips supports the format, there is no need to convert the image, since in this case the consumer is not the browser.
-                path = _converterService.ConvertFile(path);
-
             var (width, height) = size.GetDimensions();
-            using var sourceImage = Image.NewFromFile(path, false, Enums.Access.SequentialUnbuffered);
-
-            using var thumbnail = Image.Thumbnail(path, width, height: height,
-                size: GetSizeForDimensions(sourceImage, width, height),
-                crop: GetCropForDimensions(sourceImage, width, height));
+            using var thumbnail = Thumbnail(path, width, height);
             var filename = fileName + encodeFormat.GetExtension();
-            thumbnail.WriteToFile(_directoryService.FileSystem.Path.Join(outputDirectory, filename));
+            thumbnail.Write(_directoryService.FileSystem.Path.Join(outputDirectory, filename));
             return filename;
         }
         catch (Exception ex)
@@ -254,15 +257,8 @@ public string WriteCoverThumbnail(string originalNameWithExtension, Stream strea
         var (targetWidth, targetHeight) = size.GetDimensions();
         if (stream.CanSeek) stream.Position = 0;
 
-        using var sourceImage = _converterService.GetImageFromStream(originalNameWithExtension, stream);
-
-        var scalingSize = GetSizeForDimensions(sourceImage, targetWidth, targetHeight);
-        var scalingCrop = GetCropForDimensions(sourceImage, targetWidth, targetHeight);
-
-        using var thumbnail = sourceImage.ThumbnailImage(targetWidth, targetHeight,
-            size: scalingSize,
-            crop: scalingCrop);
-
+        using var sourceImage = new MagickImage(stream);
+        using var thumbnail = Thumbnail(sourceImage, targetWidth, targetHeight);
         var filename = fileName + encodeFormat.GetExtension();
         _directoryService.ExistOrCreate(outputDirectory);
 
@@ -273,55 +269,37 @@ public string WriteCoverThumbnail(string originalNameWithExtension, Stream strea
 
         try
         {
-            thumbnail.WriteToFile(_directoryService.FileSystem.Path.Join(outputDirectory, filename));
-
+            thumbnail.Write(_directoryService.FileSystem.Path.Join(outputDirectory, filename));
             return filename;
         }
-        catch (VipsException)
+        catch (Exception)
         {
-            // NetVips Issue: https://github.com/kleisauke/net-vips/issues/234
-            // Saving pdf covers from a stream can fail, so revert to old code
-
-            if (stream.CanSeek) stream.Position = 0;
-            using var thumbnail2 = Image.ThumbnailStream(stream, targetWidth, height: targetHeight,
-                size: scalingSize,
-                crop: scalingCrop);
-            thumbnail2.WriteToFile(_directoryService.FileSystem.Path.Join(outputDirectory, filename));
-
-            return filename;
+            return string.Empty; //IDK?
         }
     }
 
     public string WriteCoverThumbnail(string sourceFile, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size = CoverImageSize.Default)
     {
-        if (!_converterService.IsVipsSupported(sourceFile)) //If Vips supports the format, there is no need to convert the image, since in this case the consumer is not the browser.
-            sourceFile = _converterService.ConvertFile(sourceFile);
-
         var (width, height) = size.GetDimensions();
-        using var sourceImage = Image.NewFromFile(sourceFile, false, Enums.Access.SequentialUnbuffered);
-
-        using var thumbnail = Image.Thumbnail(sourceFile, width, height: height,
-            size: GetSizeForDimensions(sourceImage, width, height),
-            crop: GetCropForDimensions(sourceImage, width, height));
+        using var thumbnail = Thumbnail(sourceFile, width, height);
         var filename = fileName + encodeFormat.GetExtension();
         _directoryService.ExistOrCreate(outputDirectory);
         try
         {
             _directoryService.FileSystem.File.Delete(_directoryService.FileSystem.Path.Join(outputDirectory, filename));
         } catch (Exception) {/* Swallow exception */}
-        thumbnail.WriteToFile(_directoryService.FileSystem.Path.Join(outputDirectory, filename));
+        thumbnail.Write(_directoryService.FileSystem.Path.Join(outputDirectory, filename));
         return filename;
     }
 
-    public Task<string> ConvertToEncodingFormat(string filePath, string outputPath, EncodeFormat encodeFormat)
+    public async Task<string> ConvertToEncodingFormat(string filePath, string outputPath, EncodeFormat encodeFormat)
     {
         var file = _directoryService.FileSystem.FileInfo.New(filePath);
         var fileName = file.Name.Replace(file.Extension, string.Empty);
         var outputFile = Path.Join(outputPath, fileName + encodeFormat.GetExtension());
-
-        using var sourceImage = Image.NewFromFile(filePath, false, Enums.Access.SequentialUnbuffered);
-        sourceImage.WriteToFile(outputFile);
-        return Task.FromResult(outputFile);
+        using var sourceImage = new MagickImage(filePath);
+        await sourceImage.WriteAsync(outputFile).ConfigureAwait(false);
+        return outputFile;
     }
 
     /// <summary>
@@ -333,17 +311,16 @@ public async Task<bool> IsImage(string filePath)
     {
         try
         {
-            var info = await SixLabors.ImageSharp.Image.IdentifyAsync(filePath);
-            if (info == null) return false;
-
-            return true;
+            MagickImageInfo info = new MagickImageInfo(filePath);
+            if (info.Width > 0 || info.Height > 0)
+                return true;
         }
         catch (Exception)
         {
             /* Swallow Exception */
         }
 
-        return false;
+        return true;
     }
 
     public async Task<string> DownloadFaviconAsync(string url, EncodeFormat encodeFormat)
@@ -418,18 +395,18 @@ public async Task<string> DownloadFaviconAsync(string url, EncodeFormat encodeFo
                 .GetStreamAsync();
 
             // Create the destination file path
-            using var image = Image.PngloadStream(faviconStream);
+            using var image = new MagickImage(faviconStream);
             var filename = ImageService.GetWebLinkFormat(baseUrl, encodeFormat);
             switch (encodeFormat)
             {
                 case EncodeFormat.PNG:
-                    image.Pngsave(Path.Combine(_directoryService.FaviconDirectory, filename));
+                    await image.WriteAsync(Path.Combine(_directoryService.FaviconDirectory, filename),MagickFormat.Png32).ConfigureAwait(false);
                     break;
                 case EncodeFormat.WEBP:
-                    image.Webpsave(Path.Combine(_directoryService.FaviconDirectory, filename));
+                    await image.WriteAsync(Path.Combine(_directoryService.FaviconDirectory, filename), MagickFormat.WebP).ConfigureAwait(false);
                     break;
                 case EncodeFormat.AVIF:
-                    image.Heifsave(Path.Combine(_directoryService.FaviconDirectory, filename));
+                    await image.WriteAsync(Path.Combine(_directoryService.FaviconDirectory, filename), MagickFormat.Avif).ConfigureAwait(false);
                     break;
                 default:
                     throw new ArgumentOutOfRangeException(nameof(encodeFormat), encodeFormat, null);
@@ -464,18 +441,18 @@ public async Task<string> DownloadPublisherImageAsync(string publisherName, Enco
                 .GetStreamAsync();
 
             // Create the destination file path
-            using var image = Image.PngloadStream(publisherStream);
+            using var image = new MagickImage(publisherStream);
             var filename = GetPublisherFormat(publisherName, encodeFormat);
             switch (encodeFormat)
             {
                 case EncodeFormat.PNG:
-                    image.Pngsave(Path.Combine(_directoryService.PublisherDirectory, filename));
+                    await image.WriteAsync(Path.Combine(_directoryService.FaviconDirectory, filename), MagickFormat.Png32).ConfigureAwait(false);
                     break;
                 case EncodeFormat.WEBP:
-                    image.Webpsave(Path.Combine(_directoryService.PublisherDirectory, filename));
+                    await image.WriteAsync(Path.Combine(_directoryService.FaviconDirectory, filename), MagickFormat.WebP).ConfigureAwait(false);
                     break;
                 case EncodeFormat.AVIF:
-                    image.Heifsave(Path.Combine(_directoryService.PublisherDirectory, filename));
+                    await image.WriteAsync(Path.Combine(_directoryService.FaviconDirectory, filename), MagickFormat.Avif).ConfigureAwait(false);
                     break;
                 default:
                     throw new ArgumentOutOfRangeException(nameof(encodeFormat), encodeFormat, null);
@@ -493,22 +470,20 @@ public async Task<string> DownloadPublisherImageAsync(string publisherName, Enco
 
     private static (Vector3?, Vector3?) GetPrimarySecondaryColors(string imagePath)
     {
-        using var image = Image.NewFromFile(imagePath);
-        // Resize the image to speed up processing
-        var resizedImage = image.Resize(0.1);
-
-        var processedImage = PreProcessImage(resizedImage);
-
+        var settings = new MagickReadSettings { ColorSpace = ColorSpace.RGB };
+        using var sourceImage = new MagickImage(imagePath, settings);
 
+        MagickImage im = new MagickImage(imagePath);
+        // Resize the image to speed up processing
+        im.Resize(new Percentage(10));
         // Convert image to RGB array
-        var pixels = processedImage.WriteToMemory().ToArray();
-
-        // Convert to list of Vector3 (RGB)
+        float[] pixels = im.GetPixels().ToArray();
+        float mul = 1F / 255F;
         var rgbPixels = new List<Vector3>();
-        for (var i = 0; i < pixels.Length - 2; i += 3)
-        {
-            rgbPixels.Add(new Vector3(pixels[i], pixels[i + 1], pixels[i + 2]));
-        }
+        // Convert to list of Vector3 (RGB)
+
+        for (int x = 0; x < pixels.Length; x += 3)
+            rgbPixels.Add(new Vector3(pixels[x] * mul, pixels[x+1] * mul, pixels[x + 2] * mul));
 
         // Perform k-means clustering
         var clusters = KMeansClustering(rgbPixels, 4);
@@ -529,7 +504,7 @@ private static (Vector3?, Vector3?) GetPrimarySecondaryColors(string imagePath)
 
         return (null, null);
     }
-
+    /*
     private static (Vector3?, Vector3?) GetPrimaryColorSharp(string imagePath)
     {
         using var image = SixLabors.ImageSharp.Image.Load<Rgb24>(imagePath);
@@ -549,6 +524,7 @@ private static (Vector3?, Vector3?) GetPrimaryColorSharp(string imagePath)
         return (new Vector3(dominantColor.R, dominantColor.G, dominantColor.B), new Vector3(dominantColor.R, dominantColor.G, dominantColor.B));
     }
 
+
     private static Image PreProcessImage(Image image)
     {
         return image;
@@ -583,7 +559,7 @@ private static Dictionary<Vector3, int> GenerateColorHistogram(Image image)
 
         return histogram;
     }
-
+    */
     private static bool IsColorCloseToWhiteOrBlack(Vector3 color)
     {
         var (_, _, lightness) = RgbToHsl(color);
@@ -814,9 +790,12 @@ public string CreateThumbnailFromBase64(string encodedImage, string fileName, En
     {
         try
         {
-            using var thumbnail = Image.ThumbnailBuffer(Convert.FromBase64String(encodedImage), thumbnailWidth);
+
+            using var thumbnail = new MagickImage(Convert.FromBase64String(encodedImage));
+            int thumbnailHeight = (int)(thumbnail.Height * ((double)thumbnailWidth / thumbnail.Width));
+            thumbnail.Thumbnail(thumbnailWidth, thumbnailHeight);
             fileName += encodeFormat.GetExtension();
-            thumbnail.WriteToFile(_directoryService.FileSystem.Path.Join(_directoryService.CoverImageDirectory, fileName));
+            thumbnail.Write(_directoryService.FileSystem.Path.Join(_directoryService.CoverImageDirectory, fileName));
             return fileName;
         }
         catch (Exception e)
@@ -932,7 +911,7 @@ public static void CreateMergedImage(IList<string> coverImages, CoverImageSize s
         }
 
 
-        var image = Image.Black(width, height);
+        var image = new MagickImage(MagickColor.FromRgb(0,0,0), width, height);
 
         var thumbnailWidth = image.Width / cols;
         var thumbnailHeight = image.Height / rows;
@@ -940,8 +919,8 @@ public static void CreateMergedImage(IList<string> coverImages, CoverImageSize s
         for (var i = 0; i < coverImages.Count; i++)
         {
             if (!File.Exists(coverImages[i])) continue;
-            var tile = Image.NewFromFile(coverImages[i], access: Enums.Access.Sequential);
-            tile = tile.ThumbnailImage(thumbnailWidth, height: thumbnailHeight);
+            var tile = new MagickImage(coverImages[i]);
+            tile.Thumbnail(thumbnailWidth, thumbnailHeight);
 
             var row = i / cols;
             var col = i % cols;
@@ -954,11 +933,10 @@ public static void CreateMergedImage(IList<string> coverImages, CoverImageSize s
                 x = (image.Width - thumbnailWidth) / 2;
                 y = thumbnailHeight;
             }
-
-            image = image.Insert(tile, x, y);
+            image.Composite(tile,x,y,CompositeOperator.Over);
         }
 
-        image.WriteToFile(dest);
+        image.Write(dest);
     }
 
     public void UpdateColorScape(IHasCoverImage entity)
diff --git a/API/Services/Tasks/Scanner/Parser/Parser.cs b/API/Services/Tasks/Scanner/Parser/Parser.cs
index 9e20eae99..71be6078e 100644
--- a/API/Services/Tasks/Scanner/Parser/Parser.cs
+++ b/API/Services/Tasks/Scanner/Parser/Parser.cs
@@ -1,4 +1,5 @@
-using System;
+using System;
+using System.Collections.Generic;
 using System.Collections.Immutable;
 using System.Globalization;
 using System.IO;
@@ -25,7 +26,21 @@ public static class Parser
 
     public static readonly TimeSpan RegexTimeout = TimeSpan.FromMilliseconds(500);
 
-    public const string ImageFileExtensions = @"^(\.png|\.jpeg|\.jpg|\.webp|\.gif|\.avif|\.jxl|\.heif|\.heic|\.j2k|\.jp2)"; // Don't forget to update CoverChooser
+    public static Dictionary<string, List<string>> NonUniversalSupportedMimeMappings = new Dictionary<string, List<string>>()
+        {
+            { "jp2", ["jp2", "j2k"] } ,
+            { "j2k", ["jp2", "j2k"] } ,
+            { "heif", ["heif", "heic"] } ,
+            { "heic", ["heif", "heic"] } ,
+            { "jxl", ["jxl"] } ,
+            { "avif", ["avif"] } ,
+        };
+    public static string[] NonUniversalFileImageExtensionArray = { "avif", "jxl", "heif", "heic", "j2k", "jp2" };
+    public static string[] UniversalFileImageExtensionArray = { "png", "jpeg", "jpg", "webp", "gif" };
+    public static string NonUniversalFileImageExtensions = @"^(\." + string.Join(@"|\.", NonUniversalFileImageExtensionArray) + ")";
+    public static string ImageFileExtensions = @"^(\." + string.Join(@"|\.", UniversalFileImageExtensionArray.Union(NonUniversalFileImageExtensionArray)) + ")"; // Don't forget to update CoverChooser
+
+
     public const string ArchiveFileExtensions = @"\.cbz|\.zip|\.rar|\.cbr|\.tar.gz|\.7zip|\.7z|\.cb7|\.cbt";
     public const string EpubFileExtension = @"\.epub";
     public const string PdfFileExtension = @"\.pdf";
@@ -33,7 +48,7 @@ public static class Parser
     private const string XmlRegexExtensions = @"\.xml";
     public const string MacOsMetadataFileStartsWith = @"._";
 
-    public const string SupportedExtensions =
+    public static string SupportedExtensions =
         ArchiveFileExtensions + "|" + ImageFileExtensions + "|" + BookFileExtensions;
 
     private const RegexOptions MatchOptions =

From 10da91ce17ed832288f26663ba251d6dcd7a34a5 Mon Sep 17 00:00:00 2001
From: Maximo Piva <mpiva@adventintermodal.com>
Date: Fri, 27 Sep 2024 22:38:39 -0300
Subject: [PATCH 17/30] Remove CropFromDimensions (Geometry will take care)

---
 API.Tests/Services/ImageServiceTests.cs | 3 ---
 API/Services/ImageService.cs            | 4 +---
 2 files changed, 1 insertion(+), 6 deletions(-)

diff --git a/API.Tests/Services/ImageServiceTests.cs b/API.Tests/Services/ImageServiceTests.cs
index 66ef037e0..43b3addf9 100644
--- a/API.Tests/Services/ImageServiceTests.cs
+++ b/API.Tests/Services/ImageServiceTests.cs
@@ -64,10 +64,7 @@ private void GenerateFiles(string outputExtension)
             using var thumbnail = new MagickImage(imagePath);
 
             var size = ImageService.GetSizeForDimensions(thumbnail, dims.Width, dims.Height);
-            var crop = ImageService.GetCropForDimensions(thumbnail, dims.Width, dims.Height);
             thumbnail.Thumbnail(size);
-            if (crop)
-                thumbnail.Crop(dims.Width, dims.Height, Gravity.Center);
 
             var outputFileName = fileName + outputExtension + ".png";
             thumbnail.Write(Path.Join(_testDirectory, outputFileName));
diff --git a/API/Services/ImageService.cs b/API/Services/ImageService.cs
index f2e1c7256..ca0422b32 100644
--- a/API/Services/ImageService.cs
+++ b/API/Services/ImageService.cs
@@ -215,10 +215,8 @@ private MagickImage Thumbnail(string path, int width, int height)
     private MagickImage Thumbnail(MagickImage sourceImage, int width, int height)
     {
         var geometry = GetSizeForDimensions(sourceImage, width, height);
-        bool crop = GetCropForDimensions(sourceImage, width, height);
+    
         sourceImage.Thumbnail(geometry);
-        if (crop)
-            sourceImage.Crop(width, height, Gravity.Center);
         return sourceImage;
     }
     public string GetCoverImage(string path, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size)

From 1541d6ac02f21af0f482206316496287e87b1ffa Mon Sep 17 00:00:00 2001
From: Maximo Piva <mpiva@adventintermodal.com>
Date: Sat, 28 Sep 2024 00:41:18 -0300
Subject: [PATCH 18/30] BOM Changes

---
 API.Benchmark/ArchiveServiceBenchmark.cs      |   4 +-
 API.Tests/Services/ArchiveServiceTests.cs     |   2 +-
 API.Tests/Services/ImageServiceTests.cs       |   4 +-
 API/API.csproj                                |   2 +-
 API/API.csproj.bak                            | 204 ++++++++++++++++++
 .../ApplicationServiceExtensions.cs           |   3 +-
 API/Extensions/FileTypeGroupExtensions.cs     |   2 +-
 API/Services/BookService.cs                   |   2 +-
 API/Services/CacheService.cs                  |  30 +--
 API/Services/ImageService.cs                  |   2 +-
 10 files changed, 227 insertions(+), 28 deletions(-)
 create mode 100644 API/API.csproj.bak

diff --git a/API.Benchmark/ArchiveServiceBenchmark.cs b/API.Benchmark/ArchiveServiceBenchmark.cs
index f21d21347..d8e61fca4 100644
--- a/API.Benchmark/ArchiveServiceBenchmark.cs
+++ b/API.Benchmark/ArchiveServiceBenchmark.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.IO;
 using System.IO.Abstractions;
 using Microsoft.Extensions.Logging.Abstractions;
@@ -9,7 +9,6 @@
 using ImageMagick;
 using NSubstitute;
 
-
 namespace API.Benchmark;
 
 [StopOnFirstError]
@@ -22,7 +21,6 @@ public class ArchiveServiceBenchmark
     private readonly ArchiveService _archiveService;
     private readonly IDirectoryService _directoryService;
     private readonly IImageService _imageService;
-
     private const string SourceImage = "C:/Users/josep/Pictures/obey_by_grrsa-d6llkaa_colored_by_me.png";
 
 
diff --git a/API.Tests/Services/ArchiveServiceTests.cs b/API.Tests/Services/ArchiveServiceTests.cs
index 9d3d06b0a..f6e843f2d 100644
--- a/API.Tests/Services/ArchiveServiceTests.cs
+++ b/API.Tests/Services/ArchiveServiceTests.cs
@@ -1,4 +1,4 @@
-using System.Diagnostics;
+using System.Diagnostics;
 using System.IO;
 using System.IO.Abstractions;
 using System.IO.Abstractions.TestingHelpers;
diff --git a/API.Tests/Services/ImageServiceTests.cs b/API.Tests/Services/ImageServiceTests.cs
index 43b3addf9..58f23d490 100644
--- a/API.Tests/Services/ImageServiceTests.cs
+++ b/API.Tests/Services/ImageServiceTests.cs
@@ -1,4 +1,4 @@
-using System.Drawing;
+using System.Drawing;
 using System.IO;
 using System.IO.Abstractions;
 using System.Linq;
@@ -8,11 +8,9 @@
 using EasyCaching.Core;
 using ImageMagick;
 using Microsoft.Extensions.Logging;
-
 using NSubstitute;
 using Xunit;
 
-
 namespace API.Tests.Services;
 
 public class ImageServiceTests
diff --git a/API/API.csproj b/API/API.csproj
index 169ddfab9..3729b9689 100644
--- a/API/API.csproj
+++ b/API/API.csproj
@@ -1,4 +1,4 @@
-<Project Sdk="Microsoft.NET.Sdk.Web">
+<Project Sdk="Microsoft.NET.Sdk.Web">
 
   <PropertyGroup>
     <AnalysisMode>Default</AnalysisMode>
diff --git a/API/API.csproj.bak b/API/API.csproj.bak
new file mode 100644
index 000000000..169ddfab9
--- /dev/null
+++ b/API/API.csproj.bak
@@ -0,0 +1,204 @@
+<Project Sdk="Microsoft.NET.Sdk.Web">
+
+  <PropertyGroup>
+    <AnalysisMode>Default</AnalysisMode>
+    <TargetFramework>net8.0</TargetFramework>
+    <EnforceCodeStyleInBuild>true</EnforceCodeStyleInBuild>
+    <DockerDefaultTargetOS>Linux</DockerDefaultTargetOS>
+    <TieredPGO>true</TieredPGO>
+    <TieredCompilation>true</TieredCompilation>
+    <ApplicationIcon>../favicon.ico</ApplicationIcon>
+    <Nullable>warnings</Nullable>
+    <LangVersion>latestmajor</LangVersion>
+  </PropertyGroup>
+
+<!--  <Target Name="PostBuild" AfterTargets="Build" Condition=" '$(Configuration)' == 'Debug' ">-->
+<!--      <Delete Files="../openapi.json" />-->
+<!--      <Exec Command="swagger tofile &#45;&#45;output ../openapi.json bin/$(Configuration)/$(TargetFramework)/$(AssemblyName).dll v1" />-->
+<!--  </Target>-->
+
+  <PropertyGroup Condition=" '$(Configuration)' == 'Release' ">
+    <DebugSymbols>false</DebugSymbols>
+    <ApplicationIcon>../favicon.ico</ApplicationIcon>
+    <DocumentationFile>bin\$(Configuration)\$(AssemblyName).xml</DocumentationFile>
+  </PropertyGroup>
+
+  <PropertyGroup Condition=" '$(Configuration)' == 'Debug' ">
+    <DocumentationFile>bin\$(Configuration)\$(AssemblyName).xml</DocumentationFile>
+    <NoWarn>1701;1702;1591</NoWarn>
+  </PropertyGroup>
+
+    <!-- Ignore XML comments -->
+    <PropertyGroup>
+        <GenerateDocumentationFile>True</GenerateDocumentationFile>
+        <NoWarn>$(NoWarn);1591</NoWarn>
+    </PropertyGroup>
+
+    <PropertyGroup>
+        <SatelliteResourceLanguages>en</SatelliteResourceLanguages>
+    </PropertyGroup>
+
+  <!-- Set the Product and Version info for our own projects -->
+  <PropertyGroup>
+    <Product>Kavita</Product>
+    <Company>kareadita.github.io</Company>
+    <Copyright>Copyright 2020-$([System.DateTime]::Now.ToString('yyyy')) kavitareader.com (GNU General Public v3)</Copyright>
+
+    <AssemblyConfiguration>$(Configuration)-dev</AssemblyConfiguration>
+
+    <GenerateAssemblyFileVersionAttribute>false</GenerateAssemblyFileVersionAttribute>
+    <GenerateAssemblyInformationalVersionAttribute>false</GenerateAssemblyInformationalVersionAttribute>
+    <GenerateAssemblyConfigurationAttribute>false</GenerateAssemblyConfigurationAttribute>
+
+    <Deterministic Condition="$(AssemblyVersion.EndsWith('*'))">False</Deterministic>
+  </PropertyGroup>
+
+  <ItemGroup>
+      <PackageReference Include="AutoMapper" Version="13.0.1" />
+      <PackageReference Include="CsvHelper" Version="33.0.1" />
+      <PackageReference Include="Magick.NET-Q16-HDRI-AnyCPU" Version="13.10.0" />
+      <PackageReference Include="MailKit" Version="4.7.1.1" />
+      <PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="8.0.8">
+          <PrivateAssets>all</PrivateAssets>
+          <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
+      </PackageReference>
+    <PackageReference Include="Docnet.Core" Version="2.6.0" />
+    <PackageReference Include="EasyCaching.InMemory" Version="1.9.2" />
+    <PackageReference Include="ExCSS" Version="4.2.5" />
+    <PackageReference Include="Flurl" Version="4.0.0" />
+    <PackageReference Include="Flurl.Http" Version="4.0.2" />
+    <PackageReference Include="Hangfire" Version="1.8.14" />
+    <PackageReference Include="Hangfire.InMemory" Version="1.0.0" />
+    <PackageReference Include="Hangfire.MaximumConcurrentExecutions" Version="1.1.0" />
+    <PackageReference Include="Hangfire.Storage.SQLite" Version="0.4.2" />
+    <PackageReference Include="HtmlAgilityPack" Version="1.11.66" />
+    <PackageReference Include="MarkdownDeep.NET.Core" Version="1.5.0.4" />
+    <PackageReference Include="Hangfire.AspNetCore" Version="1.8.14" />
+    <PackageReference Include="Microsoft.AspNetCore.SignalR" Version="1.1.0" />
+    <PackageReference Include="Microsoft.AspNetCore.Authentication.JwtBearer" Version="8.0.8" />
+    <PackageReference Include="Microsoft.AspNetCore.Authentication.OpenIdConnect" Version="8.0.8" />
+    <PackageReference Include="Microsoft.AspNetCore.Identity.EntityFrameworkCore" Version="8.0.8" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="8.0.8" />
+    <PackageReference Include="Microsoft.Extensions.DependencyInjection" Version="8.0.0" />
+    <PackageReference Include="Microsoft.IO.RecyclableMemoryStream" Version="3.0.1" />
+    <PackageReference Include="MimeTypeMapOfficial" Version="1.0.17" />
+    <PackageReference Include="Nager.ArticleNumber" Version="1.0.7" />
+    <PackageReference Include="NReco.Logging.File" Version="1.2.1" />
+    <PackageReference Include="Serilog" Version="4.0.1" />
+    <PackageReference Include="Serilog.AspNetCore" Version="8.0.2" />
+    <PackageReference Include="Serilog.Enrichers.Thread" Version="4.0.0" />
+    <PackageReference Include="Serilog.Extensions.Hosting" Version="8.0.0" />
+    <PackageReference Include="Serilog.Settings.Configuration" Version="8.0.2" />
+    <PackageReference Include="Serilog.Sinks.AspNetCore.SignalR" Version="0.4.0" />
+    <PackageReference Include="Serilog.Sinks.Console" Version="6.0.0" />
+    <PackageReference Include="Serilog.Sinks.File" Version="6.0.0" />
+    <PackageReference Include="Serilog.Sinks.SignalR.Core" Version="0.1.2" />
+    <PackageReference Include="SharpCompress" Version="0.38.0" />
+    <PackageReference Include="SonarAnalyzer.CSharp" Version="9.32.0.97167">
+      <PrivateAssets>all</PrivateAssets>
+      <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
+    </PackageReference>
+    <PackageReference Include="Swashbuckle.AspNetCore" Version="6.7.3" />
+    <PackageReference Include="Swashbuckle.AspNetCore.Filters" Version="8.0.2" />
+    <PackageReference Include="System.IdentityModel.Tokens.Jwt" Version="8.0.2" />
+    <PackageReference Include="System.IO.Abstractions" Version="21.0.29" />
+    <PackageReference Include="System.Drawing.Common" Version="8.0.8" />
+    <PackageReference Include="VersOne.Epub" Version="3.3.2" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\Kavita.Common\Kavita.Common.csproj" />
+  </ItemGroup>
+
+
+
+  <ItemGroup>
+    <None Remove="Hangfire-log.db" />
+    <None Remove="obj\**" />
+    <None Remove="cache\**" />
+    <None Remove="backups\**" />
+    <None Remove="logs\**" />
+    <None Remove="temp\**" />
+    <None Remove="kavita.log" />
+    <None Remove="kavita.db" />
+    <None Remove="covers\**" />
+    <None Remove="wwwroot\**" />
+    <None Remove="config\cache\**" />
+    <None Remove="config\logs\**" />
+    <None Remove="config\covers\**" />
+    <None Remove="config\bookmarks\**" />
+    <None Remove="config\backups\**" />
+    <None Remove="config\temp\**" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <Compile Remove="obj\**" />
+    <Compile Remove="cache\**" />
+    <Compile Remove="backups\**" />
+    <Compile Remove="logs\**" />
+    <Compile Remove="temp\**" />
+    <Compile Remove="covers\**" />
+    <Compile Remove="wwwroot\**" />
+    <Compile Remove="config\cache\**" />
+    <Compile Remove="config\logs\**" />
+    <Compile Remove="config\covers\**" />
+    <Compile Remove="config\bookmarks\**" />
+    <Compile Remove="config\backups\**" />
+    <Compile Remove="config\temp\**" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <EmbeddedResource Remove="obj\**" />
+    <EmbeddedResource Remove="cache\**" />
+    <EmbeddedResource Remove="backups\**" />
+    <EmbeddedResource Remove="logs\**" />
+    <EmbeddedResource Remove="temp\**" />
+    <EmbeddedResource Remove="covers\**" />
+    <EmbeddedResource Remove="config\covers\**" />
+    <EmbeddedResource Remove="config\backups\**" />
+    <EmbeddedResource Remove="config\logs\**" />
+    <EmbeddedResource Remove="config\temp\**" />
+    <EmbeddedResource Remove="config\stats\**" />
+    <EmbeddedResource Remove="wwwroot\**" />
+    <EmbeddedResource Remove="config\cache\**" />
+    <EmbeddedResource Remove="config\bookmarks\**" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <Content Remove="obj\**" />
+    <Content Remove="cache\**" />
+    <Content Remove="backups\**" />
+    <Content Remove="logs\**" />
+    <Content Remove="temp\**" />
+    <Content Remove="config\stats\**" />
+    <Content Remove="config\cache\**" />
+    <Content Remove="config\backups\**" />
+    <Content Remove="config\logs\**" />
+    <Content Remove="config\temp\**" />
+    <Content Remove="config\stats\**" />
+    <Content Condition=" '$(Configuration)' == 'Release' " Remove="appsettings.Development.json" />
+    <Content Update="appsettings.json">
+      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
+    </Content>
+    <Content Remove="covers\**" />
+    <Content Remove="config\covers\**" />
+    <Content Update="bin\$(Configuration)\$(AssemblyName).xml">
+      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
+    </Content>
+    <Content Remove="config\bookmarks\**" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <Folder Include="config\themes" />
+    <Content Include="EmailTemplates\**">
+      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
+    </Content>
+    <Folder Include="Extensions\KavitaPlus\" />
+    <None Include="I18N\**" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <_DeploymentManifestIconFile Remove="favicon.ico" />
+  </ItemGroup>
+
+</Project>
diff --git a/API/Extensions/ApplicationServiceExtensions.cs b/API/Extensions/ApplicationServiceExtensions.cs
index 2f774f3e9..8b9740577 100644
--- a/API/Extensions/ApplicationServiceExtensions.cs
+++ b/API/Extensions/ApplicationServiceExtensions.cs
@@ -1,9 +1,8 @@
-using System.IO.Abstractions;
+using System.IO.Abstractions;
 using API.Constants;
 using API.Data;
 using API.Helpers;
 using API.Services;
-
 using API.Services.Plus;
 using API.Services.Tasks;
 using API.Services.Tasks.Metadata;
diff --git a/API/Extensions/FileTypeGroupExtensions.cs b/API/Extensions/FileTypeGroupExtensions.cs
index 254ff400d..cee41ca0d 100644
--- a/API/Extensions/FileTypeGroupExtensions.cs
+++ b/API/Extensions/FileTypeGroupExtensions.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using API.Entities.Enums;
 using API.Services.Tasks.Scanner.Parser;
 using MimeTypes;
diff --git a/API/Services/BookService.cs b/API/Services/BookService.cs
index 88f3cd11b..c9eb76c75 100644
--- a/API/Services/BookService.cs
+++ b/API/Services/BookService.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Collections.Generic;
 using System.Globalization;
 using System.IO;
diff --git a/API/Services/CacheService.cs b/API/Services/CacheService.cs
index 82ad11b0e..89c4ac36c 100644
--- a/API/Services/CacheService.cs
+++ b/API/Services/CacheService.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Collections.Concurrent;
 using System.Collections.Generic;
 using System.Diagnostics;
@@ -240,23 +240,23 @@ public void ExtractChapterFiles(string extractPath, IReadOnlyList<MangaFile>? fi
                     break;
                 case MangaFormat.Epub:
                 case MangaFormat.Pdf:
+                {
+                    if (!_directoryService.FileSystem.File.Exists(files[0].FilePath))
+                    {
+                        _logger.LogError("{File} does not exist on disk", files[0].FilePath);
+                        throw new KavitaException($"{files[0].FilePath} does not exist on disk");
+                    }
+                    if (extractPdfImages)
                     {
-                        if (!_directoryService.FileSystem.File.Exists(files[0].FilePath))
-                        {
-                            _logger.LogError("{File} does not exist on disk", files[0].FilePath);
-                            throw new KavitaException($"{files[0].FilePath} does not exist on disk");
-                        }
-                        if (extractPdfImages)
-                        {
-                            _readingItemService.Extract(file.FilePath, Path.Join(extractPath, extraPath), file.Format);
-                            break;
-                        }
-                        removeNonImages = false;
-
-                        _directoryService.ExistOrCreate(extractPath);
-                        _directoryService.CopyFileToDirectory(files[0].FilePath, extractPath);
+                        _readingItemService.Extract(file.FilePath, Path.Join(extractPath, extraPath), file.Format);
                         break;
                     }
+                    removeNonImages = false;
+
+                    _directoryService.ExistOrCreate(extractPath);
+                    _directoryService.CopyFileToDirectory(files[0].FilePath, extractPath);
+                    break;
+                }
             }
         }
 
diff --git a/API/Services/ImageService.cs b/API/Services/ImageService.cs
index ca0422b32..e05ec627e 100644
--- a/API/Services/ImageService.cs
+++ b/API/Services/ImageService.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Collections.Generic;
 using System.Drawing;
 using System.IO;

From 23a9aa860c21a43ada8bf3fb92b31fcfbe8f08ed Mon Sep 17 00:00:00 2001
From: Maximo Piva <mpiva@adventintermodal.com>
Date: Sat, 28 Sep 2024 00:42:06 -0300
Subject: [PATCH 19/30] Delete .bak

---
 API/API.csproj.bak | 204 ---------------------------------------------
 1 file changed, 204 deletions(-)
 delete mode 100644 API/API.csproj.bak

diff --git a/API/API.csproj.bak b/API/API.csproj.bak
deleted file mode 100644
index 169ddfab9..000000000
--- a/API/API.csproj.bak
+++ /dev/null
@@ -1,204 +0,0 @@
-<Project Sdk="Microsoft.NET.Sdk.Web">
-
-  <PropertyGroup>
-    <AnalysisMode>Default</AnalysisMode>
-    <TargetFramework>net8.0</TargetFramework>
-    <EnforceCodeStyleInBuild>true</EnforceCodeStyleInBuild>
-    <DockerDefaultTargetOS>Linux</DockerDefaultTargetOS>
-    <TieredPGO>true</TieredPGO>
-    <TieredCompilation>true</TieredCompilation>
-    <ApplicationIcon>../favicon.ico</ApplicationIcon>
-    <Nullable>warnings</Nullable>
-    <LangVersion>latestmajor</LangVersion>
-  </PropertyGroup>
-
-<!--  <Target Name="PostBuild" AfterTargets="Build" Condition=" '$(Configuration)' == 'Debug' ">-->
-<!--      <Delete Files="../openapi.json" />-->
-<!--      <Exec Command="swagger tofile &#45;&#45;output ../openapi.json bin/$(Configuration)/$(TargetFramework)/$(AssemblyName).dll v1" />-->
-<!--  </Target>-->
-
-  <PropertyGroup Condition=" '$(Configuration)' == 'Release' ">
-    <DebugSymbols>false</DebugSymbols>
-    <ApplicationIcon>../favicon.ico</ApplicationIcon>
-    <DocumentationFile>bin\$(Configuration)\$(AssemblyName).xml</DocumentationFile>
-  </PropertyGroup>
-
-  <PropertyGroup Condition=" '$(Configuration)' == 'Debug' ">
-    <DocumentationFile>bin\$(Configuration)\$(AssemblyName).xml</DocumentationFile>
-    <NoWarn>1701;1702;1591</NoWarn>
-  </PropertyGroup>
-
-    <!-- Ignore XML comments -->
-    <PropertyGroup>
-        <GenerateDocumentationFile>True</GenerateDocumentationFile>
-        <NoWarn>$(NoWarn);1591</NoWarn>
-    </PropertyGroup>
-
-    <PropertyGroup>
-        <SatelliteResourceLanguages>en</SatelliteResourceLanguages>
-    </PropertyGroup>
-
-  <!-- Set the Product and Version info for our own projects -->
-  <PropertyGroup>
-    <Product>Kavita</Product>
-    <Company>kareadita.github.io</Company>
-    <Copyright>Copyright 2020-$([System.DateTime]::Now.ToString('yyyy')) kavitareader.com (GNU General Public v3)</Copyright>
-
-    <AssemblyConfiguration>$(Configuration)-dev</AssemblyConfiguration>
-
-    <GenerateAssemblyFileVersionAttribute>false</GenerateAssemblyFileVersionAttribute>
-    <GenerateAssemblyInformationalVersionAttribute>false</GenerateAssemblyInformationalVersionAttribute>
-    <GenerateAssemblyConfigurationAttribute>false</GenerateAssemblyConfigurationAttribute>
-
-    <Deterministic Condition="$(AssemblyVersion.EndsWith('*'))">False</Deterministic>
-  </PropertyGroup>
-
-  <ItemGroup>
-      <PackageReference Include="AutoMapper" Version="13.0.1" />
-      <PackageReference Include="CsvHelper" Version="33.0.1" />
-      <PackageReference Include="Magick.NET-Q16-HDRI-AnyCPU" Version="13.10.0" />
-      <PackageReference Include="MailKit" Version="4.7.1.1" />
-      <PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="8.0.8">
-          <PrivateAssets>all</PrivateAssets>
-          <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
-      </PackageReference>
-    <PackageReference Include="Docnet.Core" Version="2.6.0" />
-    <PackageReference Include="EasyCaching.InMemory" Version="1.9.2" />
-    <PackageReference Include="ExCSS" Version="4.2.5" />
-    <PackageReference Include="Flurl" Version="4.0.0" />
-    <PackageReference Include="Flurl.Http" Version="4.0.2" />
-    <PackageReference Include="Hangfire" Version="1.8.14" />
-    <PackageReference Include="Hangfire.InMemory" Version="1.0.0" />
-    <PackageReference Include="Hangfire.MaximumConcurrentExecutions" Version="1.1.0" />
-    <PackageReference Include="Hangfire.Storage.SQLite" Version="0.4.2" />
-    <PackageReference Include="HtmlAgilityPack" Version="1.11.66" />
-    <PackageReference Include="MarkdownDeep.NET.Core" Version="1.5.0.4" />
-    <PackageReference Include="Hangfire.AspNetCore" Version="1.8.14" />
-    <PackageReference Include="Microsoft.AspNetCore.SignalR" Version="1.1.0" />
-    <PackageReference Include="Microsoft.AspNetCore.Authentication.JwtBearer" Version="8.0.8" />
-    <PackageReference Include="Microsoft.AspNetCore.Authentication.OpenIdConnect" Version="8.0.8" />
-    <PackageReference Include="Microsoft.AspNetCore.Identity.EntityFrameworkCore" Version="8.0.8" />
-    <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="8.0.8" />
-    <PackageReference Include="Microsoft.Extensions.DependencyInjection" Version="8.0.0" />
-    <PackageReference Include="Microsoft.IO.RecyclableMemoryStream" Version="3.0.1" />
-    <PackageReference Include="MimeTypeMapOfficial" Version="1.0.17" />
-    <PackageReference Include="Nager.ArticleNumber" Version="1.0.7" />
-    <PackageReference Include="NReco.Logging.File" Version="1.2.1" />
-    <PackageReference Include="Serilog" Version="4.0.1" />
-    <PackageReference Include="Serilog.AspNetCore" Version="8.0.2" />
-    <PackageReference Include="Serilog.Enrichers.Thread" Version="4.0.0" />
-    <PackageReference Include="Serilog.Extensions.Hosting" Version="8.0.0" />
-    <PackageReference Include="Serilog.Settings.Configuration" Version="8.0.2" />
-    <PackageReference Include="Serilog.Sinks.AspNetCore.SignalR" Version="0.4.0" />
-    <PackageReference Include="Serilog.Sinks.Console" Version="6.0.0" />
-    <PackageReference Include="Serilog.Sinks.File" Version="6.0.0" />
-    <PackageReference Include="Serilog.Sinks.SignalR.Core" Version="0.1.2" />
-    <PackageReference Include="SharpCompress" Version="0.38.0" />
-    <PackageReference Include="SonarAnalyzer.CSharp" Version="9.32.0.97167">
-      <PrivateAssets>all</PrivateAssets>
-      <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
-    </PackageReference>
-    <PackageReference Include="Swashbuckle.AspNetCore" Version="6.7.3" />
-    <PackageReference Include="Swashbuckle.AspNetCore.Filters" Version="8.0.2" />
-    <PackageReference Include="System.IdentityModel.Tokens.Jwt" Version="8.0.2" />
-    <PackageReference Include="System.IO.Abstractions" Version="21.0.29" />
-    <PackageReference Include="System.Drawing.Common" Version="8.0.8" />
-    <PackageReference Include="VersOne.Epub" Version="3.3.2" />
-  </ItemGroup>
-
-  <ItemGroup>
-    <ProjectReference Include="..\Kavita.Common\Kavita.Common.csproj" />
-  </ItemGroup>
-
-
-
-  <ItemGroup>
-    <None Remove="Hangfire-log.db" />
-    <None Remove="obj\**" />
-    <None Remove="cache\**" />
-    <None Remove="backups\**" />
-    <None Remove="logs\**" />
-    <None Remove="temp\**" />
-    <None Remove="kavita.log" />
-    <None Remove="kavita.db" />
-    <None Remove="covers\**" />
-    <None Remove="wwwroot\**" />
-    <None Remove="config\cache\**" />
-    <None Remove="config\logs\**" />
-    <None Remove="config\covers\**" />
-    <None Remove="config\bookmarks\**" />
-    <None Remove="config\backups\**" />
-    <None Remove="config\temp\**" />
-  </ItemGroup>
-
-  <ItemGroup>
-    <Compile Remove="obj\**" />
-    <Compile Remove="cache\**" />
-    <Compile Remove="backups\**" />
-    <Compile Remove="logs\**" />
-    <Compile Remove="temp\**" />
-    <Compile Remove="covers\**" />
-    <Compile Remove="wwwroot\**" />
-    <Compile Remove="config\cache\**" />
-    <Compile Remove="config\logs\**" />
-    <Compile Remove="config\covers\**" />
-    <Compile Remove="config\bookmarks\**" />
-    <Compile Remove="config\backups\**" />
-    <Compile Remove="config\temp\**" />
-  </ItemGroup>
-
-  <ItemGroup>
-    <EmbeddedResource Remove="obj\**" />
-    <EmbeddedResource Remove="cache\**" />
-    <EmbeddedResource Remove="backups\**" />
-    <EmbeddedResource Remove="logs\**" />
-    <EmbeddedResource Remove="temp\**" />
-    <EmbeddedResource Remove="covers\**" />
-    <EmbeddedResource Remove="config\covers\**" />
-    <EmbeddedResource Remove="config\backups\**" />
-    <EmbeddedResource Remove="config\logs\**" />
-    <EmbeddedResource Remove="config\temp\**" />
-    <EmbeddedResource Remove="config\stats\**" />
-    <EmbeddedResource Remove="wwwroot\**" />
-    <EmbeddedResource Remove="config\cache\**" />
-    <EmbeddedResource Remove="config\bookmarks\**" />
-  </ItemGroup>
-
-  <ItemGroup>
-    <Content Remove="obj\**" />
-    <Content Remove="cache\**" />
-    <Content Remove="backups\**" />
-    <Content Remove="logs\**" />
-    <Content Remove="temp\**" />
-    <Content Remove="config\stats\**" />
-    <Content Remove="config\cache\**" />
-    <Content Remove="config\backups\**" />
-    <Content Remove="config\logs\**" />
-    <Content Remove="config\temp\**" />
-    <Content Remove="config\stats\**" />
-    <Content Condition=" '$(Configuration)' == 'Release' " Remove="appsettings.Development.json" />
-    <Content Update="appsettings.json">
-      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
-    </Content>
-    <Content Remove="covers\**" />
-    <Content Remove="config\covers\**" />
-    <Content Update="bin\$(Configuration)\$(AssemblyName).xml">
-      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
-    </Content>
-    <Content Remove="config\bookmarks\**" />
-  </ItemGroup>
-
-  <ItemGroup>
-    <Folder Include="config\themes" />
-    <Content Include="EmailTemplates\**">
-      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
-    </Content>
-    <Folder Include="Extensions\KavitaPlus\" />
-    <None Include="I18N\**" />
-  </ItemGroup>
-
-  <ItemGroup>
-    <_DeploymentManifestIconFile Remove="favicon.ico" />
-  </ItemGroup>
-
-</Project>

From b6a986a685fbb56844d8a11501c13eba695f84f2 Mon Sep 17 00:00:00 2001
From: Maximo Piva <mpiva@adventintermodal.com>
Date: Sat, 28 Sep 2024 22:12:13 -0300
Subject: [PATCH 20/30] Bug fixes.

---
 API/Services/BookService.cs  | 11 +++++++++--
 API/Services/ImageService.cs |  2 +-
 2 files changed, 10 insertions(+), 3 deletions(-)

diff --git a/API/Services/BookService.cs b/API/Services/BookService.cs
index c9eb76c75..fc662b463 100644
--- a/API/Services/BookService.cs
+++ b/API/Services/BookService.cs
@@ -1276,10 +1276,17 @@ private static void GetPdfPage(IDocReader docReader, int pageNumber, Stream stre
     {
         using var pageReader = docReader.GetPageReader(pageNumber);
         var rawBytes = pageReader.GetImage(new NaiveTransparencyRemover());
-        var floats = rawBytes.Select(a=> (float)a*256F).ToArray();
+        var floats = new float[rawBytes.Length];
+        for (var i = 0; i < rawBytes.Length; i += 4)
+        {
+            floats[i] = rawBytes[i + 2] << 8;
+            floats[i + 1] = rawBytes[i + 1] << 8;
+            floats[i+2] = rawBytes[i] << 8;
+            floats[i+3] = rawBytes[i + 3] << 8;
+        }
         var width = pageReader.GetPageWidth();
         var height = pageReader.GetPageHeight();
-        using MagickImage image = new MagickImage(rawBytes, width, height,MagickFormat.Bgra);
+        MagickImage image = new MagickImage(MagickColor.FromRgba(0, 0, 0,0), width, height);
         using var pixels = image.GetPixels();
         pixels.SetArea(0,0,width, height, floats);
         stream.Seek(0, SeekOrigin.Begin);
diff --git a/API/Services/ImageService.cs b/API/Services/ImageService.cs
index e05ec627e..8c31a0dba 100644
--- a/API/Services/ImageService.cs
+++ b/API/Services/ImageService.cs
@@ -789,7 +789,7 @@ public string CreateThumbnailFromBase64(string encodedImage, string fileName, En
         try
         {
 
-            using var thumbnail = new MagickImage(Convert.FromBase64String(encodedImage));
+            using var thumbnail = MagickImage.FromBase64(encodedImage);
             int thumbnailHeight = (int)(thumbnail.Height * ((double)thumbnailWidth / thumbnail.Width));
             thumbnail.Thumbnail(thumbnailWidth, thumbnailHeight);
             fileName += encodeFormat.GetExtension();

From 9bf1fa8e128ce4eaafaf5748cb4c40877f2f2e50 Mon Sep 17 00:00:00 2001
From: Maximo Piva <mpiva@adventintermodal.com>
Date: Tue, 1 Oct 2024 18:47:43 -0300
Subject: [PATCH 21/30] Added SmartCrop (port from smartcrop.js)

---
 API.Tests/Services/ImageServiceTests.cs |   7 +-
 API/Helpers/SmartCropHelper.cs          | 546 ++++++++++++++++++++++++
 API/Services/ImageService.cs            |  33 +-
 3 files changed, 559 insertions(+), 27 deletions(-)
 create mode 100644 API/Helpers/SmartCropHelper.cs

diff --git a/API.Tests/Services/ImageServiceTests.cs b/API.Tests/Services/ImageServiceTests.cs
index 58f23d490..cd02891d9 100644
--- a/API.Tests/Services/ImageServiceTests.cs
+++ b/API.Tests/Services/ImageServiceTests.cs
@@ -59,11 +59,8 @@ private void GenerateFiles(string outputExtension)
         {
             var fileName = Path.GetFileNameWithoutExtension(imagePath);
             var dims = CoverImageSize.Default.GetDimensions();
-            using var thumbnail = new MagickImage(imagePath);
-
-            var size = ImageService.GetSizeForDimensions(thumbnail, dims.Width, dims.Height);
-            thumbnail.Thumbnail(size);
-
+            var thumbnail = new MagickImage(imagePath);
+            thumbnail = ImageService.Thumbnail(thumbnail, dims.Width, dims.Height);
             var outputFileName = fileName + outputExtension + ".png";
             thumbnail.Write(Path.Join(_testDirectory, outputFileName));
         }
diff --git a/API/Helpers/SmartCropHelper.cs b/API/Helpers/SmartCropHelper.cs
new file mode 100644
index 000000000..fdeb50f2f
--- /dev/null
+++ b/API/Helpers/SmartCropHelper.cs
@@ -0,0 +1,546 @@
+using System;
+using System.Collections.Generic;
+
+using System.Threading.Tasks;
+using ImageMagick;
+
+
+namespace API.Helpers
+{
+    /**
+     * C# port of smartcrop.js
+     * A javascript library implementing content aware image cropping
+     *
+     * Copyright (C) 2018 Jonas Wagner
+     *
+     * Permission is hereby granted, free of charge, to any person obtaining
+     * a copy of this software and associated documentation files (the
+     * "Software"), to deal in the Software without restriction, including
+     * without limitation the rights to use, copy, modify, merge, publish,
+     * distribute, sublicense, and/or sell copies of the Software, and to
+     * permit persons to whom the Software is furnished to do so, subject to
+     * the following conditions:
+     *
+     * The above copyright notice and this permission notice shall be
+     * included in all copies or substantial portions of the Software.
+     *
+     * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+     * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+     * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+     * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+     * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+     * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+     * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+     */
+
+    public static class SmartCropHelper
+    {
+
+        public static MagickGeometry SmartCrop(MagickImage inputImage, int width, int height)
+        {
+            SmartCropOptions options = new SmartCropOptions
+            {
+                Width = width,
+                Height = height
+            };
+            CropResult result = SmartCrop(inputImage, options);
+            return new MagickGeometry(result.TopCrop.X, result.TopCrop.Y, result.TopCrop.Width, result.TopCrop.Height) { FillArea = false };
+        }
+
+
+        public static CropResult SmartCrop(MagickImage inputImage, SmartCropOptions options = null)
+        {
+            if (options.Aspect != 0)
+            {
+                options.Width = (int)options.Aspect;
+                options.Height = 1;
+            }
+            var scale = 1.0f;
+            var prescale = 1.0f;
+
+            // Open the image
+            var image = (MagickImage)inputImage.Clone();
+            if (options.Width != 0 && options.Height != 0)
+            {
+                scale = Math.Min(image.Width / options.Width, image.Height / options.Height);
+                options.CropWidth = (int)(options.Width * scale);
+                options.CropHeight = (int)(options.Height * scale);
+                options.MinScale = Math.Min(options.MaxScale, Math.Max(1.0f / scale, options.MinScale));
+
+                // Prescale if possible
+                if (options.Prescale)
+                {
+                    prescale = Math.Min(Math.Max(256.0f / image.Width, 256.0f / image.Height), 1);
+                    if (prescale < 1)
+                    {
+                        // Resample the image
+                        image.Resize((int)(image.Width * prescale), (int)(image.Height * prescale));
+                        options.CropWidth = (int)(options.CropWidth * prescale);
+                        options.CropHeight = (int)(options.CropHeight * prescale);
+                        foreach (Boost boost in options.Boosts)
+                        {
+                            boost.X = (float)Math.Floor(boost.X * prescale);
+                            boost.Y = (float)Math.Floor(boost.Y * prescale);
+                            boost.Width = (float)Math.Floor(boost.Width * prescale);
+                            boost.Height = (float)Math.Floor(boost.Height * prescale);
+                        }
+                    }
+                }
+            }
+
+            var data = new ImageData(image);
+            var result = Analyse(options, data);
+
+            // Adjust for prescale
+            foreach (var crop in result.Crops)
+            {
+                crop.X = (int)(crop.X / prescale);
+                crop.Y = (int)(crop.Y / prescale);
+                crop.Width = (int)(crop.Width / prescale);
+                crop.Height = (int)(crop.Height / prescale);
+            }
+
+            return result;
+        }
+        private static CropResult Analyse(SmartCropOptions options, ImageData input)
+        {
+            CropResult result = new CropResult();
+            ImageData output = new ImageData(input.Width, input.Height);
+
+            EdgeDetect(input, output);
+            SkinDetect(options, input, output);
+            SaturationDetect(options, input, output);
+            ApplyBoosts(options, output);
+
+            var scoreOutput = DownSample(output, options.ScoreDownSample);
+
+            var topScore = double.NegativeInfinity;
+            Crop topCrop = null;
+            result.Crops = GenerateCrops(options, input.Width, input.Height);
+
+            foreach (var crop in result.Crops)
+            {
+                crop.Score = Score(options, scoreOutput, crop);
+                if (crop.Score.Total > topScore)
+                {
+                    topCrop = crop;
+                    topScore = crop.Score.Total;
+                }
+            }
+
+            result.TopCrop = topCrop;
+            return result;
+        }
+        private static float Thirds(double x)
+        {
+            x = (((x - 1.0 / 3.0 + 1.0) % 2.0) * 0.5 - 0.5) * 16.0;
+            return (float)Math.Max(1.0 - x * x, 0.0);
+        }
+        private static float Importance(SmartCropOptions options, Crop crop, double x, double y)
+        {
+            if (crop.X > x || x >= crop.X + crop.Width || crop.Y > y || y >= crop.Y + crop.Height)
+            {
+                return options.OutsideImportance;
+            }
+
+            x = (x - crop.X) / crop.Width;
+            y = (y - crop.Y) / crop.Height;
+            double px = Math.Abs(0.5 - x) * 2;
+            double py = Math.Abs(0.5 - y) * 2;
+
+            // Distance from edge
+            double dx = Math.Max(px - 1.0 + options.EdgeRadius, 0);
+            double dy = Math.Max(py - 1.0 + options.EdgeRadius, 0);
+            double d = (dx * dx + dy * dy) * options.EdgeWeight;
+            double s = 1.41 - Math.Sqrt(px * px + py * py);
+
+            if (options.RuleOfThirds)
+            {
+                s += Math.Max(0, s + d + 0.5) * 1.2 * (Thirds(px) + Thirds(py));
+            }
+
+            return (float)(s + d);
+        }
+        private static ScoreResult Score(SmartCropOptions options, ImageData output, Crop crop)
+        {
+
+
+            var od = output.Data;
+            var downSample = options.ScoreDownSample;
+            var invDownSample = 1.0 / downSample;
+            var outputHeightDownSample = output.Height * downSample;
+            var outputWidthDownSample = output.Width * downSample;
+            var outputWidth = output.Width;
+
+            double rskin = 0;
+            double rdetail = 0;
+            double rsaturation = 0;
+            double rboost = 0;
+            for (var y = 0; y < outputHeightDownSample; y += downSample)
+            {
+                for (var x = 0; x < outputWidthDownSample; x += downSample)
+                {
+                    var p = (int)((Math.Floor(y * invDownSample) * outputWidth + Math.Floor(x * invDownSample)) * 4);
+                    var i = Importance(options, crop, x, y);
+                    var detail = od[p + 1] / 255.0;
+
+                    rskin += (od[p] / 255.0) * (detail + options.SkinBias) * i;
+                    rdetail += detail * i;
+                    rsaturation += (od[p + 2] / 255.0) * (detail + options.SaturationBias) * i;
+                    rboost += (od[p + 3] / 255.0) * i;
+                }
+            }
+
+            return new ScoreResult
+            {
+                Detail = (float)rdetail,
+                Saturation = (float)rsaturation,
+                Skin = (float)rskin,
+                Boost = (float)rboost,
+                Total = (float)((rdetail * options.DetailWeight + rskin * options.SkinWeight +
+                                 rsaturation * options.SaturationWeight +
+                                 rboost * options.BoostWeight) /
+                                (double)(crop.Width * crop.Height))
+            };
+        }
+        private static void EdgeDetect(ImageData input, ImageData output)
+        {
+            // Get the pixel collection of both input and output images
+            float[] inputPixels = input.Data;
+            float[] outputPixels = output.Data;
+            
+            int width = input.Width;
+            int height = input.Height;
+
+            for (int y = 0; y < height; y++)
+            {
+                for (int x = 0; x < width; x++)
+                {
+                    int p = (y * width + x) * 4;
+                    float lightness;
+
+                    // Handle edge cases for pixels at the borders
+                    if (x == 0 || x >= width - 1 || y == 0 || y >= height - 1)
+                    {
+                        lightness = Sample(inputPixels, p);
+                    }
+                    else
+                    {
+                        lightness = Sample(inputPixels, p) * 4 -
+                                    Sample(inputPixels, p - width * 4) - // Above pixel
+                                    Sample(inputPixels, p - 4) - // Left pixel
+                                    Sample(inputPixels, p + 4) - // Right pixel
+                                    Sample(inputPixels, p + width * 4);  // Below pixel
+                    }
+
+                    outputPixels[p + 1] = lightness;
+                }
+            }
+        }
+        private static List<Crop> GenerateCrops(SmartCropOptions options, int width, int height)
+        {
+            var results = new List<Crop>();
+            var minDimension = Math.Min(width, height);
+            var cropWidth = options.CropWidth != 0 ? options.CropWidth : minDimension;
+            var cropHeight = options.CropHeight!=0 ? options.CropHeight : minDimension;
+
+            for (var scale = options.MaxScale; scale >= options.MinScale; scale -= options.ScaleStep)
+            {
+                for (var y = 0; y + cropHeight * scale <= height; y += options.Step)
+                {
+                    for (var x = 0; x + cropWidth * scale <= width; x += options.Step)
+                    {
+                        results.Add(new Crop
+                        {
+                            X = x,
+                            Y = y,
+                            Width = (int)Math.Round(cropWidth * scale),
+                            Height = (int)Math.Round(cropHeight * scale)
+                        });
+                    }
+                }
+            }
+
+            return results;
+        }
+        private static void ApplyBoosts(SmartCropOptions options, ImageData output)
+        {
+            if (options.Boosts.Count==0) return;
+            var od = output.Data;
+            for (int i = 0; i < output.Width; i += 4)
+            {
+                od[i + 3] = 0;
+            }
+            foreach(Boost boost in options.Boosts)
+            {
+                ApplyBoost(boost, options, output);
+            }
+        }
+        private static ImageData DownSample(ImageData input, int factor)
+        {
+            var idata = input.Data;
+            var iwidth = input.Width;
+            var width = (int)Math.Floor((double)input.Width / factor);
+            var height = (int)Math.Floor((double)input.Height / factor);
+            var output = new ImageData(width, height);
+            var data = output.Data;
+            var ifactor2 = 1.0 / (factor * factor);
+
+            for (var y = 0; y < height; y++)
+            {
+                for (var x = 0; x < width; x++)
+                {
+                    var i = (y * width + x) * 4;
+
+                    double r = 0, g = 0, b = 0, a = 0;
+                    double mr = 0, mg = 0;
+
+                    for (var v = 0; v < factor; v++)
+                    {
+                        for (var u = 0; u < factor; u++)
+                        {
+                            var j = ((y * factor + v) * iwidth + (x * factor + u)) * 4;
+                            r += idata[j];
+                            g += idata[j + 1];
+                            b += idata[j + 2];
+                            a += idata[j + 3];
+                            mr = Math.Max(mr, idata[j]);
+                            mg = Math.Max(mg, idata[j + 1]);
+                        }
+                    }
+
+                    data[i] = (byte)(r * ifactor2 * 0.5 + mr * 0.5);
+                    data[i + 1] = (byte)(g * ifactor2 * 0.7 + mg * 0.3);
+                    data[i + 2] = (byte)(b * ifactor2);
+                    data[i + 3] = (byte)(a * ifactor2);
+                }
+            }
+
+            return output;
+        }
+        private static void ApplyBoost(Boost boost, SmartCropOptions options, ImageData output)
+        {
+            var od = output.Data;
+            var w = output.Width;
+            var x0 = (int)(boost.X);
+            var x1 = (int)(boost.X + boost.Width);
+            var y0 = (int)(boost.Y);
+            var y1 = (int)(boost.Y + boost.Height);
+            var weight = boost.Weight * 255;
+            for (var y = y0; y < y1; y++)
+            {
+                for (var x = x0; x < x1; x++)
+                {
+                    var i = (y * w + x) * 4;
+                    od[i + 3] += weight;
+                }
+            }
+        }
+        private static void SaturationDetect(SmartCropOptions options, ImageData i, ImageData o)
+        {
+            var id = i.Data;
+            var od = o.Data;
+            var w = i.Width;
+            var h = i.Height;
+            for (var y = 0; y < h; y++)
+            {
+                for (var x = 0; x < w; x++)
+                {
+                    var p = (y * w + x) * 4;
+
+                    var lightness = CIE(id[p], id[p + 1], id[p + 2]) / 255;
+                    var sat = Saturation(id[p], id[p + 1], id[p + 2]);
+
+                    var acceptableSaturation = sat > options.SaturationThreshold;
+                    var acceptableLightness = lightness >= options.SaturationBrightnessMin && lightness <= options.SaturationBrightnessMax;
+                    if (acceptableLightness && acceptableSaturation)
+                    {
+                        od[p + 2] = (sat - options.SaturationThreshold) * (255 / (1 - options.SaturationThreshold));
+                    }
+                    else
+                    {
+                        od[p + 2] = 0;
+                    }
+                }
+            }
+        }
+        private static float Saturation(float r, float g, float b)
+        {
+            var maximum = Math.Max(r / 255f, Math.Max(g / 255f, b / 255f));
+            var minimum = Math.Min(r / 255f, Math.Min(g / 255f, b / 255f));
+
+            if (Math.Abs(maximum - minimum) < float.Epsilon)
+            {
+                return 0;
+            }
+
+            var l = (maximum + minimum) / 2;
+            var d = maximum - minimum;
+
+            return l > 0.5f ? d / (2.0f - maximum - minimum) : d / (maximum + minimum);
+        }
+        private static void  SkinDetect(SmartCropOptions options, ImageData i, ImageData o)
+        {
+            float[] id = i.Data;
+            float[] od = o.Data;
+            int w = i.Width;
+            int h = i.Height;
+
+            for (int y = 0; y < h; y++)
+            {
+                for (int x = 0; x < w; x++)
+                {
+                    int p = (y * w + x) * 4;
+                    float lightness = CIE(id[p], id[p + 1], id[p + 2]) / 255;
+                    float skin = SkinColor(options, id[p], id[p + 1], id[p + 2]);
+                    bool isSkinColor = skin > options.SkinThreshold;
+                    bool isSkinBrightness = lightness >= options.SkinBrightnessMin && lightness <= options.SkinBrightnessMax;
+                    if (isSkinColor && isSkinBrightness)
+                    {
+                        od[p] = (skin - options.SkinThreshold) * (255 / (1 - options.SkinThreshold));
+                    }
+                    else
+                    {
+                        od[p] = 0;
+                    }
+                }
+            }
+        }
+        private static float Sample(float[] data, int p)
+        {
+            return CIE(data[p], data[p + 1], data[p + 2]);
+        }
+        private static float CIE(float r, float g,  float b)
+        {
+            return 0.5126f * b + 0.7152f * g + 0.0722f * r;
+        }
+        private static float SkinColor(SmartCropOptions options, float r, float g, float b)
+        {
+            double mag = Math.Sqrt(r * r + g * g + b * b);
+            double rd = r / mag - options.SkinColor[0];
+            double gd = g / mag - options.SkinColor[1];
+            double bd = b / mag - options.SkinColor[2];
+            double d = Math.Sqrt(rd * rd + gd * gd + bd * bd);
+            return (float)(1.0 - d);
+        }
+        public class SmartCropOptions
+        {
+            public int Width { get; set; } = 0;
+            public int Height { get; set; } = 0;
+            public float Aspect { get; set; } = 0;
+            public int CropWidth { get; set; } = 0;
+            public int CropHeight { get; set; } = 0;
+            public float DetailWeight { get; set; } = 0.2f;
+            public float[] SkinColor { get; set; } = new float[] { 0.78f, 0.57f, 0.44f };
+            public float SkinBias { get; set; } = 0.01f;
+            public float SkinBrightnessMin { get; set; } = 0.2f;
+            public float SkinBrightnessMax { get; set; } = 1.0f;
+            public float SkinThreshold { get; set; } = 0.8f;
+            public float SkinWeight { get; set; } = 1.8f;
+            public float SaturationBrightnessMin { get; set; } = 0.05f;
+            public float SaturationBrightnessMax { get; set; } = 0.9f;
+            public float SaturationThreshold { get; set; } = 0.4f;
+            public float SaturationBias { get; set; } = 0.2f;
+            public float SaturationWeight { get; set; } = 0.1f;
+            public int ScoreDownSample { get; set; } = 8;
+            public int Step { get; set; } = 8;
+            public float ScaleStep { get; set; } = 0.1f;
+            public float MinScale { get; set; } = 1.0f;
+            public float MaxScale { get; set; } = 1.0f;
+            public float EdgeRadius { get; set; } = 0.4f;
+            public float EdgeWeight { get; set; } = -20.0f;
+            public float OutsideImportance { get; set; } = -0.5f;
+            public float BoostWeight { get; set; } = 100.0f;
+            public bool RuleOfThirds { get; set; } = true;
+            public bool Prescale { get; set; } = true;
+            public List<Boost> Boosts { get; set; } = new List<Boost>();
+        }
+        public class CropResult
+        {
+            public List<Crop> Crops { get; set; }
+            public Crop TopCrop { get; set; }
+        }
+        public class ScoreResult
+        {
+            public float Detail { get; set; }
+            public float Saturation { get; set; }
+            public float Skin { get; set; }
+            public float Boost { get; set; }
+            public float Total { get; set; }
+        }
+        public class Crop
+        {
+            public int X { get; set; }
+            public int Y { get; set; }
+            public int Width { get; set; }
+            public int Height { get; set; }
+
+            public ScoreResult Score { get; set; }
+        }
+        public class Boost
+        {
+            public float X { get; set; }
+            public float Y { get; set; }
+            public float Width { get; set; }
+            public float Height { get; set; }
+            public float Weight { get; set; }
+        }
+        public class ImageData
+        {
+            public int Width { get; set; }
+            public int Height { get; set; }
+            public float[] Data { get; set; }
+
+            public ImageData(int width, int height)
+            {
+                Width = width;
+                Height = height;
+                Data = new float[width * height * 4];
+            }
+
+            public ImageData(MagickImage image)
+            {
+                Width = image.Width;
+                Height = image.Height;
+                float scale = 1.0f / 256;
+                if (image.ChannelCount == 4)
+                {
+                    Data = image.GetPixels().GetValues();
+                    for (int x = 0; x < Data.Length; x++)
+                    {
+                        Data[x] *= scale;
+                    }
+                }
+                else if (image.ChannelCount == 3)
+                {
+                    float[] temp = image.GetPixels().GetValues();
+                    Data = new float[Width * Height * 4];
+                    int oi = 0;
+                    int ii = 0;
+                    for(int y = 0; y < Height*Width; y++)
+                    {
+
+                        Data[oi++] = temp[ii++] * scale;
+                        Data[oi++] = temp[ii++] * scale;
+                        Data[oi++] = temp[ii++] * scale;
+                        Data[oi++] = 255F;
+                    }
+                }
+                else if (image.ChannelCount == 1)
+                {
+                    float[] temp = image.GetPixels().GetValues();
+                    Data = new float[Width * Height * 4];
+                    int oi = 0;
+                    int ii = 0;
+                    for (int y = 0; y < Height * Width; y++)
+                    {
+                        Data[oi++] = temp[ii++] * scale;
+                        Data[oi++] = temp[oi-1];
+                        Data[oi++] = temp[oi-1];
+                        Data[oi++] = 255F;
+                    }
+                }
+            }
+        }
+    }
+}
diff --git a/API/Services/ImageService.cs b/API/Services/ImageService.cs
index 8c31a0dba..d2d4787cb 100644
--- a/API/Services/ImageService.cs
+++ b/API/Services/ImageService.cs
@@ -10,6 +10,7 @@
 using API.Entities.Enums;
 using API.Entities.Interfaces;
 using API.Extensions;
+using API.Helpers;
 using EasyCaching.Core;
 using Flurl;
 using Flurl.Http;
@@ -17,6 +18,7 @@
 using ImageMagick;
 using Kavita.Common;
 using Microsoft.Extensions.Logging;
+using static API.Helpers.SmartCropHelper;
 
 namespace API.Services;
 #nullable enable
@@ -155,26 +157,9 @@ public static MagickGeometry GetSizeForDimensions(MagickImage image, int targetW
         {
             /* Swallow */
         }
-
-        return new MagickGeometry(targetWidth, targetHeight) { IgnoreAspectRatio = true, FillArea = true };
+        return SmartCropHelper.SmartCrop(image, targetWidth, targetHeight);
     }
 
-    public static bool GetCropForDimensions(MagickImage image, int targetWidth, int targetHeight)
-    {
-        try
-        {
-            if (WillScaleWell(image, targetWidth, targetHeight) || IsLikelyWideImage(image.Width, image.Height))
-            {
-                return false;
-            }
-        } catch (Exception)
-        {
-            /* Swallow */
-            return false;
-        }
-
-        return true; //crop
-    }
 
     public static bool WillScaleWell(MagickImage sourceImage, int targetWidth, int targetHeight, double tolerance = 0.1)
     {
@@ -207,15 +192,19 @@ private static bool IsLikelyWideImage(int width, int height)
         return aspectRatio > 1.25;
     }
 
-    private MagickImage Thumbnail(string path, int width, int height)
+    public static MagickImage Thumbnail(string path, int width, int height)
     {
         var sourceImage = new MagickImage(path);
         return Thumbnail(sourceImage, width, height);
     }
-    private MagickImage Thumbnail(MagickImage sourceImage, int width, int height)
+    public static MagickImage Thumbnail(MagickImage sourceImage, int width, int height)
     {
         var geometry = GetSizeForDimensions(sourceImage, width, height);
-    
+        if (geometry.Width != width && geometry.Height != height)
+        {
+            sourceImage.Crop(geometry);
+            geometry = new MagickGeometry(width, height) { IgnoreAspectRatio = true };
+        }
         sourceImage.Thumbnail(geometry);
         return sourceImage;
     }
@@ -476,7 +465,7 @@ private static (Vector3?, Vector3?) GetPrimarySecondaryColors(string imagePath)
         im.Resize(new Percentage(10));
         // Convert image to RGB array
         float[] pixels = im.GetPixels().ToArray();
-        float mul = 1F / 255F;
+        float mul = 1F / 256F;
         var rgbPixels = new List<Vector3>();
         // Convert to list of Vector3 (RGB)
 

From 170c3b671f8537964cbad3696534e77cbb4443bf Mon Sep 17 00:00:00 2001
From: Maximo Piva <mpiva@adventintermodal.com>
Date: Thu, 3 Oct 2024 21:03:29 -0300
Subject: [PATCH 22/30] Refactor and cleanup.

---
 API.Benchmark/ArchiveServiceBenchmark.cs      |  27 +-
 API.Tests/Services/ArchiveServiceTests.cs     |  17 +-
 API.Tests/Services/BookServiceTests.cs        |   5 +-
 API.Tests/Services/CacheServiceTests.cs       |  16 +-
 API.Tests/Services/ImageServiceTests.cs       |  25 +-
 API/API.csproj                                |   2 +-
 API/Controllers/ImageController.cs            |   4 +-
 API/Controllers/OPDSController.cs             |   8 +-
 API/Controllers/ReaderController.cs           |  10 +-
 API/Entities/Enums/EncodeFormat.cs            |  10 +-
 .../ApplicationServiceExtensions.cs           |   6 +-
 API/Extensions/EncodeFormatExtensions.cs      |   3 +-
 API/Services/ArchiveService.cs                |   6 +-
 API/Services/BookService.cs                   |  24 +-
 API/Services/CacheService.cs                  |  24 +-
 API/Services/ImageConverterService.cs         |  82 ----
 API/Services/ImageService.cs                  | 443 +++++++++---------
 API/Services/ImageServices/IImage.cs          | 102 ++++
 API/Services/ImageServices/IImageFactory.cs   |  67 +++
 .../ImageMagick/ImageMagickImage.cs           | 227 +++++++++
 .../ImageMagick/ImageMagickImageFactory.cs    |  79 ++++
 .../ImageServices/SmartCrop.cs}               | 121 ++---
 API/Services/ReadingListService.cs            |   4 +-
 docker-build.sh                               |   2 +-
 24 files changed, 838 insertions(+), 476 deletions(-)
 delete mode 100644 API/Services/ImageConverterService.cs
 create mode 100644 API/Services/ImageServices/IImage.cs
 create mode 100644 API/Services/ImageServices/IImageFactory.cs
 create mode 100644 API/Services/ImageServices/ImageMagick/ImageMagickImage.cs
 create mode 100644 API/Services/ImageServices/ImageMagick/ImageMagickImageFactory.cs
 rename API/{Helpers/SmartCropHelper.cs => Services/ImageServices/SmartCrop.cs} (83%)

diff --git a/API.Benchmark/ArchiveServiceBenchmark.cs b/API.Benchmark/ArchiveServiceBenchmark.cs
index d8e61fca4..e975bd00f 100644
--- a/API.Benchmark/ArchiveServiceBenchmark.cs
+++ b/API.Benchmark/ArchiveServiceBenchmark.cs
@@ -1,14 +1,17 @@
-using System;
+using System;
 using System.IO;
 using System.IO.Abstractions;
+using API.Entities.Enums;
 using Microsoft.Extensions.Logging.Abstractions;
 using API.Services;
+using API.Services.ImageServices;
+using API.Services.ImageServices.ImageMagick;
 using BenchmarkDotNet.Attributes;
 using BenchmarkDotNet.Order;
 using EasyCaching.Core;
-using ImageMagick;
 using NSubstitute;
 
+
 namespace API.Benchmark;
 
 [StopOnFirstError]
@@ -21,14 +24,16 @@ public class ArchiveServiceBenchmark
     private readonly ArchiveService _archiveService;
     private readonly IDirectoryService _directoryService;
     private readonly IImageService _imageService;
+    private readonly IImageFactory _imageFactory;
     private const string SourceImage = "C:/Users/josep/Pictures/obey_by_grrsa-d6llkaa_colored_by_me.png";
 
 
     public ArchiveServiceBenchmark()
     {
         _directoryService = new DirectoryService(null, new FileSystem());
-        _imageService = new ImageService(null, _directoryService, Substitute.For<IEasyCachingProviderFactory>(), Substitute.For<IImageConverterService>());
+        _imageService = new ImageService(null, _directoryService, Substitute.For<IEasyCachingProviderFactory>(), Substitute.For<IImageFactory>());
         _archiveService = new ArchiveService(new NullLogger<ArchiveService>(), _directoryService, _imageService, Substitute.For<IMediaErrorService>());
+        _imageFactory = new ImageMagickImageFactory();
     }
 
     [Benchmark(Baseline = true)]
@@ -62,11 +67,11 @@ public void ImageSharp_ExtractImage_PNG()
         _directoryService.ExistOrCreate(outputDirectory);
 
         using var stream = new FileStream(SourceImage, FileMode.Open);
-        using var thumbnail2 = new MagickImage(stream);
+        using var thumbnail2 = _imageFactory.Create(stream);
         int width = 320;
         int height = (int)(thumbnail2.Height * (width / (double)thumbnail2.Width));
         thumbnail2.Thumbnail(width, height);
-        thumbnail2.Write(_directoryService.FileSystem.Path.Join(outputDirectory, "imagesharp.png"));
+        thumbnail2.Save(_directoryService.FileSystem.Path.Join(outputDirectory, "imagesharp.png"), EncodeFormat.PNG, 100);
     }
 
     [Benchmark]
@@ -76,11 +81,11 @@ public void ImageSharp_ExtractImage_WebP()
         _directoryService.ExistOrCreate(outputDirectory);
 
         using var stream = new FileStream(SourceImage, FileMode.Open);
-        using var thumbnail2 = new MagickImage(stream);
+        using var thumbnail2 = _imageFactory.Create(stream);
         int width = 320;
         int height = (int)(thumbnail2.Height * (width / (double)thumbnail2.Width));
         thumbnail2.Thumbnail(width, height);
-        thumbnail2.Write(_directoryService.FileSystem.Path.Join(outputDirectory, "imagesharp.webp"));
+        thumbnail2.Save(_directoryService.FileSystem.Path.Join(outputDirectory, "imagesharp.webp"), EncodeFormat.PNG, 100);
     }
 
     [Benchmark]
@@ -90,11 +95,11 @@ public void NetVips_ExtractImage_PNG()
         _directoryService.ExistOrCreate(outputDirectory);
 
         using var stream = new FileStream(SourceImage, FileMode.Open);
-        using var thumbnail = new MagickImage(stream);
+        using var thumbnail = _imageFactory.Create(stream);
         int width = 320;
         int height = (int)(thumbnail.Height * (width / (double)thumbnail.Width));
         thumbnail.Thumbnail(width, height);
-        thumbnail.Write(_directoryService.FileSystem.Path.Join(outputDirectory, "netvips.png"));
+        thumbnail.Save(_directoryService.FileSystem.Path.Join(outputDirectory, "netvips.png"), EncodeFormat.PNG, 100);
     }
 
     [Benchmark]
@@ -104,11 +109,11 @@ public void NetVips_ExtractImage_WebP()
         _directoryService.ExistOrCreate(outputDirectory);
 
         using var stream = new FileStream(SourceImage, FileMode.Open);
-        using var thumbnail = new MagickImage(stream);
+        using var thumbnail = _imageFactory.Create(stream);
         int width = 320;
         int height = (int)(thumbnail.Height * (width / (double)thumbnail.Width));
         thumbnail.Thumbnail(width, height);
-        thumbnail.Write(_directoryService.FileSystem.Path.Join(outputDirectory, "netvips.webp"));
+        thumbnail.Save(_directoryService.FileSystem.Path.Join(outputDirectory, "netvips.webp"), EncodeFormat.WEBP, 100);
     }
 
     // Benchmark to test default GetNumberOfPages from archive
diff --git a/API.Tests/Services/ArchiveServiceTests.cs b/API.Tests/Services/ArchiveServiceTests.cs
index f6e843f2d..7f0a9b7b7 100644
--- a/API.Tests/Services/ArchiveServiceTests.cs
+++ b/API.Tests/Services/ArchiveServiceTests.cs
@@ -1,4 +1,4 @@
-using System.Diagnostics;
+using System.Diagnostics;
 using System.IO;
 using System.IO.Abstractions;
 using System.IO.Abstractions.TestingHelpers;
@@ -7,8 +7,9 @@
 using API.Archive;
 using API.Entities.Enums;
 using API.Services;
+using API.Services.ImageServices;
+using API.Services.ImageServices.ImageMagick;
 using EasyCaching.Core;
-using ImageMagick;
 using Microsoft.Extensions.Logging;
 using NSubstitute;
 using NSubstitute.Extensions;
@@ -29,7 +30,7 @@ public ArchiveServiceTests(ITestOutputHelper testOutputHelper)
     {
         _testOutputHelper = testOutputHelper;
         _archiveService = new ArchiveService(_logger, _directoryService,
-            new ImageService(Substitute.For<ILogger<ImageService>>(), _directoryService, Substitute.For<IEasyCachingProviderFactory>(), Substitute.For<IImageConverterService>()),
+            new ImageService(Substitute.For<ILogger<ImageService>>(), _directoryService, Substitute.For<IEasyCachingProviderFactory>(), Substitute.For<IImageFactory>()),
             Substitute.For<IMediaErrorService>());
     }
 
@@ -167,16 +168,16 @@ public void FindFirstEntry(string[] files, string expected)
     public void GetCoverImage_Default_Test(string inputFile, string expectedOutputFile)
     {
         var ds = Substitute.For<DirectoryService>(_directoryServiceLogger, new FileSystem());
-        var imageService = new ImageService(Substitute.For<ILogger<ImageService>>(), ds, Substitute.For<IEasyCachingProviderFactory>(), Substitute.For<IImageConverterService>());
+        var imageService = new ImageService(Substitute.For<ILogger<ImageService>>(), ds, Substitute.For<IEasyCachingProviderFactory>(), new ImageMagickImageFactory());
         var archiveService =  Substitute.For<ArchiveService>(_logger, ds, imageService, Substitute.For<IMediaErrorService>());
 
         var testDirectory = Path.GetFullPath(Path.Join(Directory.GetCurrentDirectory(), "../../../Services/Test Data/ArchiveService/CoverImages"));
-        using var thumbnail = new MagickImage(Path.Join(testDirectory, expectedOutputFile));
+        using var thumbnail = imageService.ImageFactory.Create(Path.Join(testDirectory, expectedOutputFile));
         int width = 320;
         int height = (int)(thumbnail.Height * (width / (double)thumbnail.Width));
         thumbnail.Thumbnail(width, height);
         using MemoryStream stream = new MemoryStream();
-        thumbnail.Write(stream, MagickFormat.Png32);
+        thumbnail.Save(stream, EncodeFormat.PNG, 100);
         var expectedBytes = stream.ToArray();
 
         archiveService.Configure().CanOpen(Path.Join(testDirectory, inputFile)).Returns(ArchiveLibrary.Default);
@@ -204,7 +205,7 @@ public void GetCoverImage_Default_Test(string inputFile, string expectedOutputFi
     [InlineData("sorting.zip", "sorting.expected.png")]
     public void GetCoverImage_SharpCompress_Test(string inputFile, string expectedOutputFile)
     {
-        var imageService = new ImageService(Substitute.For<ILogger<ImageService>>(), _directoryService, Substitute.For<IEasyCachingProviderFactory>(), Substitute.For<IImageConverterService>());
+        var imageService = new ImageService(Substitute.For<ILogger<ImageService>>(), _directoryService, Substitute.For<IEasyCachingProviderFactory>(), Substitute.For<IImageFactory>());
         var archiveService =  Substitute.For<ArchiveService>(_logger,
             new DirectoryService(_directoryServiceLogger, new FileSystem()), imageService,
             Substitute.For<IMediaErrorService>());
@@ -230,7 +231,7 @@ public void GetCoverImage_SharpCompress_Test(string inputFile, string expectedOu
     public void CanParseCoverImage(string inputFile)
     {
         var imageService = Substitute.For<IImageService>();
-        imageService.WriteCoverThumbnail(Arg.Any<string>(), Arg.Any<Stream>(), Arg.Any<string>(), Arg.Any<string>(), Arg.Any<EncodeFormat>())
+        imageService.WriteCoverThumbnail(Arg.Any<Stream>(), Arg.Any<string>(), Arg.Any<string>(), Arg.Any<EncodeFormat>())
             .Returns(x => "cover.jpg");
         var archiveService = new ArchiveService(_logger, _directoryService, imageService, Substitute.For<IMediaErrorService>());
         var testDirectory = Path.Join(Directory.GetCurrentDirectory(), "../../../Services/Test Data/ArchiveService/");
diff --git a/API.Tests/Services/BookServiceTests.cs b/API.Tests/Services/BookServiceTests.cs
index b24085bde..48245e639 100644
--- a/API.Tests/Services/BookServiceTests.cs
+++ b/API.Tests/Services/BookServiceTests.cs
@@ -1,6 +1,7 @@
-using System.IO;
+using System.IO;
 using System.IO.Abstractions;
 using API.Services;
+using API.Services.ImageServices;
 using EasyCaching.Core;
 using Microsoft.Extensions.Logging;
 using NSubstitute;
@@ -17,7 +18,7 @@ public BookServiceTests()
     {
         var directoryService = new DirectoryService(Substitute.For<ILogger<DirectoryService>>(), new FileSystem());
         _bookService = new BookService(_logger, directoryService,
-            new ImageService(Substitute.For<ILogger<ImageService>>(), directoryService, Substitute.For<IEasyCachingProviderFactory>(), Substitute.For<IImageConverterService>())
+            new ImageService(Substitute.For<ILogger<ImageService>>(), directoryService, Substitute.For<IEasyCachingProviderFactory>(), Substitute.For<IImageFactory>())
             , Substitute.For<IMediaErrorService>());
     }
 
diff --git a/API.Tests/Services/CacheServiceTests.cs b/API.Tests/Services/CacheServiceTests.cs
index 45a86d04f..2bc18f8b6 100644
--- a/API.Tests/Services/CacheServiceTests.cs
+++ b/API.Tests/Services/CacheServiceTests.cs
@@ -1,4 +1,4 @@
-using System.Collections.Generic;
+using System.Collections.Generic;
 using System.Data.Common;
 using System.IO;
 using System.IO.Abstractions.TestingHelpers;
@@ -158,7 +158,7 @@ public async Task Ensure_DirectoryAlreadyExists_DontExtractAnything()
             new ReadingItemService(Substitute.For<IArchiveService>(),
                 Substitute.For<IBookService>(),
                 Substitute.For<IImageService>(), ds, Substitute.For<ILogger<ReadingItemService>>()),
-            Substitute.For<IBookmarkService>(), Substitute.For<IImageConverterService>());
+            Substitute.For<IBookmarkService>(), Substitute.For<IImageService>());
 
         await ResetDB();
         var s = new SeriesBuilder("Test").Build();
@@ -234,7 +234,7 @@ public void CleanupChapters_AllFilesShouldBeDeleted()
         var cleanupService = new CacheService(_logger, _unitOfWork, ds,
             new ReadingItemService(Substitute.For<IArchiveService>(),
                 Substitute.For<IBookService>(), Substitute.For<IImageService>(), ds, Substitute.For<ILogger<ReadingItemService>>()),
-            Substitute.For<IBookmarkService>(), Substitute.For<IImageConverterService>());
+            Substitute.For<IBookmarkService>(), Substitute.For<IImageService>());
 
         cleanupService.CleanupChapters(new []{1, 3});
         Assert.Empty(ds.GetFiles(CacheDirectory, searchOption:SearchOption.AllDirectories));
@@ -256,7 +256,7 @@ public void GetCachedEpubFile_ShouldReturnFirstEpub()
         var cs = new CacheService(_logger, _unitOfWork, ds,
             new ReadingItemService(Substitute.For<IArchiveService>(),
                 Substitute.For<IBookService>(), Substitute.For<IImageService>(), ds, Substitute.For<ILogger<ReadingItemService>>()),
-            Substitute.For<IBookmarkService>(), Substitute.For<IImageConverterService>());
+            Substitute.For<IBookmarkService>(), Substitute.For<IImageService>());
 
         var c = new ChapterBuilder("1")
             .WithFile(new MangaFileBuilder($"{DataDirectory}1.epub", MangaFormat.Epub).Build())
@@ -297,7 +297,7 @@ public void GetCachedPagePath_ReturnNullIfNoFiles()
         var cs = new CacheService(_logger, _unitOfWork, ds,
             new ReadingItemService(Substitute.For<IArchiveService>(),
                 Substitute.For<IBookService>(), Substitute.For<IImageService>(), ds, Substitute.For<ILogger<ReadingItemService>>()),
-            Substitute.For<IBookmarkService>(),Substitute.For<IImageConverterService>());
+            Substitute.For<IBookmarkService>(),Substitute.For<IImageService>());
 
         // Flatten to prepare for how GetFullPath expects
         ds.Flatten($"{CacheDirectory}1/");
@@ -341,7 +341,7 @@ public void GetCachedPagePath_GetFileFromFirstFile()
         var cs = new CacheService(_logger, _unitOfWork, ds,
             new ReadingItemService(Substitute.For<IArchiveService>(),
                 Substitute.For<IBookService>(), Substitute.For<IImageService>(), ds, Substitute.For<ILogger<ReadingItemService>>()),
-            Substitute.For<IBookmarkService>(), Substitute.For<IImageConverterService>());
+            Substitute.For<IBookmarkService>(), Substitute.For<IImageService>());
 
         // Flatten to prepare for how GetFullPath expects
         ds.Flatten($"{CacheDirectory}1/");
@@ -382,7 +382,7 @@ public void GetCachedPagePath_GetLastPageFromSingleFile()
         var cs = new CacheService(_logger, _unitOfWork, ds,
             new ReadingItemService(Substitute.For<IArchiveService>(),
                 Substitute.For<IBookService>(), Substitute.For<IImageService>(), ds, Substitute.For<ILogger<ReadingItemService>>()),
-            Substitute.For<IBookmarkService>(), Substitute.For<IImageConverterService>());
+            Substitute.For<IBookmarkService>(), Substitute.For<IImageService>());
 
         // Flatten to prepare for how GetFullPath expects
         ds.Flatten($"{CacheDirectory}1/");
@@ -427,7 +427,7 @@ public void GetCachedPagePath_GetFileFromSecondFile()
         var cs = new CacheService(_logger, _unitOfWork, ds,
             new ReadingItemService(Substitute.For<IArchiveService>(),
                 Substitute.For<IBookService>(), Substitute.For<IImageService>(), ds, Substitute.For<ILogger<ReadingItemService>>()),
-            Substitute.For<IBookmarkService>(), Substitute.For<IImageConverterService>());
+            Substitute.For<IBookmarkService>(), Substitute.For<IImageService>());
 
         // Flatten to prepare for how GetFullPath expects
         ds.Flatten($"{CacheDirectory}1/");
diff --git a/API.Tests/Services/ImageServiceTests.cs b/API.Tests/Services/ImageServiceTests.cs
index cd02891d9..3f63228e6 100644
--- a/API.Tests/Services/ImageServiceTests.cs
+++ b/API.Tests/Services/ImageServiceTests.cs
@@ -1,12 +1,12 @@
-using System.Drawing;
+using System.Drawing;
 using System.IO;
 using System.IO.Abstractions;
 using System.Linq;
 using System.Text;
 using API.Entities.Enums;
 using API.Services;
+using API.Services.ImageServices.ImageMagick;
 using EasyCaching.Core;
-using ImageMagick;
 using Microsoft.Extensions.Logging;
 using NSubstitute;
 using Xunit;
@@ -55,14 +55,15 @@ private void GenerateFiles(string outputExtension)
             .ToList();
 
         // Step 3: Process each image
+        ImageMagickImageFactory factory = new ImageMagickImageFactory();
         foreach (var imagePath in imageFiles)
         {
             var fileName = Path.GetFileNameWithoutExtension(imagePath);
             var dims = CoverImageSize.Default.GetDimensions();
-            var thumbnail = new MagickImage(imagePath);
+            var thumbnail = factory.Create(imagePath);
             thumbnail = ImageService.Thumbnail(thumbnail, dims.Width, dims.Height);
             var outputFileName = fileName + outputExtension + ".png";
-            thumbnail.Write(Path.Join(_testDirectory, outputFileName));
+            thumbnail.Save(Path.Join(_testDirectory, outputFileName), EncodeFormat.PNG,100);
         }
     }
 
@@ -72,6 +73,7 @@ private void GenerateHtmlFile()
             .Where(file => !file.EndsWith("html"))
             .Where(file => !file.Contains(OutputPattern) && !file.Contains(BaselinePattern))
             .ToList();
+        ImageMagickImageFactory factory = new ImageMagickImageFactory();
 
         var htmlBuilder = new StringBuilder();
         htmlBuilder.AppendLine("<!DOCTYPE html>");
@@ -97,7 +99,7 @@ private void GenerateHtmlFile()
             var outputPath = Path.Combine(_testDirectory, fileName + "_output.png");
             var dims = CoverImageSize.Default.GetDimensions();
 
-            using var sourceImage = new MagickImage(imagePath);
+            using var sourceImage = factory.Create(imagePath);
             htmlBuilder.AppendLine("<div class=\"image-row\">");
             htmlBuilder.AppendLine($"<p>{fileName} ({((double) sourceImage.Width / sourceImage.Height).ToString("F2")}) - {ImageService.WillScaleWell(sourceImage, dims.Width, dims.Height)}</p>");
             htmlBuilder.AppendLine($"<img src=\"./{Path.GetFileName(imagePath)}\" alt=\"{fileName}\">");
@@ -136,11 +138,16 @@ public void TestColorScapes()
             .Where(file => !file.Contains(OutputPattern) && !file.Contains(BaselinePattern))
             .ToList();
 
+        var factory = LoggerFactory.Create(builder => { builder.AddConsole(); });
+        var logger = factory.CreateLogger<ImageService>();
+
+        ImageService service = new ImageService(logger, null, null, new ImageMagickImageFactory());
+
         // Step 3: Process each image
         foreach (var imagePath in imageFiles)
         {
             var fileName = Path.GetFileNameWithoutExtension(imagePath);
-            var colors = ImageService.CalculateColorScape(imagePath);
+            var colors = service.CalculateColorScape(imagePath);
 
             // Generate primary color image
             GenerateColorImage(colors.Primary, Path.Combine(_testDirectoryColorScapes, $"{fileName}_primary_output.png"));
@@ -156,10 +163,10 @@ public void TestColorScapes()
 
     private static void GenerateColorImage(string hexColor, string outputPath)
     {
+        ImageMagickImageFactory factory = new ImageMagickImageFactory();
         var color = ImageService.HexToRgb(hexColor);
-        using var colorImage =
-            new MagickImage(MagickColor.FromRgb(color.R, color.G, color.B), 200, 100);
-        colorImage.Write(outputPath);
+        using var colorImage = factory.Create(200,100,color.R, color.G, color.B);
+        colorImage.Save(outputPath, EncodeFormat.PNG, 100);
     }
 
     private void GenerateHtmlFileForColorScape()
diff --git a/API/API.csproj b/API/API.csproj
index 3729b9689..169ddfab9 100644
--- a/API/API.csproj
+++ b/API/API.csproj
@@ -1,4 +1,4 @@
-<Project Sdk="Microsoft.NET.Sdk.Web">
+<Project Sdk="Microsoft.NET.Sdk.Web">
 
   <PropertyGroup>
     <AnalysisMode>Default</AnalysisMode>
diff --git a/API/Controllers/ImageController.cs b/API/Controllers/ImageController.cs
index 6275c6d4c..5a0379879 100644
--- a/API/Controllers/ImageController.cs
+++ b/API/Controllers/ImageController.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.IO;
 using System.Linq;
 using System.Threading.Tasks;
@@ -171,7 +171,7 @@ private async Task<string> GenerateCollectionCoverImage(int collectionId)
         var settings = await _unitOfWork.SettingsRepository.GetSettingsDtoAsync();
         destFile += settings.EncodeMediaAs.GetExtension();
         if (_directoryService.FileSystem.File.Exists(destFile)) return destFile;
-        ImageService.CreateMergedImage(
+        _imageService.CreateMergedImage(
             covers.Select(c => _directoryService.FileSystem.Path.Join(_directoryService.CoverImageDirectory, c)).ToList(),
             settings.CoverImageSize,
             destFile);
diff --git a/API/Controllers/OPDSController.cs b/API/Controllers/OPDSController.cs
index 1ef56b8bf..dd5aaf2a7 100644
--- a/API/Controllers/OPDSController.cs
+++ b/API/Controllers/OPDSController.cs
@@ -43,7 +43,7 @@ public class OpdsController : BaseApiController
     private readonly ISeriesService _seriesService;
     private readonly IAccountService _accountService;
     private readonly ILocalizationService _localizationService;
-    private readonly IImageConverterService _converterService;
+    private readonly IImageService _imageService;
     private readonly IMapper _mapper;
 
 
@@ -82,7 +82,7 @@ public OpdsController(IUnitOfWork unitOfWork, IDownloadService downloadService,
         IDirectoryService directoryService, ICacheService cacheService,
         IReaderService readerService, ISeriesService seriesService,
         IAccountService accountService, ILocalizationService localizationService,
-        IImageConverterService converterService,
+        IImageService imageService,
         IMapper mapper)
     {
         _unitOfWork = unitOfWork;
@@ -93,7 +93,7 @@ public OpdsController(IUnitOfWork unitOfWork, IDownloadService downloadService,
         _seriesService = seriesService;
         _accountService = accountService;
         _localizationService = localizationService;
-        _converterService = converterService;
+        _imageService = imageService;
         _mapper = mapper;
 
         _xmlSerializer = new XmlSerializer(typeof(Feed));
@@ -1245,7 +1245,7 @@ public async Task<ActionResult> GetPageStreamedImage(string apiKey, [FromQuery]
             var path = _cacheService.GetCachedPagePath(chapter.Id, pageNumber);
             if (string.IsNullOrEmpty(path) || !System.IO.File.Exists(path))
                 return BadRequest(await _localizationService.Translate(userId, "no-image-for-page", pageNumber));
-            path = _converterService.ConvertFile(path, Request.SupportedImageTypesFromRequest());
+            path = _imageService.ReplaceImageFileFormat(path, Request.SupportedImageTypesFromRequest());
             var content = await _directoryService.ReadFileAsync(path);
             var format = Path.GetExtension(path);
 
diff --git a/API/Controllers/ReaderController.cs b/API/Controllers/ReaderController.cs
index 973085c02..e8ad2d8ba 100644
--- a/API/Controllers/ReaderController.cs
+++ b/API/Controllers/ReaderController.cs
@@ -42,7 +42,7 @@ public class ReaderController : BaseApiController
     private readonly IEventHub _eventHub;
     private readonly IScrobblingService _scrobblingService;
     private readonly ILocalizationService _localizationService;
-    private readonly IImageConverterService _converterService;
+    private readonly IImageService _imageService;
 
     /// <inheritdoc />
     public ReaderController(ICacheService cacheService,
@@ -51,7 +51,7 @@ public ReaderController(ICacheService cacheService,
         IAccountService accountService, IEventHub eventHub,
         IScrobblingService scrobblingService,
         ILocalizationService localizationService,
-        IImageConverterService converterService)
+        IImageService imageService)
     {
         _cacheService = cacheService;
         _unitOfWork = unitOfWork;
@@ -62,7 +62,7 @@ public ReaderController(ICacheService cacheService,
         _eventHub = eventHub;
         _scrobblingService = scrobblingService;
         _localizationService = localizationService;
-        _converterService = converterService;
+        _imageService = imageService;
     }
 
     /// <summary>
@@ -124,7 +124,7 @@ public async Task<ActionResult> GetImage(int chapterId, int page, string apiKey,
             var path = _cacheService.GetCachedPagePath(chapter.Id, page);
             if (string.IsNullOrEmpty(path) || !System.IO.File.Exists(path))
                 return BadRequest(await _localizationService.Translate(userId, "no-image-for-page", page));
-            path = _converterService.ConvertFile(path, Request.SupportedImageTypesFromRequest());
+            path = _imageService.ReplaceImageFileFormat(path, Request.SupportedImageTypesFromRequest());
             var format = Path.GetExtension(path);
 
             return PhysicalFile(path, format.GetMimeType(), Path.GetFileName(path), true);
@@ -188,7 +188,7 @@ public async Task<ActionResult> GetBookmarkImage(int seriesId, string apiKey, in
         {
             var path = _cacheService.GetCachedBookmarkPagePath(seriesId, page);
             if (string.IsNullOrEmpty(path) || !System.IO.File.Exists(path)) return BadRequest(await _localizationService.Translate(userId, "no-image-for-page", page));
-            path = _converterService.ConvertFile(path, Request.SupportedImageTypesFromRequest());
+            path = _imageService.ReplaceImageFileFormat(path, Request.SupportedImageTypesFromRequest());
             var format = Path.GetExtension(path);
 
             return PhysicalFile(path, format.GetMimeType(), Path.GetFileName(path));
diff --git a/API/Entities/Enums/EncodeFormat.cs b/API/Entities/Enums/EncodeFormat.cs
index 70345f1db..189b12745 100644
--- a/API/Entities/Enums/EncodeFormat.cs
+++ b/API/Entities/Enums/EncodeFormat.cs
@@ -1,13 +1,17 @@
-using System.ComponentModel;
+using System.ComponentModel;
 
 namespace API.Entities.Enums;
 
-public enum EncodeFormat
+public enum EncodeFormat 
 {
     [Description("PNG")]
     PNG = 0,
     [Description("WebP")]
     WEBP = 1,
     [Description("AVIF")]
-    AVIF = 2
+    AVIF = 2,
+    //Internal Use
+    [Description("JPEG")]
+    JPEG = 3
 }
+
diff --git a/API/Extensions/ApplicationServiceExtensions.cs b/API/Extensions/ApplicationServiceExtensions.cs
index 8b9740577..cbcad8206 100644
--- a/API/Extensions/ApplicationServiceExtensions.cs
+++ b/API/Extensions/ApplicationServiceExtensions.cs
@@ -1,8 +1,10 @@
-using System.IO.Abstractions;
+using System.IO.Abstractions;
 using API.Constants;
 using API.Data;
 using API.Helpers;
 using API.Services;
+using API.Services.ImageServices;
+using API.Services.ImageServices.ImageMagick;
 using API.Services.Plus;
 using API.Services.Tasks;
 using API.Services.Tasks.Metadata;
@@ -34,7 +36,7 @@ public static void AddApplicationServices(this IServiceCollection services, ICon
         services.AddScoped<ICacheService, CacheService>();
         services.AddScoped<IArchiveService, ArchiveService>();
 
-        services.AddScoped<IImageConverterService, ImageConverterService>();
+        services.AddScoped<IImageFactory, ImageMagickImageFactory>();
 
         services.AddScoped<IBackupService, BackupService>();
         services.AddScoped<ICleanupService, CleanupService>();
diff --git a/API/Extensions/EncodeFormatExtensions.cs b/API/Extensions/EncodeFormatExtensions.cs
index 924ae8b89..301c69fa5 100644
--- a/API/Extensions/EncodeFormatExtensions.cs
+++ b/API/Extensions/EncodeFormatExtensions.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using API.Entities.Enums;
 
 namespace API.Extensions;
@@ -13,6 +13,7 @@ public static string GetExtension(this EncodeFormat encodeFormat)
             EncodeFormat.PNG => ".png",
             EncodeFormat.WEBP => ".webp",
             EncodeFormat.AVIF => ".avif",
+            EncodeFormat.JPEG => ".jpg",
             _ => throw new ArgumentOutOfRangeException(nameof(encodeFormat), encodeFormat, null)
         };
     }
diff --git a/API/Services/ArchiveService.cs b/API/Services/ArchiveService.cs
index 5ce662bed..46ea4c301 100644
--- a/API/Services/ArchiveService.cs
+++ b/API/Services/ArchiveService.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Collections.Generic;
 using System.Diagnostics;
 using System.IO;
@@ -233,7 +233,7 @@ public string GetCoverImage(string archivePath, string fileName, string outputDi
                     var entry = archive.Entries.Single(e => e.FullName == entryName);
 
                     using var stream = entry.Open();
-                    return _imageService.WriteCoverThumbnail(entryName, stream, fileName, outputDirectory, format, size);
+                    return _imageService.WriteCoverThumbnail(stream, fileName, outputDirectory, format, size);
                 }
                 case ArchiveLibrary.SharpCompress:
                 {
@@ -244,7 +244,7 @@ public string GetCoverImage(string archivePath, string fileName, string outputDi
                     var entry = archive.Entries.Single(e => e.Key == entryName);
 
                     using var stream = entry.OpenEntryStream();
-                    return _imageService.WriteCoverThumbnail(entryName, stream, fileName, outputDirectory, format, size);
+                    return _imageService.WriteCoverThumbnail(stream, fileName, outputDirectory, format, size);
                 }
                 case ArchiveLibrary.NotSupported:
                     _logger.LogWarning("[GetCoverImage] This archive cannot be read: {ArchivePath}. Defaulting to no cover image", archivePath);
diff --git a/API/Services/BookService.cs b/API/Services/BookService.cs
index fc662b463..27096f9cb 100644
--- a/API/Services/BookService.cs
+++ b/API/Services/BookService.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Collections.Generic;
 using System.Globalization;
 using System.IO;
@@ -11,6 +11,7 @@
 using API.Entities;
 using API.Entities.Enums;
 using API.Extensions;
+using API.Services.ImageServices;
 using API.Services.Tasks.Scanner.Parser;
 using Docnet.Core;
 using Docnet.Core.Converters;
@@ -18,7 +19,6 @@
 using Docnet.Core.Readers;
 using ExCSS;
 using HtmlAgilityPack;
-using ImageMagick;
 using Kavita.Common;
 using Microsoft.Extensions.Logging;
 using Microsoft.IO;
@@ -1228,7 +1228,7 @@ public string GetCoverImage(string fileFilePath, string fileName, string outputD
             if (coverImageContent == null) return string.Empty;
             using var stream = coverImageContent.GetContentStream();
 
-            return _imageService.WriteCoverThumbnail(fileFilePath, stream, fileName, outputDirectory, encodeFormat, size);
+            return _imageService.WriteCoverThumbnail(stream, fileName, outputDirectory, encodeFormat, size);
         }
         catch (Exception ex)
         {
@@ -1251,7 +1251,7 @@ private string GetPdfCoverImage(string fileFilePath, string fileName, string out
             using var stream = StreamManager.GetStream("BookService.GetPdfPage");
             GetPdfPage(docReader, 0, stream);
 
-            return _imageService.WriteCoverThumbnail(fileFilePath, stream, fileName, outputDirectory, encodeFormat, size);
+            return _imageService.WriteCoverThumbnail(stream, fileName, outputDirectory, encodeFormat, size);
 
         }
         catch (Exception ex)
@@ -1272,25 +1272,15 @@ private string GetPdfCoverImage(string fileFilePath, string fileName, string out
     /// <param name="docReader"></param>
     /// <param name="pageNumber"></param>
     /// <param name="stream"></param>
-    private static void GetPdfPage(IDocReader docReader, int pageNumber, Stream stream)
+    private void GetPdfPage(IDocReader docReader, int pageNumber, Stream stream)
     {
         using var pageReader = docReader.GetPageReader(pageNumber);
         var rawBytes = pageReader.GetImage(new NaiveTransparencyRemover());
-        var floats = new float[rawBytes.Length];
-        for (var i = 0; i < rawBytes.Length; i += 4)
-        {
-            floats[i] = rawBytes[i + 2] << 8;
-            floats[i + 1] = rawBytes[i + 1] << 8;
-            floats[i+2] = rawBytes[i] << 8;
-            floats[i+3] = rawBytes[i + 3] << 8;
-        }
         var width = pageReader.GetPageWidth();
         var height = pageReader.GetPageHeight();
-        MagickImage image = new MagickImage(MagickColor.FromRgba(0, 0, 0,0), width, height);
-        using var pixels = image.GetPixels();
-        pixels.SetArea(0,0,width, height, floats);
+        IImage image = _imageService.ImageFactory.CreateFromBGRAByteArray(rawBytes, width, height);
         stream.Seek(0, SeekOrigin.Begin);
-        image.Write(stream, MagickFormat.Png);
+        image.Save(stream, EncodeFormat.PNG, 100);
         stream.Seek(0, SeekOrigin.Begin);
     }
 
diff --git a/API/Services/CacheService.cs b/API/Services/CacheService.cs
index 89c4ac36c..6c0fe17a9 100644
--- a/API/Services/CacheService.cs
+++ b/API/Services/CacheService.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Collections.Concurrent;
 using System.Collections.Generic;
 using System.Diagnostics;
@@ -11,7 +11,6 @@
 using API.Entities;
 using API.Entities.Enums;
 using API.Extensions;
-using ImageMagick;
 using Kavita.Common;
 using Microsoft.Extensions.Logging;
 using static System.Net.Mime.MediaTypeNames;
@@ -53,20 +52,21 @@ public class CacheService : ICacheService
     private readonly IDirectoryService _directoryService;
     private readonly IReadingItemService _readingItemService;
     private readonly IBookmarkService _bookmarkService;
-    private readonly IImageConverterService _converterService;
+    private readonly IImageService _imageService;
+
 
     private static readonly ConcurrentDictionary<int, SemaphoreSlim> ExtractLocks = new();
 
     public CacheService(ILogger<CacheService> logger, IUnitOfWork unitOfWork,
         IDirectoryService directoryService, IReadingItemService readingItemService,
-        IBookmarkService bookmarkService, IImageConverterService converterService)
+        IBookmarkService bookmarkService, IImageService imageService)
     {
         _logger = logger;
         _unitOfWork = unitOfWork;
         _directoryService = directoryService;
         _readingItemService = readingItemService;
         _bookmarkService = bookmarkService;
-        _converterService = converterService;
+        _imageService = imageService;
     }
 
     public IEnumerable<string> GetCachedPages(int chapterId)
@@ -99,14 +99,18 @@ public IEnumerable<FileDimensionDto> GetCachedFileDimensions(string cachePath)
             for (var i = 0; i < files.Length; i++)
             {
                 var file = files[i];
-                MagickImageInfo info = new MagickImageInfo(file);
-
+                var info = _imageService.ImageFactory.GetDimensions(file);
+                if (info == null)
+                {
+                    _logger.LogError("There was an error calculating image dimensions for image {file}", file);
+                    continue;
+                }
                 dimensions.Add(new FileDimensionDto()
                 {
                     PageNumber = i,
-                    Height = info.Height,
-                    Width = info.Width,
-                    IsWide = info.Width > info.Height,
+                    Height = info.Value.Height,
+                    Width = info.Value.Width,
+                    IsWide = info.Value.Width > info.Value.Height,
                     FileName = file.Replace(cachePath, string.Empty)
                 });
             }
diff --git a/API/Services/ImageConverterService.cs b/API/Services/ImageConverterService.cs
deleted file mode 100644
index 7345d81be..000000000
--- a/API/Services/ImageConverterService.cs
+++ /dev/null
@@ -1,82 +0,0 @@
-using System.Collections;
-using System.Collections.Generic;
-using System.Diagnostics;
-using System.IO;
-using System.IO.Abstractions;
-using System.Linq;
-using System.Text.RegularExpressions;
-using API.Services.Tasks.Scanner.Parser;
-using ImageMagick;
-using Microsoft.Extensions.Logging;
-
-
-namespace API.Services
-{
-    /// <summary>
-    /// Represents an image converter service.
-    /// </summary>
-    public interface IImageConverterService
-    {
-
-        /// <summary>
-        /// Converts the specified image file to jpg image format.
-        /// </summary>
-        /// <param name="filename">The filename of the image.</param>
-        /// <param name="supportedImageFormats">The list of supported image formats by the client from the Accept Header. If null is passed, the conversion will execute if the image requires conversion.</param>
-        /// <returns>The converted image file path if conversion is required. Note: original filename is deleted if conversion is executed</returns>
-        string ConvertFile(string filename, List<string> supportedImageFormats = null);
-
-    }
-
-    /// <summary>
-    /// Represents an implementation of the image converter service.
-    /// </summary>
-    public class ImageConverterService : IImageConverterService
-    {
-
-        private readonly ILogger<ImageConverterService> _logger;
-
-        /// <summary>
-        /// Initializes a new instance of the <see cref="ImageConverterService"/> class.
-        /// </summary>
-        /// <param name="logger">The logger instance.</param>
-        /// <param name="converters">The collection of image converter providers.</param>
-        public ImageConverterService(ILogger<ImageConverterService> logger)
-        {
-            _logger = logger;
-
-        }
-
-    
-
-        private bool CheckDirectSupport(string filename, List<string> supportedImageFormats)
-        {
-            if (supportedImageFormats == null)
-                return false;
-            string ext = Path.GetExtension(filename).ToLowerInvariant().Substring(1);
-            return supportedImageFormats.Contains(ext);
-        }
-
-        /// <inheritdoc/>
-        public string ConvertFile(string filename, List<string> supportedImageFormats = null)
-        {
-            if (CheckDirectSupport(filename, supportedImageFormats))
-                return filename;
-            Match m = Regex.Match(Path.GetExtension(filename), Parser.NonUniversalFileImageExtensions, RegexOptions.IgnoreCase, Tasks.Scanner.Parser.Parser.RegexTimeout);
-            if (!m.Success)
-                return filename;
-            var sw = Stopwatch.StartNew();
-            string destination = Path.ChangeExtension(filename, "jpg");
-            using var sourceImage = new MagickImage(filename);
-            sourceImage.Quality = 99;
-            sourceImage.Write(destination);
-            File.Delete(filename);
-            _logger.LogDebug("Image converted from '{Extension}' to '.jpg' in {ElapsedMilliseconds} milliseconds", Path.GetExtension(filename), sw.ElapsedMilliseconds);
-            return destination;
-        }
-
-
-
-
-    }
-}
diff --git a/API/Services/ImageService.cs b/API/Services/ImageService.cs
index d2d4787cb..d20f8584f 100644
--- a/API/Services/ImageService.cs
+++ b/API/Services/ImageService.cs
@@ -1,81 +1,164 @@
-using System;
+using System;
 using System.Collections.Generic;
+using System.Diagnostics;
 using System.Drawing;
 using System.IO;
 using System.Linq;
 using System.Numerics;
+using System.Text.RegularExpressions;
 using System.Threading.Tasks;
 using API.Constants;
 using API.DTOs;
 using API.Entities.Enums;
 using API.Entities.Interfaces;
 using API.Extensions;
-using API.Helpers;
+using API.Services.ImageServices;
+using API.Services.Tasks.Scanner.Parser;
 using EasyCaching.Core;
 using Flurl;
 using Flurl.Http;
 using HtmlAgilityPack;
-using ImageMagick;
 using Kavita.Common;
+using Microsoft.EntityFrameworkCore.Migrations.Operations;
 using Microsoft.Extensions.Logging;
-using static API.Helpers.SmartCropHelper;
 
-namespace API.Services;
-#nullable enable
 
+namespace API.Services;
+/// <summary>
+/// Interface for the ImageService.
+/// </summary>
 public interface IImageService
 {
+    /// <summary>
+    /// Extracts images from a file and copies them to the target directory.
+    /// </summary>
+    /// <param name="fileFilePath">The file path of the source file.</param>
+    /// <param name="targetDirectory">The target directory to copy the images to.</param>
+    /// <param name="fileCount">The number of files to extract. Default is 1.</param>
     void ExtractImages(string fileFilePath, string targetDirectory, int fileCount = 1);
-    string GetCoverImage(string path, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size);
 
     /// <summary>
-    /// Creates a Thumbnail version of a base64 image
+    /// Gets the cover image from the specified path and saves it to the output directory.
     /// </summary>
-    /// <param name="encodedImage">base64 encoded image</param>
-    /// <param name="fileName"></param>
-    /// <param name="encodeFormat">Convert and save as encoding format</param>
-    /// <param name="thumbnailWidth">Width of thumbnail</param>
+    /// <param name="path">The path of the image file.</param>
+    /// <param name="fileName">The name of the output file.</param>
+    /// <param name="outputDirectory">The output directory to save the image.</param>
+    /// <param name="encodeFormat">The encoding format to convert and save the image.</param>
+    /// <param name="size">The size of the cover image.</param>
+    /// <param name="quality">The quality of the image. Default is 100.</param>
+    /// <returns>The file name with extension of the saved image.</returns>
+    string GetCoverImage(string path, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size, int quality = 100);
+
+    /// <summary>
+    /// Creates a thumbnail version of a base64 encoded image.
+    /// </summary>
+    /// <param name="encodedImage">The base64 encoded image.</param>
+    /// <param name="fileName">The name of the output file.</param>
+    /// <param name="encodeFormat">The encoding format to convert and save the image.</param>
+    /// <param name="thumbnailWidth">The width of the thumbnail. Default is 320.</param>
+    /// <param name="quality">The quality of the image. Default is 100.</param>
+    /// <returns>The file name with extension of the saved thumbnail image.</returns>
+    string CreateThumbnailFromBase64(string encodedImage, string fileName, EncodeFormat encodeFormat, int thumbnailWidth = 320, int quality = 100);
+
+    /// <summary>
+    /// Creates a thumbnail out of a memory stream and saves to <see cref="DirectoryService.CoverImageDirectory"/> with the passed
+    /// fileName and the appropriate extension.
+    /// </summary>
+    /// <param name="stream">Stream to write to disk. Ensure this is rewinded.</param>
+    /// <param name="fileName">filename to save as without extension</param>
+    /// <param name="outputDirectory">Where to output the file, defaults to covers directory</param>
+    /// <param name="encodeFormat">Export the file as the passed encoding</param>
+    /// <param name="size">The size of the cover image.</param>
+    /// <param name="quality">The quality of the image. Default is 100.</param>
     /// <returns>File name with extension of the file. This will always write to <see cref="DirectoryService.CoverImageDirectory"/></returns>
-    string CreateThumbnailFromBase64(string encodedImage, string fileName, EncodeFormat encodeFormat, int thumbnailWidth = 320);
+    string WriteCoverThumbnail(Stream stream, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size = CoverImageSize.Default, int quality = 100);
+
     /// <summary>
-    /// Writes out a thumbnail by stream input
+    /// Writes out a thumbnail image from a file path input and saves to <see cref="DirectoryService.CoverImageDirectory"/> with the passed
     /// </summary>
-    /// <param name="stream"></param>
-    /// <param name="fileName"></param>
-    /// <param name="outputDirectory"></param>
-    /// <param name="encodeFormat"></param>
-    /// <returns></returns>
-    string WriteCoverThumbnail(string originalNameWithExtension, Stream stream, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size = CoverImageSize.Default);
+    /// <param name="sourceFile">The path of the source image file.</param>
+    /// <param name="fileName">filename to save as without extension</param>
+    /// <param name="outputDirectory">Where to output the file, defaults to covers directory</param>
+    /// <param name="encodeFormat">Export the file as the passed encoding</param>
+    /// <param name="size">The size of the cover image.</param>
+    /// <param name="quality">The quality of the image. Default is 100.</param>
+    /// <returns>File name with extension of the file. This will always write to <see cref="DirectoryService.CoverImageDirectory"/></returns>
+    string WriteCoverThumbnail(string sourceFile, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size = CoverImageSize.Default, int quality = 100);
+
     /// <summary>
-    /// Writes out a thumbnail by file path input
+    /// Converts the specified image file to the specified encoding format and saves it to the output path.
     /// </summary>
-    /// <param name="sourceFile"></param>
-    /// <param name="fileName"></param>
-    /// <param name="outputDirectory"></param>
-    /// <param name="encodeFormat"></param>
-    /// <returns></returns>
-    string WriteCoverThumbnail(string sourceFile, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size = CoverImageSize.Default);
+    /// <param name="filePath">The full path of the image file to convert.</param>
+    /// <param name="outputPath">The path to save the converted image file.</param>
+    /// <param name="encodeFormat">The encoding format to convert the image.</param>
+    /// <param name="quality">The quality of the image. Default is 100.</param>
+    /// <returns>The file path of the converted image file.</returns>
+    Task<string> ConvertToEncodingFormat(string filePath, string outputPath, EncodeFormat encodeFormat, int quality = 100);
+
     /// <summary>
-    /// Converts the passed image to encoding and outputs it in the same directory
+    /// Checks if the specified file is an image.
     /// </summary>
-    /// <param name="filePath">Full path to the image to convert</param>
-    /// <param name="outputPath">Where to output the file</param>
-    /// <param name="encodeFormat">Encoding Format</param>
-    /// <returns>File of written encoded image</returns>
-    Task<string> ConvertToEncodingFormat(string filePath, string outputPath, EncodeFormat encodeFormat);
+    /// <param name="filePath">The path of the file to check.</param>
+    /// <returns>True if the file is an image; otherwise, false.</returns>
     Task<bool> IsImage(string filePath);
-    Task<string> DownloadFaviconAsync(string url, EncodeFormat encodeFormat);
-    Task<string> DownloadPublisherImageAsync(string publisherName, EncodeFormat encodeFormat);
+
+    /// <summary>
+    /// Downloads the favicon from the specified URL and saves it to the output directory.
+    /// </summary>
+    /// <param name="url">The URL of the favicon.</param>
+    /// <param name="encodeFormat">The encoding format to convert and save the favicon.</param>
+    /// <param name="quality">The quality of the favicon. Default is 100.</param>
+    /// <returns>The file name with extension of the saved favicon.</returns>
+    Task<string> DownloadFaviconAsync(string url, EncodeFormat encodeFormat, int quality = 100);
+
+    /// <summary>
+    /// Downloads the publisher image for the specified publisher name and saves it to the output directory.
+    /// </summary>
+    /// <param name="publisherName">The name of the publisher.</param>
+    /// <param name="encodeFormat">The encoding format to convert and save the publisher image.</param>
+    /// <param name="quality">The quality of the publisher image. Default is 100.</param>
+    /// <returns>The file name with extension of the saved publisher image.</returns>
+    Task<string> DownloadPublisherImageAsync(string publisherName, EncodeFormat encodeFormat, int quality = 100);
+
+    /// <summary>
+    /// Updates the color scape of an entity with a cover image.
+    /// </summary>
+    /// <param name="entity">The entity with a cover image.</param>
     void UpdateColorScape(IHasCoverImage entity);
+
+    /// <summary>
+    /// Replaces the file format of an image with the specified supported image formats by the browser, if needed, otherwise original file will be served.
+    /// </summary>
+    /// <param name="filename">The name of the image file.</param>
+    /// <param name="supportedImageFormats">The list of supported image formats by the browser.</param>
+    /// <param name="format">The encoding format to convert the image. Default is JPG</param>
+    /// <param name="quality">The quality of the image. Default is 99.</param>
+    /// <returns>The file name with extension of the replaced image file.</returns>
+    string ReplaceImageFileFormat(string filename, List<string> supportedImageFormats = null, EncodeFormat format = EncodeFormat.JPEG, int quality = 99);
+
+    /// <summary>
+    /// Creates a merged image from a list of cover images and saves it to the specified destination.
+    /// </summary>
+    /// <param name="coverImages">The list of cover images.</param>
+    /// <param name="size">The size of the merged image.</param>
+    /// <param name="dest">The destination path to save the merged image.</param>
+    /// <param name="format">The encoding format to convert and save the merged image. Default is PNG.</param>
+    /// <param name="quality">The quality of the merged image. Default is 100.</param>
+    void CreateMergedImage(IList<string> coverImages, CoverImageSize size, string dest, EncodeFormat format = EncodeFormat.PNG, int quality = 100);
+
+    /// <summary>
+    /// The image factory used to create and manipulate images.
+    /// </summary>
+    IImageFactory ImageFactory { get; }
 }
 
 public class ImageService : IImageService
 {
-    public const string Name = "BookmarkService";
+    public const string Name = "ImageService";
     private readonly ILogger<ImageService> _logger;
     private readonly IDirectoryService _directoryService;
     private readonly IEasyCachingProviderFactory _cacheFactory;
-    private readonly IImageConverterService _converterService;
+    private readonly IImageFactory _imageFactory;
     public const string ChapterCoverImageRegex = @"v\d+_c\d+";
     public const string SeriesCoverImageRegex = @"series\d+";
     public const string CollectionTagCoverImageRegex = @"tag\d+";
@@ -114,14 +197,24 @@ public class ImageService : IImageService
         ["https://app.plex.tv"] = "https://plex.tv"
     };
 
-    public ImageService(ILogger<ImageService> logger, IDirectoryService directoryService, IEasyCachingProviderFactory cacheFactory, IImageConverterService converterService)
+    /// <summary>
+    /// Initializes a new instance of the <see cref="ImageService"/> class.
+    /// </summary>
+    /// <param name="logger">The logger.</param>
+    /// <param name="directoryService">The directory service.</param>
+    /// <param name="cacheFactory">The cache factory.</param>
+    /// <param name="imageFactory">The image factory.</param>
+    public ImageService(ILogger<ImageService> logger, IDirectoryService directoryService, IEasyCachingProviderFactory cacheFactory, IImageFactory imageFactory)
     {
         _logger = logger;
         _directoryService = directoryService;
         _cacheFactory = cacheFactory;
-        _converterService = converterService;
+        _imageFactory = imageFactory;
     }
 
+    public IImageFactory ImageFactory => _imageFactory;
+
+    /// <inheritdoc/>
     public void ExtractImages(string? fileFilePath, string targetDirectory, int fileCount = 1)
     {
         if (string.IsNullOrEmpty(fileFilePath)) return;
@@ -136,32 +229,39 @@ public void ExtractImages(string? fileFilePath, string targetDirectory, int file
                 Tasks.Scanner.Parser.Parser.ImageFileExtensions);
         }
     }
-
+    
     /// <summary>
-    /// Tries to determine if there is a better mode for resizing
+    /// Creates a thumbnail image from the specified image with the given width and height.
+    /// If the image aspect ratio is significantly different from the target aspect ratio, it will be context aware cropped to fit.
     /// </summary>
-    /// <param name="image"></param>
-    /// <param name="targetWidth"></param>
-    /// <param name="targetHeight"></param>
-    /// <returns></returns>
-    public static MagickGeometry GetSizeForDimensions(MagickImage image, int targetWidth, int targetHeight)
+    /// <param name="image">The image to create a thumbnail from.</param>
+    /// <param name="width">The width of the thumbnail.</param>
+    /// <param name="height">The height of the thumbnail.</param>
+    /// <returns>The thumbnail image.</returns>
+    public static IImage Thumbnail(IImage image, int width, int height)
     {
         try
         {
-            if (WillScaleWell(image, targetWidth, targetHeight) || IsLikelyWideImage(image.Width, image.Height))
+            if (WillScaleWell(image, width, height) || IsLikelyWideImage(image.Width, image.Height))
             {
-                return new MagickGeometry(targetWidth, targetHeight) { IgnoreAspectRatio = true };
+                image.Thumbnail(width, height);
+                return image;
             }
         }
         catch (Exception)
         {
             /* Swallow */
         }
-        return SmartCropHelper.SmartCrop(image, targetWidth, targetHeight);
+        var crop = SmartCrop.Crop(image, new SmartCrop.SmartCropOptions { Width = width, Height = height });
+        if (crop.TopCrop.Width != width && crop.TopCrop.Height != height)
+        {
+            image.Crop(crop.TopCrop.X, crop.TopCrop.Y, crop.TopCrop.Width, crop.TopCrop.Height);
+        }
+        image.Thumbnail(width, height);
+        return image;
     }
 
-
-    public static bool WillScaleWell(MagickImage sourceImage, int targetWidth, int targetHeight, double tolerance = 0.1)
+    public static bool WillScaleWell(IImage sourceImage, int targetWidth, int targetHeight, double tolerance = 0.1)
     {
         // Calculate the aspect ratios
         var sourceAspectRatio = (double) sourceImage.Width / sourceImage.Height;
@@ -192,32 +292,18 @@ private static bool IsLikelyWideImage(int width, int height)
         return aspectRatio > 1.25;
     }
 
-    public static MagickImage Thumbnail(string path, int width, int height)
-    {
-        var sourceImage = new MagickImage(path);
-        return Thumbnail(sourceImage, width, height);
-    }
-    public static MagickImage Thumbnail(MagickImage sourceImage, int width, int height)
-    {
-        var geometry = GetSizeForDimensions(sourceImage, width, height);
-        if (geometry.Width != width && geometry.Height != height)
-        {
-            sourceImage.Crop(geometry);
-            geometry = new MagickGeometry(width, height) { IgnoreAspectRatio = true };
-        }
-        sourceImage.Thumbnail(geometry);
-        return sourceImage;
-    }
-    public string GetCoverImage(string path, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size)
+
+    /// <inheritdoc/>
+    public string GetCoverImage(string path, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size, int quality = 100)
     {
         if (string.IsNullOrEmpty(path)) return string.Empty;
 
         try
         {
             var (width, height) = size.GetDimensions();
-            using var thumbnail = Thumbnail(path, width, height);
+            using var thumbnail = Thumbnail(_imageFactory.Create(path), width, height);
             var filename = fileName + encodeFormat.GetExtension();
-            thumbnail.Write(_directoryService.FileSystem.Path.Join(outputDirectory, filename));
+            thumbnail.Save(_directoryService.FileSystem.Path.Join(outputDirectory, filename), encodeFormat, quality);
             return filename;
         }
         catch (Exception ex)
@@ -228,24 +314,13 @@ public string GetCoverImage(string path, string fileName, string outputDirectory
         return string.Empty;
     }
 
-    /// <summary>
-    /// Creates a thumbnail out of a memory stream and saves to <see cref="DirectoryService.CoverImageDirectory"/> with the passed
-    /// fileName and the appropriate extension.
-    /// </summary>
-    /// <param name="originalNameWithExtension">The OriginalNameWithExtension of the image
-    /// (Not a file,  only the name, if it came from the filesystem or an archive entry).</param>
-    /// <param name="stream">Stream to write to disk. Ensure this is rewinded.</param>
-    /// <param name="fileName">filename to save as without extension</param>
-    /// <param name="outputDirectory">Where to output the file, defaults to covers directory</param>
-    /// <param name="encodeFormat">Export the file as the passed encoding</param>
-    /// <returns>File name with extension of the file. This will always write to <see cref="DirectoryService.CoverImageDirectory"/></returns>
-    public string WriteCoverThumbnail(string originalNameWithExtension, Stream stream, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size = CoverImageSize.Default)
+    /// <inheritdoc/>
+    public string WriteCoverThumbnail(Stream stream, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size = CoverImageSize.Default, int quality = 100)
     {
         var (targetWidth, targetHeight) = size.GetDimensions();
         if (stream.CanSeek) stream.Position = 0;
 
-        using var sourceImage = new MagickImage(stream);
-        using var thumbnail = Thumbnail(sourceImage, targetWidth, targetHeight);
+        using var thumbnail = Thumbnail(_imageFactory.Create(stream), targetWidth, targetHeight);
         var filename = fileName + encodeFormat.GetExtension();
         _directoryService.ExistOrCreate(outputDirectory);
 
@@ -256,7 +331,7 @@ public string WriteCoverThumbnail(string originalNameWithExtension, Stream strea
 
         try
         {
-            thumbnail.Write(_directoryService.FileSystem.Path.Join(outputDirectory, filename));
+            thumbnail.Save(_directoryService.FileSystem.Path.Join(outputDirectory, filename), encodeFormat, quality);
             return filename;
         }
         catch (Exception)
@@ -264,53 +339,49 @@ public string WriteCoverThumbnail(string originalNameWithExtension, Stream strea
             return string.Empty; //IDK?
         }
     }
-
-    public string WriteCoverThumbnail(string sourceFile, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size = CoverImageSize.Default)
+    /// <inheritdoc/>
+    public string WriteCoverThumbnail(string sourceFile, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size = CoverImageSize.Default, int quality = 100)
     {
         var (width, height) = size.GetDimensions();
-        using var thumbnail = Thumbnail(sourceFile, width, height);
+        using var thumbnail = Thumbnail(_imageFactory.Create(sourceFile), width, height);
         var filename = fileName + encodeFormat.GetExtension();
         _directoryService.ExistOrCreate(outputDirectory);
         try
         {
             _directoryService.FileSystem.File.Delete(_directoryService.FileSystem.Path.Join(outputDirectory, filename));
         } catch (Exception) {/* Swallow exception */}
-        thumbnail.Write(_directoryService.FileSystem.Path.Join(outputDirectory, filename));
+        thumbnail.Save(_directoryService.FileSystem.Path.Join(outputDirectory, filename), encodeFormat, quality);
         return filename;
     }
-
-    public async Task<string> ConvertToEncodingFormat(string filePath, string outputPath, EncodeFormat encodeFormat)
+    /// <inheritdoc/>
+    public async Task<string> ConvertToEncodingFormat(string filePath, string outputPath, EncodeFormat encodeFormat, int quality = 100)
     {
         var file = _directoryService.FileSystem.FileInfo.New(filePath);
         var fileName = file.Name.Replace(file.Extension, string.Empty);
         var outputFile = Path.Join(outputPath, fileName + encodeFormat.GetExtension());
-        using var sourceImage = new MagickImage(filePath);
-        await sourceImage.WriteAsync(outputFile).ConfigureAwait(false);
+        using var sourceImage = _imageFactory.Create(filePath);
+        await sourceImage.SaveAsync(outputFile, encodeFormat, quality).ConfigureAwait(false);
         return outputFile;
     }
 
-    /// <summary>
-    /// Performs I/O to determine if the file is a valid Image
-    /// </summary>
-    /// <param name="filePath"></param>
-    /// <returns></returns>
-    public async Task<bool> IsImage(string filePath)
+    /// <inheritdoc/>
+    public Task<bool> IsImage(string filePath)
     {
         try
         {
-            MagickImageInfo info = new MagickImageInfo(filePath);
-            if (info.Width > 0 || info.Height > 0)
-                return true;
+            var result= _imageFactory.GetDimensions(filePath);
+            if (result!=null)
+                return Task.FromResult(true);
         }
         catch (Exception)
         {
             /* Swallow Exception */
         }
 
-        return true;
+        return Task.FromResult(false);
     }
-
-    public async Task<string> DownloadFaviconAsync(string url, EncodeFormat encodeFormat)
+    /// <inheritdoc/>
+    public async Task<string> DownloadFaviconAsync(string url, EncodeFormat encodeFormat, int quality = 100)
     {
         // Parse the URL to get the domain (including subdomain)
         var uri = new Uri(url);
@@ -382,24 +453,9 @@ public async Task<string> DownloadFaviconAsync(string url, EncodeFormat encodeFo
                 .GetStreamAsync();
 
             // Create the destination file path
-            using var image = new MagickImage(faviconStream);
+            using var image = _imageFactory.Create(faviconStream);
             var filename = ImageService.GetWebLinkFormat(baseUrl, encodeFormat);
-            switch (encodeFormat)
-            {
-                case EncodeFormat.PNG:
-                    await image.WriteAsync(Path.Combine(_directoryService.FaviconDirectory, filename),MagickFormat.Png32).ConfigureAwait(false);
-                    break;
-                case EncodeFormat.WEBP:
-                    await image.WriteAsync(Path.Combine(_directoryService.FaviconDirectory, filename), MagickFormat.WebP).ConfigureAwait(false);
-                    break;
-                case EncodeFormat.AVIF:
-                    await image.WriteAsync(Path.Combine(_directoryService.FaviconDirectory, filename), MagickFormat.Avif).ConfigureAwait(false);
-                    break;
-                default:
-                    throw new ArgumentOutOfRangeException(nameof(encodeFormat), encodeFormat, null);
-            }
-
-
+            await image.SaveAsync(Path.Combine(_directoryService.FaviconDirectory, filename), encodeFormat, quality);
             _logger.LogDebug("Favicon for {Domain} downloaded and saved successfully", domain);
             return filename;
         } catch (Exception ex)
@@ -408,8 +464,8 @@ public async Task<string> DownloadFaviconAsync(string url, EncodeFormat encodeFo
             throw;
         }
     }
-
-    public async Task<string> DownloadPublisherImageAsync(string publisherName, EncodeFormat encodeFormat)
+    /// <inheritdoc/>
+    public async Task<string> DownloadPublisherImageAsync(string publisherName, EncodeFormat encodeFormat, int quality = 100)
     {
         try
         {
@@ -428,24 +484,9 @@ public async Task<string> DownloadPublisherImageAsync(string publisherName, Enco
                 .GetStreamAsync();
 
             // Create the destination file path
-            using var image = new MagickImage(publisherStream);
+            using var image = _imageFactory.Create(publisherStream);
             var filename = GetPublisherFormat(publisherName, encodeFormat);
-            switch (encodeFormat)
-            {
-                case EncodeFormat.PNG:
-                    await image.WriteAsync(Path.Combine(_directoryService.FaviconDirectory, filename), MagickFormat.Png32).ConfigureAwait(false);
-                    break;
-                case EncodeFormat.WEBP:
-                    await image.WriteAsync(Path.Combine(_directoryService.FaviconDirectory, filename), MagickFormat.WebP).ConfigureAwait(false);
-                    break;
-                case EncodeFormat.AVIF:
-                    await image.WriteAsync(Path.Combine(_directoryService.FaviconDirectory, filename), MagickFormat.Avif).ConfigureAwait(false);
-                    break;
-                default:
-                    throw new ArgumentOutOfRangeException(nameof(encodeFormat), encodeFormat, null);
-            }
-
-
+            await image.SaveAsync(Path.Combine(_directoryService.FaviconDirectory, filename), encodeFormat, quality);
             _logger.LogDebug("Publisher image for {PublisherName} downloaded and saved successfully", publisherName);
             return filename;
         } catch (Exception ex)
@@ -455,22 +496,11 @@ public async Task<string> DownloadPublisherImageAsync(string publisherName, Enco
         }
     }
 
-    private static (Vector3?, Vector3?) GetPrimarySecondaryColors(string imagePath)
+    private (Vector3?, Vector3?) GetPrimarySecondaryColors(string imagePath)
     {
-        var settings = new MagickReadSettings { ColorSpace = ColorSpace.RGB };
-        using var sourceImage = new MagickImage(imagePath, settings);
 
-        MagickImage im = new MagickImage(imagePath);
-        // Resize the image to speed up processing
-        im.Resize(new Percentage(10));
-        // Convert image to RGB array
-        float[] pixels = im.GetPixels().ToArray();
-        float mul = 1F / 256F;
-        var rgbPixels = new List<Vector3>();
-        // Convert to list of Vector3 (RGB)
 
-        for (int x = 0; x < pixels.Length; x += 3)
-            rgbPixels.Add(new Vector3(pixels[x] * mul, pixels[x+1] * mul, pixels[x + 2] * mul));
+        var rgbPixels = _imageFactory.GetRgbPixelsPercentage(imagePath, 10);
 
         // Perform k-means clustering
         var clusters = KMeansClustering(rgbPixels, 4);
@@ -491,62 +521,7 @@ private static (Vector3?, Vector3?) GetPrimarySecondaryColors(string imagePath)
 
         return (null, null);
     }
-    /*
-    private static (Vector3?, Vector3?) GetPrimaryColorSharp(string imagePath)
-    {
-        using var image = SixLabors.ImageSharp.Image.Load<Rgb24>(imagePath);
-
-        image.Mutate(
-            x => x
-                // Scale the image down preserving the aspect ratio. This will speed up quantization.
-                // We use nearest neighbor as it will be the fastest approach.
-                .Resize(new ResizeOptions() { Sampler = KnownResamplers.NearestNeighbor, Size = new SixLabors.ImageSharp.Size(100, 0) })
-
-                // Reduce the color palette to 1 color without dithering.
-                .Quantize(new OctreeQuantizer(new QuantizerOptions { MaxColors = 4 })));
-
-        Rgb24 dominantColor = image[0, 0];
-
-        // This will give you a dominant color in HEX format i.e #5E35B1FF
-        return (new Vector3(dominantColor.R, dominantColor.G, dominantColor.B), new Vector3(dominantColor.R, dominantColor.G, dominantColor.B));
-    }
-
-
-    private static Image PreProcessImage(Image image)
-    {
-        return image;
-        // Create a mask for white and black pixels
-        var whiteMask = image.Colourspace(Enums.Interpretation.Lab)[0] > (WhiteThreshold * 100);
-        var blackMask = image.Colourspace(Enums.Interpretation.Lab)[0] < (BlackThreshold * 100);
-
-        // Create a replacement color (e.g., medium gray)
-        var replacementColor = new[] { 240.0, 240.0, 240.0 };
-
-        // Apply the masks to replace white and black pixels
-        var processedImage = image.Copy();
-        processedImage = processedImage.Ifthenelse(whiteMask, replacementColor);
-        //processedImage = processedImage.Ifthenelse(blackMask, replacementColor);
-
-        return processedImage;
-    }
-
-    private static Dictionary<Vector3, int> GenerateColorHistogram(Image image)
-    {
-        var pixels = image.WriteToMemory().ToArray();
-        var histogram = new Dictionary<Vector3, int>();
-
-        for (var i = 0; i < pixels.Length; i += 3)
-        {
-            var color = new Vector3(pixels[i], pixels[i + 1], pixels[i + 2]);
-            if (!histogram.TryAdd(color, 1))
-            {
-                histogram[color]++;
-            }
-        }
-
-        return histogram;
-    }
-    */
+    
     private static bool IsColorCloseToWhiteOrBlack(Vector3 color)
     {
         var (_, _, lightness) = RgbToHsl(color);
@@ -701,7 +676,7 @@ private static double HueToRgb(double p, double q, double t)
     /// <remarks>This may use a second most common color or a complementary color. It's up to implemenation to choose what's best</remarks>
     /// <param name="sourceFile"></param>
     /// <returns></returns>
-    public static ColorScape CalculateColorScape(string sourceFile)
+    public ColorScape CalculateColorScape(string sourceFile)
     {
         if (!File.Exists(sourceFile)) return new ColorScape() {Primary = null, Secondary = null};
 
@@ -713,6 +688,30 @@ public static ColorScape CalculateColorScape(string sourceFile)
             Secondary = colors.Item2 == null ? null : RgbToHex(colors.Item2.Value)
         };
     }
+    private bool CheckDirectSupport(string filename, List<string> supportedImageFormats)
+    {
+        if (supportedImageFormats == null)
+            return false;
+        string ext = Path.GetExtension(filename).ToLowerInvariant().Substring(1);
+        return supportedImageFormats.Contains(ext);
+    }
+    /// <inheritdoc/>
+    public string ReplaceImageFileFormat(string filename, List<string> supportedImageFormats = null, EncodeFormat format = EncodeFormat.JPEG, int quality = 99)
+    {
+        if (CheckDirectSupport(filename, supportedImageFormats))
+            return filename;
+        Match m = Regex.Match(Path.GetExtension(filename), Parser.NonUniversalFileImageExtensions, RegexOptions.IgnoreCase, Parser.RegexTimeout);
+        if (!m.Success)
+            return filename;
+        var sw = Stopwatch.StartNew();
+        string destination = Path.ChangeExtension(filename, format.GetExtension().Substring(1));
+
+        using var sourceImage = _imageFactory.Create(filename);
+        sourceImage.Save(destination, format, quality);
+        File.Delete(filename);
+        _logger.LogDebug("Image converted from '{Extension}' to '{format.GetExtension()}' in {ElapsedMilliseconds} milliseconds", Path.GetExtension(filename), sw.ElapsedMilliseconds);
+        return destination;
+    }
 
     private static async Task<string> FallbackToKavitaReaderFavicon(string baseUrl)
     {
@@ -773,16 +772,16 @@ private static async Task<string> FallbackToKavitaReaderPublisher(string publish
     }
 
     /// <inheritdoc />
-    public string CreateThumbnailFromBase64(string encodedImage, string fileName, EncodeFormat encodeFormat, int thumbnailWidth = ThumbnailWidth)
+    public string CreateThumbnailFromBase64(string encodedImage, string fileName, EncodeFormat encodeFormat, int thumbnailWidth = ThumbnailWidth, int quality = 100)
     {
         try
         {
 
-            using var thumbnail = MagickImage.FromBase64(encodedImage);
+            using var thumbnail = _imageFactory.CreateFromBase64(encodedImage);
             int thumbnailHeight = (int)(thumbnail.Height * ((double)thumbnailWidth / thumbnail.Width));
             thumbnail.Thumbnail(thumbnailWidth, thumbnailHeight);
             fileName += encodeFormat.GetExtension();
-            thumbnail.Write(_directoryService.FileSystem.Path.Join(_directoryService.CoverImageDirectory, fileName));
+            thumbnail.Save(_directoryService.FileSystem.Path.Join(_directoryService.CoverImageDirectory, fileName), encodeFormat, quality);
             return fileName;
         }
         catch (Exception e)
@@ -875,8 +874,8 @@ public static string GetPublisherFormat(string publisher, EncodeFormat encodeFor
         return $"{publisher}{encodeFormat.GetExtension()}";
     }
 
-
-    public static void CreateMergedImage(IList<string> coverImages, CoverImageSize size, string dest)
+    /// <inheritdoc/>
+    public void CreateMergedImage(IList<string> coverImages, CoverImageSize size, string dest, EncodeFormat format = EncodeFormat.PNG, int quality = 100)
     {
         var (width, height) = size.GetDimensions();
         int rows, cols;
@@ -898,7 +897,7 @@ public static void CreateMergedImage(IList<string> coverImages, CoverImageSize s
         }
 
 
-        var image = new MagickImage(MagickColor.FromRgb(0,0,0), width, height);
+        var image = _imageFactory.Create(width, height);
 
         var thumbnailWidth = image.Width / cols;
         var thumbnailHeight = image.Height / rows;
@@ -906,7 +905,7 @@ public static void CreateMergedImage(IList<string> coverImages, CoverImageSize s
         for (var i = 0; i < coverImages.Count; i++)
         {
             if (!File.Exists(coverImages[i])) continue;
-            var tile = new MagickImage(coverImages[i]);
+            var tile = _imageFactory.Create(coverImages[i]);
             tile.Thumbnail(thumbnailWidth, thumbnailHeight);
 
             var row = i / cols;
@@ -920,16 +919,16 @@ public static void CreateMergedImage(IList<string> coverImages, CoverImageSize s
                 x = (image.Width - thumbnailWidth) / 2;
                 y = thumbnailHeight;
             }
-            image.Composite(tile,x,y,CompositeOperator.Over);
+            image.Composite(tile,x,y);
         }
 
-        image.Write(dest);
+        image.Save(dest, format, quality);
     }
 
+    /// <inheritdoc/>
     public void UpdateColorScape(IHasCoverImage entity)
     {
-        var colors = CalculateColorScape(
-            _directoryService.FileSystem.Path.Join(_directoryService.CoverImageDirectory, entity.CoverImage));
+        var colors = CalculateColorScape(_directoryService.FileSystem.Path.Join(_directoryService.CoverImageDirectory, entity.CoverImage));
         entity.PrimaryColor = colors.Primary;
         entity.SecondaryColor = colors.Secondary;
     }
diff --git a/API/Services/ImageServices/IImage.cs b/API/Services/ImageServices/IImage.cs
new file mode 100644
index 000000000..448dd2645
--- /dev/null
+++ b/API/Services/ImageServices/IImage.cs
@@ -0,0 +1,102 @@
+using System;
+using System.IO;
+using System.Threading;
+using System.Threading.Tasks;
+using API.Entities.Enums;
+
+namespace API.Services.ImageServices;
+
+/// <summary>
+/// Represents an image with various operations.
+/// </summary>
+public interface IImage : IDisposable
+{
+    /// <summary>
+    /// Gets the width of the image.
+    /// </summary>
+    public int Width { get; }
+
+    /// <summary>
+    /// Gets the height of the image.
+    /// </summary>
+    public int Height { get; }
+
+    /// <summary>
+    /// Creates a new instance of the image that is a copy of the current instance.
+    /// </summary>
+    /// <returns>A new instance of the image.</returns>
+    IImage Clone();
+
+    /// <summary>
+    /// Resizes the image to the specified width and height.
+    /// </summary>
+    /// <param name="width">The new width of the image.</param>
+    /// <param name="height">The new height of the image.</param>
+    void Resize(int width, int height);
+
+    /// <summary>
+    /// Crops the image to the specified region.
+    /// </summary>
+    /// <param name="x">The x-coordinate of the top-left corner of the region.</param>
+    /// <param name="y">The y-coordinate of the top-left corner of the region.</param>
+    /// <param name="width">The width of the region.</param>
+    /// <param name="height">The height of the region.</param>
+    void Crop(int x, int y, int width, int height);
+
+    /// <summary>
+    /// Creates a thumbnail of the image with the specified width and height.
+    /// </summary>
+    /// <param name="width">The width of the thumbnail.</param>
+    /// <param name="height">The height of the thumbnail.</param>
+    void Thumbnail(int width, int height);
+
+    /// <summary>
+    /// Overlays another image onto the current image at the specified position.
+    /// </summary>
+    /// <param name="overlay">The image to overlay.</param>
+    /// <param name="x">The x-coordinate of the top-left corner of the overlay.</param>
+    /// <param name="y">The y-coordinate of the top-left corner of the overlay.</param>
+    void Composite(IImage overlay, int x, int y);
+
+    /// <summary>
+    /// Saves the image to the specified file with the specified format and quality.
+    /// </summary>
+    /// <param name="filename">The name of the file to save the image to.</param>
+    /// <param name="format">The format to save the image in.</param>
+    /// <param name="quality">The quality of the saved image.</param>
+    void Save(string filename, EncodeFormat format, int quality);
+
+    /// <summary>
+    /// Saves the image to the specified stream with the specified format and quality.
+    /// </summary>
+    /// <param name="stream">The stream to save the image to.</param>
+    /// <param name="format">The format to save the image in.</param>
+    /// <param name="quality">The quality of the saved image.</param>
+    void Save(Stream stream, EncodeFormat format, int quality);
+
+    /// <summary>
+    /// Asynchronously saves the image to the specified file with the specified format and quality.
+    /// </summary>
+    /// <param name="filename">The name of the file to save the image to.</param>
+    /// <param name="format">The format to save the image in.</param>
+    /// <param name="quality">The quality of the saved image.</param>
+    /// <param name="token">The cancellation token.</param>
+    /// <returns>A task representing the asynchronous save operation.</returns>
+    Task SaveAsync(string filename, EncodeFormat format, int quality, CancellationToken token = default);
+
+    /// <summary>
+    /// Asynchronously saves the image to the specified stream with the specified format and quality.
+    /// </summary>
+    /// <param name="stream">The stream to save the image to.</param>
+    /// <param name="format">The format to save the image in.</param>
+    /// <param name="quality">The quality of the saved image.</param>
+    /// <param name="token">The cancellation token.</param>
+    /// <returns>A task representing the asynchronous save operation.</returns>
+    Task SaveAsync(Stream stream, EncodeFormat format, int quality, CancellationToken token = default);
+
+    /// <summary>
+    /// Gets the RGBA image data as an array of floats.
+    /// </summary>
+    /// <returns>An array of floats representing the RGBA image data.</returns>
+    float[] GetRGBAImageData();
+}
diff --git a/API/Services/ImageServices/IImageFactory.cs b/API/Services/ImageServices/IImageFactory.cs
new file mode 100644
index 000000000..f556cd19e
--- /dev/null
+++ b/API/Services/ImageServices/IImageFactory.cs
@@ -0,0 +1,67 @@
+using System.Collections.Generic;
+using System.IO;
+using System.Numerics;
+
+namespace API.Services.ImageServices;
+
+/// <summary>
+/// Represents a factory for creating images.
+/// </summary>
+public interface IImageFactory
+{
+    /// <summary>
+    /// Creates an image from the specified file.
+    /// </summary>
+    /// <param name="filename">The path to the image file.</param>
+    /// <returns>The created image.</returns>
+    IImage Create(string filename);
+
+    /// <summary>
+    /// Creates an image from the specified stream.
+    /// </summary>
+    /// <param name="stream">The stream containing the image data.</param>
+    /// <returns>The created image.</returns>
+    IImage Create(Stream stream);
+
+    /// <summary>
+    /// Creates a blank image with the specified dimensions and color.
+    /// </summary>
+    /// <param name="width">The width of the image.</param>
+    /// <param name="height">The height of the image.</param>
+    /// <param name="red">The red component of the color (default is 0).</param>
+    /// <param name="green">The green component of the color (default is 0).</param>
+    /// <param name="blue">The blue component of the color (default is 0).</param>
+    /// <returns>The created image.</returns>
+    IImage Create(int width, int height, byte red = 0, byte green = 0, byte blue = 0);
+
+    /// <summary>
+    /// Creates an image from the specified base64 string.
+    /// </summary>
+    /// <param name="base64">The base64 string representing the image data.</param>
+    /// <returns>The created image.</returns>
+    IImage CreateFromBase64(string base64);
+
+    /// <summary>
+    /// Creates an image from the specified BGRA byte array (Output from a pdf page)
+    /// </summary>
+    /// <param name="bgraByteArray">The BGRA byte array representing the image data.</param>
+    /// <param name="width">The width of the image.</param>
+    /// <param name="height">The height of the image.</param>
+    /// <returns>The created image.</returns>
+    IImage CreateFromBGRAByteArray(byte[] bgraByteArray, int width, int height);
+
+    /// <summary>
+    /// Gets the dimensions (width and height) of the specified image file.
+    /// </summary>
+    /// <param name="filename">The path to the image file.</param>
+    /// <returns>The dimensions of the image file, or null if the dimensions cannot be determined.</returns>
+    (int Width, int Height)? GetDimensions(string filename);
+
+    /// <summary>
+    /// Gets the RGB pixels of the specified image file that is resized to a certain percentage.
+    /// </summary>
+    /// <param name="filename">The path to the image file.</param>
+    /// <param name="percent">The resizing percentage.</param>
+    /// <returns>A list of RGB pixels.</returns>
+    List<Vector3> GetRgbPixelsPercentage(string filename, float percent);
+}
diff --git a/API/Services/ImageServices/ImageMagick/ImageMagickImage.cs b/API/Services/ImageServices/ImageMagick/ImageMagickImage.cs
new file mode 100644
index 000000000..81eaea5b4
--- /dev/null
+++ b/API/Services/ImageServices/ImageMagick/ImageMagickImage.cs
@@ -0,0 +1,227 @@
+using System;
+using System.IO;
+using System.Threading;
+using System.Threading.Tasks;
+using API.Entities.Enums;
+using ImageMagick;
+
+namespace API.Services.ImageServices.ImageMagick;
+
+/// <summary>
+/// Represents an image using ImageMagick library.
+/// </summary>
+public class ImageMagickImage : IImage
+{
+    private MagickImage _image;
+
+    /// <inheritdoc/>
+    public int Width => _image?.Width ?? 0;
+
+    /// <inheritdoc/>
+    public int Height => _image?.Height ?? 0;
+
+    /// <summary>
+    /// Creates an instance of <see cref="ImageMagickImage"/> from a base64 string.
+    /// </summary>
+    /// <param name="base64">The base64 string representing the image.</param>
+    /// <returns>An instance of <see cref="ImageMagickImage"/>.</returns>
+    public static IImage CreateFromBase64(string base64)
+    {
+        ImageMagickImage m = new ImageMagickImage();
+        m._image = (MagickImage)MagickImage.FromBase64(base64);
+        return m;
+    }
+
+    /// <summary>
+    /// Creates an instance of <see cref="ImageMagickImage"/> from a BGRA byte array.
+    /// </summary>
+    /// <param name="bgraByteArray">The BGRA byte array.</param>
+    /// <param name="width">The width of the image.</param>
+    /// <param name="height">The height of the image.</param>
+    /// <returns>An instance of <see cref="ImageMagickImage"/>.</returns>
+    public static IImage CreateFromBGRAByteArray(byte[] bgraByteArray, int width, int height)
+    {
+        //Convert to RGBA float array (Image Magick 16 uses float array with values from 0-65535)
+        var floats = new float[bgraByteArray.Length];
+        for (var i = 0; i < bgraByteArray.Length; i += 4)
+        {
+            floats[i] = bgraByteArray[i + 2] << 8;
+            floats[i + 1] = bgraByteArray[i + 1] << 8;
+            floats[i + 2] = bgraByteArray[i] << 8;
+            floats[i + 3] = bgraByteArray[i + 3] << 8;
+        }
+        ImageMagickImage m = new ImageMagickImage();
+        m._image = new MagickImage(MagickColor.FromRgba(0, 0, 0, 0), width, height);
+        using var pixels = m._image.GetPixels();
+        pixels.SetArea(0, 0, width, height, floats);
+        return m;
+    }
+
+    internal ImageMagickImage()
+    {
+    }
+
+    /// <summary>
+    /// Creates an instance of <see cref="ImageMagickImage"/> from a file.
+    /// </summary>
+    /// <param name="filename">The path to the file.</param>
+    public ImageMagickImage(string filename)
+    {
+        _image = new MagickImage(filename);
+    }
+
+    /// <summary>
+    /// Creates an instance of <see cref="ImageMagickImage"/> from a stream.
+    /// </summary>
+    /// <param name="stream">The stream containing the image data.</param>
+    public ImageMagickImage(Stream stream)
+    {
+        _image = new MagickImage(stream);
+    }
+
+    /// <summary>
+    /// Creates an instance of <see cref="ImageMagickImage"/> from an existing <see cref="MagickImage"/>.
+    /// </summary>
+    /// <param name="image">The existing <see cref="MagickImage"/>.</param>
+    public ImageMagickImage(MagickImage image)
+    {
+        _image = (MagickImage)image.Clone();
+    }
+
+    /// <summary>
+    /// Creates an instance of <see cref="ImageMagickImage"/> with the specified width, height, and color.
+    /// </summary>
+    /// <param name="width">The width of the image.</param>
+    /// <param name="height">The height of the image.</param>
+    /// <param name="red">The red component of the color.</param>
+    /// <param name="green">The green component of the color.</param>
+    /// <param name="blue">The blue component of the color.</param>
+    public ImageMagickImage(int width, int height, byte red = 0, byte green = 0, byte blue = 0)
+    {
+        _image = new MagickImage(MagickColor.FromRgb(red, green, blue), width, height);
+    }
+
+    /// <inheritdoc/>
+    public IImage Clone()
+    {
+        return new ImageMagickImage(_image);
+    }
+
+    /// <inheritdoc/>
+    public void Resize(int width, int height)
+    {
+        _image.Resize(width, height);
+    }
+
+    /// <inheritdoc/>
+    public void Crop(int x, int y, int width, int height)
+    {
+        _image.Crop(new MagickGeometry(x, y, width, height));
+    }
+
+    /// <inheritdoc/>
+    public void Thumbnail(int width, int height)
+    {
+        _image.Thumbnail(new MagickGeometry(width, height) { IgnoreAspectRatio = true });
+    }
+
+    /// <inheritdoc/>
+    public void Composite(IImage overlay, int x, int y)
+    {
+        ImageMagickImage tile = overlay as ImageMagickImage;
+        if (tile == null) return;
+        _image.Composite(tile._image, x, y, CompositeOperator.Over);
+    }
+
+    /// <inheritdoc/>
+    public void Save(string filename, EncodeFormat format, int quality)
+    {
+        _image.Quality = quality;
+        _image.Write(filename, MagickFormatFromEncodeFormat(format));
+    }
+
+    /// <inheritdoc/>
+    public void Save(Stream stream, EncodeFormat format, int quality)
+    {
+        _image.Quality = quality;
+        _image.Write(stream, MagickFormatFromEncodeFormat(format));
+    }
+
+    /// <inheritdoc/>
+    public Task SaveAsync(string filename, EncodeFormat format, int quality, CancellationToken token = default)
+    {
+        _image.Quality = quality;
+        return _image.WriteAsync(filename, MagickFormatFromEncodeFormat(format), token);
+    }
+
+    /// <inheritdoc/>
+    public Task SaveAsync(Stream stream, EncodeFormat format, int quality, CancellationToken token = default)
+    {
+        _image.Quality = quality;
+        return _image.WriteAsync(stream, MagickFormatFromEncodeFormat(format), token);
+    }
+
+    /// <inheritdoc/>
+    public float[] GetRGBAImageData()
+    {
+        float[] data = null;
+        float scale = 1.0f / 256;
+        if (_image.ChannelCount == 4)
+        {
+            data = _image.GetPixels().GetValues();
+            for (int x = 0; x < data.Length; x++)
+            {
+                data[x] *= scale;
+            }
+        }
+        else if (_image.ChannelCount == 3)
+        {
+            float[] temp = _image.GetPixels().GetValues();
+            data = new float[Width * Height * 4];
+            int oi = 0;
+            int ii = 0;
+            for (int y = 0; y < Height * Width; y++)
+            {
+
+                data[oi++] = temp[ii++] * scale;
+                data[oi++] = temp[ii++] * scale;
+                data[oi++] = temp[ii++] * scale;
+                data[oi++] = 255F;
+            }
+        }
+        else if (_image.ChannelCount == 1)
+        {
+            float[] temp = _image.GetPixels().GetValues();
+            data = new float[Width * Height * 4];
+            int oi = 0;
+            int ii = 0;
+            for (int y = 0; y < Height * Width; y++)
+            {
+                data[oi++] = temp[ii++] * scale;
+                data[oi++] = temp[oi - 1];
+                data[oi++] = temp[oi - 1];
+                data[oi++] = 255F;
+            }
+        }
+
+        return data;
+    }
+
+    private static MagickFormat MagickFormatFromEncodeFormat(EncodeFormat format)
+    {
+        return format switch
+        {
+            EncodeFormat.PNG => MagickFormat.Png32,
+            EncodeFormat.WEBP => MagickFormat.WebP,
+            EncodeFormat.AVIF => MagickFormat.Avif,
+            EncodeFormat.JPEG => MagickFormat.Jpeg,
+            _ => throw new ArgumentOutOfRangeException(nameof(format), format, null)
+        };
+    }
+
+    /// <inheritdoc/>
+    public void Dispose()
+    {
+        _image?.Dispose();
+    }
+}
diff --git a/API/Services/ImageServices/ImageMagick/ImageMagickImageFactory.cs b/API/Services/ImageServices/ImageMagick/ImageMagickImageFactory.cs
new file mode 100644
index 000000000..1e7d8a556
--- /dev/null
+++ b/API/Services/ImageServices/ImageMagick/ImageMagickImageFactory.cs
@@ -0,0 +1,79 @@
+using System;
+using System.Collections.Generic;
+using System.IO;
+using System.Numerics;
+using ImageMagick;
+using Org.BouncyCastle.Ocsp;
+
+namespace API.Services.ImageServices.ImageMagick;
+
+/// <summary>
+/// Represents an image factory that uses ImageMagick library.
+/// </summary>
+public class ImageMagickImageFactory : IImageFactory
+{
+    /// <inheritdoc/>
+    public IImage Create(string filename)
+    {
+        return new ImageMagickImage(filename);
+    }
+
+    /// <inheritdoc/>
+    public IImage CreateFromBase64(string base64)
+    {
+        return ImageMagickImage.CreateFromBase64(base64);
+    }
+
+    /// <inheritdoc/>
+    public IImage CreateFromBGRAByteArray(byte[] bgraByteArray, int width, int height)
+    {
+        return ImageMagickImage.CreateFromBGRAByteArray(bgraByteArray, width, height);
+    }
+
+    /// <inheritdoc/>
+    public IImage Create(Stream stream)
+    {
+        return new ImageMagickImage(stream);
+    }
+
+    /// <inheritdoc/>
+    public IImage Create(int width, int height, byte red = 0, byte green = 0, byte blue = 0)
+    {
+        return new ImageMagickImage(width, height, red, green, blue);
+    }
+
+    /// <inheritdoc/>
+    public (int Width, int Height)? GetDimensions(string filename)
+    {
+        try
+        {
+            MagickImageInfo info = new MagickImageInfo(filename);
+            return (info.Width, info.Height);
+        }
+        catch (Exception e)
+        {
+        }
+        return null;
+    }
+
+    /// <inheritdoc/>
+    public List<Vector3> GetRgbPixelsPercentage(string filename, float percent)
+    {
+        var settings = new MagickReadSettings { ColorSpace = ColorSpace.RGB };
+        using var im = new MagickImage(filename, settings);
+
+        // Resize the image to speed up processing
+        im.Resize(new Percentage(percent));
+        // Convert image to RGB array
+        float[] pixels = im.GetPixels().ToArray();
+        if (pixels == null)
+            return new List<Vector3>();
+        float mul = 1F / 256F;
+        var rgbPixels = new List<Vector3>();
+        // Convert to list of Vector3 (RGB)
+
+        for (int x = 0; x < pixels.Length; x += im.ChannelCount)
+            rgbPixels.Add(new Vector3(pixels[x] * mul, pixels[x + 1] * mul, pixels[x + 2] * mul));
+        return rgbPixels;
+    }
+}
diff --git a/API/Helpers/SmartCropHelper.cs b/API/Services/ImageServices/SmartCrop.cs
similarity index 83%
rename from API/Helpers/SmartCropHelper.cs
rename to API/Services/ImageServices/SmartCrop.cs
index fdeb50f2f..b568fcff4 100644
--- a/API/Helpers/SmartCropHelper.cs
+++ b/API/Services/ImageServices/SmartCrop.cs
@@ -1,11 +1,7 @@
 using System;
 using System.Collections.Generic;
 
-using System.Threading.Tasks;
-using ImageMagick;
-
-
-namespace API.Helpers
+namespace API.Services.ImageServices
 {
     /**
      * C# port of smartcrop.js
@@ -33,22 +29,16 @@ namespace API.Helpers
      * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
      */
 
-    public static class SmartCropHelper
+    public static class SmartCrop
     {
 
-        public static MagickGeometry SmartCrop(MagickImage inputImage, int width, int height)
-        {
-            SmartCropOptions options = new SmartCropOptions
-            {
-                Width = width,
-                Height = height
-            };
-            CropResult result = SmartCrop(inputImage, options);
-            return new MagickGeometry(result.TopCrop.X, result.TopCrop.Y, result.TopCrop.Width, result.TopCrop.Height) { FillArea = false };
-        }
-
-
-        public static CropResult SmartCrop(MagickImage inputImage, SmartCropOptions options = null)
+        /// <summary>
+        /// Performs content aware smart cropping on the input image using the specified options.
+        /// </summary>
+        /// <param name="inputImage">The input image to crop.</param>
+        /// <param name="options">The options for smart cropping.</param>
+        /// <returns>The crop result containing the generated crops and the top crop.</returns>
+        public static CropResult Crop(IImage inputImage, SmartCropOptions options = null)
         {
             if (options.Aspect != 0)
             {
@@ -59,7 +49,7 @@ public static CropResult SmartCrop(MagickImage inputImage, SmartCropOptions opti
             var prescale = 1.0f;
 
             // Open the image
-            var image = (MagickImage)inputImage.Clone();
+            var image = inputImage.Clone();
             if (options.Width != 0 && options.Height != 0)
             {
                 scale = Math.Min(image.Width / options.Width, image.Height / options.Height);
@@ -115,7 +105,7 @@ private static CropResult Analyse(SmartCropOptions options, ImageData input)
             var scoreOutput = DownSample(output, options.ScoreDownSample);
 
             var topScore = double.NegativeInfinity;
-            Crop topCrop = null;
+            CropItem topCrop = null;
             result.Crops = GenerateCrops(options, input.Width, input.Height);
 
             foreach (var crop in result.Crops)
@@ -133,10 +123,10 @@ private static CropResult Analyse(SmartCropOptions options, ImageData input)
         }
         private static float Thirds(double x)
         {
-            x = (((x - 1.0 / 3.0 + 1.0) % 2.0) * 0.5 - 0.5) * 16.0;
+            x = ((x - 1.0 / 3.0 + 1.0) % 2.0 * 0.5 - 0.5) * 16.0;
             return (float)Math.Max(1.0 - x * x, 0.0);
         }
-        private static float Importance(SmartCropOptions options, Crop crop, double x, double y)
+        private static float Importance(SmartCropOptions options, CropItem crop, double x, double y)
         {
             if (crop.X > x || x >= crop.X + crop.Width || crop.Y > y || y >= crop.Y + crop.Height)
             {
@@ -161,7 +151,7 @@ private static float Importance(SmartCropOptions options, Crop crop, double x, d
 
             return (float)(s + d);
         }
-        private static ScoreResult Score(SmartCropOptions options, ImageData output, Crop crop)
+        private static ScoreResult Score(SmartCropOptions options, ImageData output, CropItem crop)
         {
 
 
@@ -184,10 +174,10 @@ private static ScoreResult Score(SmartCropOptions options, ImageData output, Cro
                     var i = Importance(options, crop, x, y);
                     var detail = od[p + 1] / 255.0;
 
-                    rskin += (od[p] / 255.0) * (detail + options.SkinBias) * i;
+                    rskin += od[p] / 255.0 * (detail + options.SkinBias) * i;
                     rdetail += detail * i;
-                    rsaturation += (od[p + 2] / 255.0) * (detail + options.SaturationBias) * i;
-                    rboost += (od[p + 3] / 255.0) * i;
+                    rsaturation += od[p + 2] / 255.0 * (detail + options.SaturationBias) * i;
+                    rboost += od[p + 3] / 255.0 * i;
                 }
             }
 
@@ -200,7 +190,7 @@ private static ScoreResult Score(SmartCropOptions options, ImageData output, Cro
                 Total = (float)((rdetail * options.DetailWeight + rskin * options.SkinWeight +
                                  rsaturation * options.SaturationWeight +
                                  rboost * options.BoostWeight) /
-                                (double)(crop.Width * crop.Height))
+                                (crop.Width * crop.Height))
             };
         }
         private static void EdgeDetect(ImageData input, ImageData output)
@@ -208,7 +198,7 @@ private static void EdgeDetect(ImageData input, ImageData output)
             // Get the pixel collection of both input and output images
             float[] inputPixels = input.Data;
             float[] outputPixels = output.Data;
-            
+
             int width = input.Width;
             int height = input.Height;
 
@@ -237,12 +227,12 @@ private static void EdgeDetect(ImageData input, ImageData output)
                 }
             }
         }
-        private static List<Crop> GenerateCrops(SmartCropOptions options, int width, int height)
+        private static List<CropItem> GenerateCrops(SmartCropOptions options, int width, int height)
         {
-            var results = new List<Crop>();
+            var results = new List<CropItem>();
             var minDimension = Math.Min(width, height);
             var cropWidth = options.CropWidth != 0 ? options.CropWidth : minDimension;
-            var cropHeight = options.CropHeight!=0 ? options.CropHeight : minDimension;
+            var cropHeight = options.CropHeight != 0 ? options.CropHeight : minDimension;
 
             for (var scale = options.MaxScale; scale >= options.MinScale; scale -= options.ScaleStep)
             {
@@ -250,7 +240,7 @@ private static List<Crop> GenerateCrops(SmartCropOptions options, int width, int
                 {
                     for (var x = 0; x + cropWidth * scale <= width; x += options.Step)
                     {
-                        results.Add(new Crop
+                        results.Add(new CropItem
                         {
                             X = x,
                             Y = y,
@@ -265,13 +255,13 @@ private static List<Crop> GenerateCrops(SmartCropOptions options, int width, int
         }
         private static void ApplyBoosts(SmartCropOptions options, ImageData output)
         {
-            if (options.Boosts.Count==0) return;
+            if (options.Boosts.Count == 0) return;
             var od = output.Data;
             for (int i = 0; i < output.Width; i += 4)
             {
                 od[i + 3] = 0;
             }
-            foreach(Boost boost in options.Boosts)
+            foreach (Boost boost in options.Boosts)
             {
                 ApplyBoost(boost, options, output);
             }
@@ -299,7 +289,7 @@ private static ImageData DownSample(ImageData input, int factor)
                     {
                         for (var u = 0; u < factor; u++)
                         {
-                            var j = ((y * factor + v) * iwidth + (x * factor + u)) * 4;
+                            var j = ((y * factor + v) * iwidth + x * factor + u) * 4;
                             r += idata[j];
                             g += idata[j + 1];
                             b += idata[j + 2];
@@ -322,9 +312,9 @@ private static void ApplyBoost(Boost boost, SmartCropOptions options, ImageData
         {
             var od = output.Data;
             var w = output.Width;
-            var x0 = (int)(boost.X);
+            var x0 = (int)boost.X;
             var x1 = (int)(boost.X + boost.Width);
-            var y0 = (int)(boost.Y);
+            var y0 = (int)boost.Y;
             var y1 = (int)(boost.Y + boost.Height);
             var weight = boost.Weight * 255;
             for (var y = y0; y < y1; y++)
@@ -379,7 +369,7 @@ private static float Saturation(float r, float g, float b)
 
             return l > 0.5f ? d / (2.0f - maximum - minimum) : d / (maximum + minimum);
         }
-        private static void  SkinDetect(SmartCropOptions options, ImageData i, ImageData o)
+        private static void SkinDetect(SmartCropOptions options, ImageData i, ImageData o)
         {
             float[] id = i.Data;
             float[] od = o.Data;
@@ -410,7 +400,7 @@ private static float Sample(float[] data, int p)
         {
             return CIE(data[p], data[p + 1], data[p + 2]);
         }
-        private static float CIE(float r, float g,  float b)
+        private static float CIE(float r, float g, float b)
         {
             return 0.5126f * b + 0.7152f * g + 0.0722f * r;
         }
@@ -423,6 +413,9 @@ private static float SkinColor(SmartCropOptions options, float r, float g, float
             double d = Math.Sqrt(rd * rd + gd * gd + bd * bd);
             return (float)(1.0 - d);
         }
+        /// <summary>
+        /// Represents the options for content aware smart cropping.
+        /// </summary>
         public class SmartCropOptions
         {
             public int Width { get; set; } = 0;
@@ -457,8 +450,8 @@ public class SmartCropOptions
         }
         public class CropResult
         {
-            public List<Crop> Crops { get; set; }
-            public Crop TopCrop { get; set; }
+            public List<CropItem> Crops { get; set; }
+            public CropItem TopCrop { get; set; }
         }
         public class ScoreResult
         {
@@ -468,13 +461,12 @@ public class ScoreResult
             public float Boost { get; set; }
             public float Total { get; set; }
         }
-        public class Crop
+        public class CropItem
         {
             public int X { get; set; }
             public int Y { get; set; }
             public int Width { get; set; }
             public int Height { get; set; }
-
             public ScoreResult Score { get; set; }
         }
         public class Boost
@@ -498,48 +490,11 @@ public ImageData(int width, int height)
                 Data = new float[width * height * 4];
             }
 
-            public ImageData(MagickImage image)
+            public ImageData(IImage image)
             {
                 Width = image.Width;
                 Height = image.Height;
-                float scale = 1.0f / 256;
-                if (image.ChannelCount == 4)
-                {
-                    Data = image.GetPixels().GetValues();
-                    for (int x = 0; x < Data.Length; x++)
-                    {
-                        Data[x] *= scale;
-                    }
-                }
-                else if (image.ChannelCount == 3)
-                {
-                    float[] temp = image.GetPixels().GetValues();
-                    Data = new float[Width * Height * 4];
-                    int oi = 0;
-                    int ii = 0;
-                    for(int y = 0; y < Height*Width; y++)
-                    {
-
-                        Data[oi++] = temp[ii++] * scale;
-                        Data[oi++] = temp[ii++] * scale;
-                        Data[oi++] = temp[ii++] * scale;
-                        Data[oi++] = 255F;
-                    }
-                }
-                else if (image.ChannelCount == 1)
-                {
-                    float[] temp = image.GetPixels().GetValues();
-                    Data = new float[Width * Height * 4];
-                    int oi = 0;
-                    int ii = 0;
-                    for (int y = 0; y < Height * Width; y++)
-                    {
-                        Data[oi++] = temp[ii++] * scale;
-                        Data[oi++] = temp[oi-1];
-                        Data[oi++] = temp[oi-1];
-                        Data[oi++] = 255F;
-                    }
-                }
+                Data = image.GetRGBAImageData();
             }
         }
     }
diff --git a/API/Services/ReadingListService.cs b/API/Services/ReadingListService.cs
index 36048ae3d..aa63a274e 100644
--- a/API/Services/ReadingListService.cs
+++ b/API/Services/ReadingListService.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Collections.Generic;
 using System.IO;
 using System.Linq;
@@ -823,7 +823,7 @@ public async Task<string> GenerateReadingListCoverImage(int readingListId)
         destFile += settings.EncodeMediaAs.GetExtension();
 
         if (_directoryService.FileSystem.File.Exists(destFile)) return destFile;
-        ImageService.CreateMergedImage(
+        _imageService.CreateMergedImage(
             covers.Select(c => _directoryService.FileSystem.Path.Join(_directoryService.CoverImageDirectory, c)).ToList(),
             settings.CoverImageSize,
             destFile);
diff --git a/docker-build.sh b/docker-build.sh
index 072676a78..326a17f5c 100755
--- a/docker-build.sh
+++ b/docker-build.sh
@@ -100,4 +100,4 @@ Package "linux-arm64"
 cd "$dir"
 
 #Builds Docker images
-docker buildx build -t kizaing/kavita:nightly --platform linux/amd64,linux/arm/v7,linux/arm64 . --push
+#docker buildx build -t kizaing/kavita:nightly --platform linux/amd64,linux/arm/v7,linux/arm64 . --push

From 361c46499d9f08b0bcfcc9e9c176c287fe1795e8 Mon Sep 17 00:00:00 2001
From: Maximo Piva <mpiva@adventintermodal.com>
Date: Thu, 3 Oct 2024 21:12:28 -0300
Subject: [PATCH 23/30] BOM Fixes

---
 API.Benchmark/ArchiveServiceBenchmark.cs       | 2 +-
 API.Tests/Services/ArchiveServiceTests.cs      | 2 +-
 API.Tests/Services/BookServiceTests.cs         | 2 +-
 API.Tests/Services/CacheServiceTests.cs        | 2 +-
 API.Tests/Services/ImageServiceTests.cs        | 2 +-
 API/API.csproj                                 | 2 +-
 API/Controllers/ImageController.cs             | 2 +-
 API/Entities/Enums/EncodeFormat.cs             | 2 +-
 API/Extensions/ApplicationServiceExtensions.cs | 2 +-
 API/Extensions/EncodeFormatExtensions.cs       | 2 +-
 API/Extensions/HttpExtensions.cs               | 2 +-
 API/Services/ArchiveService.cs                 | 2 +-
 API/Services/BookService.cs                    | 2 +-
 API/Services/CacheService.cs                   | 2 +-
 API/Services/ImageService.cs                   | 2 +-
 API/Services/ReadingListService.cs             | 2 +-
 16 files changed, 16 insertions(+), 16 deletions(-)

diff --git a/API.Benchmark/ArchiveServiceBenchmark.cs b/API.Benchmark/ArchiveServiceBenchmark.cs
index e975bd00f..3667de414 100644
--- a/API.Benchmark/ArchiveServiceBenchmark.cs
+++ b/API.Benchmark/ArchiveServiceBenchmark.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.IO;
 using System.IO.Abstractions;
 using API.Entities.Enums;
diff --git a/API.Tests/Services/ArchiveServiceTests.cs b/API.Tests/Services/ArchiveServiceTests.cs
index 7f0a9b7b7..497effad1 100644
--- a/API.Tests/Services/ArchiveServiceTests.cs
+++ b/API.Tests/Services/ArchiveServiceTests.cs
@@ -1,4 +1,4 @@
-using System.Diagnostics;
+using System.Diagnostics;
 using System.IO;
 using System.IO.Abstractions;
 using System.IO.Abstractions.TestingHelpers;
diff --git a/API.Tests/Services/BookServiceTests.cs b/API.Tests/Services/BookServiceTests.cs
index 48245e639..a07dcd49c 100644
--- a/API.Tests/Services/BookServiceTests.cs
+++ b/API.Tests/Services/BookServiceTests.cs
@@ -1,4 +1,4 @@
-using System.IO;
+using System.IO;
 using System.IO.Abstractions;
 using API.Services;
 using API.Services.ImageServices;
diff --git a/API.Tests/Services/CacheServiceTests.cs b/API.Tests/Services/CacheServiceTests.cs
index 2bc18f8b6..15df966bf 100644
--- a/API.Tests/Services/CacheServiceTests.cs
+++ b/API.Tests/Services/CacheServiceTests.cs
@@ -1,4 +1,4 @@
-using System.Collections.Generic;
+using System.Collections.Generic;
 using System.Data.Common;
 using System.IO;
 using System.IO.Abstractions.TestingHelpers;
diff --git a/API.Tests/Services/ImageServiceTests.cs b/API.Tests/Services/ImageServiceTests.cs
index 3f63228e6..2497f02be 100644
--- a/API.Tests/Services/ImageServiceTests.cs
+++ b/API.Tests/Services/ImageServiceTests.cs
@@ -1,4 +1,4 @@
-using System.Drawing;
+using System.Drawing;
 using System.IO;
 using System.IO.Abstractions;
 using System.Linq;
diff --git a/API/API.csproj b/API/API.csproj
index 169ddfab9..3729b9689 100644
--- a/API/API.csproj
+++ b/API/API.csproj
@@ -1,4 +1,4 @@
-<Project Sdk="Microsoft.NET.Sdk.Web">
+<Project Sdk="Microsoft.NET.Sdk.Web">
 
   <PropertyGroup>
     <AnalysisMode>Default</AnalysisMode>
diff --git a/API/Controllers/ImageController.cs b/API/Controllers/ImageController.cs
index 5a0379879..32e4a86f1 100644
--- a/API/Controllers/ImageController.cs
+++ b/API/Controllers/ImageController.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.IO;
 using System.Linq;
 using System.Threading.Tasks;
diff --git a/API/Entities/Enums/EncodeFormat.cs b/API/Entities/Enums/EncodeFormat.cs
index 189b12745..f42ba4586 100644
--- a/API/Entities/Enums/EncodeFormat.cs
+++ b/API/Entities/Enums/EncodeFormat.cs
@@ -1,4 +1,4 @@
-using System.ComponentModel;
+using System.ComponentModel;
 
 namespace API.Entities.Enums;
 
diff --git a/API/Extensions/ApplicationServiceExtensions.cs b/API/Extensions/ApplicationServiceExtensions.cs
index cbcad8206..c2c44ef23 100644
--- a/API/Extensions/ApplicationServiceExtensions.cs
+++ b/API/Extensions/ApplicationServiceExtensions.cs
@@ -1,4 +1,4 @@
-using System.IO.Abstractions;
+using System.IO.Abstractions;
 using API.Constants;
 using API.Data;
 using API.Helpers;
diff --git a/API/Extensions/EncodeFormatExtensions.cs b/API/Extensions/EncodeFormatExtensions.cs
index 301c69fa5..21b57ef43 100644
--- a/API/Extensions/EncodeFormatExtensions.cs
+++ b/API/Extensions/EncodeFormatExtensions.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using API.Entities.Enums;
 
 namespace API.Extensions;
diff --git a/API/Extensions/HttpExtensions.cs b/API/Extensions/HttpExtensions.cs
index 715fd0b1b..32d82f9ff 100644
--- a/API/Extensions/HttpExtensions.cs
+++ b/API/Extensions/HttpExtensions.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Collections.Generic;
 using System.IO;
 using System.Linq;
diff --git a/API/Services/ArchiveService.cs b/API/Services/ArchiveService.cs
index 46ea4c301..078ae0500 100644
--- a/API/Services/ArchiveService.cs
+++ b/API/Services/ArchiveService.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Collections.Generic;
 using System.Diagnostics;
 using System.IO;
diff --git a/API/Services/BookService.cs b/API/Services/BookService.cs
index 27096f9cb..4df3f422f 100644
--- a/API/Services/BookService.cs
+++ b/API/Services/BookService.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Collections.Generic;
 using System.Globalization;
 using System.IO;
diff --git a/API/Services/CacheService.cs b/API/Services/CacheService.cs
index 6c0fe17a9..f123ea9f3 100644
--- a/API/Services/CacheService.cs
+++ b/API/Services/CacheService.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Collections.Concurrent;
 using System.Collections.Generic;
 using System.Diagnostics;
diff --git a/API/Services/ImageService.cs b/API/Services/ImageService.cs
index d20f8584f..194053b9e 100644
--- a/API/Services/ImageService.cs
+++ b/API/Services/ImageService.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Collections.Generic;
 using System.Diagnostics;
 using System.Drawing;
diff --git a/API/Services/ReadingListService.cs b/API/Services/ReadingListService.cs
index aa63a274e..545242485 100644
--- a/API/Services/ReadingListService.cs
+++ b/API/Services/ReadingListService.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Collections.Generic;
 using System.IO;
 using System.Linq;

From d6056b80d1eeac87af310885800a6549e4f70a6a Mon Sep 17 00:00:00 2001
From: Maximo Piva <maximo.piva@gmail.com>
Date: Thu, 3 Oct 2024 21:16:57 -0300
Subject: [PATCH 24/30] Update docker-build.sh

Enable back docker build/push
---
 docker-build.sh | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docker-build.sh b/docker-build.sh
index 326a17f5c..072676a78 100755
--- a/docker-build.sh
+++ b/docker-build.sh
@@ -100,4 +100,4 @@ Package "linux-arm64"
 cd "$dir"
 
 #Builds Docker images
-#docker buildx build -t kizaing/kavita:nightly --platform linux/amd64,linux/arm/v7,linux/arm64 . --push
+docker buildx build -t kizaing/kavita:nightly --platform linux/amd64,linux/arm/v7,linux/arm64 . --push

From 92f131a2a36e1930f384164759e61f08d6ccd543 Mon Sep 17 00:00:00 2001
From: Maximo Piva <mpiva@adventintermodal.com>
Date: Fri, 4 Oct 2024 15:33:25 -0300
Subject: [PATCH 25/30] Fixed Benchmarks

---
 API.Benchmark/API.Benchmark.csproj       |   5 +++
 API.Benchmark/ArchiveServiceBenchmark.cs |  41 ++++-------------------
 API.Benchmark/Data/comic-normal.jpg      | Bin 0 -> 457527 bytes
 3 files changed, 12 insertions(+), 34 deletions(-)
 create mode 100644 API.Benchmark/Data/comic-normal.jpg

diff --git a/API.Benchmark/API.Benchmark.csproj b/API.Benchmark/API.Benchmark.csproj
index 2dcf08f32..38c09b577 100644
--- a/API.Benchmark/API.Benchmark.csproj
+++ b/API.Benchmark/API.Benchmark.csproj
@@ -26,5 +26,10 @@
         <CopyToOutputDirectory>Always</CopyToOutputDirectory>
       </Content>
     </ItemGroup>
+    <ItemGroup>
+      <None Update="Data\comic-normal.jpg">
+        <CopyToOutputDirectory>Always</CopyToOutputDirectory>
+      </None>
+    </ItemGroup>
 
 </Project>
diff --git a/API.Benchmark/ArchiveServiceBenchmark.cs b/API.Benchmark/ArchiveServiceBenchmark.cs
index 3667de414..31f3088e8 100644
--- a/API.Benchmark/ArchiveServiceBenchmark.cs
+++ b/API.Benchmark/ArchiveServiceBenchmark.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.IO;
 using System.IO.Abstractions;
 using API.Entities.Enums;
@@ -25,8 +25,8 @@ public class ArchiveServiceBenchmark
     private readonly IDirectoryService _directoryService;
     private readonly IImageService _imageService;
     private readonly IImageFactory _imageFactory;
-    private const string SourceImage = "C:/Users/josep/Pictures/obey_by_grrsa-d6llkaa_colored_by_me.png";
-
+    private const string SourceImage = "Data/comic-normal.jpg";
+        
 
     public ArchiveServiceBenchmark()
     {
@@ -61,9 +61,9 @@ public void TestGetComicInfo_outside_root()
     }
 
     [Benchmark]
-    public void ImageSharp_ExtractImage_PNG()
+    public void ImageMagick_ExtractImage_PNG()
     {
-        var outputDirectory = "C:/Users/josep/Pictures/imagesharp/";
+        var outputDirectory = "Data/ImageMagick";
         _directoryService.ExistOrCreate(outputDirectory);
 
         using var stream = new FileStream(SourceImage, FileMode.Open);
@@ -75,9 +75,9 @@ public void ImageSharp_ExtractImage_PNG()
     }
 
     [Benchmark]
-    public void ImageSharp_ExtractImage_WebP()
+    public void ImageMagick_ExtractImage_WebP()
     {
-        var outputDirectory = "C:/Users/josep/Pictures/imagesharp/";
+        var outputDirectory = "Data/ImageMagick";
         _directoryService.ExistOrCreate(outputDirectory);
 
         using var stream = new FileStream(SourceImage, FileMode.Open);
@@ -88,33 +88,6 @@ public void ImageSharp_ExtractImage_WebP()
         thumbnail2.Save(_directoryService.FileSystem.Path.Join(outputDirectory, "imagesharp.webp"), EncodeFormat.PNG, 100);
     }
 
-    [Benchmark]
-    public void NetVips_ExtractImage_PNG()
-    {
-        var outputDirectory = "C:/Users/josep/Pictures/netvips/";
-        _directoryService.ExistOrCreate(outputDirectory);
-
-        using var stream = new FileStream(SourceImage, FileMode.Open);
-        using var thumbnail = _imageFactory.Create(stream);
-        int width = 320;
-        int height = (int)(thumbnail.Height * (width / (double)thumbnail.Width));
-        thumbnail.Thumbnail(width, height);
-        thumbnail.Save(_directoryService.FileSystem.Path.Join(outputDirectory, "netvips.png"), EncodeFormat.PNG, 100);
-    }
-
-    [Benchmark]
-    public void NetVips_ExtractImage_WebP()
-    {
-        var outputDirectory = "C:/Users/josep/Pictures/netvips/";
-        _directoryService.ExistOrCreate(outputDirectory);
-
-        using var stream = new FileStream(SourceImage, FileMode.Open);
-        using var thumbnail = _imageFactory.Create(stream);
-        int width = 320;
-        int height = (int)(thumbnail.Height * (width / (double)thumbnail.Width));
-        thumbnail.Thumbnail(width, height);
-        thumbnail.Save(_directoryService.FileSystem.Path.Join(outputDirectory, "netvips.webp"), EncodeFormat.WEBP, 100);
-    }
 
     // Benchmark to test default GetNumberOfPages from archive
     // vs a new method where I try to open the archive and return said stream
diff --git a/API.Benchmark/Data/comic-normal.jpg b/API.Benchmark/Data/comic-normal.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..91a8f9b8e8f7f55c91e9eabf2990c794b94bfd0f
GIT binary patch
literal 457527
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%0D;%
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

literal 0
HcmV?d00001


From 4f026e625391eba91834dd24d3fe3dce97ad0ab2 Mon Sep 17 00:00:00 2001
From: Maximo Piva <mpiva@adventintermodal.com>
Date: Fri, 4 Oct 2024 15:36:22 -0300
Subject: [PATCH 26/30] Fixed BOM

---
 API.Benchmark/ArchiveServiceBenchmark.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/API.Benchmark/ArchiveServiceBenchmark.cs b/API.Benchmark/ArchiveServiceBenchmark.cs
index 31f3088e8..589433360 100644
--- a/API.Benchmark/ArchiveServiceBenchmark.cs
+++ b/API.Benchmark/ArchiveServiceBenchmark.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.IO;
 using System.IO.Abstractions;
 using API.Entities.Enums;

From 00ee60b485893fa364eced0477d8f791c16ed8da Mon Sep 17 00:00:00 2001
From: Maximo Piva <mpiva@adventintermodal.com>
Date: Thu, 10 Oct 2024 17:57:33 -0300
Subject: [PATCH 27/30] Requested changes. Added Per Image Lock on conversion,
 to prevent multiple threads from processing the same image at the same time.

---
 API/Entities/Enums/EncodeFormat.cs            |   6 +-
 API/Extensions/HttpExtensions.cs              |  22 +-
 API/Services/ImageService.cs                  |  84 +-
 API/Services/ImageService.cs.bak              | 994 ++++++++++++++++++
 .../ImageMagick/ImageMagickImage.cs           |  13 +-
 API/Services/Tasks/Scanner/Parser/Parser.cs   |  22 +-
 6 files changed, 1096 insertions(+), 45 deletions(-)
 create mode 100644 API/Services/ImageService.cs.bak

diff --git a/API/Entities/Enums/EncodeFormat.cs b/API/Entities/Enums/EncodeFormat.cs
index f42ba4586..0d6140927 100644
--- a/API/Entities/Enums/EncodeFormat.cs
+++ b/API/Entities/Enums/EncodeFormat.cs
@@ -1,8 +1,8 @@
-using System.ComponentModel;
+using System.ComponentModel;
 
 namespace API.Entities.Enums;
 
-public enum EncodeFormat 
+public enum EncodeFormat
 {
     [Description("PNG")]
     PNG = 0,
@@ -10,7 +10,7 @@ public enum EncodeFormat
     WEBP = 1,
     [Description("AVIF")]
     AVIF = 2,
-    //Internal Use
+    /// Internal Use
     [Description("JPEG")]
     JPEG = 3
 }
diff --git a/API/Extensions/HttpExtensions.cs b/API/Extensions/HttpExtensions.cs
index 32d82f9ff..5e6f76d65 100644
--- a/API/Extensions/HttpExtensions.cs
+++ b/API/Extensions/HttpExtensions.cs
@@ -80,28 +80,30 @@ public static List<string> SupportedImageTypesFromRequest(this HttpRequest reque
 
         List<string> supportedExtensions = new List<string>();
 
-        //Add default extensions supported by all browsers.
+        // Add default extensions supported by all browsers.
         supportedExtensions.AddRange(Parser.UniversalFileImageExtensionArray);
-        //Browser add specific image mime types, when the image type is not a global standard, browser specify the specific image type in the accept header.
-        //Let's reuse that to identify the additional image types supported by the browser.
-        foreach (string v in split)
+
+        // Browser add specific image mime types, when the image type is not a global standard, browser specify the specific image type in the accept header.
+        // Let's reuse that to identify the additional image types supported by the browser.
+        foreach (var v in split)
         {
             if (v.StartsWith("image/", StringComparison.InvariantCultureIgnoreCase))
             {
-                string mimeimagepart = v.Substring(6).ToLowerInvariant();
-                if (mimeimagepart.StartsWith("*")) continue;
-                if (Parser.NonUniversalSupportedMimeMappings.ContainsKey(mimeimagepart))
+                var mimeImagePart = v.Substring(6).ToLowerInvariant();
+                if (mimeImagePart.StartsWith("*")) continue;
+                if (Parser.NonUniversalSupportedMimeMappings.ContainsKey(mimeImagePart))
                 {
-                    Parser.NonUniversalSupportedMimeMappings[mimeimagepart].ForEach(x => AddExtension(supportedExtensions, x));
+                    Parser.NonUniversalSupportedMimeMappings[mimeImagePart].ForEach(x => AddExtension(supportedExtensions, x));
                 }
-                else if (mimeimagepart == "svg+xml")
+                else if (mimeImagePart == "svg+xml")
                 {
                     AddExtension(supportedExtensions, "svg");
                 }
                 else
-                    AddExtension(supportedExtensions, mimeimagepart);
+                    AddExtension(supportedExtensions, mimeImagePart);
             }
         }
+
         return supportedExtensions;
     }
 }
diff --git a/API/Services/ImageService.cs b/API/Services/ImageService.cs
index 194053b9e..0f8991b5a 100644
--- a/API/Services/ImageService.cs
+++ b/API/Services/ImageService.cs
@@ -1,11 +1,15 @@
 using System;
+using System.Collections.Concurrent;
 using System.Collections.Generic;
 using System.Diagnostics;
 using System.Drawing;
 using System.IO;
 using System.Linq;
 using System.Numerics;
+using System.Security.Cryptography;
+using System.Text;
 using System.Text.RegularExpressions;
+using System.Threading;
 using System.Threading.Tasks;
 using API.Constants;
 using API.DTOs;
@@ -155,19 +159,13 @@ public interface IImageService
 public class ImageService : IImageService
 {
     public const string Name = "ImageService";
-    private readonly ILogger<ImageService> _logger;
-    private readonly IDirectoryService _directoryService;
-    private readonly IEasyCachingProviderFactory _cacheFactory;
-    private readonly IImageFactory _imageFactory;
     public const string ChapterCoverImageRegex = @"v\d+_c\d+";
     public const string SeriesCoverImageRegex = @"series\d+";
     public const string CollectionTagCoverImageRegex = @"tag\d+";
     public const string ReadingListCoverImageRegex = @"readinglist\d+";
-
     private const double WhiteThreshold = 0.95; // Colors with lightness above this are considered too close to white
     private const double BlackThreshold = 0.25; // Colors with lightness below this are considered too close to black
 
-
     /// <summary>
     /// Width of the Thumbnail generation
     /// </summary>
@@ -181,6 +179,10 @@ public class ImageService : IImageService
     /// </summary>
     public const int LibraryThumbnailWidth = 32;
 
+    private readonly ILogger<ImageService> _logger;
+    private readonly IDirectoryService _directoryService;
+    private readonly IEasyCachingProviderFactory _cacheFactory;
+    private readonly IImageFactory _imageFactory;
 
     private static readonly string[] ValidIconRelations = {
         "icon",
@@ -197,6 +199,21 @@ public class ImageService : IImageService
         ["https://app.plex.tv"] = "https://plex.tv"
     };
 
+
+
+    private static NamedMonitor _lock = new NamedMonitor();
+    /// <summary>
+    /// Represents a named monitor that provides thread-safe access to objects based on their names.
+    /// </summary>
+    class NamedMonitor
+    {
+        readonly ConcurrentDictionary<string, object> _dictionary = new ConcurrentDictionary<string, object>();
+
+        public object this[string name] => _dictionary.GetOrAdd(name, _ => new object());
+    }
+
+
+
     /// <summary>
     /// Initializes a new instance of the <see cref="ImageService"/> class.
     /// </summary>
@@ -229,7 +246,7 @@ public void ExtractImages(string? fileFilePath, string targetDirectory, int file
                 Tasks.Scanner.Parser.Parser.ImageFileExtensions);
         }
     }
-    
+
     /// <summary>
     /// Creates a thumbnail image from the specified image with the given width and height.
     /// If the image aspect ratio is significantly different from the target aspect ratio, it will be context aware cropped to fit.
@@ -332,12 +349,10 @@ public string WriteCoverThumbnail(Stream stream, string fileName, string outputD
         try
         {
             thumbnail.Save(_directoryService.FileSystem.Path.Join(outputDirectory, filename), encodeFormat, quality);
-            return filename;
-        }
-        catch (Exception)
-        {
-            return string.Empty; //IDK?
         }
+        catch (Exception) {/* Swallow exception */}
+
+        return filename;
     }
     /// <inheritdoc/>
     public string WriteCoverThumbnail(string sourceFile, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size = CoverImageSize.Default, int quality = 100)
@@ -351,6 +366,7 @@ public string WriteCoverThumbnail(string sourceFile, string fileName, string out
             _directoryService.FileSystem.File.Delete(_directoryService.FileSystem.Path.Join(outputDirectory, filename));
         } catch (Exception) {/* Swallow exception */}
         thumbnail.Save(_directoryService.FileSystem.Path.Join(outputDirectory, filename), encodeFormat, quality);
+
         return filename;
     }
     /// <inheritdoc/>
@@ -361,6 +377,7 @@ public async Task<string> ConvertToEncodingFormat(string filePath, string output
         var outputFile = Path.Join(outputPath, fileName + encodeFormat.GetExtension());
         using var sourceImage = _imageFactory.Create(filePath);
         await sourceImage.SaveAsync(outputFile, encodeFormat, quality).ConfigureAwait(false);
+
         return outputFile;
     }
 
@@ -369,9 +386,7 @@ public Task<bool> IsImage(string filePath)
     {
         try
         {
-            var result= _imageFactory.GetDimensions(filePath);
-            if (result!=null)
-                return Task.FromResult(true);
+            return Task.FromResult(_imageFactory.GetDimensions(filePath) != null);
         }
         catch (Exception)
         {
@@ -521,7 +536,7 @@ public async Task<string> DownloadPublisherImageAsync(string publisherName, Enco
 
         return (null, null);
     }
-    
+
     private static bool IsColorCloseToWhiteOrBlack(Vector3 color)
     {
         var (_, _, lightness) = RgbToHsl(color);
@@ -690,26 +705,41 @@ public ColorScape CalculateColorScape(string sourceFile)
     }
     private bool CheckDirectSupport(string filename, List<string> supportedImageFormats)
     {
-        if (supportedImageFormats == null)
-            return false;
+        if (supportedImageFormats == null) return false;
+
         string ext = Path.GetExtension(filename).ToLowerInvariant().Substring(1);
         return supportedImageFormats.Contains(ext);
     }
+
+
     /// <inheritdoc/>
     public string ReplaceImageFileFormat(string filename, List<string> supportedImageFormats = null, EncodeFormat format = EncodeFormat.JPEG, int quality = 99)
     {
-        if (CheckDirectSupport(filename, supportedImageFormats))
-            return filename;
+        if (CheckDirectSupport(filename, supportedImageFormats)) return filename;
+
         Match m = Regex.Match(Path.GetExtension(filename), Parser.NonUniversalFileImageExtensions, RegexOptions.IgnoreCase, Parser.RegexTimeout);
-        if (!m.Success)
-            return filename;
-        var sw = Stopwatch.StartNew();
+        if (!m.Success) return filename;
+
         string destination = Path.ChangeExtension(filename, format.GetExtension().Substring(1));
 
-        using var sourceImage = _imageFactory.Create(filename);
-        sourceImage.Save(destination, format, quality);
-        File.Delete(filename);
-        _logger.LogDebug("Image converted from '{Extension}' to '{format.GetExtension()}' in {ElapsedMilliseconds} milliseconds", Path.GetExtension(filename), sw.ElapsedMilliseconds);
+        // Adding a lock per destination, sometimes web ui triggers same image loading at the ~ same time.
+        // So, if other thread is already processing the image, we should wait for it to finish, then the File.Exists(destination) will early exit.
+        // This exists, to prevent multiple threads from processing the same image at the same time.
+        lock (_lock[destination])
+        {
+            if (File.Exists(destination))
+            {
+                // Destination already exist, the conversion was already made.
+                return destination;
+            }
+            using var sourceImage = _imageFactory.Create(filename);
+            sourceImage.Save(destination, format, quality);
+            try
+            {
+                File.Delete(filename);
+            }
+            catch (Exception) { /* Swallow Exception */ }
+        }
         return destination;
     }
 
diff --git a/API/Services/ImageService.cs.bak b/API/Services/ImageService.cs.bak
new file mode 100644
index 000000000..4b512a79a
--- /dev/null
+++ b/API/Services/ImageService.cs.bak
@@ -0,0 +1,994 @@
+using System;
+using System.Collections.Concurrent;
+using System.Collections.Generic;
+using System.Diagnostics;
+using System.Drawing;
+using System.IO;
+using System.Linq;
+using System.Numerics;
+using System.Security.Cryptography;
+using System.Text;
+using System.Text.RegularExpressions;
+using System.Threading;
+using System.Threading.Tasks;
+using API.Constants;
+using API.DTOs;
+using API.Entities.Enums;
+using API.Entities.Interfaces;
+using API.Extensions;
+using API.Services.ImageServices;
+using API.Services.Tasks.Scanner.Parser;
+using EasyCaching.Core;
+using Flurl;
+using Flurl.Http;
+using HtmlAgilityPack;
+using Kavita.Common;
+using Microsoft.EntityFrameworkCore.Migrations.Operations;
+using Microsoft.Extensions.Logging;
+
+
+namespace API.Services;
+/// <summary>
+/// Interface for the ImageService.
+/// </summary>
+public interface IImageService
+{
+    /// <summary>
+    /// Extracts images from a file and copies them to the target directory.
+    /// </summary>
+    /// <param name="fileFilePath">The file path of the source file.</param>
+    /// <param name="targetDirectory">The target directory to copy the images to.</param>
+    /// <param name="fileCount">The number of files to extract. Default is 1.</param>
+    void ExtractImages(string fileFilePath, string targetDirectory, int fileCount = 1);
+
+    /// <summary>
+    /// Gets the cover image from the specified path and saves it to the output directory.
+    /// </summary>
+    /// <param name="path">The path of the image file.</param>
+    /// <param name="fileName">The name of the output file.</param>
+    /// <param name="outputDirectory">The output directory to save the image.</param>
+    /// <param name="encodeFormat">The encoding format to convert and save the image.</param>
+    /// <param name="size">The size of the cover image.</param>
+    /// <param name="quality">The quality of the image. Default is 100.</param>
+    /// <returns>The file name with extension of the saved image.</returns>
+    string GetCoverImage(string path, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size, int quality = 100);
+
+    /// <summary>
+    /// Creates a thumbnail version of a base64 encoded image.
+    /// </summary>
+    /// <param name="encodedImage">The base64 encoded image.</param>
+    /// <param name="fileName">The name of the output file.</param>
+    /// <param name="encodeFormat">The encoding format to convert and save the image.</param>
+    /// <param name="thumbnailWidth">The width of the thumbnail. Default is 320.</param>
+    /// <param name="quality">The quality of the image. Default is 100.</param>
+    /// <returns>The file name with extension of the saved thumbnail image.</returns>
+    string CreateThumbnailFromBase64(string encodedImage, string fileName, EncodeFormat encodeFormat, int thumbnailWidth = 320, int quality = 100);
+
+    /// <summary>
+    /// Creates a thumbnail out of a memory stream and saves to <see cref="DirectoryService.CoverImageDirectory"/> with the passed
+    /// fileName and the appropriate extension.
+    /// </summary>
+    /// <param name="stream">Stream to write to disk. Ensure this is rewinded.</param>
+    /// <param name="fileName">filename to save as without extension</param>
+    /// <param name="outputDirectory">Where to output the file, defaults to covers directory</param>
+    /// <param name="encodeFormat">Export the file as the passed encoding</param>
+    /// <param name="size">The size of the cover image.</param>
+    /// <param name="quality">The quality of the image. Default is 100.</param>
+    /// <returns>File name with extension of the file. This will always write to <see cref="DirectoryService.CoverImageDirectory"/></returns>
+    string WriteCoverThumbnail(Stream stream, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size = CoverImageSize.Default, int quality = 100);
+
+    /// <summary>
+    /// Writes out a thumbnail image from a file path input and saves to <see cref="DirectoryService.CoverImageDirectory"/> with the passed
+    /// </summary>
+    /// <param name="sourceFile">The path of the source image file.</param>
+    /// <param name="fileName">filename to save as without extension</param>
+    /// <param name="outputDirectory">Where to output the file, defaults to covers directory</param>
+    /// <param name="encodeFormat">Export the file as the passed encoding</param>
+    /// <param name="size">The size of the cover image.</param>
+    /// <param name="quality">The quality of the image. Default is 100.</param>
+    /// <returns>File name with extension of the file. This will always write to <see cref="DirectoryService.CoverImageDirectory"/></returns>
+    string WriteCoverThumbnail(string sourceFile, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size = CoverImageSize.Default, int quality = 100);
+
+    /// <summary>
+    /// Converts the specified image file to the specified encoding format and saves it to the output path.
+    /// </summary>
+    /// <param name="filePath">The full path of the image file to convert.</param>
+    /// <param name="outputPath">The path to save the converted image file.</param>
+    /// <param name="encodeFormat">The encoding format to convert the image.</param>
+    /// <param name="quality">The quality of the image. Default is 100.</param>
+    /// <returns>The file path of the converted image file.</returns>
+    Task<string> ConvertToEncodingFormat(string filePath, string outputPath, EncodeFormat encodeFormat, int quality = 100);
+
+    /// <summary>
+    /// Checks if the specified file is an image.
+    /// </summary>
+    /// <param name="filePath">The path of the file to check.</param>
+    /// <returns>True if the file is an image; otherwise, false.</returns>
+    Task<bool> IsImage(string filePath);
+
+    /// <summary>
+    /// Downloads the favicon from the specified URL and saves it to the output directory.
+    /// </summary>
+    /// <param name="url">The URL of the favicon.</param>
+    /// <param name="encodeFormat">The encoding format to convert and save the favicon.</param>
+    /// <param name="quality">The quality of the favicon. Default is 100.</param>
+    /// <returns>The file name with extension of the saved favicon.</returns>
+    Task<string> DownloadFaviconAsync(string url, EncodeFormat encodeFormat, int quality = 100);
+
+    /// <summary>
+    /// Downloads the publisher image for the specified publisher name and saves it to the output directory.
+    /// </summary>
+    /// <param name="publisherName">The name of the publisher.</param>
+    /// <param name="encodeFormat">The encoding format to convert and save the publisher image.</param>
+    /// <param name="quality">The quality of the publisher image. Default is 100.</param>
+    /// <returns>The file name with extension of the saved publisher image.</returns>
+    Task<string> DownloadPublisherImageAsync(string publisherName, EncodeFormat encodeFormat, int quality = 100);
+
+    /// <summary>
+    /// Updates the color scape of an entity with a cover image.
+    /// </summary>
+    /// <param name="entity">The entity with a cover image.</param>
+    void UpdateColorScape(IHasCoverImage entity);
+
+    /// <summary>
+    /// Replaces the file format of an image with the specified supported image formats by the browser, if needed, otherwise original file will be served.
+    /// </summary>
+    /// <param name="filename">The name of the image file.</param>
+    /// <param name="supportedImageFormats">The list of supported image formats by the browser.</param>
+    /// <param name="format">The encoding format to convert the image. Default is JPG</param>
+    /// <param name="quality">The quality of the image. Default is 99.</param>
+    /// <returns>The file name with extension of the replaced image file.</returns>
+    string ReplaceImageFileFormat(string filename, List<string> supportedImageFormats = null, EncodeFormat format = EncodeFormat.JPEG, int quality = 99);
+
+    /// <summary>
+    /// Creates a merged image from a list of cover images and saves it to the specified destination.
+    /// </summary>
+    /// <param name="coverImages">The list of cover images.</param>
+    /// <param name="size">The size of the merged image.</param>
+    /// <param name="dest">The destination path to save the merged image.</param>
+    /// <param name="format">The encoding format to convert and save the merged image. Default is PNG.</param>
+    /// <param name="quality">The quality of the merged image. Default is 100.</param>
+    void CreateMergedImage(IList<string> coverImages, CoverImageSize size, string dest, EncodeFormat format = EncodeFormat.PNG, int quality = 100);
+
+    /// <summary>
+    /// The image factory used to create and manipulate images.
+    /// </summary>
+    IImageFactory ImageFactory { get; }
+}
+
+public class ImageService : IImageService
+{
+    public const string Name = "ImageService";
+    public const string ChapterCoverImageRegex = @"v\d+_c\d+";
+    public const string SeriesCoverImageRegex = @"series\d+";
+    public const string CollectionTagCoverImageRegex = @"tag\d+";
+    public const string ReadingListCoverImageRegex = @"readinglist\d+";
+    private const double WhiteThreshold = 0.95; // Colors with lightness above this are considered too close to white
+    private const double BlackThreshold = 0.25; // Colors with lightness below this are considered too close to black
+
+    /// <summary>
+    /// Width of the Thumbnail generation
+    /// </summary>
+    private const int ThumbnailWidth = 320;
+    /// <summary>
+    /// Height of the Thumbnail generation
+    /// </summary>
+    private const int ThumbnailHeight = 455;
+    /// <summary>
+    /// Width of a cover for Library
+    /// </summary>
+    public const int LibraryThumbnailWidth = 32;
+
+    private readonly ILogger<ImageService> _logger;
+    private readonly IDirectoryService _directoryService;
+    private readonly IEasyCachingProviderFactory _cacheFactory;
+    private readonly IImageFactory _imageFactory;
+
+    private static readonly string[] ValidIconRelations = {
+        "icon",
+        "apple-touch-icon",
+        "apple-touch-icon-precomposed",
+        "apple-touch-icon icon-precomposed" // ComicVine has it combined
+    };
+
+    /// <summary>
+    /// A mapping of urls that need to get the icon from another url, due to strangeness (like app.plex.tv loading a black icon)
+    /// </summary>
+    private static readonly IDictionary<string, string> FaviconUrlMapper = new Dictionary<string, string>
+    {
+        ["https://app.plex.tv"] = "https://plex.tv"
+    };
+
+
+
+    private static NamedMonitor _lock = new NamedMonitor();
+    /// <summary>
+    /// Represents a named monitor that provides thread-safe access to objects based on their names.
+    /// </summary>
+    class NamedMonitor
+    {
+        readonly ConcurrentDictionary<string, object> _dictionary = new ConcurrentDictionary<string, object>();
+
+        public object this[string name] => _dictionary.GetOrAdd(name, _ => new object());
+    }
+
+
+
+    /// <summary>
+    /// Initializes a new instance of the <see cref="ImageService"/> class.
+    /// </summary>
+    /// <param name="logger">The logger.</param>
+    /// <param name="directoryService">The directory service.</param>
+    /// <param name="cacheFactory">The cache factory.</param>
+    /// <param name="imageFactory">The image factory.</param>
+    public ImageService(ILogger<ImageService> logger, IDirectoryService directoryService, IEasyCachingProviderFactory cacheFactory, IImageFactory imageFactory)
+    {
+        _logger = logger;
+        _directoryService = directoryService;
+        _cacheFactory = cacheFactory;
+        _imageFactory = imageFactory;
+    }
+
+    public IImageFactory ImageFactory => _imageFactory;
+
+    /// <inheritdoc/>
+    public void ExtractImages(string? fileFilePath, string targetDirectory, int fileCount = 1)
+    {
+        if (string.IsNullOrEmpty(fileFilePath)) return;
+        _directoryService.ExistOrCreate(targetDirectory);
+        if (fileCount == 1)
+        {
+            _directoryService.CopyFileToDirectory(fileFilePath, targetDirectory);
+        }
+        else
+        {
+            _directoryService.CopyDirectoryToDirectory(_directoryService.FileSystem.Path.GetDirectoryName(fileFilePath), targetDirectory,
+                Tasks.Scanner.Parser.Parser.ImageFileExtensions);
+        }
+    }
+
+    /// <summary>
+    /// Creates a thumbnail image from the specified image with the given width and height.
+    /// If the image aspect ratio is significantly different from the target aspect ratio, it will be context aware cropped to fit.
+    /// </summary>
+    /// <param name="image">The image to create a thumbnail from.</param>
+    /// <param name="width">The width of the thumbnail.</param>
+    /// <param name="height">The height of the thumbnail.</param>
+    /// <returns>The thumbnail image.</returns>
+    public static IImage Thumbnail(IImage image, int width, int height)
+    {
+        try
+        {
+            if (WillScaleWell(image, width, height) || IsLikelyWideImage(image.Width, image.Height))
+            {
+                image.Thumbnail(width, height);
+                return image;
+            }
+        }
+        catch (Exception)
+        {
+            /* Swallow */
+        }
+        var crop = SmartCrop.Crop(image, new SmartCrop.SmartCropOptions { Width = width, Height = height });
+        if (crop.TopCrop.Width != width && crop.TopCrop.Height != height)
+        {
+            image.Crop(crop.TopCrop.X, crop.TopCrop.Y, crop.TopCrop.Width, crop.TopCrop.Height);
+        }
+        image.Thumbnail(width, height);
+        return image;
+    }
+
+    public static bool WillScaleWell(IImage sourceImage, int targetWidth, int targetHeight, double tolerance = 0.1)
+    {
+        // Calculate the aspect ratios
+        var sourceAspectRatio = (double) sourceImage.Width / sourceImage.Height;
+        var targetAspectRatio = (double) targetWidth / targetHeight;
+
+        // Compare aspect ratios
+        if (Math.Abs(sourceAspectRatio - targetAspectRatio) > tolerance)
+        {
+            return false; // Aspect ratios differ significantly
+        }
+
+        // Calculate scaling factors
+        var widthScaleFactor = (double) targetWidth / sourceImage.Width;
+        var heightScaleFactor = (double) targetHeight / sourceImage.Height;
+
+        // Check resolution quality (example thresholds)
+        if (widthScaleFactor > 2.0 || heightScaleFactor > 2.0)
+        {
+            return false; // Scaling factor too large
+        }
+
+        return true; // Image will scale well
+    }
+
+    private static bool IsLikelyWideImage(int width, int height)
+    {
+        var aspectRatio = (double) width / height;
+        return aspectRatio > 1.25;
+    }
+
+
+    /// <inheritdoc/>
+    public string GetCoverImage(string path, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size, int quality = 100)
+    {
+        if (string.IsNullOrEmpty(path)) return string.Empty;
+
+        try
+        {
+            var (width, height) = size.GetDimensions();
+            using var thumbnail = Thumbnail(_imageFactory.Create(path), width, height);
+            var filename = fileName + encodeFormat.GetExtension();
+            thumbnail.Save(_directoryService.FileSystem.Path.Join(outputDirectory, filename), encodeFormat, quality);
+            return filename;
+        }
+        catch (Exception ex)
+        {
+            _logger.LogWarning(ex, "[GetCoverImage] There was an error and prevented thumbnail generation on {ImageFile}. Defaulting to no cover image", path);
+        }
+
+        return string.Empty;
+    }
+
+    /// <inheritdoc/>
+    public string WriteCoverThumbnail(Stream stream, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size = CoverImageSize.Default, int quality = 100)
+    {
+        var (targetWidth, targetHeight) = size.GetDimensions();
+        if (stream.CanSeek) stream.Position = 0;
+
+        using var thumbnail = Thumbnail(_imageFactory.Create(stream), targetWidth, targetHeight);
+        var filename = fileName + encodeFormat.GetExtension();
+        _directoryService.ExistOrCreate(outputDirectory);
+
+        try
+        {
+            _directoryService.FileSystem.File.Delete(_directoryService.FileSystem.Path.Join(outputDirectory, filename));
+        } catch (Exception) {/* Swallow exception */}
+
+        try
+        {
+            thumbnail.Save(_directoryService.FileSystem.Path.Join(outputDirectory, filename), encodeFormat, quality);
+        }
+        catch (Exception) {/* Swallow exception */}
+
+        return filename;
+    }
+    /// <inheritdoc/>
+    public string WriteCoverThumbnail(string sourceFile, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size = CoverImageSize.Default, int quality = 100)
+    {
+        var (width, height) = size.GetDimensions();
+        using var thumbnail = Thumbnail(_imageFactory.Create(sourceFile), width, height);
+        var filename = fileName + encodeFormat.GetExtension();
+        _directoryService.ExistOrCreate(outputDirectory);
+        try
+        {
+            _directoryService.FileSystem.File.Delete(_directoryService.FileSystem.Path.Join(outputDirectory, filename));
+        } catch (Exception) {/* Swallow exception */}
+        thumbnail.Save(_directoryService.FileSystem.Path.Join(outputDirectory, filename), encodeFormat, quality);
+
+        return filename;
+    }
+    /// <inheritdoc/>
+    public async Task<string> ConvertToEncodingFormat(string filePath, string outputPath, EncodeFormat encodeFormat, int quality = 100)
+    {
+        var file = _directoryService.FileSystem.FileInfo.New(filePath);
+        var fileName = file.Name.Replace(file.Extension, string.Empty);
+        var outputFile = Path.Join(outputPath, fileName + encodeFormat.GetExtension());
+        using var sourceImage = _imageFactory.Create(filePath);
+        await sourceImage.SaveAsync(outputFile, encodeFormat, quality).ConfigureAwait(false);
+
+        return outputFile;
+    }
+
+    /// <inheritdoc/>
+    public Task<bool> IsImage(string filePath)
+    {
+        try
+        {
+            return Task.FromResult(_imageFactory.GetDimensions(filePath) != null);
+        }
+        catch (Exception)
+        {
+            /* Swallow Exception */
+        }
+
+        return Task.FromResult(false);
+    }
+    /// <inheritdoc/>
+    public async Task<string> DownloadFaviconAsync(string url, EncodeFormat encodeFormat, int quality = 100)
+    {
+        // Parse the URL to get the domain (including subdomain)
+        var uri = new Uri(url);
+        var domain = uri.Host.Replace(Environment.NewLine, string.Empty);
+        var baseUrl = uri.Scheme + "://" + uri.Host;
+
+
+        var provider = _cacheFactory.GetCachingProvider(EasyCacheProfiles.Favicon);
+        var res = await provider.GetAsync<string>(baseUrl);
+        if (res.HasValue)
+        {
+            _logger.LogInformation("Kavita has already tried to fetch from {BaseUrl} and failed. Skipping duplicate check", baseUrl);
+            throw new KavitaException($"Kavita has already tried to fetch from {baseUrl} and failed. Skipping duplicate check");
+        }
+
+        await provider.SetAsync(baseUrl, string.Empty, TimeSpan.FromDays(10));
+        if (FaviconUrlMapper.TryGetValue(baseUrl, out var value))
+        {
+            url = value;
+        }
+
+        var correctSizeLink = string.Empty;
+
+        try
+        {
+            var htmlContent = url.GetStringAsync().Result;
+            var htmlDocument = new HtmlDocument();
+            htmlDocument.LoadHtml(htmlContent);
+            var pngLinks = htmlDocument.DocumentNode.Descendants("link")
+                .Where(link => ValidIconRelations.Contains(link.GetAttributeValue("rel", string.Empty)))
+                .Select(link => link.GetAttributeValue("href", string.Empty))
+                .Where(href => href.Split("?")[0].EndsWith(".png", StringComparison.InvariantCultureIgnoreCase))
+                .ToList();
+
+            correctSizeLink = (pngLinks?.Find(pngLink => pngLink.Contains("32")) ?? pngLinks?.FirstOrDefault());
+        }
+        catch (Exception ex)
+        {
+            _logger.LogError(ex, "Error downloading favicon.png for {Domain}, will try fallback methods", domain);
+        }
+
+        try
+        {
+            if (string.IsNullOrEmpty(correctSizeLink))
+            {
+                correctSizeLink = await FallbackToKavitaReaderFavicon(baseUrl);
+            }
+            if (string.IsNullOrEmpty(correctSizeLink))
+            {
+                throw new KavitaException($"Could not grab favicon from {baseUrl}");
+            }
+
+            var finalUrl = correctSizeLink;
+
+            // If starts with //, it's coming usually from an offsite cdn
+            if (correctSizeLink.StartsWith("//"))
+            {
+                finalUrl = "https:" + correctSizeLink;
+            }
+            else if (!correctSizeLink.StartsWith(uri.Scheme))
+            {
+                finalUrl = Url.Combine(baseUrl, correctSizeLink);
+            }
+
+            _logger.LogTrace("Fetching favicon from {Url}", finalUrl);
+            // Download the favicon.ico file using Flurl
+            var faviconStream = await finalUrl
+                .AllowHttpStatus("2xx,304")
+                .GetStreamAsync();
+
+            // Create the destination file path
+            using var image = _imageFactory.Create(faviconStream);
+            var filename = ImageService.GetWebLinkFormat(baseUrl, encodeFormat);
+            await image.SaveAsync(Path.Combine(_directoryService.FaviconDirectory, filename), encodeFormat, quality);
+            _logger.LogDebug("Favicon for {Domain} downloaded and saved successfully", domain);
+            return filename;
+        } catch (Exception ex)
+        {
+            _logger.LogError(ex, "Error downloading favicon for {Domain}", domain);
+            throw;
+        }
+    }
+    /// <inheritdoc/>
+    public async Task<string> DownloadPublisherImageAsync(string publisherName, EncodeFormat encodeFormat, int quality = 100)
+    {
+        try
+        {
+            var publisherLink = await FallbackToKavitaReaderPublisher(publisherName);
+            if (string.IsNullOrEmpty(publisherLink))
+            {
+                throw new KavitaException($"Could not grab publisher image for {publisherName}");
+            }
+
+            var finalUrl = publisherLink;
+
+            _logger.LogTrace("Fetching publisher image from {Url}", finalUrl);
+            // Download the favicon.ico file using Flurl
+            var publisherStream = await finalUrl
+                .AllowHttpStatus("2xx,304")
+                .GetStreamAsync();
+
+            // Create the destination file path
+            using var image = _imageFactory.Create(publisherStream);
+            var filename = GetPublisherFormat(publisherName, encodeFormat);
+            await image.SaveAsync(Path.Combine(_directoryService.FaviconDirectory, filename), encodeFormat, quality);
+            _logger.LogDebug("Publisher image for {PublisherName} downloaded and saved successfully", publisherName);
+            return filename;
+        } catch (Exception ex)
+        {
+            _logger.LogError(ex, "Error downloading image for {PublisherName}", publisherName);
+            throw;
+        }
+    }
+
+    private (Vector3?, Vector3?) GetPrimarySecondaryColors(string imagePath)
+    {
+
+
+        var rgbPixels = _imageFactory.GetRgbPixelsPercentage(imagePath, 10);
+
+        // Perform k-means clustering
+        var clusters = KMeansClustering(rgbPixels, 4);
+
+        var sorted = SortByVibrancy(clusters);
+
+        // Ensure white and black are not selected as primary/secondary colors
+        sorted = sorted.Where(c => !IsCloseToWhiteOrBlack(c)).ToList();
+
+        if (sorted.Count >= 2)
+        {
+            return (sorted[0], sorted[1]);
+        }
+        if (sorted.Count == 1)
+        {
+            return (sorted[0], null);
+        }
+
+        return (null, null);
+    }
+
+    private static bool IsColorCloseToWhiteOrBlack(Vector3 color)
+    {
+        var (_, _, lightness) = RgbToHsl(color);
+        return lightness is > WhiteThreshold or < BlackThreshold;
+    }
+
+    private static List<Vector3> KMeansClustering(List<Vector3> points, int k, int maxIterations = 100)
+    {
+        var random = new Random();
+        var centroids = points.OrderBy(x => random.Next()).Take(k).ToList();
+
+        for (var i = 0; i < maxIterations; i++)
+        {
+            var clusters = new List<Vector3>[k];
+            for (var j = 0; j < k; j++)
+            {
+                clusters[j] = [];
+            }
+
+            foreach (var point in points)
+            {
+                var nearestCentroidIndex = centroids
+                    .Select((centroid, index) => new { Index = index, Distance = Vector3.DistanceSquared(centroid, point) })
+                    .OrderBy(x => x.Distance)
+                    .First().Index;
+                clusters[nearestCentroidIndex].Add(point);
+            }
+
+            var newCentroids = clusters.Select(cluster =>
+                cluster.Count != 0 ? new Vector3(
+                    cluster.Average(p => p.X),
+                    cluster.Average(p => p.Y),
+                    cluster.Average(p => p.Z)
+                ) : Vector3.Zero
+            ).ToList();
+
+            if (centroids.SequenceEqual(newCentroids))
+                break;
+
+            centroids = newCentroids;
+        }
+
+        return centroids;
+    }
+
+    public static List<Vector3> SortByBrightness(List<Vector3> colors)
+    {
+        return colors.OrderBy(c => 0.299 * c.X + 0.587 * c.Y + 0.114 * c.Z).ToList();
+    }
+
+    private static List<Vector3> SortByVibrancy(List<Vector3> colors)
+    {
+        return colors.OrderByDescending(c =>
+        {
+            var max = Math.Max(c.X, Math.Max(c.Y, c.Z));
+            var min = Math.Min(c.X, Math.Min(c.Y, c.Z));
+            return (max - min) / max;
+        }).ToList();
+    }
+
+    private static bool IsCloseToWhiteOrBlack(Vector3 color)
+    {
+        var threshold = 30;
+        return (color.X > 255 - threshold && color.Y > 255 - threshold && color.Z > 255 - threshold) ||
+               (color.X < threshold && color.Y < threshold && color.Z < threshold);
+    }
+
+    private static string RgbToHex(Vector3 color)
+    {
+        return $"#{(int)color.X:X2}{(int)color.Y:X2}{(int)color.Z:X2}";
+    }
+
+    private static Vector3 GetComplementaryColor(Vector3 color)
+    {
+        // Convert RGB to HSL
+        var (h, s, l) = RgbToHsl(color);
+
+        // Rotate hue by 180 degrees
+        h = (h + 180) % 360;
+
+        // Convert back to RGB
+        return HslToRgb(h, s, l);
+    }
+
+    private static (double H, double S, double L) RgbToHsl(Vector3 rgb)
+    {
+        double r = rgb.X / 255;
+        double g = rgb.Y / 255;
+        double b = rgb.Z / 255;
+
+        var max = Math.Max(r, Math.Max(g, b));
+        var min = Math.Min(r, Math.Min(g, b));
+        var diff = max - min;
+
+        double h = 0;
+        double s = 0;
+        var l = (max + min) / 2;
+
+        if (Math.Abs(diff) > 0.00001)
+        {
+            s = l > 0.5 ? diff / (2 - max - min) : diff / (max + min);
+
+            if (max == r)
+                h = (g - b) / diff + (g < b ? 6 : 0);
+            else if (max == g)
+                h = (b - r) / diff + 2;
+            else if (max == b)
+                h = (r - g) / diff + 4;
+
+            h *= 60;
+        }
+
+        return (h, s, l);
+    }
+
+    private static Vector3 HslToRgb(double h, double s, double l)
+    {
+        double r, g, b;
+
+        if (Math.Abs(s) < 0.00001)
+        {
+            r = g = b = l;
+        }
+        else
+        {
+            var q = l < 0.5 ? l * (1 + s) : l + s - l * s;
+            var p = 2 * l - q;
+            r = HueToRgb(p, q, h + 120);
+            g = HueToRgb(p, q, h);
+            b = HueToRgb(p, q, h - 120);
+        }
+
+        return new Vector3((float)(r * 255), (float)(g * 255), (float)(b * 255));
+    }
+
+    private static double HueToRgb(double p, double q, double t)
+    {
+        if (t < 0) t += 360;
+        if (t > 360) t -= 360;
+        return t switch
+        {
+            < 60 => p + (q - p) * t / 60,
+            < 180 => q,
+            < 240 => p + (q - p) * (240 - t) / 60,
+            _ => p
+        };
+    }
+
+    /// <summary>
+    /// Generates the Primary and Secondary colors from a file
+    /// </summary>
+    /// <remarks>This may use a second most common color or a complementary color. It's up to implemenation to choose what's best</remarks>
+    /// <param name="sourceFile"></param>
+    /// <returns></returns>
+    public ColorScape CalculateColorScape(string sourceFile)
+    {
+        if (!File.Exists(sourceFile)) return new ColorScape() {Primary = null, Secondary = null};
+
+        var colors = GetPrimarySecondaryColors(sourceFile);
+
+        return new ColorScape()
+        {
+            Primary = colors.Item1 == null ? null : RgbToHex(colors.Item1.Value),
+            Secondary = colors.Item2 == null ? null : RgbToHex(colors.Item2.Value)
+        };
+    }
+    private bool CheckDirectSupport(string filename, List<string> supportedImageFormats)
+    {
+        if (supportedImageFormats == null) return false;
+
+        string ext = Path.GetExtension(filename).ToLowerInvariant().Substring(1);
+        return supportedImageFormats.Contains(ext);
+    }
+
+
+    /// <inheritdoc/>
+    public string ReplaceImageFileFormat(string filename, List<string> supportedImageFormats = null, EncodeFormat format = EncodeFormat.JPEG, int quality = 99)
+    {
+        if (CheckDirectSupport(filename, supportedImageFormats)) return filename;
+
+        Match m = Regex.Match(Path.GetExtension(filename), Parser.NonUniversalFileImageExtensions, RegexOptions.IgnoreCase, Parser.RegexTimeout);
+        if (!m.Success) return filename;
+
+        string destination = Path.ChangeExtension(filename, format.GetExtension().Substring(1));
+
+        // Adding a lock per destination, sometimes web ui triggers same image loading at the ~ same time.
+        // So, if other thread is already processing the image, we should wait for it to finish, then the File.Exists(destination) will early exit.
+        // This exists, to prevent multiple threads from processing the same image at the same time.
+        lock (_lock[destination])
+        {
+            if (File.Exists(destination))
+            {
+                // Destination already exist, the conversion was already made.
+                return destination;
+            }
+            using var sourceImage = _imageFactory.Create(filename);
+            sourceImage.Save(destination, format, quality);
+            try
+            {
+                File.Delete(filename);
+            }
+            catch (Exception) { /* Swallow Exception */ }
+        }
+        return destination;
+    }
+
+    private static async Task<string> FallbackToKavitaReaderFavicon(string baseUrl)
+    {
+        var correctSizeLink = string.Empty;
+        var allOverrides = await "https://www.kavitareader.com/assets/favicons/urls.txt".GetStringAsync();
+        if (!string.IsNullOrEmpty(allOverrides))
+        {
+            var cleanedBaseUrl = baseUrl.Replace("https://", string.Empty);
+            var externalFile = allOverrides
+                .Split("\n")
+                .FirstOrDefault(url =>
+                    cleanedBaseUrl.Equals(url.Replace(".png", string.Empty)) ||
+                    cleanedBaseUrl.Replace("www.", string.Empty).Equals(url.Replace(".png", string.Empty)
+                    ));
+
+            if (string.IsNullOrEmpty(externalFile))
+            {
+                throw new KavitaException($"Could not grab favicon from {baseUrl}");
+            }
+
+            correctSizeLink = "https://www.kavitareader.com/assets/favicons/" + externalFile;
+        }
+
+        return correctSizeLink;
+    }
+
+    private static async Task<string> FallbackToKavitaReaderPublisher(string publisherName)
+    {
+        var externalLink = string.Empty;
+        var allOverrides = await "https://www.kavitareader.com/assets/publishers/publishers.txt".GetStringAsync();
+        if (!string.IsNullOrEmpty(allOverrides))
+        {
+            var externalFile = allOverrides
+                .Split("\n")
+                .Select(publisherLine =>
+                {
+                    var tokens = publisherLine.Split("|");
+                    if (tokens.Length != 2) return null;
+                    var aliases = tokens[0];
+                    // Multiple publisher aliases are separated by #
+                    if (aliases.Split("#").Any(name => name.ToLowerInvariant().Trim().Equals(publisherName.ToLowerInvariant().Trim())))
+                    {
+                        return tokens[1];
+                    }
+                    return null;
+                })
+                .FirstOrDefault(url => !string.IsNullOrEmpty(url));
+
+            if (string.IsNullOrEmpty(externalFile))
+            {
+                throw new KavitaException($"Could not grab publisher image for {publisherName}");
+            }
+
+            externalLink = "https://www.kavitareader.com/assets/publishers/" + externalFile;
+        }
+
+        return externalLink;
+    }
+
+    /// <inheritdoc />
+    public string CreateThumbnailFromBase64(string encodedImage, string fileName, EncodeFormat encodeFormat, int thumbnailWidth = ThumbnailWidth, int quality = 100)
+    {
+        try
+        {
+
+            using var thumbnail = _imageFactory.CreateFromBase64(encodedImage);
+            int thumbnailHeight = (int)(thumbnail.Height * ((double)thumbnailWidth / thumbnail.Width));
+            thumbnail.Thumbnail(thumbnailWidth, thumbnailHeight);
+            fileName += encodeFormat.GetExtension();
+            thumbnail.Save(_directoryService.FileSystem.Path.Join(_directoryService.CoverImageDirectory, fileName), encodeFormat, quality);
+            return fileName;
+        }
+        catch (Exception e)
+        {
+            _logger.LogError(e, "Error creating thumbnail from url");
+        }
+
+        return string.Empty;
+    }
+
+    /// <summary>
+    /// Returns the name format for a chapter cover image
+    /// </summary>
+    /// <param name="chapterId"></param>
+    /// <param name="volumeId"></param>
+    /// <returns></returns>
+    public static string GetChapterFormat(int chapterId, int volumeId)
+    {
+        return $"v{volumeId}_c{chapterId}";
+    }
+
+    /// <summary>
+    /// Returns the name format for a volume cover image (custom)
+    /// </summary>
+    /// <param name="volumeId"></param>
+    /// <returns></returns>
+    public static string GetVolumeFormat(int volumeId)
+    {
+        return $"v{volumeId}";
+    }
+
+    /// <summary>
+    /// Returns the name format for a library cover image
+    /// </summary>
+    /// <param name="libraryId"></param>
+    /// <returns></returns>
+    public static string GetLibraryFormat(int libraryId)
+    {
+        return $"l{libraryId}";
+    }
+
+    /// <summary>
+    /// Returns the name format for a series cover image
+    /// </summary>
+    /// <param name="seriesId"></param>
+    /// <returns></returns>
+    public static string GetSeriesFormat(int seriesId)
+    {
+        return $"series{seriesId}";
+    }
+
+    /// <summary>
+    /// Returns the name format for a collection tag cover image
+    /// </summary>
+    /// <param name="tagId"></param>
+    /// <returns></returns>
+    public static string GetCollectionTagFormat(int tagId)
+    {
+        return $"tag{tagId}";
+    }
+
+    /// <summary>
+    /// Returns the name format for a reading list cover image
+    /// </summary>
+    /// <param name="readingListId"></param>
+    /// <returns></returns>
+    public static string GetReadingListFormat(int readingListId)
+    {
+        // ReSharper disable once StringLiteralTypo
+        return $"readinglist{readingListId}";
+    }
+
+    /// <summary>
+    /// Returns the name format for a thumbnail (temp thumbnail)
+    /// </summary>
+    /// <param name="chapterId"></param>
+    /// <returns></returns>
+    public static string GetThumbnailFormat(int chapterId)
+    {
+        return $"thumbnail{chapterId}";
+    }
+
+    public static string GetWebLinkFormat(string url, EncodeFormat encodeFormat)
+    {
+        return $"{new Uri(url).Host.Replace("www.", string.Empty)}{encodeFormat.GetExtension()}";
+    }
+
+    public static string GetPublisherFormat(string publisher, EncodeFormat encodeFormat)
+    {
+        return $"{publisher}{encodeFormat.GetExtension()}";
+    }
+
+    /// <inheritdoc/>
+    public void CreateMergedImage(IList<string> coverImages, CoverImageSize size, string dest, EncodeFormat format = EncodeFormat.PNG, int quality = 100)
+    {
+        var (width, height) = size.GetDimensions();
+        int rows, cols;
+
+        if (coverImages.Count == 1)
+        {
+            rows = 1;
+            cols = 1;
+        }
+        else if (coverImages.Count == 2)
+        {
+            rows = 1;
+            cols = 2;
+        }
+        else
+        {
+            rows = 2;
+            cols = 2;
+        }
+
+
+        var image = _imageFactory.Create(width, height);
+
+        var thumbnailWidth = image.Width / cols;
+        var thumbnailHeight = image.Height / rows;
+
+        for (var i = 0; i < coverImages.Count; i++)
+        {
+            if (!File.Exists(coverImages[i])) continue;
+            var tile = _imageFactory.Create(coverImages[i]);
+            tile.Thumbnail(thumbnailWidth, thumbnailHeight);
+
+            var row = i / cols;
+            var col = i % cols;
+
+            var x = col * thumbnailWidth;
+            var y = row * thumbnailHeight;
+
+            if (coverImages.Count == 3 && i == 2)
+            {
+                x = (image.Width - thumbnailWidth) / 2;
+                y = thumbnailHeight;
+            }
+            image.Composite(tile,x,y);
+        }
+
+        image.Save(dest, format, quality);
+    }
+
+    /// <inheritdoc/>
+    public void UpdateColorScape(IHasCoverImage entity)
+    {
+        var colors = CalculateColorScape(_directoryService.FileSystem.Path.Join(_directoryService.CoverImageDirectory, entity.CoverImage));
+        entity.PrimaryColor = colors.Primary;
+        entity.SecondaryColor = colors.Secondary;
+    }
+
+    public static Color HexToRgb(string? hex)
+    {
+        if (string.IsNullOrEmpty(hex)) throw new ArgumentException("Hex cannot be null");
+
+        // Remove the leading '#' if present
+        hex = hex.TrimStart('#');
+
+        // Ensure the hex string is valid
+        if (hex.Length != 6 && hex.Length != 3)
+        {
+            throw new ArgumentException("Hex string should be 6 or 3 characters long.");
+        }
+
+        if (hex.Length == 3)
+        {
+            // Expand shorthand notation to full form (e.g., "abc" -> "aabbcc")
+            hex = string.Concat(hex[0], hex[0], hex[1], hex[1], hex[2], hex[2]);
+        }
+
+        // Parse the hex string into RGB components
+        var r = Convert.ToInt32(hex.Substring(0, 2), 16);
+        var g = Convert.ToInt32(hex.Substring(2, 2), 16);
+        var b = Convert.ToInt32(hex.Substring(4, 2), 16);
+
+        return Color.FromArgb(r, g, b);
+    }
+
+
+}
diff --git a/API/Services/ImageServices/ImageMagick/ImageMagickImage.cs b/API/Services/ImageServices/ImageMagick/ImageMagickImage.cs
index 81eaea5b4..504022bbf 100644
--- a/API/Services/ImageServices/ImageMagick/ImageMagickImage.cs
+++ b/API/Services/ImageServices/ImageMagick/ImageMagickImage.cs
@@ -27,8 +27,11 @@ public class ImageMagickImage : IImage
     /// <returns>An instance of <see cref="ImageMagickImage"/>.</returns>
     public static IImage CreateFromBase64(string base64)
     {
+        if (string.IsNullOrEmpty(base64))
+            throw new ArgumentNullException(nameof(base64));
+
         ImageMagickImage m = new ImageMagickImage();
-        m._image = (MagickImage)MagickImage.FromBase64(base64);
+        m._image = (MagickImage) MagickImage.FromBase64(base64);
         return m;
     }
 
@@ -41,7 +44,7 @@ public static IImage CreateFromBase64(string base64)
     /// <returns>An instance of <see cref="ImageMagickImage"/>.</returns>
     public static IImage CreateFromBGRAByteArray(byte[] bgraByteArray, int width, int height)
     {
-        //Convert to RGBA float array (Image Magick 16 uses float array with values from 0-65535)
+        // Convert to RGBA float array (Image Magick 16 uses float array with values from 0-65535)
         var floats = new float[bgraByteArray.Length];
         for (var i = 0; i < bgraByteArray.Length; i += 4)
         {
@@ -50,10 +53,12 @@ public static IImage CreateFromBGRAByteArray(byte[] bgraByteArray, int width, in
             floats[i + 2] = bgraByteArray[i] << 8;
             floats[i + 3] = bgraByteArray[i + 3] << 8;
         }
+
         ImageMagickImage m = new ImageMagickImage();
         m._image = new MagickImage(MagickColor.FromRgba(0, 0, 0, 0), width, height);
         using var pixels = m._image.GetPixels();
         pixels.SetArea(0, 0, width, height, floats);
+
         return m;
     }
 
@@ -85,7 +90,7 @@ public ImageMagickImage(Stream stream)
     /// <param name="image">The existing <see cref="MagickImage"/>.</param>
     public ImageMagickImage(MagickImage image)
     {
-        _image = (MagickImage)image.Clone();
+        _image = (MagickImage) image.Clone();
     }
 
     /// <summary>
@@ -164,7 +169,7 @@ public Task SaveAsync(Stream stream, EncodeFormat format, int quality, Cancellat
     /// <inheritdoc/>
     public float[] GetRGBAImageData()
     {
-        float[] data = null;
+        float[] data = [];
         float scale = 1.0f / 256;
         if (_image.ChannelCount == 4)
         {
diff --git a/API/Services/Tasks/Scanner/Parser/Parser.cs b/API/Services/Tasks/Scanner/Parser/Parser.cs
index 71be6078e..9d647445e 100644
--- a/API/Services/Tasks/Scanner/Parser/Parser.cs
+++ b/API/Services/Tasks/Scanner/Parser/Parser.cs
@@ -26,6 +26,13 @@ public static class Parser
 
     public static readonly TimeSpan RegexTimeout = TimeSpan.FromMilliseconds(500);
 
+    /// <summary>
+    /// Mime Mappings on Browsers Non Universally Supported Image Formats.
+    /// Examples:
+    /// Browser presents jp2, which means it supports images with file extensions jp2 and j2k.  (JPEG200)
+    /// Browser present heif, which means it supports images with file extensions heif and heic (HEIF)
+    /// Browser present jxl, which means it supports images with file extension jxl             (JPEG-XL)
+    /// </summary>
     public static Dictionary<string, List<string>> NonUniversalSupportedMimeMappings = new Dictionary<string, List<string>>()
         {
             { "jp2", ["jp2", "j2k"] } ,
@@ -35,9 +42,22 @@ public static class Parser
             { "jxl", ["jxl"] } ,
             { "avif", ["avif"] } ,
         };
-    public static string[] NonUniversalFileImageExtensionArray = { "avif", "jxl", "heif", "heic", "j2k", "jp2" };
+
+    /// <summary>
+    /// Browser Universally Supported Image extensions that we support. Means, all browsers support this image formats.
+    /// </summary>
     public static string[] UniversalFileImageExtensionArray = { "png", "jpeg", "jpg", "webp", "gif" };
+    /// <summary>
+    /// Browser Non Universally Supported Image extensions that we support.
+    /// </summary>
+    public static string[] NonUniversalFileImageExtensionArray = { "avif", "jxl", "heif", "heic", "j2k", "jp2" };
+    /// <summary>
+    /// Regex to Match Non Universally supported Images extensions.
+    /// </summary>
     public static string NonUniversalFileImageExtensions = @"^(\." + string.Join(@"|\.", NonUniversalFileImageExtensionArray) + ")";
+    /// <summary>
+    /// Regex to Match All our supported Images extensions.
+    /// </summary>
     public static string ImageFileExtensions = @"^(\." + string.Join(@"|\.", UniversalFileImageExtensionArray.Union(NonUniversalFileImageExtensionArray)) + ")"; // Don't forget to update CoverChooser
 
 

From fbbbbb8e8bb3d70d05e68efebdae3c7224856920 Mon Sep 17 00:00:00 2001
From: Maximo Piva <mpiva@adventintermodal.com>
Date: Thu, 10 Oct 2024 18:14:16 -0300
Subject: [PATCH 28/30] Removed bak files, fixed EncodeFormat BOM

---
 API/Entities/Enums/EncodeFormat.cs |   2 +-
 API/Services/ImageService.cs.bak   | 994 -----------------------------
 2 files changed, 1 insertion(+), 995 deletions(-)
 delete mode 100644 API/Services/ImageService.cs.bak

diff --git a/API/Entities/Enums/EncodeFormat.cs b/API/Entities/Enums/EncodeFormat.cs
index 0d6140927..fa4e97130 100644
--- a/API/Entities/Enums/EncodeFormat.cs
+++ b/API/Entities/Enums/EncodeFormat.cs
@@ -1,4 +1,4 @@
-using System.ComponentModel;
+using System.ComponentModel;
 
 namespace API.Entities.Enums;
 
diff --git a/API/Services/ImageService.cs.bak b/API/Services/ImageService.cs.bak
deleted file mode 100644
index 4b512a79a..000000000
--- a/API/Services/ImageService.cs.bak
+++ /dev/null
@@ -1,994 +0,0 @@
-using System;
-using System.Collections.Concurrent;
-using System.Collections.Generic;
-using System.Diagnostics;
-using System.Drawing;
-using System.IO;
-using System.Linq;
-using System.Numerics;
-using System.Security.Cryptography;
-using System.Text;
-using System.Text.RegularExpressions;
-using System.Threading;
-using System.Threading.Tasks;
-using API.Constants;
-using API.DTOs;
-using API.Entities.Enums;
-using API.Entities.Interfaces;
-using API.Extensions;
-using API.Services.ImageServices;
-using API.Services.Tasks.Scanner.Parser;
-using EasyCaching.Core;
-using Flurl;
-using Flurl.Http;
-using HtmlAgilityPack;
-using Kavita.Common;
-using Microsoft.EntityFrameworkCore.Migrations.Operations;
-using Microsoft.Extensions.Logging;
-
-
-namespace API.Services;
-/// <summary>
-/// Interface for the ImageService.
-/// </summary>
-public interface IImageService
-{
-    /// <summary>
-    /// Extracts images from a file and copies them to the target directory.
-    /// </summary>
-    /// <param name="fileFilePath">The file path of the source file.</param>
-    /// <param name="targetDirectory">The target directory to copy the images to.</param>
-    /// <param name="fileCount">The number of files to extract. Default is 1.</param>
-    void ExtractImages(string fileFilePath, string targetDirectory, int fileCount = 1);
-
-    /// <summary>
-    /// Gets the cover image from the specified path and saves it to the output directory.
-    /// </summary>
-    /// <param name="path">The path of the image file.</param>
-    /// <param name="fileName">The name of the output file.</param>
-    /// <param name="outputDirectory">The output directory to save the image.</param>
-    /// <param name="encodeFormat">The encoding format to convert and save the image.</param>
-    /// <param name="size">The size of the cover image.</param>
-    /// <param name="quality">The quality of the image. Default is 100.</param>
-    /// <returns>The file name with extension of the saved image.</returns>
-    string GetCoverImage(string path, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size, int quality = 100);
-
-    /// <summary>
-    /// Creates a thumbnail version of a base64 encoded image.
-    /// </summary>
-    /// <param name="encodedImage">The base64 encoded image.</param>
-    /// <param name="fileName">The name of the output file.</param>
-    /// <param name="encodeFormat">The encoding format to convert and save the image.</param>
-    /// <param name="thumbnailWidth">The width of the thumbnail. Default is 320.</param>
-    /// <param name="quality">The quality of the image. Default is 100.</param>
-    /// <returns>The file name with extension of the saved thumbnail image.</returns>
-    string CreateThumbnailFromBase64(string encodedImage, string fileName, EncodeFormat encodeFormat, int thumbnailWidth = 320, int quality = 100);
-
-    /// <summary>
-    /// Creates a thumbnail out of a memory stream and saves to <see cref="DirectoryService.CoverImageDirectory"/> with the passed
-    /// fileName and the appropriate extension.
-    /// </summary>
-    /// <param name="stream">Stream to write to disk. Ensure this is rewinded.</param>
-    /// <param name="fileName">filename to save as without extension</param>
-    /// <param name="outputDirectory">Where to output the file, defaults to covers directory</param>
-    /// <param name="encodeFormat">Export the file as the passed encoding</param>
-    /// <param name="size">The size of the cover image.</param>
-    /// <param name="quality">The quality of the image. Default is 100.</param>
-    /// <returns>File name with extension of the file. This will always write to <see cref="DirectoryService.CoverImageDirectory"/></returns>
-    string WriteCoverThumbnail(Stream stream, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size = CoverImageSize.Default, int quality = 100);
-
-    /// <summary>
-    /// Writes out a thumbnail image from a file path input and saves to <see cref="DirectoryService.CoverImageDirectory"/> with the passed
-    /// </summary>
-    /// <param name="sourceFile">The path of the source image file.</param>
-    /// <param name="fileName">filename to save as without extension</param>
-    /// <param name="outputDirectory">Where to output the file, defaults to covers directory</param>
-    /// <param name="encodeFormat">Export the file as the passed encoding</param>
-    /// <param name="size">The size of the cover image.</param>
-    /// <param name="quality">The quality of the image. Default is 100.</param>
-    /// <returns>File name with extension of the file. This will always write to <see cref="DirectoryService.CoverImageDirectory"/></returns>
-    string WriteCoverThumbnail(string sourceFile, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size = CoverImageSize.Default, int quality = 100);
-
-    /// <summary>
-    /// Converts the specified image file to the specified encoding format and saves it to the output path.
-    /// </summary>
-    /// <param name="filePath">The full path of the image file to convert.</param>
-    /// <param name="outputPath">The path to save the converted image file.</param>
-    /// <param name="encodeFormat">The encoding format to convert the image.</param>
-    /// <param name="quality">The quality of the image. Default is 100.</param>
-    /// <returns>The file path of the converted image file.</returns>
-    Task<string> ConvertToEncodingFormat(string filePath, string outputPath, EncodeFormat encodeFormat, int quality = 100);
-
-    /// <summary>
-    /// Checks if the specified file is an image.
-    /// </summary>
-    /// <param name="filePath">The path of the file to check.</param>
-    /// <returns>True if the file is an image; otherwise, false.</returns>
-    Task<bool> IsImage(string filePath);
-
-    /// <summary>
-    /// Downloads the favicon from the specified URL and saves it to the output directory.
-    /// </summary>
-    /// <param name="url">The URL of the favicon.</param>
-    /// <param name="encodeFormat">The encoding format to convert and save the favicon.</param>
-    /// <param name="quality">The quality of the favicon. Default is 100.</param>
-    /// <returns>The file name with extension of the saved favicon.</returns>
-    Task<string> DownloadFaviconAsync(string url, EncodeFormat encodeFormat, int quality = 100);
-
-    /// <summary>
-    /// Downloads the publisher image for the specified publisher name and saves it to the output directory.
-    /// </summary>
-    /// <param name="publisherName">The name of the publisher.</param>
-    /// <param name="encodeFormat">The encoding format to convert and save the publisher image.</param>
-    /// <param name="quality">The quality of the publisher image. Default is 100.</param>
-    /// <returns>The file name with extension of the saved publisher image.</returns>
-    Task<string> DownloadPublisherImageAsync(string publisherName, EncodeFormat encodeFormat, int quality = 100);
-
-    /// <summary>
-    /// Updates the color scape of an entity with a cover image.
-    /// </summary>
-    /// <param name="entity">The entity with a cover image.</param>
-    void UpdateColorScape(IHasCoverImage entity);
-
-    /// <summary>
-    /// Replaces the file format of an image with the specified supported image formats by the browser, if needed, otherwise original file will be served.
-    /// </summary>
-    /// <param name="filename">The name of the image file.</param>
-    /// <param name="supportedImageFormats">The list of supported image formats by the browser.</param>
-    /// <param name="format">The encoding format to convert the image. Default is JPG</param>
-    /// <param name="quality">The quality of the image. Default is 99.</param>
-    /// <returns>The file name with extension of the replaced image file.</returns>
-    string ReplaceImageFileFormat(string filename, List<string> supportedImageFormats = null, EncodeFormat format = EncodeFormat.JPEG, int quality = 99);
-
-    /// <summary>
-    /// Creates a merged image from a list of cover images and saves it to the specified destination.
-    /// </summary>
-    /// <param name="coverImages">The list of cover images.</param>
-    /// <param name="size">The size of the merged image.</param>
-    /// <param name="dest">The destination path to save the merged image.</param>
-    /// <param name="format">The encoding format to convert and save the merged image. Default is PNG.</param>
-    /// <param name="quality">The quality of the merged image. Default is 100.</param>
-    void CreateMergedImage(IList<string> coverImages, CoverImageSize size, string dest, EncodeFormat format = EncodeFormat.PNG, int quality = 100);
-
-    /// <summary>
-    /// The image factory used to create and manipulate images.
-    /// </summary>
-    IImageFactory ImageFactory { get; }
-}
-
-public class ImageService : IImageService
-{
-    public const string Name = "ImageService";
-    public const string ChapterCoverImageRegex = @"v\d+_c\d+";
-    public const string SeriesCoverImageRegex = @"series\d+";
-    public const string CollectionTagCoverImageRegex = @"tag\d+";
-    public const string ReadingListCoverImageRegex = @"readinglist\d+";
-    private const double WhiteThreshold = 0.95; // Colors with lightness above this are considered too close to white
-    private const double BlackThreshold = 0.25; // Colors with lightness below this are considered too close to black
-
-    /// <summary>
-    /// Width of the Thumbnail generation
-    /// </summary>
-    private const int ThumbnailWidth = 320;
-    /// <summary>
-    /// Height of the Thumbnail generation
-    /// </summary>
-    private const int ThumbnailHeight = 455;
-    /// <summary>
-    /// Width of a cover for Library
-    /// </summary>
-    public const int LibraryThumbnailWidth = 32;
-
-    private readonly ILogger<ImageService> _logger;
-    private readonly IDirectoryService _directoryService;
-    private readonly IEasyCachingProviderFactory _cacheFactory;
-    private readonly IImageFactory _imageFactory;
-
-    private static readonly string[] ValidIconRelations = {
-        "icon",
-        "apple-touch-icon",
-        "apple-touch-icon-precomposed",
-        "apple-touch-icon icon-precomposed" // ComicVine has it combined
-    };
-
-    /// <summary>
-    /// A mapping of urls that need to get the icon from another url, due to strangeness (like app.plex.tv loading a black icon)
-    /// </summary>
-    private static readonly IDictionary<string, string> FaviconUrlMapper = new Dictionary<string, string>
-    {
-        ["https://app.plex.tv"] = "https://plex.tv"
-    };
-
-
-
-    private static NamedMonitor _lock = new NamedMonitor();
-    /// <summary>
-    /// Represents a named monitor that provides thread-safe access to objects based on their names.
-    /// </summary>
-    class NamedMonitor
-    {
-        readonly ConcurrentDictionary<string, object> _dictionary = new ConcurrentDictionary<string, object>();
-
-        public object this[string name] => _dictionary.GetOrAdd(name, _ => new object());
-    }
-
-
-
-    /// <summary>
-    /// Initializes a new instance of the <see cref="ImageService"/> class.
-    /// </summary>
-    /// <param name="logger">The logger.</param>
-    /// <param name="directoryService">The directory service.</param>
-    /// <param name="cacheFactory">The cache factory.</param>
-    /// <param name="imageFactory">The image factory.</param>
-    public ImageService(ILogger<ImageService> logger, IDirectoryService directoryService, IEasyCachingProviderFactory cacheFactory, IImageFactory imageFactory)
-    {
-        _logger = logger;
-        _directoryService = directoryService;
-        _cacheFactory = cacheFactory;
-        _imageFactory = imageFactory;
-    }
-
-    public IImageFactory ImageFactory => _imageFactory;
-
-    /// <inheritdoc/>
-    public void ExtractImages(string? fileFilePath, string targetDirectory, int fileCount = 1)
-    {
-        if (string.IsNullOrEmpty(fileFilePath)) return;
-        _directoryService.ExistOrCreate(targetDirectory);
-        if (fileCount == 1)
-        {
-            _directoryService.CopyFileToDirectory(fileFilePath, targetDirectory);
-        }
-        else
-        {
-            _directoryService.CopyDirectoryToDirectory(_directoryService.FileSystem.Path.GetDirectoryName(fileFilePath), targetDirectory,
-                Tasks.Scanner.Parser.Parser.ImageFileExtensions);
-        }
-    }
-
-    /// <summary>
-    /// Creates a thumbnail image from the specified image with the given width and height.
-    /// If the image aspect ratio is significantly different from the target aspect ratio, it will be context aware cropped to fit.
-    /// </summary>
-    /// <param name="image">The image to create a thumbnail from.</param>
-    /// <param name="width">The width of the thumbnail.</param>
-    /// <param name="height">The height of the thumbnail.</param>
-    /// <returns>The thumbnail image.</returns>
-    public static IImage Thumbnail(IImage image, int width, int height)
-    {
-        try
-        {
-            if (WillScaleWell(image, width, height) || IsLikelyWideImage(image.Width, image.Height))
-            {
-                image.Thumbnail(width, height);
-                return image;
-            }
-        }
-        catch (Exception)
-        {
-            /* Swallow */
-        }
-        var crop = SmartCrop.Crop(image, new SmartCrop.SmartCropOptions { Width = width, Height = height });
-        if (crop.TopCrop.Width != width && crop.TopCrop.Height != height)
-        {
-            image.Crop(crop.TopCrop.X, crop.TopCrop.Y, crop.TopCrop.Width, crop.TopCrop.Height);
-        }
-        image.Thumbnail(width, height);
-        return image;
-    }
-
-    public static bool WillScaleWell(IImage sourceImage, int targetWidth, int targetHeight, double tolerance = 0.1)
-    {
-        // Calculate the aspect ratios
-        var sourceAspectRatio = (double) sourceImage.Width / sourceImage.Height;
-        var targetAspectRatio = (double) targetWidth / targetHeight;
-
-        // Compare aspect ratios
-        if (Math.Abs(sourceAspectRatio - targetAspectRatio) > tolerance)
-        {
-            return false; // Aspect ratios differ significantly
-        }
-
-        // Calculate scaling factors
-        var widthScaleFactor = (double) targetWidth / sourceImage.Width;
-        var heightScaleFactor = (double) targetHeight / sourceImage.Height;
-
-        // Check resolution quality (example thresholds)
-        if (widthScaleFactor > 2.0 || heightScaleFactor > 2.0)
-        {
-            return false; // Scaling factor too large
-        }
-
-        return true; // Image will scale well
-    }
-
-    private static bool IsLikelyWideImage(int width, int height)
-    {
-        var aspectRatio = (double) width / height;
-        return aspectRatio > 1.25;
-    }
-
-
-    /// <inheritdoc/>
-    public string GetCoverImage(string path, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size, int quality = 100)
-    {
-        if (string.IsNullOrEmpty(path)) return string.Empty;
-
-        try
-        {
-            var (width, height) = size.GetDimensions();
-            using var thumbnail = Thumbnail(_imageFactory.Create(path), width, height);
-            var filename = fileName + encodeFormat.GetExtension();
-            thumbnail.Save(_directoryService.FileSystem.Path.Join(outputDirectory, filename), encodeFormat, quality);
-            return filename;
-        }
-        catch (Exception ex)
-        {
-            _logger.LogWarning(ex, "[GetCoverImage] There was an error and prevented thumbnail generation on {ImageFile}. Defaulting to no cover image", path);
-        }
-
-        return string.Empty;
-    }
-
-    /// <inheritdoc/>
-    public string WriteCoverThumbnail(Stream stream, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size = CoverImageSize.Default, int quality = 100)
-    {
-        var (targetWidth, targetHeight) = size.GetDimensions();
-        if (stream.CanSeek) stream.Position = 0;
-
-        using var thumbnail = Thumbnail(_imageFactory.Create(stream), targetWidth, targetHeight);
-        var filename = fileName + encodeFormat.GetExtension();
-        _directoryService.ExistOrCreate(outputDirectory);
-
-        try
-        {
-            _directoryService.FileSystem.File.Delete(_directoryService.FileSystem.Path.Join(outputDirectory, filename));
-        } catch (Exception) {/* Swallow exception */}
-
-        try
-        {
-            thumbnail.Save(_directoryService.FileSystem.Path.Join(outputDirectory, filename), encodeFormat, quality);
-        }
-        catch (Exception) {/* Swallow exception */}
-
-        return filename;
-    }
-    /// <inheritdoc/>
-    public string WriteCoverThumbnail(string sourceFile, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size = CoverImageSize.Default, int quality = 100)
-    {
-        var (width, height) = size.GetDimensions();
-        using var thumbnail = Thumbnail(_imageFactory.Create(sourceFile), width, height);
-        var filename = fileName + encodeFormat.GetExtension();
-        _directoryService.ExistOrCreate(outputDirectory);
-        try
-        {
-            _directoryService.FileSystem.File.Delete(_directoryService.FileSystem.Path.Join(outputDirectory, filename));
-        } catch (Exception) {/* Swallow exception */}
-        thumbnail.Save(_directoryService.FileSystem.Path.Join(outputDirectory, filename), encodeFormat, quality);
-
-        return filename;
-    }
-    /// <inheritdoc/>
-    public async Task<string> ConvertToEncodingFormat(string filePath, string outputPath, EncodeFormat encodeFormat, int quality = 100)
-    {
-        var file = _directoryService.FileSystem.FileInfo.New(filePath);
-        var fileName = file.Name.Replace(file.Extension, string.Empty);
-        var outputFile = Path.Join(outputPath, fileName + encodeFormat.GetExtension());
-        using var sourceImage = _imageFactory.Create(filePath);
-        await sourceImage.SaveAsync(outputFile, encodeFormat, quality).ConfigureAwait(false);
-
-        return outputFile;
-    }
-
-    /// <inheritdoc/>
-    public Task<bool> IsImage(string filePath)
-    {
-        try
-        {
-            return Task.FromResult(_imageFactory.GetDimensions(filePath) != null);
-        }
-        catch (Exception)
-        {
-            /* Swallow Exception */
-        }
-
-        return Task.FromResult(false);
-    }
-    /// <inheritdoc/>
-    public async Task<string> DownloadFaviconAsync(string url, EncodeFormat encodeFormat, int quality = 100)
-    {
-        // Parse the URL to get the domain (including subdomain)
-        var uri = new Uri(url);
-        var domain = uri.Host.Replace(Environment.NewLine, string.Empty);
-        var baseUrl = uri.Scheme + "://" + uri.Host;
-
-
-        var provider = _cacheFactory.GetCachingProvider(EasyCacheProfiles.Favicon);
-        var res = await provider.GetAsync<string>(baseUrl);
-        if (res.HasValue)
-        {
-            _logger.LogInformation("Kavita has already tried to fetch from {BaseUrl} and failed. Skipping duplicate check", baseUrl);
-            throw new KavitaException($"Kavita has already tried to fetch from {baseUrl} and failed. Skipping duplicate check");
-        }
-
-        await provider.SetAsync(baseUrl, string.Empty, TimeSpan.FromDays(10));
-        if (FaviconUrlMapper.TryGetValue(baseUrl, out var value))
-        {
-            url = value;
-        }
-
-        var correctSizeLink = string.Empty;
-
-        try
-        {
-            var htmlContent = url.GetStringAsync().Result;
-            var htmlDocument = new HtmlDocument();
-            htmlDocument.LoadHtml(htmlContent);
-            var pngLinks = htmlDocument.DocumentNode.Descendants("link")
-                .Where(link => ValidIconRelations.Contains(link.GetAttributeValue("rel", string.Empty)))
-                .Select(link => link.GetAttributeValue("href", string.Empty))
-                .Where(href => href.Split("?")[0].EndsWith(".png", StringComparison.InvariantCultureIgnoreCase))
-                .ToList();
-
-            correctSizeLink = (pngLinks?.Find(pngLink => pngLink.Contains("32")) ?? pngLinks?.FirstOrDefault());
-        }
-        catch (Exception ex)
-        {
-            _logger.LogError(ex, "Error downloading favicon.png for {Domain}, will try fallback methods", domain);
-        }
-
-        try
-        {
-            if (string.IsNullOrEmpty(correctSizeLink))
-            {
-                correctSizeLink = await FallbackToKavitaReaderFavicon(baseUrl);
-            }
-            if (string.IsNullOrEmpty(correctSizeLink))
-            {
-                throw new KavitaException($"Could not grab favicon from {baseUrl}");
-            }
-
-            var finalUrl = correctSizeLink;
-
-            // If starts with //, it's coming usually from an offsite cdn
-            if (correctSizeLink.StartsWith("//"))
-            {
-                finalUrl = "https:" + correctSizeLink;
-            }
-            else if (!correctSizeLink.StartsWith(uri.Scheme))
-            {
-                finalUrl = Url.Combine(baseUrl, correctSizeLink);
-            }
-
-            _logger.LogTrace("Fetching favicon from {Url}", finalUrl);
-            // Download the favicon.ico file using Flurl
-            var faviconStream = await finalUrl
-                .AllowHttpStatus("2xx,304")
-                .GetStreamAsync();
-
-            // Create the destination file path
-            using var image = _imageFactory.Create(faviconStream);
-            var filename = ImageService.GetWebLinkFormat(baseUrl, encodeFormat);
-            await image.SaveAsync(Path.Combine(_directoryService.FaviconDirectory, filename), encodeFormat, quality);
-            _logger.LogDebug("Favicon for {Domain} downloaded and saved successfully", domain);
-            return filename;
-        } catch (Exception ex)
-        {
-            _logger.LogError(ex, "Error downloading favicon for {Domain}", domain);
-            throw;
-        }
-    }
-    /// <inheritdoc/>
-    public async Task<string> DownloadPublisherImageAsync(string publisherName, EncodeFormat encodeFormat, int quality = 100)
-    {
-        try
-        {
-            var publisherLink = await FallbackToKavitaReaderPublisher(publisherName);
-            if (string.IsNullOrEmpty(publisherLink))
-            {
-                throw new KavitaException($"Could not grab publisher image for {publisherName}");
-            }
-
-            var finalUrl = publisherLink;
-
-            _logger.LogTrace("Fetching publisher image from {Url}", finalUrl);
-            // Download the favicon.ico file using Flurl
-            var publisherStream = await finalUrl
-                .AllowHttpStatus("2xx,304")
-                .GetStreamAsync();
-
-            // Create the destination file path
-            using var image = _imageFactory.Create(publisherStream);
-            var filename = GetPublisherFormat(publisherName, encodeFormat);
-            await image.SaveAsync(Path.Combine(_directoryService.FaviconDirectory, filename), encodeFormat, quality);
-            _logger.LogDebug("Publisher image for {PublisherName} downloaded and saved successfully", publisherName);
-            return filename;
-        } catch (Exception ex)
-        {
-            _logger.LogError(ex, "Error downloading image for {PublisherName}", publisherName);
-            throw;
-        }
-    }
-
-    private (Vector3?, Vector3?) GetPrimarySecondaryColors(string imagePath)
-    {
-
-
-        var rgbPixels = _imageFactory.GetRgbPixelsPercentage(imagePath, 10);
-
-        // Perform k-means clustering
-        var clusters = KMeansClustering(rgbPixels, 4);
-
-        var sorted = SortByVibrancy(clusters);
-
-        // Ensure white and black are not selected as primary/secondary colors
-        sorted = sorted.Where(c => !IsCloseToWhiteOrBlack(c)).ToList();
-
-        if (sorted.Count >= 2)
-        {
-            return (sorted[0], sorted[1]);
-        }
-        if (sorted.Count == 1)
-        {
-            return (sorted[0], null);
-        }
-
-        return (null, null);
-    }
-
-    private static bool IsColorCloseToWhiteOrBlack(Vector3 color)
-    {
-        var (_, _, lightness) = RgbToHsl(color);
-        return lightness is > WhiteThreshold or < BlackThreshold;
-    }
-
-    private static List<Vector3> KMeansClustering(List<Vector3> points, int k, int maxIterations = 100)
-    {
-        var random = new Random();
-        var centroids = points.OrderBy(x => random.Next()).Take(k).ToList();
-
-        for (var i = 0; i < maxIterations; i++)
-        {
-            var clusters = new List<Vector3>[k];
-            for (var j = 0; j < k; j++)
-            {
-                clusters[j] = [];
-            }
-
-            foreach (var point in points)
-            {
-                var nearestCentroidIndex = centroids
-                    .Select((centroid, index) => new { Index = index, Distance = Vector3.DistanceSquared(centroid, point) })
-                    .OrderBy(x => x.Distance)
-                    .First().Index;
-                clusters[nearestCentroidIndex].Add(point);
-            }
-
-            var newCentroids = clusters.Select(cluster =>
-                cluster.Count != 0 ? new Vector3(
-                    cluster.Average(p => p.X),
-                    cluster.Average(p => p.Y),
-                    cluster.Average(p => p.Z)
-                ) : Vector3.Zero
-            ).ToList();
-
-            if (centroids.SequenceEqual(newCentroids))
-                break;
-
-            centroids = newCentroids;
-        }
-
-        return centroids;
-    }
-
-    public static List<Vector3> SortByBrightness(List<Vector3> colors)
-    {
-        return colors.OrderBy(c => 0.299 * c.X + 0.587 * c.Y + 0.114 * c.Z).ToList();
-    }
-
-    private static List<Vector3> SortByVibrancy(List<Vector3> colors)
-    {
-        return colors.OrderByDescending(c =>
-        {
-            var max = Math.Max(c.X, Math.Max(c.Y, c.Z));
-            var min = Math.Min(c.X, Math.Min(c.Y, c.Z));
-            return (max - min) / max;
-        }).ToList();
-    }
-
-    private static bool IsCloseToWhiteOrBlack(Vector3 color)
-    {
-        var threshold = 30;
-        return (color.X > 255 - threshold && color.Y > 255 - threshold && color.Z > 255 - threshold) ||
-               (color.X < threshold && color.Y < threshold && color.Z < threshold);
-    }
-
-    private static string RgbToHex(Vector3 color)
-    {
-        return $"#{(int)color.X:X2}{(int)color.Y:X2}{(int)color.Z:X2}";
-    }
-
-    private static Vector3 GetComplementaryColor(Vector3 color)
-    {
-        // Convert RGB to HSL
-        var (h, s, l) = RgbToHsl(color);
-
-        // Rotate hue by 180 degrees
-        h = (h + 180) % 360;
-
-        // Convert back to RGB
-        return HslToRgb(h, s, l);
-    }
-
-    private static (double H, double S, double L) RgbToHsl(Vector3 rgb)
-    {
-        double r = rgb.X / 255;
-        double g = rgb.Y / 255;
-        double b = rgb.Z / 255;
-
-        var max = Math.Max(r, Math.Max(g, b));
-        var min = Math.Min(r, Math.Min(g, b));
-        var diff = max - min;
-
-        double h = 0;
-        double s = 0;
-        var l = (max + min) / 2;
-
-        if (Math.Abs(diff) > 0.00001)
-        {
-            s = l > 0.5 ? diff / (2 - max - min) : diff / (max + min);
-
-            if (max == r)
-                h = (g - b) / diff + (g < b ? 6 : 0);
-            else if (max == g)
-                h = (b - r) / diff + 2;
-            else if (max == b)
-                h = (r - g) / diff + 4;
-
-            h *= 60;
-        }
-
-        return (h, s, l);
-    }
-
-    private static Vector3 HslToRgb(double h, double s, double l)
-    {
-        double r, g, b;
-
-        if (Math.Abs(s) < 0.00001)
-        {
-            r = g = b = l;
-        }
-        else
-        {
-            var q = l < 0.5 ? l * (1 + s) : l + s - l * s;
-            var p = 2 * l - q;
-            r = HueToRgb(p, q, h + 120);
-            g = HueToRgb(p, q, h);
-            b = HueToRgb(p, q, h - 120);
-        }
-
-        return new Vector3((float)(r * 255), (float)(g * 255), (float)(b * 255));
-    }
-
-    private static double HueToRgb(double p, double q, double t)
-    {
-        if (t < 0) t += 360;
-        if (t > 360) t -= 360;
-        return t switch
-        {
-            < 60 => p + (q - p) * t / 60,
-            < 180 => q,
-            < 240 => p + (q - p) * (240 - t) / 60,
-            _ => p
-        };
-    }
-
-    /// <summary>
-    /// Generates the Primary and Secondary colors from a file
-    /// </summary>
-    /// <remarks>This may use a second most common color or a complementary color. It's up to implemenation to choose what's best</remarks>
-    /// <param name="sourceFile"></param>
-    /// <returns></returns>
-    public ColorScape CalculateColorScape(string sourceFile)
-    {
-        if (!File.Exists(sourceFile)) return new ColorScape() {Primary = null, Secondary = null};
-
-        var colors = GetPrimarySecondaryColors(sourceFile);
-
-        return new ColorScape()
-        {
-            Primary = colors.Item1 == null ? null : RgbToHex(colors.Item1.Value),
-            Secondary = colors.Item2 == null ? null : RgbToHex(colors.Item2.Value)
-        };
-    }
-    private bool CheckDirectSupport(string filename, List<string> supportedImageFormats)
-    {
-        if (supportedImageFormats == null) return false;
-
-        string ext = Path.GetExtension(filename).ToLowerInvariant().Substring(1);
-        return supportedImageFormats.Contains(ext);
-    }
-
-
-    /// <inheritdoc/>
-    public string ReplaceImageFileFormat(string filename, List<string> supportedImageFormats = null, EncodeFormat format = EncodeFormat.JPEG, int quality = 99)
-    {
-        if (CheckDirectSupport(filename, supportedImageFormats)) return filename;
-
-        Match m = Regex.Match(Path.GetExtension(filename), Parser.NonUniversalFileImageExtensions, RegexOptions.IgnoreCase, Parser.RegexTimeout);
-        if (!m.Success) return filename;
-
-        string destination = Path.ChangeExtension(filename, format.GetExtension().Substring(1));
-
-        // Adding a lock per destination, sometimes web ui triggers same image loading at the ~ same time.
-        // So, if other thread is already processing the image, we should wait for it to finish, then the File.Exists(destination) will early exit.
-        // This exists, to prevent multiple threads from processing the same image at the same time.
-        lock (_lock[destination])
-        {
-            if (File.Exists(destination))
-            {
-                // Destination already exist, the conversion was already made.
-                return destination;
-            }
-            using var sourceImage = _imageFactory.Create(filename);
-            sourceImage.Save(destination, format, quality);
-            try
-            {
-                File.Delete(filename);
-            }
-            catch (Exception) { /* Swallow Exception */ }
-        }
-        return destination;
-    }
-
-    private static async Task<string> FallbackToKavitaReaderFavicon(string baseUrl)
-    {
-        var correctSizeLink = string.Empty;
-        var allOverrides = await "https://www.kavitareader.com/assets/favicons/urls.txt".GetStringAsync();
-        if (!string.IsNullOrEmpty(allOverrides))
-        {
-            var cleanedBaseUrl = baseUrl.Replace("https://", string.Empty);
-            var externalFile = allOverrides
-                .Split("\n")
-                .FirstOrDefault(url =>
-                    cleanedBaseUrl.Equals(url.Replace(".png", string.Empty)) ||
-                    cleanedBaseUrl.Replace("www.", string.Empty).Equals(url.Replace(".png", string.Empty)
-                    ));
-
-            if (string.IsNullOrEmpty(externalFile))
-            {
-                throw new KavitaException($"Could not grab favicon from {baseUrl}");
-            }
-
-            correctSizeLink = "https://www.kavitareader.com/assets/favicons/" + externalFile;
-        }
-
-        return correctSizeLink;
-    }
-
-    private static async Task<string> FallbackToKavitaReaderPublisher(string publisherName)
-    {
-        var externalLink = string.Empty;
-        var allOverrides = await "https://www.kavitareader.com/assets/publishers/publishers.txt".GetStringAsync();
-        if (!string.IsNullOrEmpty(allOverrides))
-        {
-            var externalFile = allOverrides
-                .Split("\n")
-                .Select(publisherLine =>
-                {
-                    var tokens = publisherLine.Split("|");
-                    if (tokens.Length != 2) return null;
-                    var aliases = tokens[0];
-                    // Multiple publisher aliases are separated by #
-                    if (aliases.Split("#").Any(name => name.ToLowerInvariant().Trim().Equals(publisherName.ToLowerInvariant().Trim())))
-                    {
-                        return tokens[1];
-                    }
-                    return null;
-                })
-                .FirstOrDefault(url => !string.IsNullOrEmpty(url));
-
-            if (string.IsNullOrEmpty(externalFile))
-            {
-                throw new KavitaException($"Could not grab publisher image for {publisherName}");
-            }
-
-            externalLink = "https://www.kavitareader.com/assets/publishers/" + externalFile;
-        }
-
-        return externalLink;
-    }
-
-    /// <inheritdoc />
-    public string CreateThumbnailFromBase64(string encodedImage, string fileName, EncodeFormat encodeFormat, int thumbnailWidth = ThumbnailWidth, int quality = 100)
-    {
-        try
-        {
-
-            using var thumbnail = _imageFactory.CreateFromBase64(encodedImage);
-            int thumbnailHeight = (int)(thumbnail.Height * ((double)thumbnailWidth / thumbnail.Width));
-            thumbnail.Thumbnail(thumbnailWidth, thumbnailHeight);
-            fileName += encodeFormat.GetExtension();
-            thumbnail.Save(_directoryService.FileSystem.Path.Join(_directoryService.CoverImageDirectory, fileName), encodeFormat, quality);
-            return fileName;
-        }
-        catch (Exception e)
-        {
-            _logger.LogError(e, "Error creating thumbnail from url");
-        }
-
-        return string.Empty;
-    }
-
-    /// <summary>
-    /// Returns the name format for a chapter cover image
-    /// </summary>
-    /// <param name="chapterId"></param>
-    /// <param name="volumeId"></param>
-    /// <returns></returns>
-    public static string GetChapterFormat(int chapterId, int volumeId)
-    {
-        return $"v{volumeId}_c{chapterId}";
-    }
-
-    /// <summary>
-    /// Returns the name format for a volume cover image (custom)
-    /// </summary>
-    /// <param name="volumeId"></param>
-    /// <returns></returns>
-    public static string GetVolumeFormat(int volumeId)
-    {
-        return $"v{volumeId}";
-    }
-
-    /// <summary>
-    /// Returns the name format for a library cover image
-    /// </summary>
-    /// <param name="libraryId"></param>
-    /// <returns></returns>
-    public static string GetLibraryFormat(int libraryId)
-    {
-        return $"l{libraryId}";
-    }
-
-    /// <summary>
-    /// Returns the name format for a series cover image
-    /// </summary>
-    /// <param name="seriesId"></param>
-    /// <returns></returns>
-    public static string GetSeriesFormat(int seriesId)
-    {
-        return $"series{seriesId}";
-    }
-
-    /// <summary>
-    /// Returns the name format for a collection tag cover image
-    /// </summary>
-    /// <param name="tagId"></param>
-    /// <returns></returns>
-    public static string GetCollectionTagFormat(int tagId)
-    {
-        return $"tag{tagId}";
-    }
-
-    /// <summary>
-    /// Returns the name format for a reading list cover image
-    /// </summary>
-    /// <param name="readingListId"></param>
-    /// <returns></returns>
-    public static string GetReadingListFormat(int readingListId)
-    {
-        // ReSharper disable once StringLiteralTypo
-        return $"readinglist{readingListId}";
-    }
-
-    /// <summary>
-    /// Returns the name format for a thumbnail (temp thumbnail)
-    /// </summary>
-    /// <param name="chapterId"></param>
-    /// <returns></returns>
-    public static string GetThumbnailFormat(int chapterId)
-    {
-        return $"thumbnail{chapterId}";
-    }
-
-    public static string GetWebLinkFormat(string url, EncodeFormat encodeFormat)
-    {
-        return $"{new Uri(url).Host.Replace("www.", string.Empty)}{encodeFormat.GetExtension()}";
-    }
-
-    public static string GetPublisherFormat(string publisher, EncodeFormat encodeFormat)
-    {
-        return $"{publisher}{encodeFormat.GetExtension()}";
-    }
-
-    /// <inheritdoc/>
-    public void CreateMergedImage(IList<string> coverImages, CoverImageSize size, string dest, EncodeFormat format = EncodeFormat.PNG, int quality = 100)
-    {
-        var (width, height) = size.GetDimensions();
-        int rows, cols;
-
-        if (coverImages.Count == 1)
-        {
-            rows = 1;
-            cols = 1;
-        }
-        else if (coverImages.Count == 2)
-        {
-            rows = 1;
-            cols = 2;
-        }
-        else
-        {
-            rows = 2;
-            cols = 2;
-        }
-
-
-        var image = _imageFactory.Create(width, height);
-
-        var thumbnailWidth = image.Width / cols;
-        var thumbnailHeight = image.Height / rows;
-
-        for (var i = 0; i < coverImages.Count; i++)
-        {
-            if (!File.Exists(coverImages[i])) continue;
-            var tile = _imageFactory.Create(coverImages[i]);
-            tile.Thumbnail(thumbnailWidth, thumbnailHeight);
-
-            var row = i / cols;
-            var col = i % cols;
-
-            var x = col * thumbnailWidth;
-            var y = row * thumbnailHeight;
-
-            if (coverImages.Count == 3 && i == 2)
-            {
-                x = (image.Width - thumbnailWidth) / 2;
-                y = thumbnailHeight;
-            }
-            image.Composite(tile,x,y);
-        }
-
-        image.Save(dest, format, quality);
-    }
-
-    /// <inheritdoc/>
-    public void UpdateColorScape(IHasCoverImage entity)
-    {
-        var colors = CalculateColorScape(_directoryService.FileSystem.Path.Join(_directoryService.CoverImageDirectory, entity.CoverImage));
-        entity.PrimaryColor = colors.Primary;
-        entity.SecondaryColor = colors.Secondary;
-    }
-
-    public static Color HexToRgb(string? hex)
-    {
-        if (string.IsNullOrEmpty(hex)) throw new ArgumentException("Hex cannot be null");
-
-        // Remove the leading '#' if present
-        hex = hex.TrimStart('#');
-
-        // Ensure the hex string is valid
-        if (hex.Length != 6 && hex.Length != 3)
-        {
-            throw new ArgumentException("Hex string should be 6 or 3 characters long.");
-        }
-
-        if (hex.Length == 3)
-        {
-            // Expand shorthand notation to full form (e.g., "abc" -> "aabbcc")
-            hex = string.Concat(hex[0], hex[0], hex[1], hex[1], hex[2], hex[2]);
-        }
-
-        // Parse the hex string into RGB components
-        var r = Convert.ToInt32(hex.Substring(0, 2), 16);
-        var g = Convert.ToInt32(hex.Substring(2, 2), 16);
-        var b = Convert.ToInt32(hex.Substring(4, 2), 16);
-
-        return Color.FromArgb(r, g, b);
-    }
-
-
-}

From a0f804ba175cda90d40a38219ef4a81589c12756 Mon Sep 17 00:00:00 2001
From: Maximo Piva <mpiva@adventintermodal.com>
Date: Fri, 11 Oct 2024 20:30:40 -0300
Subject: [PATCH 29/30] Removed quality parameter everywhere. Added Quality
 From EncodedFormat Extension

---
 API.Benchmark/ArchiveServiceBenchmark.cs      |  6 +-
 API.Tests/Services/ArchiveServiceTests.cs     |  2 +-
 API.Tests/Services/ImageServiceTests.cs       |  4 +-
 API/Extensions/EncodeFormatExtensions.cs      | 12 ++++
 API/Services/BookService.cs                   |  2 +-
 API/Services/ImageService.cs                  | 63 ++++++++-----------
 API/Services/ImageServices/IImage.cs          |  8 +--
 .../ImageMagick/ImageMagickImage.cs           | 17 ++---
 8 files changed, 59 insertions(+), 55 deletions(-)

diff --git a/API.Benchmark/ArchiveServiceBenchmark.cs b/API.Benchmark/ArchiveServiceBenchmark.cs
index 589433360..dd7b5f1e7 100644
--- a/API.Benchmark/ArchiveServiceBenchmark.cs
+++ b/API.Benchmark/ArchiveServiceBenchmark.cs
@@ -26,7 +26,7 @@ public class ArchiveServiceBenchmark
     private readonly IImageService _imageService;
     private readonly IImageFactory _imageFactory;
     private const string SourceImage = "Data/comic-normal.jpg";
-        
+
 
     public ArchiveServiceBenchmark()
     {
@@ -71,7 +71,7 @@ public void ImageMagick_ExtractImage_PNG()
         int width = 320;
         int height = (int)(thumbnail2.Height * (width / (double)thumbnail2.Width));
         thumbnail2.Thumbnail(width, height);
-        thumbnail2.Save(_directoryService.FileSystem.Path.Join(outputDirectory, "imagesharp.png"), EncodeFormat.PNG, 100);
+        thumbnail2.Save(_directoryService.FileSystem.Path.Join(outputDirectory, "imagesharp.png"), EncodeFormat.PNG);
     }
 
     [Benchmark]
@@ -85,7 +85,7 @@ public void ImageMagick_ExtractImage_WebP()
         int width = 320;
         int height = (int)(thumbnail2.Height * (width / (double)thumbnail2.Width));
         thumbnail2.Thumbnail(width, height);
-        thumbnail2.Save(_directoryService.FileSystem.Path.Join(outputDirectory, "imagesharp.webp"), EncodeFormat.PNG, 100);
+        thumbnail2.Save(_directoryService.FileSystem.Path.Join(outputDirectory, "imagesharp.webp"), EncodeFormat.PNG);
     }
 
 
diff --git a/API.Tests/Services/ArchiveServiceTests.cs b/API.Tests/Services/ArchiveServiceTests.cs
index 497effad1..9fd1772cb 100644
--- a/API.Tests/Services/ArchiveServiceTests.cs
+++ b/API.Tests/Services/ArchiveServiceTests.cs
@@ -177,7 +177,7 @@ public void GetCoverImage_Default_Test(string inputFile, string expectedOutputFi
         int height = (int)(thumbnail.Height * (width / (double)thumbnail.Width));
         thumbnail.Thumbnail(width, height);
         using MemoryStream stream = new MemoryStream();
-        thumbnail.Save(stream, EncodeFormat.PNG, 100);
+        thumbnail.Save(stream, EncodeFormat.PNG);
         var expectedBytes = stream.ToArray();
 
         archiveService.Configure().CanOpen(Path.Join(testDirectory, inputFile)).Returns(ArchiveLibrary.Default);
diff --git a/API.Tests/Services/ImageServiceTests.cs b/API.Tests/Services/ImageServiceTests.cs
index 2497f02be..77f79ca57 100644
--- a/API.Tests/Services/ImageServiceTests.cs
+++ b/API.Tests/Services/ImageServiceTests.cs
@@ -63,7 +63,7 @@ private void GenerateFiles(string outputExtension)
             var thumbnail = factory.Create(imagePath);
             thumbnail = ImageService.Thumbnail(thumbnail, dims.Width, dims.Height);
             var outputFileName = fileName + outputExtension + ".png";
-            thumbnail.Save(Path.Join(_testDirectory, outputFileName), EncodeFormat.PNG,100);
+            thumbnail.Save(Path.Join(_testDirectory, outputFileName), EncodeFormat.PNG);
         }
     }
 
@@ -166,7 +166,7 @@ private static void GenerateColorImage(string hexColor, string outputPath)
         ImageMagickImageFactory factory = new ImageMagickImageFactory();
         var color = ImageService.HexToRgb(hexColor);
         using var colorImage = factory.Create(200,100,color.R, color.G, color.B);
-        colorImage.Save(outputPath, EncodeFormat.PNG, 100);
+        colorImage.Save(outputPath, EncodeFormat.PNG);
     }
 
     private void GenerateHtmlFileForColorScape()
diff --git a/API/Extensions/EncodeFormatExtensions.cs b/API/Extensions/EncodeFormatExtensions.cs
index 21b57ef43..b4372d5f9 100644
--- a/API/Extensions/EncodeFormatExtensions.cs
+++ b/API/Extensions/EncodeFormatExtensions.cs
@@ -17,4 +17,16 @@ public static string GetExtension(this EncodeFormat encodeFormat)
             _ => throw new ArgumentOutOfRangeException(nameof(encodeFormat), encodeFormat, null)
         };
     }
+
+    public static int DefaultQuality(this EncodeFormat encodeFormat)
+    {
+        return encodeFormat switch
+        {
+            EncodeFormat.PNG => 100, // (Image Magick Maximum Deflate Compression) (In case of PNG, png is always lossless, Quality indicate the compression level)
+            EncodeFormat.WEBP => 100,
+            EncodeFormat.AVIF => 100,
+            EncodeFormat.JPEG => 99, // (Best Compression speed, with almost no visual quality loss)
+            _ => throw new ArgumentOutOfRangeException(nameof(encodeFormat), encodeFormat, null)
+        };
+    }
 }
diff --git a/API/Services/BookService.cs b/API/Services/BookService.cs
index 4df3f422f..31703b2a1 100644
--- a/API/Services/BookService.cs
+++ b/API/Services/BookService.cs
@@ -1280,7 +1280,7 @@ private void GetPdfPage(IDocReader docReader, int pageNumber, Stream stream)
         var height = pageReader.GetPageHeight();
         IImage image = _imageService.ImageFactory.CreateFromBGRAByteArray(rawBytes, width, height);
         stream.Seek(0, SeekOrigin.Begin);
-        image.Save(stream, EncodeFormat.PNG, 100);
+        image.Save(stream, EncodeFormat.PNG);
         stream.Seek(0, SeekOrigin.Begin);
     }
 
diff --git a/API/Services/ImageService.cs b/API/Services/ImageService.cs
index 0f8991b5a..73fbac60f 100644
--- a/API/Services/ImageService.cs
+++ b/API/Services/ImageService.cs
@@ -49,9 +49,8 @@ public interface IImageService
     /// <param name="outputDirectory">The output directory to save the image.</param>
     /// <param name="encodeFormat">The encoding format to convert and save the image.</param>
     /// <param name="size">The size of the cover image.</param>
-    /// <param name="quality">The quality of the image. Default is 100.</param>
     /// <returns>The file name with extension of the saved image.</returns>
-    string GetCoverImage(string path, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size, int quality = 100);
+    string GetCoverImage(string path, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size);
 
     /// <summary>
     /// Creates a thumbnail version of a base64 encoded image.
@@ -60,9 +59,8 @@ public interface IImageService
     /// <param name="fileName">The name of the output file.</param>
     /// <param name="encodeFormat">The encoding format to convert and save the image.</param>
     /// <param name="thumbnailWidth">The width of the thumbnail. Default is 320.</param>
-    /// <param name="quality">The quality of the image. Default is 100.</param>
     /// <returns>The file name with extension of the saved thumbnail image.</returns>
-    string CreateThumbnailFromBase64(string encodedImage, string fileName, EncodeFormat encodeFormat, int thumbnailWidth = 320, int quality = 100);
+    string CreateThumbnailFromBase64(string encodedImage, string fileName, EncodeFormat encodeFormat, int thumbnailWidth = 320);
 
     /// <summary>
     /// Creates a thumbnail out of a memory stream and saves to <see cref="DirectoryService.CoverImageDirectory"/> with the passed
@@ -73,9 +71,8 @@ public interface IImageService
     /// <param name="outputDirectory">Where to output the file, defaults to covers directory</param>
     /// <param name="encodeFormat">Export the file as the passed encoding</param>
     /// <param name="size">The size of the cover image.</param>
-    /// <param name="quality">The quality of the image. Default is 100.</param>
     /// <returns>File name with extension of the file. This will always write to <see cref="DirectoryService.CoverImageDirectory"/></returns>
-    string WriteCoverThumbnail(Stream stream, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size = CoverImageSize.Default, int quality = 100);
+    string WriteCoverThumbnail(Stream stream, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size = CoverImageSize.Default);
 
     /// <summary>
     /// Writes out a thumbnail image from a file path input and saves to <see cref="DirectoryService.CoverImageDirectory"/> with the passed
@@ -85,9 +82,8 @@ public interface IImageService
     /// <param name="outputDirectory">Where to output the file, defaults to covers directory</param>
     /// <param name="encodeFormat">Export the file as the passed encoding</param>
     /// <param name="size">The size of the cover image.</param>
-    /// <param name="quality">The quality of the image. Default is 100.</param>
     /// <returns>File name with extension of the file. This will always write to <see cref="DirectoryService.CoverImageDirectory"/></returns>
-    string WriteCoverThumbnail(string sourceFile, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size = CoverImageSize.Default, int quality = 100);
+    string WriteCoverThumbnail(string sourceFile, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size = CoverImageSize.Default);
 
     /// <summary>
     /// Converts the specified image file to the specified encoding format and saves it to the output path.
@@ -95,9 +91,8 @@ public interface IImageService
     /// <param name="filePath">The full path of the image file to convert.</param>
     /// <param name="outputPath">The path to save the converted image file.</param>
     /// <param name="encodeFormat">The encoding format to convert the image.</param>
-    /// <param name="quality">The quality of the image. Default is 100.</param>
     /// <returns>The file path of the converted image file.</returns>
-    Task<string> ConvertToEncodingFormat(string filePath, string outputPath, EncodeFormat encodeFormat, int quality = 100);
+    Task<string> ConvertToEncodingFormat(string filePath, string outputPath, EncodeFormat encodeFormat);
 
     /// <summary>
     /// Checks if the specified file is an image.
@@ -111,18 +106,16 @@ public interface IImageService
     /// </summary>
     /// <param name="url">The URL of the favicon.</param>
     /// <param name="encodeFormat">The encoding format to convert and save the favicon.</param>
-    /// <param name="quality">The quality of the favicon. Default is 100.</param>
     /// <returns>The file name with extension of the saved favicon.</returns>
-    Task<string> DownloadFaviconAsync(string url, EncodeFormat encodeFormat, int quality = 100);
+    Task<string> DownloadFaviconAsync(string url, EncodeFormat encodeFormat);
 
     /// <summary>
     /// Downloads the publisher image for the specified publisher name and saves it to the output directory.
     /// </summary>
     /// <param name="publisherName">The name of the publisher.</param>
     /// <param name="encodeFormat">The encoding format to convert and save the publisher image.</param>
-    /// <param name="quality">The quality of the publisher image. Default is 100.</param>
     /// <returns>The file name with extension of the saved publisher image.</returns>
-    Task<string> DownloadPublisherImageAsync(string publisherName, EncodeFormat encodeFormat, int quality = 100);
+    Task<string> DownloadPublisherImageAsync(string publisherName, EncodeFormat encodeFormat);
 
     /// <summary>
     /// Updates the color scape of an entity with a cover image.
@@ -136,9 +129,8 @@ public interface IImageService
     /// <param name="filename">The name of the image file.</param>
     /// <param name="supportedImageFormats">The list of supported image formats by the browser.</param>
     /// <param name="format">The encoding format to convert the image. Default is JPG</param>
-    /// <param name="quality">The quality of the image. Default is 99.</param>
     /// <returns>The file name with extension of the replaced image file.</returns>
-    string ReplaceImageFileFormat(string filename, List<string> supportedImageFormats = null, EncodeFormat format = EncodeFormat.JPEG, int quality = 99);
+    string ReplaceImageFileFormat(string filename, List<string> supportedImageFormats = null, EncodeFormat format = EncodeFormat.JPEG);
 
     /// <summary>
     /// Creates a merged image from a list of cover images and saves it to the specified destination.
@@ -147,8 +139,7 @@ public interface IImageService
     /// <param name="size">The size of the merged image.</param>
     /// <param name="dest">The destination path to save the merged image.</param>
     /// <param name="format">The encoding format to convert and save the merged image. Default is PNG.</param>
-    /// <param name="quality">The quality of the merged image. Default is 100.</param>
-    void CreateMergedImage(IList<string> coverImages, CoverImageSize size, string dest, EncodeFormat format = EncodeFormat.PNG, int quality = 100);
+    void CreateMergedImage(IList<string> coverImages, CoverImageSize size, string dest, EncodeFormat format = EncodeFormat.PNG);
 
     /// <summary>
     /// The image factory used to create and manipulate images.
@@ -311,7 +302,7 @@ private static bool IsLikelyWideImage(int width, int height)
 
 
     /// <inheritdoc/>
-    public string GetCoverImage(string path, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size, int quality = 100)
+    public string GetCoverImage(string path, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size)
     {
         if (string.IsNullOrEmpty(path)) return string.Empty;
 
@@ -320,7 +311,7 @@ public string GetCoverImage(string path, string fileName, string outputDirectory
             var (width, height) = size.GetDimensions();
             using var thumbnail = Thumbnail(_imageFactory.Create(path), width, height);
             var filename = fileName + encodeFormat.GetExtension();
-            thumbnail.Save(_directoryService.FileSystem.Path.Join(outputDirectory, filename), encodeFormat, quality);
+            thumbnail.Save(_directoryService.FileSystem.Path.Join(outputDirectory, filename), encodeFormat);
             return filename;
         }
         catch (Exception ex)
@@ -332,7 +323,7 @@ public string GetCoverImage(string path, string fileName, string outputDirectory
     }
 
     /// <inheritdoc/>
-    public string WriteCoverThumbnail(Stream stream, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size = CoverImageSize.Default, int quality = 100)
+    public string WriteCoverThumbnail(Stream stream, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size = CoverImageSize.Default)
     {
         var (targetWidth, targetHeight) = size.GetDimensions();
         if (stream.CanSeek) stream.Position = 0;
@@ -348,14 +339,14 @@ public string WriteCoverThumbnail(Stream stream, string fileName, string outputD
 
         try
         {
-            thumbnail.Save(_directoryService.FileSystem.Path.Join(outputDirectory, filename), encodeFormat, quality);
+            thumbnail.Save(_directoryService.FileSystem.Path.Join(outputDirectory, filename), encodeFormat);
         }
         catch (Exception) {/* Swallow exception */}
 
         return filename;
     }
     /// <inheritdoc/>
-    public string WriteCoverThumbnail(string sourceFile, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size = CoverImageSize.Default, int quality = 100)
+    public string WriteCoverThumbnail(string sourceFile, string fileName, string outputDirectory, EncodeFormat encodeFormat, CoverImageSize size = CoverImageSize.Default)
     {
         var (width, height) = size.GetDimensions();
         using var thumbnail = Thumbnail(_imageFactory.Create(sourceFile), width, height);
@@ -365,18 +356,18 @@ public string WriteCoverThumbnail(string sourceFile, string fileName, string out
         {
             _directoryService.FileSystem.File.Delete(_directoryService.FileSystem.Path.Join(outputDirectory, filename));
         } catch (Exception) {/* Swallow exception */}
-        thumbnail.Save(_directoryService.FileSystem.Path.Join(outputDirectory, filename), encodeFormat, quality);
+        thumbnail.Save(_directoryService.FileSystem.Path.Join(outputDirectory, filename), encodeFormat);
 
         return filename;
     }
     /// <inheritdoc/>
-    public async Task<string> ConvertToEncodingFormat(string filePath, string outputPath, EncodeFormat encodeFormat, int quality = 100)
+    public async Task<string> ConvertToEncodingFormat(string filePath, string outputPath, EncodeFormat encodeFormat)
     {
         var file = _directoryService.FileSystem.FileInfo.New(filePath);
         var fileName = file.Name.Replace(file.Extension, string.Empty);
         var outputFile = Path.Join(outputPath, fileName + encodeFormat.GetExtension());
         using var sourceImage = _imageFactory.Create(filePath);
-        await sourceImage.SaveAsync(outputFile, encodeFormat, quality).ConfigureAwait(false);
+        await sourceImage.SaveAsync(outputFile, encodeFormat).ConfigureAwait(false);
 
         return outputFile;
     }
@@ -396,7 +387,7 @@ public Task<bool> IsImage(string filePath)
         return Task.FromResult(false);
     }
     /// <inheritdoc/>
-    public async Task<string> DownloadFaviconAsync(string url, EncodeFormat encodeFormat, int quality = 100)
+    public async Task<string> DownloadFaviconAsync(string url, EncodeFormat encodeFormat)
     {
         // Parse the URL to get the domain (including subdomain)
         var uri = new Uri(url);
@@ -470,7 +461,7 @@ public async Task<string> DownloadFaviconAsync(string url, EncodeFormat encodeFo
             // Create the destination file path
             using var image = _imageFactory.Create(faviconStream);
             var filename = ImageService.GetWebLinkFormat(baseUrl, encodeFormat);
-            await image.SaveAsync(Path.Combine(_directoryService.FaviconDirectory, filename), encodeFormat, quality);
+            await image.SaveAsync(Path.Combine(_directoryService.FaviconDirectory, filename), encodeFormat);
             _logger.LogDebug("Favicon for {Domain} downloaded and saved successfully", domain);
             return filename;
         } catch (Exception ex)
@@ -480,7 +471,7 @@ public async Task<string> DownloadFaviconAsync(string url, EncodeFormat encodeFo
         }
     }
     /// <inheritdoc/>
-    public async Task<string> DownloadPublisherImageAsync(string publisherName, EncodeFormat encodeFormat, int quality = 100)
+    public async Task<string> DownloadPublisherImageAsync(string publisherName, EncodeFormat encodeFormat)
     {
         try
         {
@@ -501,7 +492,7 @@ public async Task<string> DownloadPublisherImageAsync(string publisherName, Enco
             // Create the destination file path
             using var image = _imageFactory.Create(publisherStream);
             var filename = GetPublisherFormat(publisherName, encodeFormat);
-            await image.SaveAsync(Path.Combine(_directoryService.FaviconDirectory, filename), encodeFormat, quality);
+            await image.SaveAsync(Path.Combine(_directoryService.FaviconDirectory, filename), encodeFormat);
             _logger.LogDebug("Publisher image for {PublisherName} downloaded and saved successfully", publisherName);
             return filename;
         } catch (Exception ex)
@@ -713,7 +704,7 @@ private bool CheckDirectSupport(string filename, List<string> supportedImageForm
 
 
     /// <inheritdoc/>
-    public string ReplaceImageFileFormat(string filename, List<string> supportedImageFormats = null, EncodeFormat format = EncodeFormat.JPEG, int quality = 99)
+    public string ReplaceImageFileFormat(string filename, List<string> supportedImageFormats = null, EncodeFormat format = EncodeFormat.JPEG)
     {
         if (CheckDirectSupport(filename, supportedImageFormats)) return filename;
 
@@ -733,7 +724,7 @@ public string ReplaceImageFileFormat(string filename, List<string> supportedImag
                 return destination;
             }
             using var sourceImage = _imageFactory.Create(filename);
-            sourceImage.Save(destination, format, quality);
+            sourceImage.Save(destination, format);
             try
             {
                 File.Delete(filename);
@@ -802,7 +793,7 @@ private static async Task<string> FallbackToKavitaReaderPublisher(string publish
     }
 
     /// <inheritdoc />
-    public string CreateThumbnailFromBase64(string encodedImage, string fileName, EncodeFormat encodeFormat, int thumbnailWidth = ThumbnailWidth, int quality = 100)
+    public string CreateThumbnailFromBase64(string encodedImage, string fileName, EncodeFormat encodeFormat, int thumbnailWidth = ThumbnailWidth)
     {
         try
         {
@@ -811,7 +802,7 @@ public string CreateThumbnailFromBase64(string encodedImage, string fileName, En
             int thumbnailHeight = (int)(thumbnail.Height * ((double)thumbnailWidth / thumbnail.Width));
             thumbnail.Thumbnail(thumbnailWidth, thumbnailHeight);
             fileName += encodeFormat.GetExtension();
-            thumbnail.Save(_directoryService.FileSystem.Path.Join(_directoryService.CoverImageDirectory, fileName), encodeFormat, quality);
+            thumbnail.Save(_directoryService.FileSystem.Path.Join(_directoryService.CoverImageDirectory, fileName), encodeFormat);
             return fileName;
         }
         catch (Exception e)
@@ -905,7 +896,7 @@ public static string GetPublisherFormat(string publisher, EncodeFormat encodeFor
     }
 
     /// <inheritdoc/>
-    public void CreateMergedImage(IList<string> coverImages, CoverImageSize size, string dest, EncodeFormat format = EncodeFormat.PNG, int quality = 100)
+    public void CreateMergedImage(IList<string> coverImages, CoverImageSize size, string dest, EncodeFormat format = EncodeFormat.PNG)
     {
         var (width, height) = size.GetDimensions();
         int rows, cols;
@@ -952,7 +943,7 @@ public void CreateMergedImage(IList<string> coverImages, CoverImageSize size, st
             image.Composite(tile,x,y);
         }
 
-        image.Save(dest, format, quality);
+        image.Save(dest, format);
     }
 
     /// <inheritdoc/>
diff --git a/API/Services/ImageServices/IImage.cs b/API/Services/ImageServices/IImage.cs
index 448dd2645..7fcaa4a00 100644
--- a/API/Services/ImageServices/IImage.cs
+++ b/API/Services/ImageServices/IImage.cs
@@ -64,7 +64,7 @@ public interface IImage : IDisposable
     /// <param name="filename">The name of the file to save the image to.</param>
     /// <param name="format">The format to save the image in.</param>
     /// <param name="quality">The quality of the saved image.</param>
-    void Save(string filename, EncodeFormat format, int quality);
+    void Save(string filename, EncodeFormat format);
 
     /// <summary>
     /// Saves the image to the specified stream with the specified format and quality.
@@ -72,7 +72,7 @@ public interface IImage : IDisposable
     /// <param name="stream">The stream to save the image to.</param>
     /// <param name="format">The format to save the image in.</param>
     /// <param name="quality">The quality of the saved image.</param>
-    void Save(Stream stream, EncodeFormat format, int quality);
+    void Save(Stream stream, EncodeFormat format);
 
     /// <summary>
     /// Asynchronously saves the image to the specified file with the specified format and quality.
@@ -82,7 +82,7 @@ public interface IImage : IDisposable
     /// <param name="quality">The quality of the saved image.</param>
     /// <param name="token">The cancellation token.</param>
     /// <returns>A task representing the asynchronous save operation.</returns>
-    Task SaveAsync(string filename, EncodeFormat format, int quality, CancellationToken token = default);
+    Task SaveAsync(string filename, EncodeFormat format, CancellationToken token = default);
 
     /// <summary>
     /// Asynchronously saves the image to the specified stream with the specified format and quality.
@@ -92,7 +92,7 @@ public interface IImage : IDisposable
     /// <param name="quality">The quality of the saved image.</param>
     /// <param name="token">The cancellation token.</param>
     /// <returns>A task representing the asynchronous save operation.</returns>
-    Task SaveAsync(Stream stream, EncodeFormat format, int quality, CancellationToken token = default);
+    Task SaveAsync(Stream stream, EncodeFormat format, CancellationToken token = default);
 
     /// <summary>
     /// Gets the RGBA image data as an array of floats.
diff --git a/API/Services/ImageServices/ImageMagick/ImageMagickImage.cs b/API/Services/ImageServices/ImageMagick/ImageMagickImage.cs
index 504022bbf..402762b57 100644
--- a/API/Services/ImageServices/ImageMagick/ImageMagickImage.cs
+++ b/API/Services/ImageServices/ImageMagick/ImageMagickImage.cs
@@ -3,6 +3,7 @@
 using System.Threading;
 using System.Threading.Tasks;
 using API.Entities.Enums;
+using API.Extensions;
 using ImageMagick;
 
 namespace API.Services.ImageServices.ImageMagick;
@@ -139,30 +140,30 @@ public void Composite(IImage overlay, int x, int y)
     }
 
     /// <inheritdoc/>
-    public void Save(string filename, EncodeFormat format, int quality)
+    public void Save(string filename, EncodeFormat format)
     {
-        _image.Quality = quality;
+        _image.Quality = format.DefaultQuality();
         _image.Write(filename, MagickFormatFromEncodeFormat(format));
     }
 
     /// <inheritdoc/>
-    public void Save(Stream stream, EncodeFormat format, int quality)
+    public void Save(Stream stream, EncodeFormat format)
     {
-        _image.Quality = quality;
+        _image.Quality = format.DefaultQuality();
         _image.Write(stream, MagickFormatFromEncodeFormat(format));
     }
 
     /// <inheritdoc/>
-    public Task SaveAsync(string filename, EncodeFormat format, int quality, CancellationToken token = default)
+    public Task SaveAsync(string filename, EncodeFormat format, CancellationToken token = default)
     {
-        _image.Quality = quality;
+        _image.Quality = format.DefaultQuality();
         return _image.WriteAsync(filename, MagickFormatFromEncodeFormat(format), token);
     }
 
     /// <inheritdoc/>
-    public Task SaveAsync(Stream stream, EncodeFormat format, int quality, CancellationToken token = default)
+    public Task SaveAsync(Stream stream, EncodeFormat format, CancellationToken token = default)
     {
-        _image.Quality = quality;
+        _image.Quality = format.DefaultQuality();
         return _image.WriteAsync(stream, MagickFormatFromEncodeFormat(format), token);
     }
 

From 11749bd5c48a807a99667f3bc4a40c8fa4cd1f87 Mon Sep 17 00:00:00 2001
From: Maximo Piva <mpiva@adventintermodal.com>
Date: Tue, 15 Oct 2024 11:26:27 -0300
Subject: [PATCH 30/30] Remove quality parameters after refactor.

---
 API/Extensions/EncodeFormatExtensions.cs | 2 +-
 API/Services/ImageServices/IImage.cs     | 4 ----
 2 files changed, 1 insertion(+), 5 deletions(-)

diff --git a/API/Extensions/EncodeFormatExtensions.cs b/API/Extensions/EncodeFormatExtensions.cs
index b4372d5f9..8dbf4dac5 100644
--- a/API/Extensions/EncodeFormatExtensions.cs
+++ b/API/Extensions/EncodeFormatExtensions.cs
@@ -22,7 +22,7 @@ public static int DefaultQuality(this EncodeFormat encodeFormat)
     {
         return encodeFormat switch
         {
-            EncodeFormat.PNG => 100, // (Image Magick Maximum Deflate Compression) (In case of PNG, png is always lossless, Quality indicate the compression level)
+            EncodeFormat.PNG => 100, // (Image Magick Maximum Deflate Compression) (In case of PNG, png is always lossless, Quality indicates the compression level)
             EncodeFormat.WEBP => 100,
             EncodeFormat.AVIF => 100,
             EncodeFormat.JPEG => 99, // (Best Compression speed, with almost no visual quality loss)
diff --git a/API/Services/ImageServices/IImage.cs b/API/Services/ImageServices/IImage.cs
index 7fcaa4a00..afb118af9 100644
--- a/API/Services/ImageServices/IImage.cs
+++ b/API/Services/ImageServices/IImage.cs
@@ -63,7 +63,6 @@ public interface IImage : IDisposable
     /// </summary>
     /// <param name="filename">The name of the file to save the image to.</param>
     /// <param name="format">The format to save the image in.</param>
-    /// <param name="quality">The quality of the saved image.</param>
     void Save(string filename, EncodeFormat format);
 
     /// <summary>
@@ -71,7 +70,6 @@ public interface IImage : IDisposable
     /// </summary>
     /// <param name="stream">The stream to save the image to.</param>
     /// <param name="format">The format to save the image in.</param>
-    /// <param name="quality">The quality of the saved image.</param>
     void Save(Stream stream, EncodeFormat format);
 
     /// <summary>
@@ -79,7 +77,6 @@ public interface IImage : IDisposable
     /// </summary>
     /// <param name="filename">The name of the file to save the image to.</param>
     /// <param name="format">The format to save the image in.</param>
-    /// <param name="quality">The quality of the saved image.</param>
     /// <param name="token">The cancellation token.</param>
     /// <returns>A task representing the asynchronous save operation.</returns>
     Task SaveAsync(string filename, EncodeFormat format, CancellationToken token = default);
@@ -89,7 +86,6 @@ public interface IImage : IDisposable
     /// </summary>
     /// <param name="stream">The stream to save the image to.</param>
     /// <param name="format">The format to save the image in.</param>
-    /// <param name="quality">The quality of the saved image.</param>
     /// <param name="token">The cancellation token.</param>
     /// <returns>A task representing the asynchronous save operation.</returns>
     Task SaveAsync(Stream stream, EncodeFormat format, CancellationToken token = default);