Image Flow Gallery

Browse Markdown notes, images, and videos in a masonry gallery inside Obsidian.

Features

• Mixed gallery with All, Documents, and Media filters.
• Note titles, tags, excerpts, and the first embedded image as a cover.
• Lazy loading of note previews and media.
• Filename search and newest/oldest sorting.
• Configurable top-level folders and media filename labels.
• Click a card to open the original file; hover over a video to preview it when the format is supported.

Getting started

1. Install and enable Image Flow.
2. Open Settings → Image Flow Gallery and select the folders to browse. No folders are selected by default.
3. Click the grid icon in the left ribbon, or run Image Flow Gallery: Open Image Flow gallery from the command palette.
4. Optionally assign this command a hotkey in Settings → Hotkeys.

The gallery does not open automatically on startup. Folder settings are saved separately in each vault. Reopen the gallery to refresh its contents after changing settings or files.

Manual installation

Download main.js, manifest.json, and styles.css from the latest GitHub release. Put them in <vault>/.obsidian/plugins/xibao-image-flow-gallery/, reload installed plugins, and enable Image Flow. Community directory publication is pending; availability in the in-app browser depends on acceptance.

Supported files

Markdown: md. Images: png, jpg, jpeg, gif, webp, bmp, svg. Videos: mp4, mov, webm, mkv. Actual video playback depends on the codecs supported by your device. Audio and PDF previews are not included.

Privacy

The plugin reads files from the selected folders and saves only its own settings. It does not upload notes or media. If a note contains an external image URL used as its cover, displaying that cover makes a request to that image host. Cloud-only files may need to be downloaded by your sync provider before they can be previewed.

Development

The source is plain JavaScript in main.js, with styles in styles.css. No build step is required. Run npm run check for a syntax check.

中文说明

把 Obsidian 中的文章、图片和视频以瀑布流方式预览。先在插件设置里勾选扫描目录，再点击左侧四宫格按钮，或在命令面板搜索 Image Flow。支持文档/媒体筛选、文件名搜索和时间排序。不会自动在启动时打开，也不会修改原始文章或媒体。

License

MIT © 2026 xibao

The public plugin ID is xibao-image-flow-gallery to distinguish this gallery from an unrelated image-upload plugin named Image Flow. If migrating from the private image-flow installation, disable that version before enabling this public version and select your folders again.