README file from
GithubImageFull
Minimal Obsidian plugin that opens embedded images in a clean fullscreen viewer with gesture-based zoom and pan. No settings, no toolbar — just the image.
Features
- Double-click (or double-tap on touch) an embedded image → fullscreen overlay
- Pinch (touch or trackpad) → zoom up to 10×
- Two-finger swipe / trackpad swipe → shift the visible image section
- Mouse drag when zoomed → pan
- Double-click overlay → close
- Keyboard:
Esccloses ·0resets the zoom - Works in reading view and live preview, desktop and mobile
Installation
From the community directory (once approved)
Settings → Community plugins → Browse → search "ImageFull" → Install → Enable.
Manual
- Download
main.js,manifest.json,styles.cssfrom the latest release. - Place them in
<Vault>/.obsidian/plugins/imagefull/. - Settings → Community plugins → enable ImageFull.
Usage
Double-click any embedded image in a note (works in both reading and live-preview modes). The image opens centered on a dimmed overlay. Use pinch or two-finger swipe to zoom and pan. Double-click anywhere on the overlay to close.
Why a separate plugin?
Obsidian's built-in image preview opens in a side pane and doesn't offer a clean fullscreen flow with pinch zoom. ImageFull keeps the interaction minimal — one gesture to open, one to close, and standard pinch/pan in between.
Development
No build step. The plugin is a single main.js plus styles.css. Edit directly and reload the plugin in Obsidian.
Run the community-submission linter locally:
npm install
npm run lint
License
MIT © Björn Kindler