ComfyUI-MagnifyGlass
A powerful, customizable magnifying glass extension for ComfyUI.
Inspect fine details in your generated images, node connections, and canvas with ease.
Features • Installation • Usage • Configuration • Changelog
🚀 What's New in v1.7.0 (January 3, 2026)
This release adds Multi-Monitor Pop-Out Viewer for dual-monitor workflows:
- Pop-Out Tab: Open the magnified view in a separate browser tab (
Shift+P). - Professional Dark Theme: Sleek two-column layout with inspector sidebar.
- Real-Time Sync: Frame sync at 30fps with live inspector updates.
- Resizable Canvas: Drag to resize the preview, size is remembered.
- FPS & Resolution Display: Performance metrics in the viewer footer.
📄 See CHANGELOG.md for the complete version history.
✨ Features
🔍 Magnifying Glass
- WebGL-Powered: Smooth, high-performance rendering at any zoom level.
- Smart Interactions: Follows your cursor or stays fixed. Toggles transparently for click-through.
- Customizable: Adjust zoom (up to 10x), size, border, and shape (Circle/Square/Rounded).
ℹ️ Inspector Panel
- Deep Analysis: View node parameters (Seed, CFG, Steps), text content, and image details on hover.
- Dockable Interface: Pin the panel to keep it stable, or let it follow the glass.
- Themed: Automatically matches any ComfyUI theme (Dark, Light, Solarized, Arc, Nord, GitHub).
⚙️ Sidebar Integration
- Organized Settings: All Magnify Glass and Info Panel settings in one place.
- Live Previews: Changes apply instantly without needing to refresh.
- Reset Options: Quickly restore defaults with individual or global reset buttons.
🖥️ Multi-Monitor Pop-Out
- Detachable Viewer: Open the magnified view in a separate browser tab.
- Inspector Sidebar: Real-time node details, cursor position, and canvas scale.
- Resizable Canvas: Drag to resize, size persists across sessions.
📦 Installation
Option 1: ComfyUI Manager (Recommended)
- Open ComfyUI Manager.
- Search for
ComfyUI-MagnifyGlass. - Click Install.
Option 2: Manual Install
cd /path/to/ComfyUI/custom_nodes
git clone https://github.com/AEmotionStudio/ComfyUI-MagnifyGlass.git
🎮 Usage
| Key | Action |
|---|---|
X |
Activate / Toggle Tool (Master Switch) |
H |
Toggle Follow Cursor Mode |
I |
Toggle Inspector Panel Visibility |
G |
Toggle Glass Preview (Enters "Inspector Only" Mode) |
Shift+P |
Open Pop-Out Viewer in New Tab |
U |
Pin/Unpin Inspector Panel |
O |
Reset Offsets |
| Arrows | Nudge Glass Position |
Pro Tip: Toggle the Glass Preview (
G) off to keep the Inspector Panel active but hide the magnifying preview.
⚙️ Configuration
Access settings via the new Sidebar Panel or the ComfyUI Settings (⚙️) menu.
Magnify Glass
| Setting | Default | Description |
|---|---|---|
| Zoom Factor | 300 |
Magnification level (300 = 3x). |
| Glass Size | 300px |
Diameter of the lens. |
| Shape | Rounded |
Circle, Square, or Rounded Square. |
| Activation Key | X |
Hotkey to toggle the tool. |
Information Panel
| Setting | Default | Description |
|---|---|---|
| Theme | Auto |
Syncs with ComfyUI theme automatically. |
| Opacity | 100% |
Transparency of the panel background. |
| Show Hover Controls | On |
Displays the quick-action toolbar on the panel. |
| Controls Position | Top |
Position of hover controls (Top/Bottom). |
📝 License
This project is licensed under the GPL-3.0 License - see the LICENSE file for details.
🤝 Contributing
Contributions are welcome! Please submit a Pull Request or open an Issue on GitHub.
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature) - Commit your Changes (
git commit -m 'Add some AmazingFeature') - Push to the Branch (
git push origin feature/AmazingFeature) - Open a Pull Request
Developed by Æmotion Studio
