# Attachment Atlas
Find duplicate images, clean up unused images, and keep your Obsidian notes linked to the right files.
[简体中文](README.zh-CN.md) · [Changelog](CHANGELOG.md)
- **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+.
## 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.
Install from GitHub Releases
1. Download `main.js`, `manifest.json`, and `styles.css` from the same [release](https://github.com/saltcoffee/AttachmentAtlas/releases).
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. **Unreferenced** has its own selection and preview.
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. Incomplete reference checks block merging and recycling; inspect **Needs review**.
- **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](assets/donations/wechat-pay.jpg) · [Open Alipay QR code](assets/donations/alipay.jpg)
## Feedback and contributing
[Report a bug or request a feature](https://github.com/saltcoffee/AttachmentAtlas/issues) with reproduction steps and a small, non-private example. For sensitive reports, follow [SECURITY.md](SECURITY.md). Development instructions are in [CONTRIBUTING.md](CONTRIBUTING.md).
## License
[MIT](LICENSE) © 2026 gua. See [third-party licenses](THIRD_PARTY_NOTICES.md).