Version 1.1.1 (Bugfix)

Message Format

The integration now provides two ways to access message information:

1. Legacy format (maintained for compatibility):

event_data:
  message: "The message content"
  sender: "Nick!user@host"
  channel: "#channel"
  type: "public"

2. New structured format:

event_data:
  message: "The message content"
  sender: "Nick!user@host"  # Maintained for compatibility
  nick: "Nick"
  host: "user@host"
  channel: "#channel"
  type: "public"
  timestamp: "HH:MM:SS"

Full Changelog: v1.1.0...v1.1.1

Version 1.1.0

New Features

• Structured message format with timestamp
• Separate fields for nick and host in messages
• Improved message display in Home Assistant

Example Usage

type: vertical-stack
cards:
  - type: markdown
    content: |
      ![IRC Icon](/local/icons/icons8-chat.gif)  Messages:
    card_mod:
      style: |
        ha-card {
          background: rgba(0, 0, 0, 0.7) !important;
          color: white !important;
          box-shadow: none !important;
          padding: 8px !important;
        }
  - type: custom:mushroom-template-card
    primary: IRC Messages
    secondary: "{{ states('sensor.irc') }}"
    icon: mdi:chat
    card_mod:
      style: |
        ha-card {
          background: rgba(0, 0, 0, 0.7) !important;
          color: white !important;
          box-shadow: none !important;
          padding: 8px !important;
        }
    template: |
      {% set messages = state_attr('sensor.irc', 'messages') %}
      {% if messages %}
        {% for msg in messages %}
          <div style="margin-bottom: 8px; border-bottom: 1px solid rgba(255,255,255,0.1); padding-bottom: 4px;">
            <div style="color: #888; font-size: 0.8em;">{{ msg.timestamp }}</div>
            <div>
              <strong style="color: #4CAF50;">{{ msg.nick }}</strong>
              {% if msg.host %}
                <span style="color: #888; font-size: 0.8em;">({{ msg.host }})</span>
              {% endif %}
            </div>
            <div style="margin-left: 8px;">{{ msg.message }}</div>
          </div>
        {% endfor %}
      {% else %}
        No messages yet
      {% endif %}

Full Changelog: v1.0.0...v1.1.0

v1.0.0

Release Notes

v1.0.0 (2024-04-12)

Features

• Initial release of the Home Assistant IRC integration
• Support for connecting to IRC servers with or without SSL
• Bidirectional communication between IRC and Home Assistant
• Automatic reconnection on connection loss
• Support for sending and receiving messages
• Integration with Home Assistant automations
• HACS installation support

Improvements

• Robust error handling and logging
• Thread-safe message handling
• Automatic channel prefix handling (#)
• Support for private messages
• Configurable nickname and channel

Bug Fixes

• Fixed issue with message sending when channel not specified
• Improved connection stability
• Fixed thread handling for reactor operations

Version 0.1.5 (2025-04-08)

Bug Fixes

• Fixed shutdown error when transport is None
• Improved connection state management
• Added proper transport handling in IRC client
• Added service_identity dependency for proper SSL/TLS support

Technical Details

• Added service_identity>=23.1.0 for proper SSL/TLS certificate verification
• Improved SSL/TLS security with proper hostname verification
• Full support for secure IRC connections

Dependencies

• Twisted>=22.10.0
• service_identity>=23.1.0

Version 0.1.4 (2025-04-08)

Breaking Changes

• Switched from pydle to Twisted as IRC library
  • Reason: Better support for newer Python versions and more mature library
  • Impact: Existing configurations will still work, but requires Home Assistant restart
  • Migration: No migration needed, but recommended to remove and re-add the integration

New Features

• Improved error handling and reconnection logic
• Added support for both private and public messages
• Added a maximum limit for stored messages (100 messages)

Technical Details

• Using Twisted>=22.10.0 as IRC library
• Full support for Python 3.13
• Improved connection and message handling
• More robust error handling

Dependencies

• Twisted>=22.10.0

Version 0.1.3 (2025-04-08)

Changed

• Updated documentation link to correct repository
• Updated codeowners to correct username

Version 0.1.2 (2025-04-08) - Withdrawn

Critical Issues

• Version was withdrawn due to Home Assistant crash
• Issues with irc3 library and Python 3.13

Version 0.1.1 (2025-04-08)

New Features

• Initial release of IRC Home Assistant Integration
• Support for connecting to IRC servers
• Support for SSL encryption
• Support for server passwords
• Support for incoming messages
• GUI configuration

Technical Details

• Using pydle>=0.9.4 as IRC library
• Supports both private and public messages
• Shows connection status in Home Assistant
• Stores the last 10 messages

Dependencies

• pydle>=0.9.4

Stability Improvements

• Added comprehensive error handling
• Implemented automatic reconnection with exponential backoff
• Limited message storage to prevent memory issues
• Added proper cleanup on shutdown
• Improved connection state management

Known Issues

• Compatibility issue with Python 3.13:
  • Error: ImportError: cannot import name 'coroutine' from 'asyncio'
  • Cause: The coroutine decorator was removed from asyncio in Python 3.13
  • Workaround: Use Python 3.12 or earlier until pydle library is updated
  • Status: Investigating alternative solutions

Installation Methods

• Added HACS installation support
• Maintained manual installation option

Documentation

• Added comprehensive documentation in multiple languages:
  • English (default)
  • Nordic languages:
    • Norwegian
    • Swedish
    • Danish
    • Finnish
  • Major languages:
    • Spanish
    • French
    • German
    • Chinese (Simplified)
    • Japanese
• Updated installation instructions for HACS
• Added troubleshooting guide
• Added contribution guidelines

Technical Details

• Compatible with Home Assistant 2024.1.0 and later
• Supports sensor and binary_sensor domains
• Local push IoT class
• Persistent directory support for user files
• Maximum of 100 stored messages
• Automatic reconnection with 5-minute maximum retry interval

Dependencies

• pydle>=0.9.4 (requires Python 3.12 or earlier)
• Home Assistant Core 2024.1.0 or later
• HACS (optional, for easy installation)