# Majoor Assets Manager - Drag & Drop Guide

**Version**: 2.4.9
**Last Updated**: May 18, 2026

## Overview
The Majoor Assets Manager provides seamless drag and drop functionality that integrates with both ComfyUI and your operating system. This guide covers all aspects of drag and drop operations within the extension.

**Recent highlights**: Audio file staging support, improved multi-select ZIP creation, S+drag clean export, and better node compatibility detection.

## Drag to ComfyUI Canvas

### Basic Drag Operation
1. Select one or more assets in the Assets Manager
2. Click and hold on an asset card
3. Drag the asset onto the ComfyUI canvas
4. Release the mouse button to drop the asset

### Single Asset Drag
- Drag any single asset to the canvas
- Dropping on a compatible loader node stages the asset and injects the staged path
- Dropping media on empty canvas imports a valid embedded workflow when present; otherwise it creates the matching loader node
- Hold **L** while dropping on empty canvas to skip embedded workflow import and create the matching media loader node directly. With a multi-selection, one loader node is created per selected asset.
- The staged copy is placed under the ComfyUI input directory for immediate use

### Multiple Asset Drag
- Select multiple assets using Ctrl/Cmd+click or Shift+click
- Drag any selected asset outside the browser to create a ZIP for OS/file-manager drops
- Hold **L** while dropping a multi-selection on empty canvas to create one matching loader node per selected asset
- Dropping a multi-selection on an existing node still injects only the card that started the drag into that node

### Node Compatibility
The system intelligently identifies compatible nodes:

#### Image Input Nodes
- **LoadImage**: Accepts image file paths
- **LoadImageMask**: For mask images

#### Video Input Nodes
- **LoadVideo**: For video file paths
- **VideoLoad**: For various video formats

#### Other Media Input Nodes
- Audio loader nodes with audio path widgets
- 3D/model loader nodes with model, mesh, geometry, or scene path widgets

### Staging Mechanism
- Assets are copied or hard-linked into the ComfyUI input directory before node injection
- Paths are injected into compatible input widgets after staging completes
- Empty-canvas image drops can create a LoadImage node using the staged path
- Staging writes an input-side file; the workflow itself changes only when a node is created or a widget value is updated

## Drag to Operating System

### Single File Drag
1. Select an asset in the Assets Manager
2. Click and drag the asset outside the browser window
3. Drop onto your file explorer, desktop, or another application
4. The original file is transferred to the destination

### Multiple File Drag
1. Select multiple assets using Ctrl/Cmd+click or Shift+click
2. Drag any selected asset outside the browser window
3. A ZIP file is automatically created containing all selected assets
4. Drop the ZIP file onto your destination

### Clean Export Without ComfyUI Metadata
- Normal drag-out preserves the original file and does not show a metadata prompt.
- Hold **S** while starting the drag to export clean copies with ComfyUI workflow/generation metadata stripped.
- S+drag works for one or more selected assets. For multiple selected assets, a single clean ZIP is created for the OS drop.
- If an asset has no supported embedded metadata to strip, it is exported unchanged.

### ZIP Creation Process
- ZIP files are created on-demand when dragging multiple items
- Files are streamed directly from disk (no temporary copies)
- ZIPs are flat (no directory structure maintained)
- ZIP files are automatically cleaned up after transfer

### Protocol Support
The system supports multiple drag protocols:

#### DownloadURL Protocol
- Used for single file transfers
- Direct file download to destination
- Maintains original filename and extension

#### text/uri-list Protocol
- Used for multiple file transfers
- Properly formatted URI list for operating system
- Compatible with most file managers and applications

## Drag Operations

### Starting a Drag
- Click and hold on any asset card for a moment
- A visual indicator appears showing the drag is active
- The cursor changes to indicate drag operation
- Selection remains active during drag

### Drag Indicators
- **Visual Outline**: Selected assets show a highlighted border
- **Cursor Change**: Cursor changes to indicate drag capability
- **Preview**: Small preview of dragged asset(s) follows cursor
- **Count Display**: For multiple selections, shows number of items

### Drag Targets
The system recognizes different drag targets:

#### Valid Targets
- ComfyUI canvas area
- Compatible input nodes
- Browser address bar (downloads)
- File explorer windows
- Desktop
- Email attachments
- Other applications accepting files

#### Invalid Targets
- Text input fields (unless specifically designed for file drops)
- Non-compatible areas of the interface
- Applications that don't accept the file type

## File Transfer Mechanisms

### Direct File Transfer
- Single files are transferred directly
- Maintains original file properties
- Preserves embedded metadata
- No quality loss during transfer

### Batch ZIP Transfer
- Multiple files are packaged into a ZIP archive
- ZIP created dynamically during drag operation
- No temporary files written to disk
- Automatic cleanup after transfer completion

### Streaming Transfer
- Files are streamed directly from disk
- No intermediate copies created
- Memory efficient for large files
- Maintains file integrity during transfer

## Filename Collision Indicator

### Understanding the Indicator
- When multiple assets share the same filename, the extension badge shows `EXT+`
- For example: `image.png` becomes `PNG+` when duplicates exist
- Helps identify potential conflicts during drag operations

### Handling Collisions
- Collisions don't prevent drag operations
- ZIP files handle duplicate names automatically
- Individual file drops may require manual renaming
- Consider renaming files to avoid confusion

## Drag Performance

### Optimizations
- Lightweight preview during drag
- Asynchronous file operations
- Memory-efficient streaming
- Responsive interface during drag operations

### Performance Considerations
- Large files may take time to initiate transfer
- Multiple large files in ZIP may take longer to create
- Network drives may affect performance
- System resources impact drag responsiveness

## Advanced Drag Features

### Drag Preview
- Live preview of dragged assets
- Shows thumbnail of the primary dragged item
- Displays count for multiple selections
- Updates in real-time during drag

### Drag Validation
- Validates target compatibility before allowing drop
- Provides visual feedback for valid/invalid targets
- Prevents invalid operations
- Shows appropriate cursors for different states

### Drag Cancellation
- Cancel drag by releasing over invalid target
- Escape key cancels active drag operation
- Clicking elsewhere cancels drag
- Drag automatically cancels if window loses focus

## Integration with Other Features

### Selection Integration
- Drag operations work with current selection
- Multiple selections enable batch operations
- Selection filters apply to drag operations
- Search results can be dragged directly

### Collection Integration
- Assets from collections can be dragged normally
- Entire collections can be exported via drag
- Collection organization preserved in transfers
- Cross-collection drags work seamlessly

### Rating/Tag Integration
- Rated and tagged assets maintain metadata during drag
- Tags and ratings preserved in file transfers (when supported)
- Filtered views can be dragged directly
- Quality indicators visible during drag

## Troubleshooting

### Common Drag Issues

#### Drag Not Initiating
- Ensure you're clicking and holding long enough
- Check that the asset is properly selected
- Verify no JavaScript errors in console
- Try refreshing the Assets Manager

#### Drag Target Not Recognized
- Ensure target application accepts file drops
- Check if target area is actually droppable
- For ComfyUI node drops, use loader/input nodes with file-path widgets
- Preview/output nodes are not file-path drop targets
- Try dragging to a different application

#### ZIP Creation Failure
- Check available disk space
- Verify write permissions to temporary directory
- Ensure no antivirus interference
- Try dragging fewer files at once

#### File Transfer Problems
- Large files may timeout during transfer
- Network drives may cause delays
- Antivirus software may interfere
- Check file permissions at destination

### Browser-Specific Issues

#### Chrome/Chromium
- May require specific security settings for file downloads
- Extensions might interfere with drag operations
- Incognito mode may behave differently

#### Firefox
- Security settings may restrict file operations
- Enhanced Tracking Protection might interfere
- Check privacy settings for file handling

#### Safari
- May require additional permissions for file access
- Security restrictions could limit functionality
- Check website permissions for file handling

### Operating System Issues

#### Windows
- UAC (User Account Control) may interfere
- Antivirus software may block operations
- File permissions may restrict transfers

#### macOS
- Gatekeeper may restrict file operations
- Privacy settings may limit access
- Sandboxing could affect functionality

#### Linux
- File permissions are strictly enforced
- Desktop environment may affect drag behavior
- Security modules might restrict operations

## Security Considerations

### File Access Security
- Drag operations respect file system permissions
- No files can be accessed that the user can't read
- Temporary files are created with restricted permissions
- ZIP files are cleaned up automatically

### Cross-Origin Security
- Drag operations confined to same origin
- No cross-site data leakage possible
- File system access limited to allowed directories
- Path validation prevents directory traversal

### Malicious File Protection
- No automatic execution of dragged files
- Files transferred in their original form
- No modification during drag operations
- Integrity preserved throughout transfer

## Performance Optimization

### Large File Handling
- Stream large files instead of loading entirely
- Progress indicators for long operations
- Asynchronous operations to maintain interface responsiveness
- Memory management for multiple large files

### Multiple File Optimization
- Efficient ZIP creation algorithms
- Parallel processing where possible
- Memory buffering for optimal performance
- Cleanup operations scheduled appropriately

### Interface Responsiveness
- Drag operations don't block UI thread
- Smooth animations during drag
- Immediate feedback for user actions
- Graceful degradation for slower systems

## Best Practices

### Efficient Drag Operations
- Use multiple selection for batch operations
- Organize assets in collections for easier access
- Use search and filters to find assets quickly
- Verify target compatibility before initiating drag

### File Organization
- Maintain consistent naming conventions
- Use collections to group related assets
- Apply tags for easy retrieval
- Regular cleanup of unused assets

### Workflow Integration
- Use drag operations to accelerate workflow creation
- Stage frequently used assets in collections
- Leverage drag to canvas for rapid prototyping
- Combine with other Assets Manager features

### Performance Tips
- Close unnecessary browser tabs during large operations
- Ensure sufficient system resources
- Use wired connections for network drives
- Regular maintenance of index database

## Advanced Usage

### Scripted Operations
- Combine drag operations with automation scripts
- Use collections for automated workflows
- Integrate with external tools via file operations
- Batch processing using drag interfaces

### Power User Techniques
- Master keyboard shortcuts with drag operations
- Use multiple monitors for efficient transfers
- Leverage search and filters for precise selection
- Combine collections with drag for complex operations

---
*Drag & Drop Guide Version: 1.0*
*Last Updated: April 5, 2026*