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 • Known Issues • Contributing • Changelog
Inspector Power-Ups & Settings Overhaul
- 📊 Popout Viewer Pro:
- Visual Charts: Render images/charts directly in the popout.
- Window Controls: Fullscreen, Fit-to-Window, and "Keep Alive" modes.
- Remote Control: Select and focus nodes on the main canvas from the popout window.
- 🧭 Advanced Navigation:
- Sortable Lists: Find nodes by Execution Order or ID.
- Focus Target: One-click zoom to any inspected node.
- 📋 Copy Everything: Added one-click copy buttons to all text fields.
📄 See CHANGELOG.md for the complete version history.
- 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).
- 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).
- 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.
- 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.
- Visual Modes: Toggle Invert Colors or Grayscale for high-contrast viewing.
- Reduce Motion: Disable smooth animations for instant feedback.
- Text Enhancements: Scaling, Bold, Glow, and Outline options for maximum legibility.
- Open ComfyUI Manager.
- Search for
ComfyUI-MagnifyGlass. - Click Install.
cd /path/to/ComfyUI/custom_nodes
git clone https://github.com/AEmotionStudio/ComfyUI-MagnifyGlass.git| 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 |
D |
Force Direct Capture (accurate cursor at low zoom) |
| Arrows | Nudge Glass Position |
Pro Tip: Toggle the Glass Preview (
G) off to keep the Inspector Panel active but hide the magnifying preview.
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). |
This project is licensed under the GPL-3.0 License - see the LICENSE file for details.
- Virtual Zoom Cursor Alignment: When using "Virtual Zoom" (canvas zoom < 100%), the mini cursor preview in the glass may not perfectly align with the actual content due to a fundamental drift in the coordinate capture system. Workaround: Press
Dto toggle Direct Capture mode for accurate cursor alignment (at the cost of lower magnification quality). - Inflated FPS Counter: You may notice the ComfyUI FPS counter displaying extremely high numbers (e.g., 1000+ FPS) while the glass is active. This is a False Reading caused by the extension's internal render loop triggering the counter hooks multiple times per frame to ensure smooth glass updates. It does not indicate excessive GPU load or actual frame rate.
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
