Add a minimum confidence level threshold to match after scan runs.

client/components/modals/libraries/EditModal.vue

@@ -126,6 +126,7 @@ export default {
           skipMatchingMediaWithIsbn: false,
           autoScanCronExpression: null,
           matchAfterScan: false,
+          matchMinConfidence: 0,
           hideSingleBookSeries: false,
           onlyShowLaterBooksInContinueSeries: false,
           metadataPrecedence: ['folderStructure', 'audioMetatags', 'nfoFile', 'txtFiles', 'opfFile', 'absMetadata'],

client/components/modals/libraries/ScheduleScan.vue

@@ -9,6 +9,10 @@
       <div class="mt-4">
         <ui-checkbox v-model="matchAfterScan" @input="updateMatchAfterScan" :label="$strings.LabelMatchAfterScan" medium checkbox-bg="bg" label-class="pl-2 text-base" />
       </div>
+      <div class="mt-4" v-if="matchAfterScan">
+        <label class="px-1 text-sm font-semibold">{{ $strings.LabelMatchMinConfidence }}</label>
+        <ui-range-input v-model.number="matchMinConfidencePercentage" :min="0" :max="100" :step="1" />
+      </div>
     </div>
     <div v-else>
       <p class="text-yellow-400 text-base">{{ $strings.MessageScheduleLibraryScanNote }}</p>
@@ -29,10 +33,21 @@ export default {
     return {
       cronExpression: null,
       enableAutoScan: false,
-      matchAfterScan: false
+      matchAfterScan: false,
+      matchMinConfidence: 0
+    }
+  },
+  computed: {
+    matchMinConfidencePercentage: {
+      get() {
+        return this.matchMinConfidence * 100
+      },
+      set(val) {
+        this.matchMinConfidence = val / 100
+        this.updateMatchMinConfidence()
+      }
     }
   },
-  computed: {},
   methods: {
     checkBlurExpressionInput() {
       // returns true if advanced cron input is focused
@@ -60,10 +75,18 @@ export default {
         }
       })
     },
+    updateMatchMinConfidence() {
+      this.$emit('update', {
+        settings: {
+          matchMinConfidence: this.matchMinConfidence
+        }
+      })
+    },
     init() {
       this.cronExpression = this.library.settings.autoScanCronExpression
       this.enableAutoScan = !!this.cronExpression
       this.matchAfterScan = this.library.settings.matchAfterScan
+      this.matchMinConfidence = this.library.settings.matchMinConfidence || 0
     }
   },
   mounted() {

client/strings/en-us.json

@@ -449,6 +449,7 @@
   "LabelLowestPriority": "Lowest Priority",
   "LabelMatchConfidence": "Confidence",
   "LabelMatchAfterScan": "Run 'Match Books' after scan",
+  "LabelMatchMinConfidence": "Minimum match confidence (0-100)",
   "LabelMatchExistingUsersBy": "Match existing users by",
   "LabelMatchExistingUsersByDescription": "Used for connecting existing users. Once connected, users will be matched by a unique id from your SSO provider",
   "LabelMaxEpisodesToDownload": "Max # of episodes to download. Use 0 for unlimited.",

server/controllers/LibraryController.js

@@ -354,6 +354,19 @@ class LibraryController {
             updatedSettings[key] = req.body.settings[key] === null ? null : Number(req.body.settings[key])
             Logger.debug(`[LibraryController] Library "${req.library.name}" updating setting "${key}" to "${updatedSettings[key]}"`)
           }
+        } else if (key === 'matchMinConfidence') {
+          if (req.body.settings[key] !== null && isNaN(req.body.settings[key])) {
+            Logger.error(`[LibraryController] Invalid request. Setting "${key}" must be a number`)
+            return res.status(400).send(`Invalid request. Setting "${key}" must be a number`)
+          } else if (req.body.settings[key] !== null && (Number(req.body.settings[key]) < 0 || Number(req.body.settings[key]) > 1)) {
+            Logger.error(`[LibraryController] Invalid request. Setting "${key}" must be between 0 and 1`)
+            return res.status(400).send(`Invalid request. Setting "${key}" must be between 0 and 1`)
+          }
+          if (req.body.settings[key] !== updatedSettings[key]) {
+            hasUpdates = true
+            updatedSettings[key] = req.body.settings[key] === null ? null : Number(req.body.settings[key])
+            Logger.debug(`[LibraryController] Library "${req.library.name}" updating setting "${key}" to "${updatedSettings[key]}"`)
+          }
         } else if (key === 'matchAfterScan') {
           if (typeof req.body.settings[key] !== 'boolean') {
             return res.status(400).send('Invalid request. Setting "matchAfterScan" must be a boolean')

server/managers/CronManager.js

@@ -84,7 +84,9 @@ class CronManager {
             checkRemoveEmptySeries,
             checkRemoveAuthorsWithNoBooks
           }
-          Scanner.matchLibraryItems(apiRouterCtx, library)
+          Scanner.matchLibraryItems(apiRouterCtx, library, {
+            minConfidence: library.settings.matchMinConfidence
+          })
         }
       }
     })

server/models/Library.js

@@ -69,6 +69,7 @@ class Library extends Model {
         disableWatcher: false,
         autoScanCronExpression: null,
         matchAfterScan: false,
+        matchMinConfidence: 0,
         skipMatchingMediaWithAsin: false,
         skipMatchingMediaWithIsbn: false,
         audiobooksOnly: false,

server/scanner/Scanner.js

@@ -60,6 +60,12 @@ class Scanner {
       }
       const matchData = results[0]
 
+      if (options.minConfidence && matchData.matchConfidence < options.minConfidence) {
+        return {
+          warning: `Match confidence ${matchData.matchConfidence} is below the minimum of ${options.minConfidence}`
+        }
+      }
+
       // Update cover if not set OR overrideCover flag
       if (matchData.cover && (!libraryItem.media.coverPath || options.overrideCover)) {
         Logger.debug(`[Scanner] Updating cover "${matchData.cover}"`)
@@ -433,7 +439,7 @@ class Scanner {
    * @param {LibraryScan} libraryScan
    * @returns {Promise<boolean>} false if scan canceled
    */
-  async matchLibraryItemsChunk(apiRouterCtx, library, libraryItems, libraryScan) {
+  async matchLibraryItemsChunk(apiRouterCtx, library, libraryItems, libraryScan, options = {}) {
     for (let i = 0; i < libraryItems.length; i++) {
       const libraryItem = libraryItems[i]
 
@@ -448,7 +454,7 @@ class Scanner {
       }
 
       Logger.debug(`[Scanner] matchLibraryItems: Quick matching "${libraryItem.media.title}" (${i + 1} of ${libraryItems.length})`)
-      const result = await this.quickMatchLibraryItem(apiRouterCtx, libraryItem, { provider: library.provider })
+      const result = await this.quickMatchLibraryItem(apiRouterCtx, libraryItem, { provider: library.provider, minConfidence: options.minConfidence })
       if (result.warning) {
         Logger.warn(`[Scanner] matchLibraryItems: Match warning ${result.warning} for library item "${libraryItem.media.title}"`)
       } else if (result.updated) {
@@ -470,7 +476,7 @@ class Scanner {
    * @param {import('../routers/ApiRouter')} apiRouterCtx
    * @param {import('../models/Library')} library
    */
-  async matchLibraryItems(apiRouterCtx, library) {
+  async matchLibraryItems(apiRouterCtx, library, options = {}) {
     if (library.mediaType === 'podcast') {
       Logger.error(`[Scanner] matchLibraryItems: Match all not supported for podcasts yet`)
       return
@@ -509,7 +515,7 @@ class Scanner {
       offset += limit
       hasMoreChunks = libraryItems.length === limit
 
-      const shouldContinue = await this.matchLibraryItemsChunk(apiRouterCtx, library, libraryItems, libraryScan)
+      const shouldContinue = await this.matchLibraryItemsChunk(apiRouterCtx, library, libraryItems, libraryScan, options)
       if (!shouldContinue) {
         isCanceled = true
         break