find feature

Author: jeffcrouse

backend/app/api/routes/library.py

@@ -37,6 +37,7 @@ class ScanProgress(BaseModel):
     files_total: int = 0
     new_tracks: int = 0
     updated_tracks: int = 0
+    relocated_tracks: int = 0
     deleted_tracks: int = 0
     unchanged_tracks: int = 0
     current_file: str | None = None

backend/app/services/scanner.py

@@ -180,20 +180,42 @@ async def scan(self, library_path: Path, full_scan: bool = False) -> dict:
             if processed % 50 == 0:
                 await asyncio.sleep(0)
 
-        # Handle deleted files - only delete files that were under this library_path
+        # Handle missing files - only check files that were under this library_path
         library_prefix = str(library_path)
-        deleted_paths = set(
+        missing_paths = set(
             p for p in existing_paths.keys()
             if p.startswith(library_prefix)
         ) - found_paths
 
-        if deleted_paths:
-            logger.info(f"Removing {len(deleted_paths)} deleted files from database...")
+        if missing_paths:
+            logger.info(f"Found {len(missing_paths)} missing files, searching for relocated files...")
             if self.scan_state:
-                self.scan_state.set_cleanup(len(deleted_paths))
-
-        for path_str in deleted_paths:
+                self.scan_state.set_cleanup(len(missing_paths))
+
+        # Build filename -> path map for relocated file search
+        filename_to_path: dict[str, str] = {}
+        for path_str in found_paths:
+            filename = Path(path_str).name.lower()
+            # Only use first occurrence to avoid ambiguity
+            if filename not in filename_to_path:
+                filename_to_path[filename] = path_str
+
+        results["relocated"] = 0
+        for path_str in missing_paths:
             track = existing_paths[path_str]
+            filename = Path(path_str).name.lower()
+
+            # Check if file exists at a new location
+            if filename in filename_to_path:
+                new_path = filename_to_path[filename]
+                # Verify it's not already tracked by another record
+                if new_path not in existing_paths:
+                    logger.info(f"RELOCATED: {Path(path_str).name} -> {new_path}")
+                    track.file_path = new_path
+                    results["relocated"] += 1
+                    continue
+
+            # File truly deleted
             logger.info(f"DELETED: {Path(path_str).name}")
             await self.db.delete(track)
             results["deleted"] += 1
@@ -204,7 +226,7 @@ async def scan(self, library_path: Path, full_scan: bool = False) -> dict:
 
         await self.db.commit()
 
-        logger.info(f"Scan complete: {results['new']} new, {results['updated']} updated, {results['deleted']} deleted, {results['unchanged']} unchanged")
+        logger.info(f"Scan complete: {results['new']} new, {results['updated']} updated, {results['relocated']} relocated, {results['deleted']} deleted, {results['unchanged']} unchanged")
 
         return results
 

frontend/src/components/Settings/LibraryOrganizer.tsx

@@ -137,6 +137,11 @@ export function LibraryOrganizer() {
               Only tracks with complete metadata (title, artist, album) will be moved.
               Always preview changes first.
             </p>
+            <p className="text-amber-300/80 mt-2">
+              <strong>Note:</strong> If you use other music applications (iTunes, Plex, Roon, etc.),
+              reorganizing files may break their stored paths. Consider whether those apps can
+              handle file location changes before proceeding.
+            </p>
           </div>
         </div>
       </div>

frontend/src/components/Settings/LibraryScan.tsx

@@ -8,6 +8,7 @@ interface ScanProgress {
   files_total: number;
   new_tracks: number;
   updated_tracks: number;
+  relocated_tracks: number;
   deleted_tracks: number;
   unchanged_tracks: number;
   current_file: string | null;
@@ -159,7 +160,7 @@ export function LibraryScan() {
             </p>
           )}
 
-          <div className="grid grid-cols-4 gap-2 text-center text-xs">
+          <div className="grid grid-cols-5 gap-2 text-center text-xs">
             <div className="bg-zinc-700/50 rounded p-2">
               <div className="text-green-400 font-medium">{progress.new_tracks}</div>
               <div className="text-zinc-500">New</div>
@@ -168,6 +169,10 @@ export function LibraryScan() {
               <div className="text-blue-400 font-medium">{progress.updated_tracks}</div>
               <div className="text-zinc-500">Updated</div>
             </div>
+            <div className="bg-zinc-700/50 rounded p-2">
+              <div className="text-purple-400 font-medium">{progress.relocated_tracks}</div>
+              <div className="text-zinc-500">Relocated</div>
+            </div>
             <div className="bg-zinc-700/50 rounded p-2">
               <div className="text-zinc-400 font-medium">{progress.unchanged_tracks}</div>
               <div className="text-zinc-500">Unchanged</div>
@@ -196,7 +201,7 @@ export function LibraryScan() {
 
       {/* Summary when completed */}
       {scanStatus?.status === 'completed' && progress && (
-        <div className="mt-3 grid grid-cols-4 gap-2 text-center text-xs">
+        <div className="mt-3 grid grid-cols-5 gap-2 text-center text-xs">
           <div className="bg-zinc-700/50 rounded p-2">
             <div className="text-green-400 font-medium">{progress.new_tracks}</div>
             <div className="text-zinc-500">New</div>
@@ -205,6 +210,10 @@ export function LibraryScan() {
             <div className="text-blue-400 font-medium">{progress.updated_tracks}</div>
             <div className="text-zinc-500">Updated</div>
           </div>
+          <div className="bg-zinc-700/50 rounded p-2">
+            <div className="text-purple-400 font-medium">{progress.relocated_tracks}</div>
+            <div className="text-zinc-500">Relocated</div>
+          </div>
           <div className="bg-zinc-700/50 rounded p-2">
             <div className="text-zinc-400 font-medium">{progress.unchanged_tracks}</div>
             <div className="text-zinc-500">Unchanged</div>