Plugins¶

Starting from the 0.7.5 version, poezio supports plugins. Here is a quick howto and a plugin index.

Setting up plugins¶

Poezio seeks the plugins in the ~/.local/share/poezio/plugins/ dir (more generally, the $XDG_DATA_HOME/poezio/plugins/ dir), but that can be changed by setting the plugins_dir option to the directory where you want to put your plugins.

By default, poezio will also seek the plugins in ../plugins, in the source directory, in order to always load the latest versions. You should put a plugin in $XDG_DATA_HOME/poezio/plugins only if you have a custom version (that will override the one in ../plugins), or if it is a plugin you made.

Plugin autoload¶

Use the plugins_autoload option to select which plugins should be loaded on startup. The value is a list of plugin names separated by colons, e.g.

plugins_autoload = tell:exec

Manual plugin load¶

Plugins can of course be loaded with the command /load and unloaded with the command /unload.

Plugin configuration¶

Most plugins will manage their configuration internally, and you do not (and should not) have to edit it, but some (e.g. mpd_client) require manual editing (the /set command can be used, but it is not pleasant to set multiple values with it).

The plugin configuration directory is located in ~/.config/poezio/plugins/ (or $XDG_CONFIG_HOME/poezio/plugins/) and the file related to a specific plugin is named plugin_name.cfg. The configuration options should usually be inside a section named after the plugin (sections are delimited with []).

[plugin_name]
key = value
other_key = other_value

Plugin index¶

Admin¶

Creates convenient aliases for chatroom administration.

Alias¶

Allows you to create your own aliases.

Amsg¶

Allows a message to be broadcasted on all the rooms your are in. Caution: do not overuse.

Autocorrect¶

Add new ways to correct messages.

Close all¶

Close all tabs except chatrooms and the contact list.

Contact¶

Do a disco#info query on the JID and display the contact addresses.

CSI¶

Set the client state indication manually.

Cyber¶

Add a cybertouch to your messages.

Day Change¶

Logs the day change inside the buffers, to keep track of the days when backlogging.

Dice¶

Roll one or several dice using message corrections.

Disco¶

Add a /disco command to display the disco#info of a JID.

Display corrections¶

Lists old versions of a corrected message.

Double¶

Double the first word of each sentence.

Embed¶

Send an URL annotating it as embedded.

Exec¶

Runs a system command an optionally sends the output as a message.

Figlet¶

Ascii-art writing (requires the figlet package on your system).

IQ Show¶

Shows the received IQs, for debugging purposes.

IRC¶

Manage IRC gateways with biboumi more easily

Link¶

Opens links in a web browser, locally or remotely using a FIFO and SSH.

Marquee¶

Reproduce the behavior of the <marquee/> html tag.

Moderate¶

Documentation

Retracts a message as a moderator in groupchats.

MPD Client¶

Sends the current song (and optionally the progress inside the song) to the current (chat) tab.

OMEMO¶

Not distributed with Poezio. See https://lab.louiz.org/poezio/poezio-omemo.

Allows for end-to-end encrypted exchanges using the OMEMO mechanism.

PacoKick¶

Kicks a random user in the room.

Ping¶

Sends a ping probe to an entity (XEP-0199)

Pipe Command¶

Send commands to poezio through a named pipe.

PointPoint¶

Insert dots in your messages.

Quote¶

Adds a /quote command to quote a message at HH:MM:SS and put it in the input (to prevent painful copy/pastes).

Rainbow¶

Sends your messages in rainbow colors using XHTML-IM.

Regex Admin¶

Add regex-based kick and ban commands.

Reminder¶

Reminds you to do something every now and then.

Reorder¶

Reorder the tabs according to a static layout.

Replace¶

Replace some patterns in your messages.

Revstr¶

Reverse everything you say.

Screen Detach¶

Changes your status to away if the screen (or tmux) poezio is in gets detached.

Send Delayed¶

Program the sending of futur messages.

Server Part¶

Add a /server_part command.

Shuffle¶

Shuffle everything you say.

Simple notify¶

Sends a notification with a command of your choice on (non-chatroom) messages.

Spam¶

Adds a subtle little advertising in your messages.

Status¶

Adds convenient aliases to /status (/away, etc).

Sticker¶

Opens a graphical sticker picker and sends the selected one.

Tell¶

Sends a message to a nick when he connects to a chatroom.

Time Marker¶

Display the time between two messages.

Title change¶

Change the title of the terminal according to the name of the current tab.

Upload¶

Add an /upload command to upload a file.

Uptime¶

Gets the uptime of a XMPP server or a component.

User Extras¶

Add /mood, /gaming, /activity

vCard¶

Add a /vcard command to retrieve and display a vCard.