Search...Search plugins and themes...
⌘K
Sign in
  • Get started
  • Download
  • Pricing
  • Enterprise
  • Account
  • Obsidian
  • Overview
  • Sync
  • Publish
  • Canvas
  • Mobile
  • Web Clipper
  • CLI
  • Learn
  • Help
  • Developers
  • Changelog
  • About
  • Roadmap
  • Blog
  • Resources
  • System status
  • License overview
  • Terms of service
  • Privacy policy
  • Security
  • Community
  • Plugins
  • Join the community
  • Discord
  • Forum / 中文论坛
  • Merch store
  • Brand guidelines
Follow us
DiscordTwitterBlueskyThreadsMastodonYouTubeGitHub
© 2026 Obsidian

Unique attachments

dy-shdy-sh13k downloads

Rename attachments, making their names unique (based on hashing of file content).

Add to Obsidian
  • Overview
  • Scorecard
  • Updates4

This plugin for Obsidian renames attachments, making their names unique. A hash function (MD5) is used to generate the filename, so the filename is indeed unique.

If two files have exactly the same content (up to each byte), then their names will also be the same. This way, if you find two files with the same name, you can be sure that they are copies of the same file.

After processing, the filenames look something like this: 5be2a494d8c98092d803718d29fe14c0.png

This approach to naming attachments will add a bit of consistency to your notes. You might want to use this plugin in conjunction with Consistent attachments and links plugin.

After using "Rename all attachments" the plugin updates the links in all notes that used these files. Alternatively you can use ''Rename only active attachments'' to rename attachments linked only to the current active MD file.

This plugin can also delete duplicates (files that have the same content) if they are in the same folder. This will make your vault a little cleaner.

In the settings there is also an option "Rename only linked attachments". If it is enabled, you can be sure that the plugin renames only those files that are referenced in the notes in the standard markdown format. So, if no note is referenced to the file, or refers to it in wikilink format, then this file will be ignored.

The "Rename all attachments" command is only compatible with standard markdown links (![](https://raw.githubusercontent.com/dy-sh/obsidian-unique-attachments/HEAD/../attachments/title.png)). Wikilinks are not supported. You can convert all wikilinks to markdown links with Consistent attachments and links plugin. ''Rename only active attachments'' command works with all kind of links and generate links based on your preferences.

How to configure

Assign a hotkey to "Unique attachments: Rename all attachments" and/or **"Unique attachments: Rename only active attachments" commands in the Obsidian Hotkeys settings.

In the plugin settings, you can set the type of attachments that will be processed. Or you can ignore some folders that you don't want to process.

How to use

Call the hotkey when you want to search and rename attachments. You will see a notification about how many files have been renamed. In the console, you can see more detailed information about what happened.

It is recommended to make a backup of your files before using this plugin.

78%
HealthExcellent
ReviewCaution
About
Rename attachments to content-based MD5 filenames so identical files get the same name and different content gets unique names. Update links across notes, optionally delete duplicate files in the same folder, and restrict renaming to linked or active attachments.
AttachmentsFilesLinks
Details
Current version
1.0.4
Last updated
3 weeks ago
Created
5 years ago
Updates
4 releases
Downloads
13k
Compatible with
Obsidian 0.9.12+
License
MIT
Report bugRequest featureReport plugin
Sponsor
Buy Me a Coffee
Author
dy-shdy-sh
github.com/dy-sh/
GitHubdy-sh
  1. Community
  2. Plugins
  3. Attachments
  4. Unique attachments

Related plugins

Custom Attachment Location

Customize attachment location with variables($filename, $data, etc) like Typora.

Advanced URI

Control everything with URI.

Consistent attachments and links

Move note attachments and update links automatically.

Note Refactor

Extract note content into new notes and split notes.

Find orphaned files and broken links

Find files that are not linked anywhere and would otherwise be lost in your vault. In other words: files with no backlinks.

Janitor

Perform cleanup tasks on your vault.

Notebook Navigator

Alternative file browser with folders, tags, properties, shortcuts, previews, keyboard navigation, drag and drop, and pinned notes.

Smart Connections

AI link discovery copilot. See related notes as you write. Lookup using semantic (vector) search across your vault. Zero-setup local model for embeddings, no API keys, private.

Recent Files

Display a list of recently opened files.

Omnisearch

Intelligent search for your notes, PDFs, and OCR for images.