ComfyUI Christmas Theme 🎄✨

<div align="center">

🎄 ComfyUI Christmas Theme ✨

Transform your ComfyUI workspace into a winter wonderland

Dynamic backgrounds • Animated snowfall • Festive node connections • Interactive mouse effects

<p align="center"> <a href="#-features">Features</a> • <a href="#-installation">Installation</a> • <a href="#-settings">Settings</a> • <a href="#-technical-details">Technical Details</a> • <a href="#-contributing">Contributing</a> • <a href="CHANGELOG.md">Changelog</a> </p> </div>

---

What's New in v1.4.4 (January 15, 2026)

TypeScript Migration & Animation Fixes

• TypeScript Core: Completely rewrote the codebase in TypeScript for improved stability and maintenance.
• Robust Testing: Added comprehensive Unit (Vitest) and End-to-End (Playwright) standard testing suites.
• Smoother Animations: Fixed issue where background animations would pause when idle; added continuous render loop.
• New Year's Countdown: A festive countdown to 2027!
• Custom Snowflakes: Upload your own snowflake images (logos, emojis, or photos) to create unique snowfall effects.
• Mix Mode: Blend custom images with standard vector snowflakes for a varied, festive look.
• Performance Mode: Automatically detects low-fps situations and reduces particle count.
• Modular Design: Streamlined UI and optimized CSS for a smoother, faster experience.

📄 See CHANGELOG.md for the complete version history.

---

<img src="https://img.youtube.com/vi/pI6Kc-xebAQ/maxresdefault.jpg" width="100%">

<p align="center"><i>NotebookLM Overview: Exploring the features and updates of the Christmas Theme extension.</i></p>

✨ Features

<table> <tr> <td width="50%">

🎄 Christmas Node Links

• Animated light effects along connections
• 6 color schemes: Traditional, Warm White, Cool White, Multicolor, Pastel, New Year's Eve
• 6 animation styles: Steady, Gentle Twinkle, Sparkle, Candy Cane, Frost Trail, Aurora Flow
• Icicle-shaped bulbs with adjustable size and glow
• Multiple link styles (spline, straight, linear, hidden)

</td> <td width="50%">

❄️ Snowfall Effect

• Custom Snowflakes: Upload your own images, logos, or emojis
• Mix Mode: Blend custom images with standard snowflakes
• 8 unique SVG snowflake designs with JS animation
• 5 color options: White, Ice Blue, Rainbow, Match Theme, New Year's
• Adjustable glow intensity
• GPU-accelerated rendering
• Auto-scales based on device performance

</td> </tr> <tr> <td width="50%">

🌌 Dynamic Backgrounds

• Animated starry night sky with nebula clouds
• 6 atmospheric themes:
  • 🌌 Classic Night
  • 🎄 Christmas Forest
  • 🍬 Candy Cane Red
  • ❄️ Frost Night
  • 🍪 Gingerbread
  • 🌑 Dark Night

</td> <td width="50%">

✨ Interactive Mouse Effects

• 21 unique particle effects with physics simulation
• Sparklers, Confetti, Stardust, Aurora, and more
• Each effect has unique friction, gravity, and spawn behaviors
• Fully GPU-accelerated with object pooling

</td> </tr> <tr> <td width="50%">

🎆 New Year Celebration

• Live countdown timer to midnight
• Professional fireworks display with 6 explosion types
• Multi-stage finale triggered at 00:00:00

</td> <td width="50%">

⚡ 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

</td> </tr> </table>

---

📦 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

---

⚙️ Settings

All settings are accessible via ComfyUI Settings → Christmas Theme

<details> <summary><b>🎄 Christmas Effects</b></summary>

| 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 | | Bulb Shape | Classic Round, Icicle Point | Classic Round | | Light Size | 1 - 10 | 3 | | Glow Intensity | 0 - 30 | 20 | | Flow Direction | Forward / Reverse | Forward | | Link Style | Spline, Straight, Linear, Hidden | Spline |

</details> <details> <summary><b>🌌 Background Theme</b></summary>

| 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 |

</details> <details> <summary><b>❄️ Snow Effect</b></summary>

| Setting | Options | Default | |---------|---------|---------| | Snow Effect | On / Off | On | | Snowflake Color | Classic White, Ice Blue, Rainbow, Match Lights, New Year's Eve | Classic White | | Snowflake Shape | Random Mix, Classic, Simple, Bold, Custom Image, Mix Custom + Standard | Random Mix | | Snowflake Glow | 0 - 20 | 10 |

</details> <details> <summary><b>⚡ Performance</b></summary>

| Setting | Options | Default | |---------|---------|---------| | Pause During Render | Enabled / Disabled | Enabled |

</details>

---

🔧 Technical Details

| Component | Technology | |-----------|------------| | Snowflakes | Pure DOM + JS-driven CSS Transforms (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! Please see the CONTRIBUTING.md for guidelines on how to get started. Whether it's bug reports, feature suggestions, or pull requests, your help is appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

---

📝 License

This project is licensed under the GPL-3.0 License - see the LICENSE file for details.

---

<div align="center">

Developed by Æmotion Studio

</div>

---

<div align="center">

Happy Holidays and a Happy New Year! 🎄

</div>