orion4d-ComfyUI-Image-Effects/README.md

🎨 ComfyUI Image Effects

Complete collection of professional image effects for ComfyUI

Transform your images with 32 powerful nodes across 6 specialized categories

📥 Installation • 📚 Tutorial • 📖 Documentation

---

✨ Features

🎚️ Core Effects (7 nodes) 🎚️ Levels Adjustment 📈 RGB Curves 🎨 Color Balance 🌈 Vibrance & Saturation 🌗 Shadow/Highlight 🔀 Channel Mixer 💾 Saver Plus	🎨 Creative Effects (5 nodes) 🔮 Kaleidoscope Effect ✨ Kaleidoscope Advanced 🎭 ASCII Art Generator 📝 ASCII Text Generator 🎛️ CSS Filters	📼 Vintage Effects (5 nodes) 📼 VHS Glitch 🎞️ Film Grain 💡 Light Leaks 📺 Vintage TV 📷 Polaroid Effect
🌊 Deformation Effects (5 nodes) 🐠 Fisheye 🍐 Barrel Distortion 🌊 Ripple 🔵 Spherize 🤏 Pinch	💡 Light Effects (5 nodes) 💡 Lens Flare 🌞 God Rays 🌟 Neon Glow 🌈 Holographic 🌌 Aurora	🔺 Geometric Effects (5 nodes) 🔺 Triangulate 📐 Voronoi ⬡ Hexagonal Pixelate ❄️ Crystallize 🔷 Polygon

---

📥 Installation

Quick Install (Recommended)

cd ComfyUI/custom_nodes
git clone https://github.com/orion4d/ComfyUI-Image-Effects.git
cd ComfyUI-Image-Effects
pip install -r requirements.txt

Manual Install

1. Download the repository as ZIP
2. Extract to ComfyUI/custom_nodes/ComfyUI-Image-Effects
3. Install dependencies: pip install -r requirements.txt
4. Restart ComfyUI

---

📚 Tutorial - Getting Started

Step 1: Basic Setup

1. Start ComfyUI and open the default workflow
2. Load an image using the "Load Image" node
3. Add Image Effects nodes by right-clicking and selecting "Add Node" → "Image Effects"

Step 2: Basic Workflow

Load Image → Image Effect Node → Preview Image

Step 3: Using Core Effects

For color correction:

1. Add Levels Adjustment for exposure
2. Add Color Balance for temperature
3. Add Vibrance & Saturation for color intensity

Step 4: Using Creative Effects

For artistic transformation:

1. Add Kaleidoscope Effect for symmetrical patterns
2. Add ASCII Art Generator for text-based art
3. Add CSS Filters for web-style effects

Step 5: Using Vintage Effects

For retro aesthetics:

1. Add VHS Glitch for authentic artifacts
2. Add Film Grain for analog texture
3. Add Polaroid Effect for instant camera look

Step 6: Advanced Workflows

Combine multiple effects:

Load Image → Core Effect → Creative Effect → Vintage Effect → Save Image

Step 7: Tips & Tricks

• Start with low values and gradually increase
• Use Core effects first for color correction
• Chain effects for complex results
• Save workflows for reuse

---

📖 Quick Reference

Core Effects Usage

Node	Purpose	Best For
🎚️ Levels	Brightness/Contrast	Exposure correction
📈 Curves	Advanced color grading	Professional color work
🎨 Color Balance	Color temperature	Warm/cool adjustments
🌈 Vibrance	Color intensity	Making colors pop
🌗 Shadow/Highlight	Detail recovery	Fixing exposure
🔀 Channel Mixer	Color effects	Creative color mixing
💾 Saver Plus	Export control	High-quality saves

Creative Effects Usage

Node	Purpose	Best For
🔮 Kaleidoscope	Symmetrical patterns	Psychedelic art
✨ Kaleidoscope Advanced	Complex patterns	Advanced symmetry
🎭 ASCII Art	Text-based art	Retro computer style
📝 ASCII Text	Pure text output	Forum signatures
🎛️ CSS Filters	Web-style effects	Quick adjustments

Vintage Effects Usage

Node	Purpose	Best For
📼 VHS Glitch	Tape artifacts	Retro aesthetics
🎞️ Film Grain	Analog texture	Film simulation
💡 Light Leaks	Organic lighting	Vintage photography
📺 Vintage TV	CRT display	Old monitor look
📷 Polaroid	Instant camera	Nostalgic photos

Deformation Effects Usage

Node	Purpose	Best For
🐠 Fisheye	Wide-angle distortion	Lens effects
🍐 Barrel Distortion	Lens correction	Optical effects
🌊 Ripple	Water effects	Psychedelic distortion
🔵 Spherize	Bubble effects	Magnification
🤏 Pinch	Localized distortion	Artistic warping

Light Effects Usage

Node	Purpose	Best For
💡 Lens Flare	Optical reflections	Cinematic lighting
🌞 God Rays	Dramatic lighting	Divine effects
🌟 Neon Glow	Edge highlighting	Cyberpunk style
🌈 Holographic	Sci-fi effects	Futuristic displays
🌌 Aurora	Natural phenomena	Magical atmospheres

Geometric Effects Usage

Node	Purpose	Best For
🔺 Triangulate	Low-poly art	Geometric stylization
📐 Voronoi	Cellular patterns	Organic textures
⬡ Hexagonal Pixelate	Stylized pixels	Honeycomb effects
❄️ Crystallize	Crystal fragments	Shattered glass
🔷 Polygon	Shape reduction	Simplified art

---

🛠️ Requirements

• ComfyUI (Latest version)
• Python 3.8+
• Dependencies (auto-installed):
  • NumPy ≥ 1.21.0
  • OpenCV ≥ 4.5.0
  • SciPy ≥ 1.7.0
  • Pillow ≥ 8.0.0

---

🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Submit a pull request

---

📄 License

This project is licensed under the Apache License 2.0

---

🌟 Show Your Support

If this project helped you, please consider giving it a ⭐ on GitHub!

Made with ❤️ for the ComfyUI community

by Orion4D