community.general.irc – Send a message to an IRC channel or a nick

Note

This plugin is part of the community.general collection (version 4.2.0).

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install community.general.

To use it in a playbook, specify: community.general.irc.

Synopsis

  • Send a message to an IRC channel or a nick. This is a very simplistic implementation.

Requirements

The below requirements are needed on the host that executes this module.

  • socket

Parameters

Parameter Choices/Defaults Comments
channel
string
Channel name. One of nick_to or channel needs to be set. When both are set, the message will be sent to both of them.
color
string
    Choices:
  • none ←
  • white
  • black
  • blue
  • green
  • red
  • brown
  • purple
  • orange
  • yellow
  • light_green
  • teal
  • light_cyan
  • light_blue
  • pink
  • gray
  • light_gray
Text color for the message. ("none" is a valid option in 1.6 or later, in 1.6 and prior, the default color is black, not "none"). Added 11 more colors in version 2.0.

aliases: colour
key
string
Channel key
msg
string / required
The message body.
nick
string
Default:
"ansible"
Nickname to send the message from. May be shortened, depending on server's NICKLEN setting.
nick_to
list / elements=string
A list of nicknames to send the message to. One of nick_to or channel needs to be set. When both are defined, the message will be sent to both of them.
part
boolean
    Choices:
  • no
  • yes ←
Designates whether user should part from channel after sending message or not. Useful for when using a faux bot and not wanting join/parts between messages.
passwd
string
Server password
port
integer
Default:
6667
IRC server port number
server
string
Default:
"localhost"
IRC server name/address
style
string
    Choices:
  • bold
  • underline
  • reverse
  • italic
  • none ←
Text style for the message. Note italic does not work on some clients
timeout
integer
Default:
30
Timeout to use while waiting for successful registration and join messages, this is to prevent an endless loop
topic
string
Set the channel topic
use_ssl
boolean
    Choices:
  • no ←
  • yes
Designates whether TLS/SSL should be used when connecting to the IRC server

Examples

- name: Send a message to an IRC channel from nick ansible
  community.general.irc:
    server: irc.example.net
    channel: #t1
    msg: Hello world

- name: Send a message to an IRC channel
  local_action:
    module: irc
    port: 6669
    server: irc.example.net
    channel: #t1
    msg: 'All finished at {{ ansible_date_time.iso8601 }}'
    color: red
    nick: ansibleIRC

- name: Send a message to an IRC channel
  local_action:
    module: irc
    port: 6669
    server: irc.example.net
    channel: #t1
    nick_to:
      - nick1
      - nick2
    msg: 'All finished at {{ ansible_date_time.iso8601 }}'
    color: red
    nick: ansibleIRC

Authors

  • Jan-Piet Mens (@jpmens)

  • Matt Martz (@sivel)