Image Picker

approved

by ari.the.elk

A blazingly fast way to browse, search, and embed pictures across your vault

★ 32 stars↓ 2,569 downloadsUpdated 1y agoMIT
View on GitHub

📷 Image Picker

Image Picker is a blazingly fast way to browse and find media in your Obsidian vault. It's extremely performant, automatically generating thumbnails and background indexing your vault for instant search results.

Image Picker Preview

🐙 GitHub | 📖 Docs | 💝 Donate

⚙️ Settings

  • Image Folder: The highest root folder that you want Image Picker to search for images in. If you store your attachments in a specific folder, please select it for better performance.
  • Animate Gifs: Whether or not to animate gifs in the preview. Disabling this will improve performance if you have a lot of gifs in your vault.
  • Debug Mode: Enable this to see helpful debug logs in the console. Please use this if you're experiencing issues and want to report them.
  • Reset Image Index: Click this button to reset the image index and reload Obsidian. This will force Image Picker to re-index your vault, which is useful if you've changed your Image Folder.

🗺️ Roadmap

  • Performantly browse photos across your vault
  • Search for photos by name and extension
  • Background image indexing for instant search results
  • Automatically generate thumbnails for images
  • Support for renaming images
  • Support local LLMs for generating searchable descriptions
  • Index and search for images by metadata, such as location, date, and more
  • Support for video and audio files

🛠️ Contributing

Quick start:

# Clone the repository
git clone https://github.com/AriTheElk/obsidian-image-picker
cd obsidian-image-picker

# Install the dependencies
npm install

# To build the plugin
npm run build

# If you want to build the plugin directly into your vault
echo "/ABSOLUTE/PATH/TO/YOUR/VAULT" > .env
npm run build:vault

This will clone the repository, install the dependencies, and build the plugin. If you've set the path correctly, the plugin should be available in your Obsidian vault. It copies to {vault}/.obsidian/plugins/obsidian-image-picker-dev immediately after building.

If you'd like to help out, I'd recommend checking out the help wanted tag 🫶🏻

I'm eternally grateful for any help I get :)

👩‍⚖️ License

Obsidian Image Picker is licensed under the MIT License. See LICENSE for more information.

For plugin developers

Search results and similarity scores are powered by semantic analysis of your plugin's README. If your plugin isn't appearing for searches you'd expect, try updating your README to clearly describe your plugin's purpose, features, and use cases.