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
🚀 Latest Updates (v1.5.0)
I've completely overhauled the UI and workflow for a seamless experience. Major highlights include:
- Modernized UI: Professional SVG icons and full support for all ComfyUI themes (Dark, Solarized, Nord, etc.).
- Smart Workflow: The Inspector Panel now intelligently pins/unpins based on your usage, allowing for both "Follow Glass" and "Free Floating" modes.
- Quick Access: New toolbar toggle for instant access.
📄 See CHANGELOG.md for the complete version history and detailed patch notes.
✨ Features
🔍 Magnifying Glass
- High Performance: WebGL-powered rendering for smooth zooming.
- Smart Interactions: Follows your cursor or stays fixed. Toggles transparently to let you click through to nodes.
- Customizable: Adjust zoom level (up to 10x), size, border, and shape (Circle/Square).
ℹ️ Inspector Panel
- Deep Analysis: Hover over any node to see parameters (Seed, CFG, Steps), text content, and image details.
- Dockable Interface: Pin the panel to the screen to keep it stable, or let it follow the glass.
- Inspector Tab: Technical breakdown of coordinate space and scaling for power users.
📦 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) |
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 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. |
🤝 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 AEmotionStudio
