Æmotion StudioandClaude Opus 5.5 6799dc8fbb Fix sidebar collapse and glass media culling
- Make the sidebar tab wrapper fill the panel, and let the content keep its
  natural height when the parent has none, so the settings no longer collapse
  to a 16px scroller.
- Only measure DOM images and videos under the glass, so per-frame work scales
  with what is under the glass instead of all media on the page.
- Cap Virtual Zoom near 60 fps again, so high-refresh displays do not run two
  full graph draws every frame.
- Cull nodes with LiteGraph's boundingRect and keep collapsed nodes, so title
  bars and collapsed nodes in front of a preview stay on top in the glass.
- Drop the self-min on the title width and the dead pos/size guards.
- Remove the stale web/shared/settings.js build output.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-03 20:32:16 -08:00
2025-06-12 23:13:04 -07:00
2025-05-13 11:31:11 -07:00

ComfyUI-MagnifyGlass

A powerful, customizable magnifying glass extension for ComfyUI.

ComfyUI Version License Dependencies

Downloads Visitors Clones

Last Commit Activity

MagnifyGlass Intro
Inspect fine details in your generated images, node connections, and canvas with ease.

Features • Installation • Usage • Configuration • Known Issues • Contributing • Changelog


🚀 What's New in v1.14.0 (November 3, 2026)

Images and Videos in the Glass, Glass-Only Mode, New Sidebar

  • 🖼️ Media in the Glass: Image previews, videos and animated images now show in the glass at their real position, at any canvas zoom. Images are drawn at full resolution, videos play smoothly, and both reach the pop-out and the Invert/Grayscale filters.
  • 🔍 Glass-Only Mode: Turn off Inspector panel at the top of the sidebar to remove the panel, its hotkeys and its highlight entirely. Turn it back on without a reload.
  • 🎨 Sidebar Redesign: Follows your ComfyUI palette (light or dark), with an About section for links, version and the studio's other packs.
  • 🧩 Nodes 2.0: Basic support for the Vue nodes mode.

📄 See CHANGELOG.md for the complete version history.


NotebookLM Overview: Exploring the features and updates of the ComfyUI-MagnifyGlass extension. (Click to watch on YouTube)

✨ Features

🔍 Magnifying Glass

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

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

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

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

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

  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 (with the Inspector panel on, keeps the panel and hides the glass)
Shift+P Open Pop-Out Viewer in New Tab
U Pin/Unpin Inspector Panel
O Reset Offsets
* Focus Current Node (Center canvas on inspected node)
Left/Right Navigate Previous/Next node in execution order
D Force Direct Capture (Optional after v1.11.0 improvements)
Arrows Nudge Glass Position (When not navigating nodes)

Pro Tip: Press G to hide the magnifying preview and keep only the Inspector Panel. For the glass alone, turn off Inspector panel in the sidebar.


⚙️ Configuration

Access settings via the new Sidebar Panel or the ComfyUI Settings (⚙️) menu.

🔍 Magnify Glass
Setting Default Description
Zoom Factor 300% Magnification level (100% - 1000%).
Glass Size 300px Diameter/Size of the lens (50px - 500px).
Shape Rounded Square Circle, Square, or Rounded Square.
Position Top-Right Offset position relative to cursor.
Filtering Linear Texture filtering: Linear (smooth) or Nearest (pixelated).
Border Width 1px Width of the glass border.
Border Color #6B7280 Color of the glass border.
Show Border On Toggle the glass border visibility.
Follow Cursor Off If On, glass moves with your mouse.
Always Active On Keep the glass visible after activation.
Force Direct Capture Off High-accuracy mode for low zoom levels.
Show Mini Cursor Off Displays a cursor preview inside the glass.

Image previews, videos and animated images show in the glass in both capture modes. In Nodes 2.0 (Vue nodes) mode the glass always uses Direct Capture.

ℹ️ Information Panel
Setting Default Description
Inspector panel On Off leaves only the glass: the panel, its hotkeys (I, U, S, *) and its highlight are removed.
Persist Info Off Keep last node info visible when not hovering a node.
Node Highlight On Show high-contrast border around inspected node.
Position Bottom Position relative to the glass (Top/Bottom/Left/Right).
Width 300px Width of the inspector panel.
Max Height 300px Maximum vertical size before scrolling.
Font Size 14px Size of the text in the inspector.
Opacity 100% Background transparency of the panel.
Font Family System Custom font selection for the panel.
Text Color #6B7280 Custom text color for node data.
Accent Color #3B82F6 Color for headers and highlights.
Hover Controls On Show floating quick-action buttons.
Controls Position Left Anchor point for the floating controls.

Move Glass Position (drag-glass mode) is one of the panel's floating controls, so it is unavailable while the Inspector panel is off. Use Follow Cursor (H) or the arrow keys instead.

♿ Accessibility
Setting Default Description
Enable Accessibility Off Enable accessibility enhancements for the glass preview.
High Contrast Off Boost text contrast with bright colors.
Text Glow Off Add a glow effect behind text for better visibility.
Glow Color #FFFF00 Customizable color for the text glow.
Glow Intensity 5px Blur radius/intensity of the text glow.
Font Scale 100% Increase text size within the glass view (up to 200%).
Bold Text Off Force bold text weight for improved legibility.
Text Outline Off Add a high-contrast outline around text.
Outline Color #000000 Customizable color for the text outline.
Node Emphasis Off Apply extra styling/weight to node titles.
Invert Colors Off Invert all colors in the glass view.
Grayscale Mode Off Remove all color saturation from the view.
Reduce Motion On Disable smooth animations for instant feedback.

🐛 Known Issues

  • FPS Counter Visual Bug: While the magnifying glass is active, the ComfyUI FPS counter may display inflated values (often reaching the ~10,000 FPS limit). This is a visual display issue only and does not appear to affect actual performance.

🤝 Contributing

Contributions are welcome! Please see the CONTRIBUTING.md for guidelines on how to get started. Whether it's bug reports, feature suggestions, or pull requests, your help is appreciated.

  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

📝 License

This project is licensed under the GPL-3.0 License - see the LICENSE file for details.


Developed by Æmotion Studio

YouTube Discord Ko-fi


📺 STOP SQUINTING!

Are YOU tired of tiny nodes? Do messy workflows make you want to SCREAM? 😱 Get ComfyUI-MagnifyGlass TODAY! It ZOOMS! It INSPECTS! It POPS OUT! ⚡️🔍

(Click to watch on YouTube)

S
Description
No description provided
Readme GPL-3.0
58 MiB
Languages
TypeScript 59.3%
JavaScript 28.2%
HTML 8.3%
CSS 4.2%