Add remote path mapping for qBittorrent integration

Implements remote-to-local path mapping for qBittorrent downloads, allowing the app to handle differing filesystem paths between qBittorrent and the local environment (e.g., remote seedboxes, Docker). Adds UI controls in admin settings and setup wizard, validates mapping configuration, and applies path transformation in download and import processors. Updates documentation, API routes, and data models to support the new feature. Also improves library scan logic to remove stale records and reset orphaned audiobooks and requests. Increases minimum torrent score threshold from 30 to 50 in search and ranking logic, and exposes torrent source URLs in the admin UI.

src/app/setup/page.tsx

@@ -77,6 +77,9 @@ interface SetupState {
   downloadClientUrl: string;
   downloadClientUsername: string;
   downloadClientPassword: string;
+  remotePathMappingEnabled: boolean;
+  remotePath: string;
+  localPath: string;
   downloadDir: string;
   mediaDir: string;
   metadataTaggingEnabled: boolean;
@@ -142,6 +145,9 @@ export default function SetupWizard() {
     downloadClientUrl: '',
     downloadClientUsername: 'admin',
     downloadClientPassword: '',
+    remotePathMappingEnabled: false,
+    remotePath: '',
+    localPath: '',
     downloadDir: '/downloads',
     mediaDir: '/media/audiobooks',
     metadataTaggingEnabled: true,
@@ -211,6 +217,9 @@ export default function SetupWizard() {
           url: state.downloadClientUrl,
           username: state.downloadClientUsername,
           password: state.downloadClientPassword,
+          remotePathMappingEnabled: state.remotePathMappingEnabled,
+          remotePath: state.remotePath,
+          localPath: state.localPath,
         },
         paths: {
           download_dir: state.downloadDir,
@@ -494,6 +503,9 @@ export default function SetupWizard() {
           downloadClientUrl={state.downloadClientUrl}
           downloadClientUsername={state.downloadClientUsername}
           downloadClientPassword={state.downloadClientPassword}
+          remotePathMappingEnabled={state.remotePathMappingEnabled}
+          remotePath={state.remotePath}
+          localPath={state.localPath}
           onUpdate={updateField}
           onNext={() => goToStep(currentStepNumber + 1)}
           onBack={() => goToStep(currentStepNumber - 1)}

src/app/setup/steps/AudiobookshelfStep.tsx

@@ -217,7 +217,7 @@ export function AudiobookshelfStep({
               <option value="">Select a library...</option>
               {libraries.map((lib) => (
                 <option key={lib.id} value={lib.id}>
-                  {lib.name} ({lib.itemCount} items)
+                  {lib.name}
                 </option>
               ))}
             </select>

src/app/setup/steps/DownloadClientStep.tsx

@@ -14,7 +14,10 @@ interface DownloadClientStepProps {
   downloadClientUrl: string;
   downloadClientUsername: string;
   downloadClientPassword: string;
-  onUpdate: (field: string, value: string) => void;
+  remotePathMappingEnabled: boolean;
+  remotePath: string;
+  localPath: string;
+  onUpdate: (field: string, value: any) => void;
   onNext: () => void;
   onBack: () => void;
 }
@@ -24,6 +27,9 @@ export function DownloadClientStep({
   downloadClientUrl,
   downloadClientUsername,
   downloadClientPassword,
+  remotePathMappingEnabled,
+  remotePath,
+  localPath,
   onUpdate,
   onNext,
   onBack,
@@ -48,6 +54,9 @@ export function DownloadClientStep({
           url: downloadClientUrl,
           username: downloadClientUsername,
           password: downloadClientPassword,
+          remotePathMappingEnabled,
+          remotePath,
+          localPath,
         }),
       });
 
@@ -176,6 +185,68 @@ export function DownloadClientStep({
           />
         </div>
 
+        {/* Remote Path Mapping */}
+        <div className="mt-4 bg-gray-50 dark:bg-gray-800 rounded-lg p-4 border border-gray-200 dark:border-gray-700">
+          <div className="flex items-start gap-4">
+            <input
+              type="checkbox"
+              id="remote-path-mapping-setup"
+              checked={remotePathMappingEnabled}
+              onChange={(e) => onUpdate('remotePathMappingEnabled', e.target.checked)}
+              className="mt-1 h-5 w-5 rounded border-gray-300 text-blue-600 focus:ring-blue-500 dark:border-gray-600 dark:bg-gray-700"
+            />
+            <div className="flex-1">
+              <label
+                htmlFor="remote-path-mapping-setup"
+                className="block text-sm font-medium text-gray-900 dark:text-gray-100 cursor-pointer"
+              >
+                Enable Remote Path Mapping
+              </label>
+              <p className="text-sm text-gray-600 dark:text-gray-400 mt-1">
+                Use this when qBittorrent runs on a different machine or uses different mount points (e.g., remote seedbox, Docker containers)
+              </p>
+              <p className="text-xs text-gray-500 dark:text-gray-400 mt-2 font-mono">
+                Example: Remote <span className="text-blue-600 dark:text-blue-400">/remote/mnt/d/done</span> → Local <span className="text-green-600 dark:text-green-400">/downloads</span>
+              </p>
+
+              {/* Conditional Fields */}
+              {remotePathMappingEnabled && (
+                <div className="mt-4 space-y-4">
+                  <div>
+                    <label className="block text-sm font-medium text-gray-700 dark:text-gray-300 mb-2">
+                      Remote Path (from qBittorrent)
+                    </label>
+                    <Input
+                      type="text"
+                      placeholder="/remote/mnt/d/done"
+                      value={remotePath}
+                      onChange={(e) => onUpdate('remotePath', e.target.value)}
+                    />
+                    <p className="text-xs text-gray-500 dark:text-gray-400 mt-1">
+                      The path prefix as reported by qBittorrent
+                    </p>
+                  </div>
+
+                  <div>
+                    <label className="block text-sm font-medium text-gray-700 dark:text-gray-300 mb-2">
+                      Local Path (for ReadMeABook)
+                    </label>
+                    <Input
+                      type="text"
+                      placeholder="/downloads"
+                      value={localPath}
+                      onChange={(e) => onUpdate('localPath', e.target.value)}
+                    />
+                    <p className="text-xs text-gray-500 dark:text-gray-400 mt-1">
+                      The actual path where files are accessible
+                    </p>
+                  </div>
+                </div>
+              )}
+            </div>
+          </div>
+        </div>
+
         <Button
           onClick={testConnection}
           loading={testing}

src/app/setup/steps/ReviewStep.tsx

@@ -9,13 +9,32 @@ import { Button } from '@/components/ui/Button';
 
 interface ReviewStepProps {
   config: {
+    backendMode: 'plex' | 'audiobookshelf';
+
+    // Plex config
     plexUrl: string;
     plexLibraryId: string;
+
+    // Audiobookshelf config
+    absUrl: string;
+    absLibraryId: string;
+
+    // Auth config (ABS mode)
+    authMethod: 'oidc' | 'manual' | 'both';
+    oidcProviderName: string;
+    adminUsername: string;
+
+    // Common config
     prowlarrUrl: string;
     downloadClient: 'qbittorrent' | 'transmission';
     downloadClientUrl: string;
     downloadDir: string;
     mediaDir: string;
+
+    // BookDate
+    bookdateConfigured: boolean;
+    bookdateProvider: string;
+    bookdateModel: string;
   };
   loading: boolean;
   error: string | null;
@@ -58,26 +77,82 @@ export function ReviewStep({ config, loading, error, onComplete, onBack }: Revie
       )}
 
       <div className="space-y-4">
-        {/* Plex Configuration */}
-        <div className="bg-gray-50 dark:bg-gray-900 rounded-lg p-4">
-          <h3 className="text-lg font-semibold text-gray-900 dark:text-gray-100 mb-3">
-            Plex Media Server
-          </h3>
-          <dl className="space-y-2">
-            <div className="flex justify-between">
-              <dt className="text-sm text-gray-600 dark:text-gray-400">Server URL:</dt>
-              <dd className="text-sm font-medium text-gray-900 dark:text-gray-100">
-                {config.plexUrl}
-              </dd>
+        {/* Backend Configuration - Conditional based on mode */}
+        {config.backendMode === 'plex' ? (
+          <div className="bg-gray-50 dark:bg-gray-900 rounded-lg p-4">
+            <h3 className="text-lg font-semibold text-gray-900 dark:text-gray-100 mb-3">
+              Plex Media Server
+            </h3>
+            <dl className="space-y-2">
+              <div className="flex justify-between">
+                <dt className="text-sm text-gray-600 dark:text-gray-400">Server URL:</dt>
+                <dd className="text-sm font-medium text-gray-900 dark:text-gray-100">
+                  {config.plexUrl}
+                </dd>
+              </div>
+              <div className="flex justify-between">
+                <dt className="text-sm text-gray-600 dark:text-gray-400">Library ID:</dt>
+                <dd className="text-sm font-medium text-gray-900 dark:text-gray-100">
+                  {config.plexLibraryId}
+                </dd>
+              </div>
+            </dl>
+          </div>
+        ) : (
+          <>
+            {/* Audiobookshelf Configuration */}
+            <div className="bg-gray-50 dark:bg-gray-900 rounded-lg p-4">
+              <h3 className="text-lg font-semibold text-gray-900 dark:text-gray-100 mb-3">
+                Audiobookshelf
+              </h3>
+              <dl className="space-y-2">
+                <div className="flex justify-between">
+                  <dt className="text-sm text-gray-600 dark:text-gray-400">Server URL:</dt>
+                  <dd className="text-sm font-medium text-gray-900 dark:text-gray-100">
+                    {config.absUrl}
+                  </dd>
+                </div>
+                <div className="flex justify-between">
+                  <dt className="text-sm text-gray-600 dark:text-gray-400">Library ID:</dt>
+                  <dd className="text-sm font-medium text-gray-900 dark:text-gray-100">
+                    {config.absLibraryId}
+                  </dd>
+                </div>
+              </dl>
             </div>
-            <div className="flex justify-between">
-              <dt className="text-sm text-gray-600 dark:text-gray-400">Library ID:</dt>
-              <dd className="text-sm font-medium text-gray-900 dark:text-gray-100">
-                {config.plexLibraryId}
-              </dd>
+
+            {/* Authentication Configuration */}
+            <div className="bg-gray-50 dark:bg-gray-900 rounded-lg p-4">
+              <h3 className="text-lg font-semibold text-gray-900 dark:text-gray-100 mb-3">
+                Authentication
+              </h3>
+              <dl className="space-y-2">
+                <div className="flex justify-between">
+                  <dt className="text-sm text-gray-600 dark:text-gray-400">Auth Method:</dt>
+                  <dd className="text-sm font-medium text-gray-900 dark:text-gray-100 capitalize">
+                    {config.authMethod === 'both' ? 'OIDC + Manual Registration' : config.authMethod === 'oidc' ? 'OIDC' : 'Manual Registration'}
+                  </dd>
+                </div>
+                {(config.authMethod === 'oidc' || config.authMethod === 'both') && (
+                  <div className="flex justify-between">
+                    <dt className="text-sm text-gray-600 dark:text-gray-400">OIDC Provider:</dt>
+                    <dd className="text-sm font-medium text-gray-900 dark:text-gray-100">
+                      {config.oidcProviderName}
+                    </dd>
+                  </div>
+                )}
+                {(config.authMethod === 'manual' || config.authMethod === 'both') && (
+                  <div className="flex justify-between">
+                    <dt className="text-sm text-gray-600 dark:text-gray-400">Admin Username:</dt>
+                    <dd className="text-sm font-medium text-gray-900 dark:text-gray-100">
+                      {config.adminUsername}
+                    </dd>
+                  </div>
+                )}
+              </dl>
             </div>
-          </dl>
-        </div>
+          </>
+        )}
 
         {/* Prowlarr Configuration */}
         <div className="bg-gray-50 dark:bg-gray-900 rounded-lg p-4">
@@ -135,6 +210,29 @@ export function ReviewStep({ config, loading, error, onComplete, onBack }: Revie
             </div>
           </dl>
         </div>
+
+        {/* BookDate Configuration (Optional) */}
+        {config.bookdateConfigured && (
+          <div className="bg-gray-50 dark:bg-gray-900 rounded-lg p-4">
+            <h3 className="text-lg font-semibold text-gray-900 dark:text-gray-100 mb-3">
+              BookDate AI Recommendations
+            </h3>
+            <dl className="space-y-2">
+              <div className="flex justify-between">
+                <dt className="text-sm text-gray-600 dark:text-gray-400">Provider:</dt>
+                <dd className="text-sm font-medium text-gray-900 dark:text-gray-100 capitalize">
+                  {config.bookdateProvider}
+                </dd>
+              </div>
+              <div className="flex justify-between">
+                <dt className="text-sm text-gray-600 dark:text-gray-400">Model:</dt>
+                <dd className="text-sm font-medium text-gray-900 dark:text-gray-100">
+                  {config.bookdateModel}
+                </dd>
+              </div>
+            </dl>
+          </div>
+        )}
       </div>
 
       <div className="bg-blue-50 dark:bg-blue-900/20 rounded-lg p-4">