irc - Send a message to an IRC channel

Synopsis

Requirements

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

  • socket

Parameters

Parameter Choices/Defaults Comments
channel
required
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
    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.
key
(added in 1.7)
Channel key
msg
required
The message body.
nick Default:
ansible
Nickname to send the message from. May be shortened, depending on server's NICKLEN setting.
nick_to
(added in 2.0)
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
bool

(added in 2.0)
    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
Server password
port Default:
6667
IRC server port number
server Default:
localhost
IRC server name/address
style
(added in 2.0)
    Choices:
  • bold
  • underline
  • reverse
  • italic
Text style for the message. Note italic does not work on some clients
timeout
(added in 1.5)
Default:
30
Timeout to use while waiting for successful registration and join messages, this is to prevent an endless loop
topic
(added in 2.0)
Set the channel topic
use_ssl
bool

(added in 1.8)
    Choices:
  • no ←
  • yes
Designates whether TLS/SSL should be used when connecting to the IRC server

Examples

- irc:
    server: irc.example.net
    channel: #t1
    msg: Hello world

- local_action:
    module: irc
    port: 6669
    server: irc.example.net
    channel: #t1
    msg: 'All finished at {{ ansible_date_time.iso8601 }}'
    color: red
    nick: ansibleIRC

- 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

Status

This module is flagged as stableinterface which means that the maintainers for this module guarantee that no backward incompatible interface changes will be made.

Maintenance

This module is flagged as community which means that it is maintained by the Ansible Community. See Module Maintenance & Support for more info.

For a list of other modules that are also maintained by the Ansible Community, see here.

Author

  • “Jan-Piet Mens (@jpmens)”
  • “Matt Martz (@sivel)”

Hint

If you notice any issues in this documentation you can edit this document to improve it.