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

Note

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

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)