POEZIO.CFG(7)

📦

version 0.18 · 2 versions

0.18 · nixpkgs unstable (latest)
0.16 · nixos 26.05

💖 NAME 💖

okay so bestie, welcome to poezio.cfg(7) from the Poezio manual — literally the Poezio Configuration File page, and it’s giving “important paperwork but make it cute.” 🎀

The config lives at ~/.config/poezio/poezio.cfg. On its first startup, poezio will create that file (and the directories around it) with the default configuration. You can edit that file manually or use the /set <#term-set> command to edit some of its values directly from poezio. This file is also used to configure key bindings, but that’s explained in the Keyboard Shortcuts <#keys-page> documentation file. slay.

The configuration is read at each startup or when the /reload command is issued, and it is updated after every /set command. lowkey important.

This configuration file requires all global options to be in a section named [Poezio]. Some other options can be in optional sections and will apply only to tabs having the option’s name.

An option is formatted like this:

option = value

careful bestie: an empty value doesn’t mean that the default value will be used. That’s just an empty value. To use the default value, just comment or remove the option entirely. no cap.

Here is a list of all the available configuration options, their meaning and their default value. ✨

✨ GLOBAL SECTION OPTIONS ✨

These options have a sense when they are in the global section. Some of them can also be in an optional configuration section, see the next section of this documentation.

The options here are separated thematically for convenience but they all go into the main config section. yes bestie, all of them. 💅

🔒 Security

Options pertaining to security, such as TLS encryption <#security-settings> and certificate validation. protective queen energy.

ca_cert_path — Default value: [empty]. Path to the certificate of the Certification Authority. As some services may keep different certificates, it is an alternative to the Trust On First Use model provided by the certificate option. This option is not affected by ignore_certificate, and both checks may be active at the same time. 🎀
certificate — Default value: [empty]. The SHA-2 fingerprint of the SubjectPublicKeyInfo of the SSL certificate as a hexadecimal string. You should not touch it, except if you know what you are doing. Note: the fingerprint was previously a fingerprint of the whole certificate, while it is now only of the SubjectPublicKeyInfo, which persists across LetsEncrypt renewals, and therefore reduces the noise generated by the alert dialog. versionchanged:: 0.12.
ciphers — Default value: HIGH+kEDH:HIGH+kEECDH:HIGH:!PSK:!SRP:!3DES:!aNULL. The TLS cipher suites allowed, in OpenSSL format (https://www.openssl.org/docs/apps/ciphers.html#CIPHER_LIST_FORMAT). Modify this if you know what you are doing, see the Ciphers <#ciphers> dedicated section for more details. 🔥
force_encryption — Default value: true. If set to true, all connections will use TLS by default. Only turn this to false if you cannot connect to your server, and do not care about your password or the privacy of your communications. like… bestie, please care. 😭
ignore_certificate — Default value: false. Skip certificate validation on connection when true. Useful when you are in anonymous mode and changing servers often. Dangerous in other cases, from a security perspective. 💀
tls_verify_cert — Default value: true. If false, skip certificate PKI validation (and hostname checking). Useful when testing things out on a local network, dangerous otherwise. 🙈

🫶 Account

Options related to account configuration, nickname… the whole “who am I on this server” vibe.

alternative_nickname — Default value: [empty]. If you want poezio to join the room with an alternative nickname when your nickname is already in use in the room you wanted to join, put a non-empty value. If you don’t, poezio won’t join the room. This value will be added to your nickname to create the alternative nickname. For example, if you set "_", and wanted to use the nickname "john", your alternative nickname will be "john_". cute.
certfile — Default value: [empty]. Path to a PEM certificate file to use for certificate authentication through SASL External. If set, keyfile MUST be set as well in order to login. 🎀
custom_host — Default value: [empty]. A custom host that will be used instead of the DNS records for the server (anonymous or the jid’s) defined above. You should not need this in a “normal” use case. no cap.
custom_port — Default value: [empty]. A custom port to use instead of the 5222. This option can be combined with custom_host. You should not need this in a “normal” use case.
default_muc_service — Default value: [empty]. If specified, will be used instead of the MUC service provided by the user domain. Added in version 0.13. ✨
default_nick — Default value: [empty]. The nick you will use when joining a room with no associated nick. If this is empty, the $USER environment variable will be used. 🦋
jid — Default value: [empty]. Jabber identifier. Specify it only if you want to connect using an existing account on a server. This is optional and useful only for some features, like room administration or nickname registration. The server option will be ignored if you specify a JID (Jabber id). It should be in the form <nickname@server.tld> or <nickname@server.tld/resource>.
keyfile — Default value: [empty]. Path to a PEM private key file to use for certificate authentication through SASL External. If set, certfile MUST be set as well in order to login.
open_all_bookmarks — Default value: false. If this option is set to true, all remote bookmarks, even those that do not have autojoin, will be opened on startup. (the tabs without autojoin will not be joined) 👀
password — Default value: [empty]. A password is needed only if you specified a jid. It will be ignored otherwise. If you leave this empty, the password will be asked at each startup, which is recommended. bestie, do that.
rooms — Default value: [empty]. The rooms you will join automatically on startup, with associated nickname or not.

Format : room@server.tld/nickname:room2@server.tld/nickname2.

The default_nick option will be used if "/nickname" is not specified. 🎀

server — Default value: anon.jeproteste.info. The server to use for anonymous authentication; make sure it supports anonymous authentication. Note that this option doesn’t do anything at all if you’re using your own JID.
status — Default value: [empty]. The status (show) poezio will send when connecting. It can be available, dnd, chat, xa or away. Nothing or an invalid value will mean available. 💅
status_message — Default value: [empty]. The status message poezio will send when connecting.

🌈 Connectivity

Options about general or chatroom connectivity. Reconnecting does not work very well, but you will at least want to know when you get disconnected. lowkey real.

auto_reconnect — Default value: true. Auto-reconnects you when you get disconnected from the server. Poezio will try to reconnect forever, until it succeeds. persistent icon behavior. 💪
autorejoin — Default value: false. Set to true if you want to automatically rejoin the room when you’re kicked. 🫶
autorejoin_delay — Default value: 5. Set to the number of seconds before reconnecting after getting kicked. 0, a negative value, or no value means you reconnect instantly. This option only works if autorejoin is enabled.
connection_check_interval — Default value: 300. A ping is sent to the server every N seconds, N being the value of that option. Change this to a low value if you want to know quickly when you are disconnected, and to a very high value if bandwidth matters so much that you can’t afford 100 bytes/minute, or if you don’t want to waste your battery by waking up the TCP connection too often. Disable this ping altogether by setting this value to 0. 🔥
connection_timeout_delay — Default value: 30. The timeout delay of the ping referenced above, 30 should really be fine, but if your network is really unstable, it can be set higher or lower, depending of your preference.
whitespace_interval — Default value: 300. Interval of the whitespace keepalive sending to the server. 300 should be fine, but change it if some services have a stricter policy on client inactivity. ✨

🦋 XMPP features

These options enable, disable, or allow to configure the behavior of some non-essential XMPP features. There is a dedicated page to understand what is carbons <#carbons-details> or user activity/gaming/mood/tune <#pep-details>. iykyk.

ack_message_receipts — Default value: true. Acknowledge message receipts requested by the other party. polite queen behavior. 💅
enable_avatars — Default value: true. Display contact avatars in the roster. 🎀
enable_carbons — Default value: true. Set this to false to disable Message Carbons (XEP-280), which allows transparent message delivery from and to other resources with carbons enabled. There should be no reason to disable this except if you encounter issues with your server. no cap.
enable_css_parsing — Default value: true. When parsing XHTML-IM content, only keep semantic elements, and not inline text styles. Only useful if enable_xhtml_im is enabled.
enable_reactions — Default value: true. Set to false if you no not want to display message reactions. Disabling reactions only takes effect on restart. 🙈
enable_smacks — Default value: false. Stream Management (XEP-0198) is an extension designed to improve the reliability of XMPP in unreliable network conditions (such as mobile networks). It can however increase bandwidth usage. It also requires server support. ⭐
enable_user_nick — Default value: true. Set to false if you don’t want your contacts to hint you their identity.
enable_xhtml_im — Default value: true.

XHTML-IM is this XMPP extension that lets people send messages with XHTML and CSS formatting inside them — so yeah, colored text, that whole thing. Set it to true if you want to actually see the colored (and otherwise formatted) messages. 💅

go_to_previous_tab_on_alt_number — Default value: false

Set this to true and pressing Alt+x (where x is a number) while you're already sitting on tab number x yeets you back to the tab you were on before. Otherwise? You just stay put on the same tab, no drama. 🌀

group_corrections — Default value: true

Lets a message "correct" (read: replace) another message in the display, but only if the sender actually meant it that way. See Message Correction <#correct-feature> for the full tea. ✨

request_message_receipts — Default value: true

Asks for message receipts when you send messages — except in groupchats, where it does not. 🫶

send_chat_states — Default value: true

When true, chat states get sent to whoever you're talking to. Chat states are like "hey I'm typing rn" or "ok I closed the tab", that genre of message. 💬

Set it to false if you don't want people knowing that stuff. But heads up: you won't receive your contacts' chat states if you don't send yours. Mutual or nothing, bestie. 🙈

send_os_info — Default value: true

When true, info about the Operating System you're running gets sent whenever anyone asks for it. Set to false if you don't want people knowing that. 🖥️

Note that this info will not be sent if send_poezio_info is False.

send_poezio_info — Default value: true

When true, info about the software (name and version) gets sent if anyone requests it. Set to false if you don't want people knowing that. 🌸

send_time — Default value: true

When true, your current time gets sent if someone asks. Set to false if you don't want people knowing that either. ⏰

synchronise_open_rooms — Default value: true

If false, poezio will not store the state of the rooms you currently have open — so if you leave a room and restart poezio (or boot up another client), it'll reopen it.

If true, /join creates a bookmark with autojoin=true, and /leave removes that bookmark. 🎀

This was previously named bookmark_on_join.

use_bookmark_method — Default value: [empty]

The method poezio uses to store your bookmarks online. Possible values are: privatexml, pep. You should not have to edit this in a normal use case, iykyk. 🔧

use_pep_nick — Default value: true

Uses the nickname broadcasted by the user when set to true — but only if none has already been set manually. 👑

use_remote_bookmarks — Default value: true

Use this option to force the use of local bookmarks if needed. Anything that isn't "false" counts as true, bestie. 🦋

🦋 VISUAL INTERFACE 🦋

All of these options change how poezio looks — either by removing bits of the interface, adding bits, changing the ordering of stuff, or changing the way messages get displayed. Makeover era. 💖

autocolor_tab_names — Default value: false

If true, it uses deterministic coloration for tab names or tab numbers in the activity bar, using Consistent Color Generation (XEP-0392). 🌈

create_gaps — Default: false

Creates gaps when you move a tab or close one. Turning this on helps you keep your tabs in the same place while poezio is running. (Gaps are not created when the closed tab is the last one.) 🕳️

display_user_color_in_join_part — Default value: true

If true, the color of the nick gets used in chatroom information messages instead of the theme's default color. 💅

enable_vertical_tab_list — Default value: true

If true, a vertical list of tabs — with their names — shows up on the left of the screen. Otherwise it's a horizontal bar with just the tab numbers, sitting above the input bar. 📋

filter_info_messages — Default value: [empty]

A list of words or sentences separated by colons (":"). Any informational messages (described above) that contain at least one of those values will not be shown. 🙅‍♀️

hide_exit_join — Default value: -1

Exact same thing as hide_status_change, except it's about the quit messages, and it'll only be hidden if the value is 0.

Default setting means: all quit and join notices will be displayed. 👋

hide_status_change — Default value: 120

Set a number here. The join AND status-change notices get displayed according to this number. 📊

-1: the notices will ALWAYS be displayed
0: the notices will NEVER be displayed
n: on any other number, the notices will only be displayed if the user involved has talked since the last n seconds

If the value is incorrect, -1 is assumed.

Default setting means status changes won't be displayed unless the user talked in the last 2 minutes. ⏳

hide_user_list — Default value: false

Whether to hide the list of users in the MultiUserChat tabs or not. Genuinely useful if you wanna copy/paste the content of the buffer, or if you just want to gain space. 🫶

highlight_on — Default value: [empty]

A list of words (separated by a colon (:)) that get highlighted if someone says them in a room. 🔥

information_buffer_popup_on — Default value: error roster warning help info

Some informational messages (an error, a contact getting connected, etc.) get added to the information buffer sometimes. These settings can make that buffer grow temporarily so you can read the info when it shows up. 👀

A list of message types that should make the information buffer grow. Possible values: error, roster, warning, info, help.

information_buffer_type_filter — Default value: [empty]

Some informational messages (an error, a contact getting connected, etc.) get added to the information buffer.

A list of message types separated by colons (":") that should never be displayed in the information buffer. Possible values: error, roster, warning, info, help. 🚫

max_nick_length — Default value: 25

The maximum length of the nickname displayed in the conversation window. Nicks that are too long get truncated and have a … appended to them. ✂️

muc_colors (section) — Default: [empty]

Fixes a color for a nick. Whenever such a nick shows up in a chatroom, it'll be displayed in that color. This color won't be changed by the recolor command. 🎨

nick_color_aliases — Default value: true

Automatically searches for the color of nick aliases. For example, if nick is set to red, then _nick, nick_, _nick_, nick__ etc. all get the same color. Alias colors are checked first, so you can still have different colors for nick_ and nick. 🧚

popup_time — Default value: 4

How long the message stays visible in the information buffer when it pops up. If the message takes more than one line, the popup stays visible two more seconds per additional line. ⏲️

roster_group_sort — Default value: name

How to sort the contact list groups. The principles are the same as roster_sort (see below).

Available methods are:

reverse: reverse the current sorting
name: sort by group name (alphabetical order)
fold: sort by unfolded/folded
connected: sort by number of connected contacts
size: sort by group size
none: put the "none" group (if any) at the end of the list

roster_show_offline — Default value: false

Set this to true if you want to display the offline contacts too. 💤

roster_sort — Default value: jid:show

How you want contacts sorted inside the contact list groups. The given methods are used sequentially (left to right), so the last one is the one on the far right. ➡️

Available methods are:

reverse: reverse the current sorting
jid: sort by JID (alphabetical order)
show: sort by show (available/away/xa/…)
name: sort by given name (if there's no name, then the bare jid is used)
resource: sort by resource number
online: sort by online presence (online or not)

Those methods can be arranged however you like, and they have to be separated by colons (":"). If you've got more than 3 or 4 chained sorting methods, your sorting is most likely inefficient, ngl. 💀

show_composing_tabs — Default value: direct

Highlights tabs where the last activity was a "composing" chat state — meaning the contact is currently typing. ⌨️

Possible values are:

direct: highlight only in one-to-one chats (equiv. of private & conversation)
private: highlight only in private chats inside chatrooms
conversation: highlight only in chats with contacts or direct JIDs
muc: highlight only in chatrooms
true: highlight all possible tabs (equiv. of muc & private & conversation)
false or any other value: don't highlight anything

show_inactive_tabs — Default value: true

If you want to show all the tabs in the Tab bar — even the ones with no activity — set this to true. Else, set it to false. 📑

show_jid_in_conversations — Default value: true

If false, the JID of the contact will not be displayed in the information window in conversation tabs. 🙈

show_muc_jid — Default value: false

If false, poezio first displays the bookmark name — or, if that's empty, the user part of the address (the bit before the @) — when showing the chatroom tab name. So poezio@muc.poez.io gets shortened to poezio, unless this option is set to true. This is only used if use_tab_nicks is set to true. ✂️

show_roster_jids — Default value: true

…so flip that to false and the contact list drops the JIDs and keeps only the contact names 🫶 — but bestie, if a contact has no name, the JID still shows up. Nobody gets ghosted entirely, periodt.

show_roster_subscriptions — default value: [empty]. This one picks how much subscription info gets a little char in the contact list. Your menu of options:
- all → show all subscriptions, the whole buffet 💅
- incomplete → show from, to and none
- one of from, to, none and both → show only that one
- no value, or literally any other value → it's disabled, we're off duty
show_s2s_errors — default value: true. Do s2s errors show up in the contact list or not? That's it, that's the toggle 🌸
show_tab_names — default value: false. Want the tab name to show in the bottom Tab bar? Set this to true and watch it slay.
show_tab_numbers — default value: true. Hate the numbers in the bottom Tab bar? Set this to false. ⚠️ But note: if show_tab_names and show_tab_numbers are both false, the numbers are still displayed anyway. The bar said what it said 💀
show_timestamps — default value: true. Timestamp before every message, or no? Your call, main character.
theme — default value: [empty]. The name of the theme file (no .py extension, bestie) that gets used. That file needs to live in the themes_dir directory. If the file isn't found (or you didn't specify a filename at all), the default theme steps in instead ✨
themes_dir — default value: [empty]. If themes_dir isn't set, themes get searched for in $XDG_DATA_HOME/poezio/themes, i.e. in ~/.local/share/poezio/themes/. So yeah, you should specify the directory you actually want to use instead. This directory gets created at startup if it doesn't already exist 🎀
unique_prefix_tab_names — default value: false. If this and show_tab_names are both true, only the shortest unique prefix of each tab name shows up instead of the full name. This declutters the interface when you've got many tabs on screen, without making you use numbers (which can completely change due to reordering — chaos 😭). Takes precedence over use_tab_nicks.
use_tab_nicks — default value: true. Every tab has a name and a nick — for a contact that's its name in the contact list, and for a private conversation it's the nickname in the chatroom. Set this to true if you want those shown instead of the contact's jid 💜
user_list_sort — default value: desc. Set it to desc and chatroom users are displayed top to bottom in the list; set it to asc and they're displayed bottom to top. Up is down, basically 🦋
vertical_tab_list_size — default value: 20. Horizontal size of the vertical tab list.
vertical_tab_list_sort — default value: desc. Set to desc and tabs display top to bottom in the list; set to asc and they display bottom to top. Same vibe, different axis ✨

🫶 User Interaction 🫶

Options that change the behavior of poezio in a non-visual manner. No glow-ups here, just vibes and behavior.

add_space_after_completion — default value: true. Adds a space after a completion in the middle of the input — note: not at the start of it. Mid-sentence courtesy space, iykyk.
after_completion — default value: ,. What gets put after the name when you use autocompletion at the beginning of the input. A space is always added after that, no matter what you put here 🎀
beep_on — default value: highlight private invite disconnect. The terminal can beep on various events — just put the events you want in a list, separated by spaces. The events can be:
- highlight → when you are highlighted in a chatroom 👑
- private → when a new private message is received, from your contacts or from someone in a chatroom
- message → any message from a chatroom
separate_history — default value: false. Set to true and the input history of the same nature won't be shared between tabs (as in weechat). Your tabs get their own little diaries 🦋
words — default value: [empty]. Your personal dictionary of words you use often, the ones you want to complete through recent-words completion. They must be separated by a colon (:). That completion works in chatrooms, private conversations, and direct conversations. Word hoard status 💅

📓 Logging 📓

Options related to logging. The receipts, literally.

log_dir — default value: [empty]. If log_dir isn't set, logs get saved in $XDG_DATA_HOME/poezio/logs, i.e. in ~/.local/share/poezio/logs/. So you should specify the directory you want to use instead. This directory will be created if it doesn't exist 🌸
log_errors — default value: true. Logs all the tracebacks and errors of poezio/slixmpp in log_dir/errors.log by default. false disables this option 😭
mam_sync — default value: true. If true, it'll try to fill local logs with missing MAM history when you open a tab or join a room. Filling in the blanks, bestie.
mam_sync_limit — default value: 2000. Maximum number of messages to fetch on a MAM sync. Heads up: this affects performance when joining rooms with a huge backlog for the first time, or after a long period away 🔥
use_log — default value: true. Set to false if you don't want any message written to the disk. Full incognito era 🙈

🧩 Plugins 🧩

This sections references the configuration of the plugin system; for more details, go to the dedicated page <#plugins-doc>.

plugins_autoload — default value: [empty]. Colon-separated list of plugins to load on startup. Your day-one squad 🫶
plugins_conf_dir — default value: [empty]. If plugins_conf_dir isn't set, plugin configs get loaded from $XDG_CONFIG_HOME/poezio/plugins. You can specify another directory to use — it'll be created if it doesn't exist 🎀
plugins_dir — default value: [empty]. If plugins_dir isn't set, plugins are loaded from the plugins/ dir of the poezio install directory, then $XDG_DATA_HOME/poezio/plugins. You can specify another directory to use. It will be created if it doesn't exist ✨

🌈 Other 🌈

exec_remote — default value: false. Set this to true and poezio will try to send the commands to a FIFO instead of executing them locally. This is meant to be used in conjunction with ssh and the daemon.py file. See the /link <#term-link> documentation for details 👀
extract_inline_images — default value: true. Some clients send inline images as base64 inside messages, which just results in an useless wall of text — not the aesthetic. If this is true, that base64 text gets replaced with a file:// link to the image file extracted in tmp_image_dir or $XDG_CACHE_HOME/poezio/images by default, which is usually ~/.cache/poezio/images. Un-wall-of-text-ified 🦋
lang — default value: en. The lang some automated entities will use when replying to you. Yes, the bots are multilingual 💅
lazy_resize — default value: true. Defines whether all tabs are resized at the same time (if set to false) or whether they're really resized only when needed (if set to true). true should be the most comfortable value — comfy era.
max_lines_in_memory — default value: 2048. Configures the maximum number of lines (for each tab) that can be kept in memory. If poezio is eating too much memory, lower these values 😭
max_messages_in_memory — default value: 2048. Configures the maximum number of messages (for each tab) that can be kept in memory. If poezio is eating too much memory, lower these values.
remote_fifo_path — default value: ./. The path of the FIFO used to send the commands (see the exec_remote option). Poezio will try to create a poezio.fifo file in this directory.
save_status — default value: true. Saves the status automatically in the status and status_message options. Your mood, remembered 🔥
send_initial_presence — default value: true. Sends initial presence (normal behaviour). If false, you will not send nor receive any presence that isn't directed (through /presence <#term-presence>) or sent by a chatroom. ⚠️ Setting this to false means you go quiet — no broadcast vibes, bestie.
tmp_image_dir — default value: [empty]. The directory where poezio will save the images it receives, if extract_inline_images is set to true. If unset, poezio defaults to $XDG_CACHE_HOME/poezio/images, which is usually ~/.cache/poezio/images 🎀

✨ OPTIONAL SECTION OPTIONS ✨

okay bestie, so these are the options that only apply to specific JIDs 💅. An optional section is literally named after a JID, and the options inside it only apply for that JID. Like, if an option shows up in a section named [<user@example.com>], it only applies for the conversations with <user@example.com> — no cap.

If an option appears in a section named [@example.com], it applies for all the conversations with people @example.com, except when the option is already defined in a [<user@example.com>] section.

The priority of settings is thus like this: <user@example.com> > @example.com > Poezio (more specific to less specific) 👑

Also note that some of these options can also appear in the global section, and then they’ll be used as a fallback value when no JID-specific option is found 🫶.

Here’s the little example so it clicks:

[Poezio]
foo = false
[user@example.com]
foo = true
[@example.com]
bar = false

autorejoin — Default value: false. Set to true if you want to automatically rejoin the room when you’re kicked or banned 😭.
autorejoin_delay — Default value: 5. Set to the number of seconds before reconnecting after getting kicked or banned. 0, a negative value, or no value means instant reconnection. This option only works if autorejoin is true.
disable_beep — Default value: false. Disable the beeps triggered by this conversation. Works in chatroom tabs, private messaging tabs, and conversation tabs 🔇.
display_user_color_in_join_part — Default value: true. If set to true, the color of the nick will be used in chatroom information messages, instead of the default color from the theme 🌈.
eval_password — Default value: [empty]. A command which execution will retrieve the password from a password manager. E.g. with secret-tool and the gnome keyring:

# Storing (to do beforehand)
secret-tool store --label="My jabber password" xmpp your@jid

# Retrieving (this should be the value of the option)
secret-tool lookup xmpp  your@jid

Note: This will only be used if the password option is empty 🫶.

hide_exit_join — Default value: -1. Exact same thing as hide_status_change, except that it concerns the quit messages, and that it will be hidden only if the value is 0. Default setting means all quit and join notices will be displayed 👀.
hide_status_change — Default value: 120. Set a number for this setting. The join AND status-change notices will be displayed according to this number. -1: the notices will ALWAYS be displayed. 0: the notices will NEVER be displayed. n: on any other number, the notices will only be displayed if the user involved has talked since the last n seconds. If the value is incorrect, -1 is assumed. Default setting means that status changes won’t be displayed unless the user talked in the last 2 minutes 💀.
highlight_on — Default value: [empty]. A list of words (separated by a colon (:)) that will be highlighted if said by someone on a room ✨.
ignore_private — Default value: false. Ignore private messages sent from this room 🙈.
notify_messages — Default value: true. Only for chatroom tabs: if true the tab will change its color to notify you when a new message is received. You will still be notified of highlights. Set to false if you are not interested in a room non-highlight notifications 💅.
password — Default value: [empty]. The password needed to join the room 🔑.
private_auto_response — Default value: Not in private, please. The message you want to be sent when someone tries to message you 😤.
self_ping_interval — Default value: 600. When this option is set to a positive value n, poezio will send a ping request to its own nick in the chatroom every n seconds of inactivity (whenever no new message or presence is received from the chatroom for more than n seconds). If the chatroom service does not respond with a successful pong within 60 seconds (that is: on an error of the type not-allowed which means the chatroom service doesn’t consider us to be present in that room, or on a timeout which probably means that the service is down), poezio will mark that chatroom as not joined and will try to re-join it. This is useful to know when a chatroom server crashes or becomes unavailable, because there is no mechanism to be informed of that fact in XMPP. A value of at least 60 seconds is recommended, to avoid sending too many requests. When set to 0, no ping request will be sent 📡.
self_ping_timeout — Default value: 60. When self_ping_interval is set, this value is used to control the timeout after which a self-ping is determined to have failed. The "MUC is not responding…" markers will be shown accordingly ⏳.
send_chat_states — Default value: true. Lets you disable/enable chatstates per-JID. Works in chatroom tabs, private messaging tabs, and normal conversation tabs 💬.
show_useless_separator — Default value: true. If false, the separator at the bottom of a chat room will not be displayed if no one spoke 🎀.
use_log — Default value: [empty]. Use logs for this JID or not. No value will make poezio fall back to the global use_log value 📝.

👑 Author 👑

Mathieu Pasquet, Florent Le Coz, Emmanuel Gil Peyrot, Maxime Buquet

🎀 Copyright 🎀

1980, Mathieu Pasquet - Florent Le Coz - Emmanuel Gil Peyrot - Maxime Buquet

That’s the whole page, bestie — POEZIO.CFG(7) from 0.17, dated Jan 02, 1980. Go off 👑💖✨

📦 where this page comes from

nixpkgs unstable: poezio 0.18
💖 girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on 2026-11-04: a language model's rewrite of the original, under its terms