🎄 ComfyUI Christmas Theme ✨

Transform your ComfyUI workspace into a winter wonderland

Dynamic backgrounds • Animated snowfall • Festive node connections

---

📢 Latest Update — December 28, 2025

🎉 New Year's Live Celebration v1.2.0

A massive update introducing a physics-based particle engine, interactive effects, and a synchronized New Year's finale.

New Feature	Description
✨ 22 Mouse Effects	Physics-based particle system with 22 unique interactive trails including Sparklers, Confetti, and Magic Wands.
🎊 Live Countdown	Dynamic timer that auto-targets the New Year with a pulsing "Celebration Mode" anticipation phase.
🤫 Surprise Finale	A spectacular, multi-stage 6-layer coordinated show triggered exactly at midnight. No spoilers!
🪩 Rave Mode	"Party Mode" setting that transforms background stars into a strobing disco light show.
🎨 Visual Core 2.0	Replaced emoji art with crisp SVG rendering for Snowflakes and Stars, plus new atmospheric Nebula clouds.

✨ Interactive Effect Library

Fully modular physics system with unique friction, gravity, and spawn behaviors:

✨ Sparkler	❄️ Snowflake	🎊 Confetti	⭐ Stardust
☄️ Comet	🌌 Aurora	🎀 Ribbon	💎 Crystal
🌸 Petals	🎁 Gifts	🍬 Candy	🔮 Magic Orb
✨ Magic Wand	🌟 Nova	💧 Bubbles	🔥 Embers
⚡ Lightning	🍂 Leaves	💫 Wishes	🎵 Notes
💖 Hearts

---

📢 Previous Update — December 25, 2025

🚀 Performance Overhaul v1.1.0

Major performance optimizations and bug fixes for a smoother experience:

Change	Description
⚡ Adaptive Performance	Auto-adjusts visual quality based on your FPS (3 tiers: normal/warning/critical)
🔧 Settings API Fix	Eliminated ~367,000 console deprecation warnings
🎯 Visibility Detection	Automatically pauses animations when tab is hidden
🧹 Pure DOM Snowflakes	Removed React dependency for lighter, faster snow effects
📱 Device-Aware	Snowflake count adapts to device capability (25-60 flakes)
🎨 Gradient Caching	Background themes now cache gradients for faster rendering
🔢 Sin Lookup Table	Pre-computed trigonometry for twinkle effects
♻️ Object Pooling	Reuses memory allocations to reduce garbage collection

---

✨ Features

🎄 Christmas Node Links Animated light effects along connections 6 color schemes: Traditional, Warm White, Cool White, Multicolor, Pastel, New Year's Eve 3 animation styles: Steady, Gentle Twinkle, Sparkle Adjustable size, glow, and flow direction Multiple link styles (spline, straight, linear, hidden)	❄️ Snowfall Effect Smooth CSS-based snowflake animations 5 color options: White, Ice Blue, Rainbow, Match Theme, New Year's Adjustable glow intensity GPU-accelerated rendering Auto-scales based on device performance
🌌 Dynamic Backgrounds Animated starry night sky 6 atmospheric themes: 🌌 Classic Night 🎄 Christmas Forest 🍬 Candy Cane Red ❄️ Frost Night 🍪 Gingerbread 🌑 Dark Night	⚡ Performance Features Adaptive quality — auto-reduces effects when FPS drops Smart pausing — animations freeze during workflow execution Tab detection — pauses when browser tab is hidden Device-aware — adjusts to hardware capabilities Object pooling — minimizes memory allocation Cached gradients — avoids recreating colors each frame

---

📦 Installation

Option 1: ComfyUI Manager (Recommended)

Search for "Christmas Theme" in ComfyUI Manager and click Install.

Option 2: Git Clone

cd ComfyUI/custom_nodes
git clone https://github.com/AEmotionStudio/ComfyUI-ChristmasTheme

Option 3: Manual Download

Download the latest release and extract to ComfyUI/custom_nodes/

After installation, restart ComfyUI to load the extension.

---

⚙️ Settings

All settings are accessible via ComfyUI Settings → Christmas Theme

🎄 Christmas Effects

Setting	Options	Default
Christmas Lights	On / Off	On
Color Scheme	Traditional, Warm White, Cool White, Multicolor, Pastel, New Year's Eve	Traditional
Light Effect	Steady, Gentle Twinkle, Sparkle, Candy Cane, Frost Trail, Aurora Flow	Gentle Twinkle
Light Size	1 - 10	3
Glow Intensity	0 - 30	20
Flow Direction	Forward / Reverse	Forward
Link Style	Spline, Straight, Linear, Hidden	Spline

🌌 Background Theme

Setting	Options	Default
Background Effect	On / Off	On
Color Theme	Classic Night, Christmas Forest, Candy Cane Red, Frost Night, Gingerbread, Dark Night	Classic
Shooting Stars	On / Off	On
Background Stars	On / Off	On
Party Mode	On / Off (Rave Stars)	Off
Fireworks	On / Off	Off
Mouse Trail Effect	None, Sparkler, Snowflake, Confetti, Stardust, Comet, Aurora, Ribbon, Crystal, Petals, Gifts, Candy, Magic Orb, Magic Wand, Nova, Bubbles, Embers, Lightning, Leaves, Wishes, Notes, Hearts	None
New Year Countdown	On / Off	Off

❄️ Snow Effect

Setting	Options	Default
Snow Effect	On / Off	On
Snowflake Color	White, Ice Blue, Rainbow, Match Theme, New Year's	White
Snowflake Glow	0 - 20	10

⚡ Performance

Setting	Options	Default
Pause During Render	Enabled / Disabled	Enabled

---

🔧 Technical Details

Component	Technology
Snowflakes	Pure DOM + CSS animations (GPU-accelerated)
Background	Canvas 2D with gradient caching
Node Links	Canvas override with adaptive rendering
Settings	Centralized cache with onChange callbacks

Performance optimizations include:

• O(1) frame time averaging
• Pre-allocated object pools
• Sin lookup tables for animations
• Page Visibility API integration
• Device capability detection

---

🤝 Contributing

Contributions are welcome! Whether it's bug reports, feature suggestions, or pull requests, your help is appreciated.

---

🔗 Connect with Æmotion (Developer)

• YouTube: AEmotionStudio
• GitHub: AEmotionStudio
• Discord: Join our community
• Website: aemotionstudio.org

☕ Support

If you find this project useful and wish to support its development, consider:

Your support helps dedicate more time to maintaining and improving this project, developing new features, and creating better documentation and tutorials.

---

Happy Holidays and a Happy New Year! 🎄