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.9.0 (January 5, 2026)

Visual Accessibility Update & Rendering Overhaul

• ♿ Visual Methods: New Invert Colors, Grayscale, and Reduce Motion modes for better accessibility.
• A11y Settings: High Contrast text, Text Glow, Font Scaling, and Node Title Emphasis.
• Native Rendering: Complete rewrite of the text rendering engine using native canvas drawing for crisp, aligned text.
• Virtual Zoom Improvements: Resolved missing widget issues in zoomed-out views.

📄 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.

♿ Accessibility Suite

• 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.

---

📦 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
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.

---

⚙️ 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.

---

🐛 Known Issues

• 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 D to toggle Direct Capture mode for accurate cursor alignment (at the cost of lower magnification quality).

---

🤝 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