ComfyUI Extension: ComfyUI ASDF Pixel Sort Nodes
A ComfyUI integration of Kim Asendorf's iconic ASDFPixelSort algorithm, bringing classic pixel sorting effects directly into your ComfyUI workflows
Custom Nodes (0)
README
ComfyUI ASDF Pixel Sort Nodes
A ComfyUI integration of Kim Asendorf's iconic ASDFPixelSort algorithm, bringing classic pixel sorting effects directly into your ComfyUI workflows.
✨ Features
- 🎨 Authentic Algorithm: Uses original Kim Asendorf ASDFPixelSort Processing script
- 🔄 Four Sorting Modes: White, Black, Bright, and Dark threshold-based sorting
- 🔗 Seamless Integration: Native ComfyUI tensor handling and workflow compatibility
- ⚙️ Full Control: Complete parameter customization for all sorting thresholds
- 🖥️ Headless Ready: Virtual display support for server environments
- 📦 Easy Install: Automated setup script for all dependencies
🚀 Quick Start
Installation
- Clone this repository into your ComfyUI custom_nodes directory:
cd /path/to/ComfyUI/custom_nodes/
git clone https://github.com/your-username/ComfyUI-ASDF-PixelSort.git
- Install dependencies (automated):
cd ComfyUI-ASDF-PixelSort
chmod +x scripts/install.sh
sudo ./scripts/install.sh
- Restart ComfyUI to load the new nodes
Basic Usage
- Add LoadImage node → Pixel Sort (ASDF) → SaveImage
- Configure sorting mode and thresholds
- Queue prompt to process
🎛️ Available Nodes
Pixel Sort (ASDF)
Location: Add Node
→ image
→ effects
→ Pixel Sort (ASDF)
Parameters:
- Mode:
white
|black
|bright
|dark
- White Threshold:
-16777216
to0
(default:-12345678
) - Black Threshold:
-16777216
to0
(default:-3456789
) - Bright Threshold:
0
to255
(default:127
) - Dark Threshold:
0
to255
(default:223
)
Pixel Sort Advanced (ASDF)
Location: Add Node
→ image
→ effects
→ Pixel Sort Advanced (ASDF)
Additional features:
- Optional parameter inputs
- Custom Processing sketch path support
- Extended configuration options
🎨 Sorting Modes Explained
| Mode | Description | Effect | |------|-------------|--------| | White | Sorts pixels based on white threshold | Flowing, organic distortions | | Black | Sorts pixels based on black threshold | Emphasizes shadows and dark regions | | Bright | Sorts pixels based on brightness values | Smooth luminance gradients | | Dark | Sorts pixels based on darkness values | High-contrast dramatic effects |
📖 Documentation
- 📋 Installation Guide - Detailed setup instructions
- 🔧 Troubleshooting - Common issues and solutions
- 📚 API Reference - Complete technical documentation
- 🎯 Examples - Ready-to-use workflow files
🛠️ System Requirements
Minimum:
- Linux (Ubuntu 20.04+, CentOS 8+, Arch Linux)
- 4GB RAM, 2GB free storage
- Python 3.8+, Java 17+
- ComfyUI v0.3.40+
Recommended:
- 8GB+ RAM, SSD storage
- Multi-core processor
- GPU for ComfyUI acceleration
🤝 Contributing
We welcome contributions! Please see our Contributing Guidelines.
- Fork the repository
- Create a feature branch:
git checkout -b feature/amazing-feature
- Commit your changes:
git commit -m 'Add amazing feature'
- Push to the branch:
git push origin feature/amazing-feature
- Open a Pull Request
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
Attribution
- Original Algorithm: ASDFPixelSort by Kim Asendorf (2010)
- ComfyUI Integration: This repository
- Processing: Processing Foundation
🙏 Acknowledgments
- Kim Asendorf for the original ASDFPixelSort algorithm
- ComfyUI Community for the excellent framework
- Processing Foundation for the creative coding platform
- Contributors who help improve this project
<div align="center">
Made with ❤️ for the ComfyUI community
</div>