diff --git a/src/components/duplicateFinder/DuplicateFinderEmptyStates.tsx b/src/components/duplicateFinder/DuplicateFinderEmptyStates.tsx
new file mode 100644
index 0000000..a3a0c9f
--- /dev/null
+++ b/src/components/duplicateFinder/DuplicateFinderEmptyStates.tsx
@@ -0,0 +1,36 @@
+export function DuplicateScanLoadingState({ progressLabel }: { progressLabel: string | null }) {
+ return (
+
+
+
{progressLabel ? `${progressLabel}…` : "Preparing scan…"}
+
+ );
+}
+
+export function DuplicateScanIntroState() {
+ return (
+
+
+
+
+
+ Finds files with identical content regardless of filename or location.
+ Click Scan for duplicates to begin.
+
+
+ Large libraries may take a minute — files are hashed from disk.
+
+
+
+ );
+}
+
+export function DuplicateScanEmptyState() {
+ return (
+
+
No duplicate files found.
+
+ );
+}
diff --git a/src/components/duplicateFinder/DuplicateFinderHeader.tsx b/src/components/duplicateFinder/DuplicateFinderHeader.tsx
new file mode 100644
index 0000000..c5797f0
--- /dev/null
+++ b/src/components/duplicateFinder/DuplicateFinderHeader.tsx
@@ -0,0 +1,173 @@
+import { DuplicateGroup, DuplicateScanProgress } from "../../store";
+import { FolderScopeDropdown } from "../FolderScopeDropdown";
+import { Tooltip } from "../Tooltip";
+import { WarningIcon } from "../icons";
+import {
+ duplicateProgressLabel,
+ duplicateProgressPercent,
+ formatBytes,
+ formatRelativeTime,
+} from "./format";
+
+export function DuplicateFinderHeader({
+ confirmingDelete,
+ deleteResult,
+ deleting,
+ duplicateGroups,
+ duplicateLastScanned,
+ duplicateScanError,
+ duplicateScanning,
+ duplicateScanProgress,
+ duplicateScanWarning,
+ hasResults,
+ hasScanned,
+ onClearSelection,
+ onConfirmDelete,
+ onDelete,
+ onScan,
+ onSelectKeepFirstAll,
+ selectedCount,
+ setConfirmingDelete,
+}: {
+ confirmingDelete: boolean;
+ deleteResult: string | null;
+ deleting: boolean;
+ duplicateGroups: DuplicateGroup[];
+ duplicateLastScanned: number | null;
+ duplicateScanError: string | null;
+ duplicateScanning: boolean;
+ duplicateScanProgress: DuplicateScanProgress | null;
+ duplicateScanWarning: string | null;
+ hasResults: boolean;
+ hasScanned: boolean;
+ onClearSelection: () => void;
+ onConfirmDelete: () => void;
+ onDelete: () => void;
+ onScan: () => void;
+ onSelectKeepFirstAll: () => void;
+ selectedCount: number;
+ setConfirmingDelete: (value: boolean | ((current: boolean) => boolean)) => void;
+}) {
+ const totalWasted = duplicateGroups.reduce(
+ (sum, group) => sum + group.file_size * (group.images.length - 1),
+ 0,
+ );
+ const totalDuplicateImages = duplicateGroups.reduce((sum, group) => sum + group.images.length - 1, 0);
+ const progressLabel = duplicateProgressLabel(duplicateScanProgress);
+ const progressPercent = duplicateProgressPercent(duplicateScanProgress);
+
+ return (
+
+
+
+
Duplicate Finder
+
+ {duplicateScanning
+ ? duplicateScanProgress
+ ? `${progressLabel}… ${duplicateScanProgress.processed.toLocaleString()} / ${duplicateScanProgress.total.toLocaleString()}${duplicateScanProgress.skipped > 0 ? ` · ${duplicateScanProgress.skipped.toLocaleString()} skipped` : ""}`
+ : "Starting scan…"
+ : hasResults
+ ? `${duplicateGroups.length} group${duplicateGroups.length === 1 ? "" : "s"} · ${formatBytes(totalWasted)} reclaimable`
+ : duplicateLastScanned !== null
+ ? "No duplicates found"
+ : "Scan your library for identical files"}
+
+ {!duplicateScanning && duplicateLastScanned !== null ? (
+
+ Last scanned {formatRelativeTime(duplicateLastScanned)}
+
+ ) : null}
+
+
+
+ {hasResults && selectedCount === 0 && !deleting ? (
+
+
+ Select all duplicates
+
+
+ ) : null}
+ {selectedCount > 0 ? (
+ <>
+
{selectedCount} marked for deletion
+
+ Deselect all
+
+
+
setConfirmingDelete((value) => !value)}
+ disabled={deleting}
+ >
+ {deleting ? "Deleting…" : `Delete ${selectedCount} file${selectedCount === 1 ? "" : "s"}`}
+
+ {confirmingDelete && !deleting ? (
+ <>
+
+
+
+
+ Permanently delete {selectedCount} file{selectedCount === 1 ? "" : "s"} from your computer.
+ This removes the actual file{selectedCount === 1 ? "" : "s"} from disk and cannot be undone.
+
+
+
+ Cancel
+
+
+ Delete {selectedCount} from disk
+
+
+
+
+ ) : null}
+
+
+ ) : null}
+
+ {duplicateScanning ? "Scanning…" : hasScanned ? "Rescan" : "Scan for duplicates"}
+
+
+
+
+ {duplicateScanning && duplicateScanProgress ? (
+
+ ) : null}
+
+ {duplicateScanError ? (
+
{duplicateScanError}
+ ) : null}
+ {duplicateScanWarning ? (
+
{duplicateScanWarning}
+ ) : null}
+ {deleteResult ? (
+
{deleteResult}
+ ) : null}
+
+ );
+}
diff --git a/src/components/duplicateFinder/DuplicateGroupCard.tsx b/src/components/duplicateFinder/DuplicateGroupCard.tsx
new file mode 100644
index 0000000..deb3195
--- /dev/null
+++ b/src/components/duplicateFinder/DuplicateGroupCard.tsx
@@ -0,0 +1,95 @@
+import { DuplicateGroup, useGalleryStore } from "../../store";
+import { mediaSrc } from "../../lib/mediaSrc";
+import { Tooltip } from "../Tooltip";
+import { formatBytes } from "./format";
+
+export function DuplicateGroupCard({ group }: { group: DuplicateGroup }) {
+ const selectedIds = useGalleryStore((state) => state.duplicateSelectedIds);
+ const toggleDuplicateSelected = useGalleryStore((state) => state.toggleDuplicateSelected);
+ const selectAllDuplicates = useGalleryStore((state) => state.selectAllDuplicates);
+ const groupSelectedCount = group.images.filter((image) => selectedIds.has(image.id)).length;
+ const noneSelected = groupSelectedCount === 0;
+
+ const handleKeepFirst = () => {
+ const toDelete = group.images.slice(1).map((image) => image.id);
+ for (const image of group.images) {
+ if (selectedIds.has(image.id)) toggleDuplicateSelected(image.id);
+ }
+ selectAllDuplicates(toDelete);
+ };
+
+ const handleDeselectGroup = () => {
+ for (const image of group.images) {
+ if (selectedIds.has(image.id)) toggleDuplicateSelected(image.id);
+ }
+ };
+
+ return (
+
+
+
+
+ {group.images.length} copies
+
+ {formatBytes(group.file_size)} each
+
+ {formatBytes(group.file_size * (group.images.length - 1))} wasted
+
+
+
+ {noneSelected ? (
+
+ Keep first
+
+ ) : (
+
+ Deselect all
+
+ )}
+
+
+
+
+ {group.images.map((image) => {
+ const isSelected = selectedIds.has(image.id);
+ const src = mediaSrc(image.thumbnail_path);
+ return (
+
+ toggleDuplicateSelected(image.id)}
+ >
+ {src ? (
+
+ )}
+ {isSelected ? (
+
+ ) : null}
+
+
{image.path.split(/[\\/]/).slice(-2).join("/")}
+
+
+ );
+ })}
+
+
+ );
+}
diff --git a/src/components/duplicateFinder/format.ts b/src/components/duplicateFinder/format.ts
new file mode 100644
index 0000000..ca176f2
--- /dev/null
+++ b/src/components/duplicateFinder/format.ts
@@ -0,0 +1,29 @@
+import { DuplicateScanProgress } from "../../store";
+
+export function formatBytes(bytes: number): string {
+ if (bytes >= 1_073_741_824) return `${(bytes / 1_073_741_824).toFixed(1)} GB`;
+ if (bytes >= 1_048_576) return `${(bytes / 1_048_576).toFixed(1)} MB`;
+ if (bytes >= 1024) return `${(bytes / 1024).toFixed(0)} KB`;
+ return `${bytes} B`;
+}
+
+export function formatRelativeTime(unixSecs: number): string {
+ const diff = Math.floor(Date.now() / 1000) - unixSecs;
+ if (diff < 60) return "just now";
+ if (diff < 3600) return `${Math.floor(diff / 60)}m ago`;
+ if (diff < 86400) return `${Math.floor(diff / 3600)}h ago`;
+ return `${Math.floor(diff / 86400)}d ago`;
+}
+
+export function duplicateProgressLabel(progress: DuplicateScanProgress | null): string | null {
+ if (!progress) return null;
+ if (progress.phase === "checking") return "Checking file sizes";
+ if (progress.phase === "hashing") return "Hashing duplicate candidates";
+ return "Confirming exact matches";
+}
+
+export function duplicateProgressPercent(progress: DuplicateScanProgress | null): number {
+ return progress && progress.total > 0
+ ? Math.round((progress.processed / progress.total) * 100)
+ : 0;
+}