Attachment Atlas

by gua
5
4
3
2
1
Score: 49/100

Description

Find duplicate images, clean up unused images, and keep your Obsidian notes linked to the right files.

Reviews

No reviews yet.

Stats

1
stars
115
downloads
0
forks
28
days
2
days
2
days
24
total PRs
1
open PRs
9
closed PRs
14
merged PRs
0
total issues
0
open issues
0
closed issues
34
commits

Latest Version

2 days ago

Changelog

Added

  • Scan a restricted, verified subset of .base files instead of blocking cleanup for any .base presence: static table views and fixed image("path") formulas in a single YAML document.
  • Protect images referenced by a fixed .base formula as read-only targets. Retain them while clearing or merging unrelated copies, without rewriting .base files.
  • Show structured reference-coverage problems with the source, reason, impact, and an actionable next step, and explain when rescanning cannot fix an unsupported format.
  • Detect executable base code blocks in Markdown and Canvas sources and keep them as unsupported execution sources.

Changed

  • Replace the flat blocking list with typed coverage issues across scanning, planning, the preview worker protocol (version 3), execution checks, and the review UI.
  • Re-read every .base source at each deletion boundary, and watch participating image changes so a changed base or image stops further actions before a host deletion.
  • Keep every reference check and image check consistent from list selection through confirmation and execution.

Fixed

  • Keep cleanup available for libraries whose .base files use only the supported static subset while unknown keys, dynamic expressions, damaged YAML, aliases, anchors, tags, merge keys, and multi-document sources still block the whole vault.
  • Require an explicit save-and-close of an open Bases view before the source is treated as verified.

README file from

Github

Attachment Atlas

Find duplicate images, clean up unused images, and keep your Obsidian notes linked to the right files.

简体中文 · Changelog

  • Merge exact duplicates in batches: choose a retained image and explicit copies in each group, then review and confirm the selected groups together.
  • Clean up unused images: review images with no detected references and choose which to recycle.
  • Inspect large images: browse by file size and check dimensions and reference locations.

Preview changes before applying them. Everything runs locally inside your vault, with no account, network requests, or telemetry.

Supported: Obsidian desktop 1.8.7+; static PNG, JPEG, and WebP images. Interface: English and Simplified Chinese. Settings search integration is available on Obsidian 1.13.0+. Bases .base files are scanned only through a restricted static subset (static table views and fixed image("path") formulas); dynamic formulas, executable base blocks, and unknown views keep merging and recycling disabled.

Installation

Open Settings → Community plugins → Browse, search for Attachment Atlas, then install and enable it. If it is not listed yet, install from GitHub Releases below.

  1. Download main.js, manifest.json, and styles.css from the same release.
  2. Place all three files in your vault's .obsidian/plugins/attachment-atlas/ folder, creating it if needed.
  3. Reload Obsidian and enable Attachment Atlas in Settings → Community plugins.

No Node.js or npm is needed. GitHub's source ZIP and tarball are not installable plugin bundles.

Quick start

  1. Click the Attachment Atlas images icon in the ribbon, or run Attachment Atlas: Open image organizer from the command palette.
  2. Select Scan vault. Scanning does not change notes or images.
  3. In Exact duplicates, choose a retained image and copies to delete in each group. Use Preview selected groups to review all selected groups together. In Unreferenced, select images, click Recycle selected images, and confirm in the dialog. Recycling reuses the scan without fingerprinting all images again.
  4. Check the file paths and reference changes, then confirm. A merge accepts up to 100 selected copies totaling 192 MiB across all groups; retained and unselected images do not count toward these limits.
  5. Review the session result for completed, partially completed, unprocessed, or unconfirmed groups. If cleanup stops, scan again and preview the remaining work; applied changes are kept.

To limit image scanning or protect folders, open Settings → Attachment Atlas.

Recycling

  • Reference coverage: supported Markdown and Canvas references can be updated during merges. Excalidraw drawings are scanned without modification, and their images are protected. Bases .base files are read through a restricted static subset: a fixed image("path") formula registers a read-only reference and its image is retained, while unrelated copies can still be merged or recycled. Frontmatter continues to act only as an existing protective hint. Dynamic formulas, executable base blocks, and unsupported views keep merging and recycling disabled; this version does not claim full Bases support, and rescanning does not make an unsupported format supported. Inspect Needs review for the source, reason, and next step.
  • Deletion and restoration: images follow Settings → Files and links → Deleted files: system trash, the vault’s .trash/ folder, or permanent deletion. Choose a trash option if you want to restore images later; permanently deleted images cannot be recovered from trash. Reference changes made during a merge are not automatically undone.

Support development

Attachment Atlas is free to use. Optional donations support development and maintenance.

Use the QR code for your payment app.

WeChat Pay · 微信支付 Alipay · 支付宝

Open WeChat Pay QR code · Open Alipay QR code

Feedback and contributing

Report a bug or request a feature with reproduction steps and a small, non-private example. For sensitive reports, follow SECURITY.md. Development instructions are in CONTRIBUTING.md.

License

MIT © 2026 gua. See third-party licenses.