Skip to content

Latest commit

 

History

History
141 lines (67 loc) · 4.54 KB

README.md

File metadata and controls

141 lines (67 loc) · 4.54 KB
Raw

Obsidian Local Images Plus

By using this software, you accept all terms and agree to the license agreement.

The author of this software is not obligated to provide any form of support and assumes no liability.

Obsidian Local Images Plus is a plugin for Obsidian

Main features of the plugin include:

  • Downloading media files from copied/pasted content of web pages
  • Localizing media files from copied/pasted content of word / Open Office documents
  • Saving attachments next to note in folder named after note
  • Downloading files embedded in markdown tags from web to vault
  • Saving base64 embedded images to vault
  • Converting PNG images to JPEG images with various quality
  • Attachments de-dulication by using MD5 hashing algorithm
  • Removing orphaned attachments from vault

Installation

  • Download the latest version from GitHub / GitHub page. Read release notes.
  • Remove obsidian-local-images plugin to avoid any conflicts.
  • Extract the archive into your Obsidian vault (e.g. Myvault/.obsidian/plugins)
  • Restart Obsidian.
  • Or install from "Obsidian Community Plugins"
  • Open "Community plugins" dialog and change plugin settings at will.
  • Enjoy

Updating

  • Update the plugin from Obsidian settings and restart Obsidian

This plugin has known compatibility issues with the following plugins:

* Paste Image Rename

* Pretty BibTex

Usage

Just copy any web content, Word/Open Office content and paste it into your regular note or a note in canvas.

Starting from version 0.15.0 the plugin also handles all attachments (screenshots/drag-and-drop for files/audio records).

img

Use it in the command/menu mode or in automatic mode (toggle "Automatic processing" option in the settings):

img

img

Localize attachments for the current note (plugin folder) - your active note will be processed and attachments will be saved in the folder preconfigured in the plugin settings.

or

Localize attachments for the current note (Obsidian folder) - your active note will be processed and attachments will be saved in the folder preconfigured in the Obsidian settings.

or

Localize attachments for all your notes (plugin folder) - will be processed all the pages in your vault, that corresponds to Include parameter in the plugin's settings and attachments will be saved in the folder(s) preconfigured in the plugin settings.

NOTE: This plugin can change all your notes at once, so you should consider doing backups of your files periodically.

You can also insert any file e.g:

![mypdf](http://mysite/mypdf.pdf)

![mylocalfile](file:///mylinuxdisk/mysong.mp3)

Files will be copied or downloaded to your attachments folder.

img

NOTE: I would not recommend to use this plugin for copying really big files, since buffered reading from disk not implemented yet.

Starting from version 0.15.6 the plugin also allows you to remove unused attachments by running commands:

Remove all orphaned attachments (Plugin folder)

and

Remove all orphaned attachments (Obsidian folder)

The first one searches orphans in the folder next to the active note, while the second one searches all unused attachments for all your notes. (this requires you to set some root subfolder in Obsidian settings)

Starting from version 0.14.5 attachment names are generated according to MD5, therefore they are pretty unique within the vault.

This means you can place an attachment file anywhere within your vault, replace the absolute path in a tag with the file name and Obsidian will still show it in your note.

Donations

Share your wishes and ideas about this software or buy me a coffee (or hot chocolate)

Credits

niekcandaele's

aleksey-rezvov

Build from source

npm run build
npm run dev