node-red-loxone-icons

Custom Loxone-style icons for Node-RED subflows and nodes.

Overview

This package provides a collection of SVG icons designed for Loxone-style home automation blocks in Node-RED. The icons are automatically available to all nodes and subflows after installation.

Installation

Via Node-RED Palette Manager (Recommended)

1. Open Node-RED editor
2. Click Menu (☰) → Manage palette
3. Go to Install tab
4. Search for: node-red-loxone-icons
5. Click Install

Via npm

cd ~/.node-red
npm install node-red-loxone-icons

For Home Assistant Node-RED add-on:

cd /config
npm install node-red-loxone-icons

Restart Node-RED after installation.

Available Icons

| Icon | Filename | Use Case | |------|----------|----------| | 🎚️ | mixer.svg | Heating mixer (Mvco) / Valve controller | | ❄️🔥 | hvac.svg | HVAC / Climate control | | 📈 | heating-curve.svg | Heating curve calculator | | 🚰 | valve.svg | Valve control | | 🔌 | usb.svg | USB / Connection |

Usage

In Subflow JSON

When creating or editing a subflow, use the icon path format:

{
  "type": "subflow",
  "name": "My Heating Mixer",
  "icon": "node-red-loxone-icons/mixer.svg",
  "color": "#E2D96E"
}

In Custom Nodes

RED.nodes.registerType('my-custom-node', {
    category: 'home automation',
    icon: 'node-red-loxone-icons/hvac.svg',
    // ... other properties
});

Examples

Heating Mixer (Mvco):

"icon": "node-red-loxone-icons/mixer.svg"

HVAC Controller:

"icon": "node-red-loxone-icons/hvac.svg"

Heating Curve:

"icon": "node-red-loxone-icons/heating-curve.svg"

Icon Format

• Format: SVG (Scalable Vector Graphics)
• Optimized for Node-RED's icon system
• Consistent sizing and styling
• Compatible with all Node-RED themes

Compatibility

• Node-RED version: 3.0.0 or higher
• Works in:
  • Standalone Node-RED installations
  • Node-RED Docker containers
  • Home Assistant Node-RED add-on
  • All operating systems (Windows, Linux, macOS)

Troubleshooting

Icons not appearing after installation

1. Restart Node-RED - Icons are loaded during startup
2. Clear browser cache - Press Ctrl+Shift+R (or Cmd+Shift+R on Mac)
3. Delete old subflow - Remove old version from palette before importing new one
4. Check package installation:

   npm list node-red-loxone-icons

Wrong icon path

Make sure to use the full path including package name:

• ✅ Correct: node-red-loxone-icons/mixer.svg
• ❌ Wrong: mixer.svg
• ❌ Wrong: icons/mixer.svg

Contributing

Want to add more icons or improve existing ones?

1. Fork the repository
2. Add your SVG icons to the icons/ folder
3. Update README with icon descriptions
4. Submit a pull request

Icon Guidelines:

• SVG format only
• Keep file size under 5KB
• Use simple, clear designs
• Test in Node-RED before submitting

License

MIT License - See LICENSE file for details

Author

Created for the Node-RED and Loxone communities.

Links

• GitHub Repository
• npm Package
• Node-RED
• Loxone

Changelog

1.0.0 (2026-02-13)

• Initial release
• 5 custom icons: mixer, hvac, heating-curve, valve, usb
• Full Node-RED compatibility
• Support for Home Assistant Node-RED add-on