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
  • Themes
  • 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.

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
2 months ago
Created
5 years ago
Updates
4 releases
Downloads
13k
Compatible with
Obsidian 0.9.12+
Platforms
Desktop, Mobile
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.

Consistent Attachments and Links

Move note attachments and update links automatically.

Advanced URI

Control everything with URI.

Note Refactor

Extract note content into new notes and split notes.

Advanced Exclude

Enhances the Excluded files setting bringing gitignore syntax.

Notebook Navigator

A better file browser and calendar inspired by Apple Notes, Bear, Evernote and Day One.

Recent Files

Display a list of recently opened files.

Smart Connections

Find related notes and excerpts while writing. Your AI link building copilot displays relevant content in graph + list view. A local embedding model powers semantic search. Zero setup. No API key.

Excalidraw

Visual PKM powerhouse. Create and edit Excalidraw drawings.

Omnisearch

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