Images - ElsaTam/obsidian-extended-graph GitHub Wiki

The image feature allows you to show images directly on graph nodes, enhancing visual recognition of your notes. Images can be sourced in multiple ways and support various formats.

images in graph

Settings

From Properties

images from properties

  • Display images specified in the frontmatter properties of notes
  • Configure the property name used to find the image (default: image)

From Embeds

images from embeds

  • Automatically displays the first image found in the note's embeds
  • Falls back to property-specified image if available
  • Property-specified images take precedence if the "From properties" setting is enabled

For Attachments

images for attachments

  • Displays images for attachment nodes
  • Useful for nodes that represent media files in your vault

Border Width

image border width

  • Adjust the visible border around images using the percentage slider
  • Border helps maintain node visibility and see the color of the underlying node

External Images

external images

  • Toggle support for external images via HTTP/HTTPS URLs
  • Warning: Invalid URLs will produce console errors but won't affect functionality

Supported Formats

  • Images: PNG, JPEG, WebP, SVG, AVIF
  • Videos (a static frame from the middle of the video is automatically extracted and displayed): MP4, WebM, OGG, MOV, MKV
  • Animated GIFs (displays the first frame only)

Performance Warning

The display of images on nodes can significantly impact graph performance, especially in large graphs. Each image requires additional processing and memory, which can lead to:

  • Slower graph loading times
  • Reduced fluidity when moving the graph
  • Potential crash
  • Memory usage increases

It is recommended to primarily use image display in local graphs only, which typically contain fewer nodes. For global graphs or graphs with many nodes, consider disabling image display to maintain optimal performance. See the Performance section for more detailed guidance on graph performance.