Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Server Messages

Server messages are messages sent from an IRC server.

Example

# Hide all join messages except for #halloy channel: [buffer.server_messages.join] exclude = "*" include = { channels = ["#halloy"] } # Hide all part messages [buffer.server_messages.part] enabled = false

Types

Event TypeDescription
change_hostMessage is sent when a user changes host
change_modeMessage is sent when a mode is set
change_nickMessage is sent when a user changes nick
change_topicMessage is sent when a channel topic is changed
joinMessage is sent when a user joins a channel
kickMessage is sent when a user is kicked from a channel
monitored_offlineMessage is sent when a monitored user goes offline
monitored_onlineMessage is sent when a monitored user goes online
partMessage is sent when a user leaves a channel
quitMessage is sent when a user closes the connection to a channel or server
standard_reply_failMessage is sent when a command/function fails or an error with the session
standard_reply_noteMessage is sent when there is information about a command/function or session
standard_reply_warnMessage is sent when there is feedback about a command/function or session
topicMessage is sent when the client joins a channel to inform them of the topic (does not include message sent when topic changes)
wallopsMessage is sent by operators to all users with mode +w on the network

Configuration

enabled

Control if internal message type is enabled.

# Type: boolean # Values: true, false # Default: true [buffer.server_messages.<server_message>] enabled = true

smart

Only show server message if the user has sent a message in the given time interval (seconds) prior to the server message.

# Type: integer # Values: any non-negative integer # Default: not set [buffer.server_messages.<server_message>] smart = 180

exclude

Exclusion conditions in which the server message will be hidden. Inclusion conditions will take precedence over exclusion conditions. You can also exclude all conditions by setting to "all" or "*".

# Type: inclusion/exclusion conditions # Values: user, channel, & server inclusion/exclusion conditions # Default: not set [buffer.server_messages.<server_message>] exclude = "*"

include

Inclusion conditions in which the server message will be shown. Server messages will be shown in all conditions (when enabled)W unless explicitly excluded, so this setting is only relevant when combined with the exclude setting.

# Type: inclusion/exclusion conditions # Values: user, channel, & server inclusion/exclusion conditions # Default: not set [buffer.server_messages.<server_message>] include = { channels = ["#halloy"] }

dimmed

Dim condensed server message. Either automatically, based on text/background colors (by setting to true), or specify a dimming value in the range 0.0 (transparent) to 1.0 (no dimming).

# Type: bool or float # Values: true, false, or float # Default: true [buffer.server_messages.<server_message>] dimmed = true

username_format

Adjust the amount of information displayed for a username in server messages. If you choose "short", only the nickname will be shown. If you choose "full", the nickname, username, and hostname (if available) will be displayed.

💡 Not all server messages uses this setting.

# Type: string # Values: "full", "short" # Default: "full" [buffer.server_messages.<server_message>] username_format = "full"

Condense

Condense multiple consecutive server messages into a single abbreviated message