srpernax_obsidian-easyfiler.../README.md
2026-07-21 13:02:50 -04:00

3 KiB

Easy File Replace Banner

Easy File Replace

Easy File Replace is an Obsidian plugin designed to let you effortlessly replace the contents of your vault's attachments without breaking any internal links.

Normally in Obsidian, if a file needs to be updated (for example, when an artist delivers a new version of an audio file or an image), you have to delete the old file, import the new one, and manually rename it so your Markdown links ([[file.png]]) don't break. Easy File Replace solves this by letting you choose a new file from your operating system and transparently overwrite the original file's content while keeping its original name and path intact.

Installation

  1. Open Obsidian Settings.
  2. Go to Community plugins and ensure Safe Mode is Off.
  3. Click Browse and search for Easy File Replace.
  4. Click Install and then Enable.

How it works

Just right-click on the attachment you want to replace in the file explorer and click on Replace file (Easy File Replace). Alternatively, you can use the command palette while the file is open.

Easy File Replace Example

A native file picker will open. Select the updated file and the plugin will automatically update the attachment data in your vault.

Format Protection

To prevent corruption or unexpected behaviors, the plugin strictly requires the new file to have the exact same extension as the file you are replacing. If you attempt to replace a file with a different format (e.g., replacing a .png with a .jpg), the plugin will automatically block the operation.

Format Blocked Warning

Support Me

If you find this plugin useful for your projects and want to support its development, consider buying me a coffee! :]


SrPernax

Support me on Ko-fi     Follow me on GitHub

Other Projects

Check out my other plugins for Obsidian:

StoryScore
StoryScore - Organize soundtracks and leitmotifs directly in your vault.

Thanks for using Easy File Replace