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
$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
$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.
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.
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
$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
Creates convenient aliases for chatroom administration.
Allows you to create your own aliases.
Allows a message to be broadcasted on all the rooms your are in. Caution: do not overuse.
Add new ways to correct messages.
- Close all
Close all tabs except chatrooms and the contact list.
Do a disco#info query on the JID and display the contact addresses.
Set the client state indication manually.
Add a cybertouch to your messages.
- Day Change
Logs the day change inside the buffers, to keep track of the days when backlogging.
Roll one or several dice using message corrections.
/discocommand to display the disco#info of a JID.
- Display corrections
Lists old versions of a corrected message.
Double the first word of each sentence.
Send an URL annotating it as embedded.
Runs a system command an optionally sends the output as a message.
Ascii-art writing (requires the
figletpackage on your system).
- IQ Show
Shows the received IQs, for debugging purposes.
Manage IRC gateways with biboumi more easily
Opens links in a web browser, locally or remotely using a FIFO and SSH.
Reproduce the behavior of the
- MPD Client
Sends the current song (and optionally the progress inside the song) to the current (chat) tab.
Allows encrypted and deniable exchanges using OTR.
Kicks a random user in the room.
Sends a ping probe to an entity (XEP-0199)
- Pipe Command
Send commands to poezio through a named pipe.
Insert dots in your messages.
Adds a /quote command to quote a message at HH:MM:SS and put it in the input (to prevent painful copy/pastes).
Sends your messages in rainbow colors using XHTML-IM.
- Regex Admin
Add regex-based kick and ban commands.
Reminds you to do something every now and then.
Reorder the tabs according to a static layout.
Replace some patterns in your messages.
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
Shuffle everything you say.
- Simple notify
Sends a notification with a command of your choice on (non-chatroom) messages.
Adds a subtle little advertising in your messages.
Adds convenient aliases to /status (/away, etc).
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.
/uploadcommand to upload a file.
Gets the uptime of a XMPP server or a component.
/vcardcommand to retrieve and display a vCard.