Skip to content

Display

Display settings for Halloy.

direction_arrows

Customize the arrows used for directional messages such as join, part, quit, kick, and CTCP messages.

left

Arrow shown for left-facing events.

toml
# Type: string
# Values: any string
# Default: "←"

[display]
direction_arrows = { left = "<" }

Arrow shown for right-facing events.

toml
# Type: string
# Values: any string
# Default: "→"

[display]
direction_arrows = { right = ">" }

truncation_character

Customize the character used to indicate a nickname was truncated.

toml
# Type: character
# Values: any character
# Default: "…"

[display]
truncation_character = '-'

decode_urls

Whether to automatically decode urls in messages, otherwise the URLs will appear exactly as sent. E.g. when enabled https://bücher.de will appear as https://bücher.dehttps://ja.wikipedia.org/wiki/%E9%87%8D%E9%9F%B3%E3%83%86%E3%83%88 will be displayed as https://ja.wikipedia.org/wiki/重音テト.

toml
# Type: boolean
# Values: true, false
# Default: true

[display]
decode_urls = false

nickname

Metadata to include when rendering user nicknames in message buffers.

toml
# Type: array of strings
# Values: "display-name", "pronouns", "color"
# Default: ["display-name"]

[display]
nickname = ["display-name"]

Examples:

toml
[display]
nickname = ["display-name", "pronouns"]

This renders as:

  • ["display-name"] -> Casper (casperstorm) when display name (Casper) is set, otherwise casperstorm
  • ["pronouns"] -> casperstorm (he/him) when pronouns are set, otherwise casperstorm
  • ["display-name", "pronouns"] -> Casper (casperstorm, he/him), omitting missing metadata
  • ["display-name"] -> Casper (casperstorm) when display name (Casper) is set, with text color as specified by the user's metadata

💡 Info

For configuring your own metadata values, see servers.<name>.metadata.

For configuring metadata key subscriptions, see metadata.

nicklist_nickname

Metadata to include when rendering user nicknames in the nicklist.

toml
# Type: array of strings
# Values: "display-name", "pronouns", "color"
# Default: ["display-name"]

[display]
nicklist_nickname = ["display-name"]

💡 Info

For configuring your own metadata values, see servers.<name>.metadata.

For configuring metadata key subscriptions, see metadata.

adapt_metadata_colors

Whether to adapt metadata colors to the configured theme (only applies if "color" has been specified for nickname or nicklist_nickname). Will modify colors from what the user has specified as their color metadata to ensure legibility and better fit in with the configured theme. If set to "illegible" then only colors determined to not be readable will be modified.

toml
# Type: string
# Values: "all", "illegible", "none"
# Default: "all"

[display]
adapt_metadata_colors = "illegible"

💡 Info

For configuring your own metadata values, see servers.<name>.metadata.

For configuring metadata key subscriptions, see metadata.