README file from
GithubImage Tab Zoom
An Obsidian plugin that adds pinch-zoom and modifier-scroll zoom to image files opened in Obsidian. Works on both desktop (macOS trackpad pinch, Cmd/Ctrl + scroll) and iOS (native pinch).
Scope
Only affects image files opened directly in Obsidian (.png, .jpg, .webp, etc. in their own tab). Images embedded inside markdown notes are not touched.
Features
- Trackpad pinch-to-zoom on macOS.
- Two-finger pinch-to-zoom on iPad/iPhone, with two-finger pan during the pinch.
- Modifier + scroll wheel zoom (Cmd, Ctrl, either, or no modifier).
- Drag to pan when zoomed in, clamped to the image's edges.
- Double-click (or double-tap on touch) to reset zoom.
- Cursor-anchored zoom — the point under your cursor stays put.
Install
From the Obsidian community plugins browser
Available once the plugin is accepted into the community directory. Submission is pending — use one of the other methods below in the meantime.
- Open
Settings → Community plugins. - Turn off Restricted mode if it is on.
- Click
Browse, search forImage Tab Zoom, and install. - Enable the plugin in
Settings → Community plugins.
Manual
- Download
manifest.jsonandmain.jsfrom the latest GitHub release. - Copy both files into your vault's
.obsidian/plugins/image-tab-zoom/folder (create the folder if it does not exist). - Reload Obsidian and enable the plugin under
Settings → Community plugins.
Settings
- Modifier key for scroll-zoom — which modifier must be held while scrolling to trigger zoom (Cmd, Ctrl, either, or none).
- Zoom sensitivity — multiplier for how fast scroll-zoom changes scale.
- Maximum zoom — upper scale bound.
- Reset on double-click — whether double-clicking resets zoom to 1x.
Contributing
See CONTRIBUTING.md for build, test, and release instructions.
License
MIT