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)

1. Open ComfyUI Manager.
2. Search for ComfyUI-MagnifyGlass.
3. 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.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

---

Developed by Æmotion Studio