🌙

🎨 Majoor Assets Manager - Ultimate User Guide

Your comprehensive resource for mastering the most powerful asset management tool for ComfyUI

📋 Table of Contents

👋 Introduction & Overview

The Majoor Assets Manager is the ultimate asset management solution for ComfyUI enthusiasts. It transforms how you organize, search, and utilize your generated assets with powerful features and an intuitive interface.

Why Choose Majoor Assets Manager?

Experience the most comprehensive asset management solution with cutting-edge features that streamline your creative workflow!

⚡ Lightning-Fast Search

Powered by SQLite FTS5 with BM25 ranking for instant results across thousands of assets.

📊 Rich Metadata

Extract generation info from PNG/WEBP/video files with ExifTool and FFprobe integration.

🎨 Advanced Viewer

With comparison tools, analysis features, and enhancement controls for detailed inspection.

💡 Pro Tip

Start with the Outputs tab to explore your generated assets. The interface will automatically index and display your creations!

📦 Installation & Setup

Get up and running with Majoor Assets Manager in minutes with our streamlined installation process.

📋 Prerequisites

🚀 Quick Installation (Recommended)

Using ComfyUI Manager

  1. Open ComfyUI Manager in your browser
  2. Find "Majoor Assets Manager" in the extensions list
  3. Click "Install" next to the extension
  4. Wait for the installation to complete
  5. Restart ComfyUI completely
  6. The extension should now be available in the Assets Manager tab

🔧 Manual Installation

  1. Navigate to your ComfyUI custom_nodes directory
  2. Clone the repository:
    git clone https://github.com/MajoorWaldi/ComfyUI-Majoor-AssetsManager ComfyUI-Majoor-AssetsManager
  3. Install Python dependencies:
    cd ComfyUI-Majoor-AssetsManager
    pip install -r requirements.txt
  4. Restart ComfyUI to load the new extension

🛠️ Optional Dependencies (Highly Recommended)

For full functionality including metadata extraction and file tagging, install these external tools:

🖥️ Windows

Using Scoop:

scoop install ffmpeg exiftool
🍎 macOS

Using Homebrew:

brew install ffmpeg exiftool
🐧 Linux

Ubuntu/Debian:

sudo apt update
sudo apt install -y ffmpeg libimage-exiftool-perl

⭐ Core Features

Discover the powerful capabilities that make Majoor Assets Manager the premier choice for asset management.

🌐 Four-Tab Interface

📤 Outputs

Browse your ComfyUI output directory with powerful filtering and search capabilities.

📥 Inputs

Manage your input assets with the same powerful tools as your outputs.

📁 Custom

Access user-defined directories for comprehensive asset management.

📚 Collections

Organize assets into custom collections for project-based workflows.

🔍 Smart Indexing

The Assets Manager automatically indexes your assets with:

⚠️ Performance Tip

The first scan of a large directory may take time, but subsequent scans are much faster thanks to incremental indexing!

🔍 Search & Filtering

Powerful search and filtering capabilities to find exactly what you need in seconds.

⚡ Full-Text Search

Our search engine uses SQLite FTS5 with BM25 ranking for the most relevant results:

🎯 Advanced Filters

🏷️ Kind Filter

Filter by file type: Images, Videos, Workflows, and more.

⭐ Rating Filter

Show only assets with minimum rating (1-5 stars).

📅 Date Filters

Filter by creation/modification dates for temporal searches.

⚙️ Workflow Filter

Show only assets with embedded workflow information.

📝 Search Tips

🖼️ Metadata & Viewer

Comprehensive metadata extraction and an advanced viewer with powerful analysis tools.

📋 Metadata Extraction

We support multiple backends for comprehensive metadata extraction:

📸 Image Metadata

Generation parameters, workflow information, technical details, and custom tags.

🎬 Video Metadata

Duration, frame rate, resolution, audio information, and embedded parameters.

🛠️ Extraction Backends

ExifTool (most comprehensive), FFprobe (video/audio focused), and built-in extraction.

📺 Advanced Viewer Features

🔍 Single View Mode

Zoom, pan, 1:1 pixel view, exposure adjustment, gamma correction, and channel isolation.

↔️ Comparison Modes

Side-by-side, A/B toggle, wipe slider, and difference comparison tools.

🎥 Video Player

Loop/once playback, seek controls, in/out point markers, and frame-by-frame stepping.

📐 Overlays

Grid overlays, pixel probe, loupe magnification, and histogram/waveform scopes.

📂 Organization Tools

Powerful tools to keep your assets organized and easily accessible.

⭐ Rating System

Rate assets from 0 to 5 stars for quick quality assessment:

🏷️ Tagging System

Customizable keywords to categorize and organize your assets:

📚 Collections

User-created groups of assets that can span multiple directories:

💡 Organization Best Practice

Create collections for different projects, styles, or clients. Use consistent tagging to make assets easily discoverable later!

🔄 Drag & Drop Functionality

Seamless drag and drop integration with both ComfyUI and your operating system.

📤 Drag to ComfyUI Canvas

Drag assets directly onto the ComfyUI canvas for instant integration:

📥 Drag to Operating System

Drag assets to your file explorer for easy file management:

Drag Power Tip

Use Ctrl/Cmd+click to select multiple assets, then drag any selected asset to initiate a multi-file drag operation!

⌨️ Keyboard Shortcuts

Boost your productivity with these essential keyboard shortcuts.

🎯 Essential Shortcuts

Action Windows/Linux macOS
Scan current scope Ctrl+S Cmd+S
Toggle details sidebar D D
Rate 5 stars 5 5
Select all Ctrl+A Cmd+A
Focus search Ctrl+F Cmd+F
Close viewer Esc Esc

🔍 Viewer Shortcuts

Action Shortcut
Toggle false color F
Toggle zebra patterns Z
Cycle grid overlays G
Toggle pixel probe I
Toggle loupe L
Copy color value C

🔥 Power User Sequence

Try this sequence: Ctrl+F [search term] Enter Ctrl+A 5 - Search, select all results, rate everything 5 stars!

⚙️ Configuration

Customize the Assets Manager to match your workflow and preferences.

🎨 Display Settings

⚡ Performance Settings

🔧 Backend Configuration

Configure the backend using environment variables:

# Override output directory
export MAJOOR_OUTPUT_DIRECTORY="/path/to/output"

# Specify tool paths if not in PATH
export MAJOOR_EXIFTOOL_PATH="/path/to/exiftool"
export MAJOOR_FFPROBE_PATH="/path/to/ffprobe"

# Set media probe backend
export MAJOOR_MEDIA_PROBE_BACKEND="auto"  # auto, exiftool, ffprobe, both

# Enable file watcher for auto-reindexing
export MAJOOR_ENABLE_FILE_WATCHER=true

🛠️ Troubleshooting

Solutions to common issues and how to resolve them.

🚨 Common Issues

❌ Missing Dependencies

If you see warnings about missing dependencies:

  1. Check that all requirements are installed: pip install -r requirements.txt
  2. Install optional tools (ExifTool, FFprobe) for full functionality
  3. Verify tools are in your system PATH or set environment variables

🐢 Slow Performance

If experiencing slow performance:

  • Large collections may take time to load
  • Increase page size for fewer requests
  • Ensure external tools (ExifTool, FFprobe) are properly installed
  • Adjust database connection settings if needed

🔍 Verification Steps

  1. Start ComfyUI and look for the Assets Manager tab
  2. Check the console/logs for any error messages during startup
  3. Run exiftool -ver and ffprobe -version to verify external tools
  4. Open the Assets Manager and try a simple search to verify indexing

📁 File Locations