1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
|
Poezio 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 in the
link:../configure.html[configuration file] to the directory where you want to
put your plugins.
This means that if you want to use a plugin, you have to copy it (the .py file or the directory) into _plugins_dir_.
Plugins autostart
-----------------
Use the _plugins_autoload_ option (from the
link:../configure.html[configuration file]) to select which plugins should be
loaded on startup. The value is a list of plugin names separated by spaces,
e.g.
.plugins_autoload example
---------
plugins_autoload = "gpg tell exec"
---------
Plugins 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 or gpg) 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 _[]_).
.section example
--------------
[plugin_name]
key = value
other_key = other_value
--------------
Plugins index
-------------
[horizontal]
*Admin*:: link:admin.html[Room administration plugin]
Creates convenient aliases for MUC administration.
*Alias*:: link:alias.html[Custom aliases plugin]
Allows you to create your own aliases.
*Amsg*:: link:amsg.html[Message broadcast plugin]
Allows a message to be broadcasted on all the rooms your arein.
Caution: do not overuse.
*Day Change*:: link:day_change.html[Day change plugin]
Logs the day change inside the buffers, to keep track of the days when
backlogging.
*Display corrections*:: link:display_corrections.html[Display corrections
plugin]
Lists old versions of a corrected message.
*Exec*:: link:exec.html[System command plugin]
Runs a system command an optionally sends the output as a message.
*Figlet*:: link:figlet.html[Figlet plugin]
Ascii-art writing (requires the _figlet_ package on your system).
*GPG*:: link:gpg.html[GnuPG plugin]
Allows encrypted exchanges and presence signing using GnuPG.
*IQ Show*:: IQ showing plugin
Shows the received IQs, for debugging purposes.
*Link*:: link:link.html[Link opener plugin]
Opens links in a web browser, locally or remotely using a FIFO and SSH.
*MPD Client*:: link:mpd_client.html[MPD client plugin]
Sends the current song (and optionally the progress inside the song) to
the current (chat) tab.
*OTR*:: link:otr.html[Off-The-Record plugin]
Allows encrypted and deniable exchanges using OTR.
*PacoKick*:: link:pacokick.html[Random kick plugin]
Kicks a random user in the room.
*Ping*:: link:ping.html[XMPP Ping plugin]
Sends a ping probe to an entity (XEP-0199)
*Quote*:: link:quote.html[Quoting plugin]
Adds a /quote command to quote a message at HH:MM:SS and put it in the
input (to prevent painful copy/pastes).
*Rainbow*:: link:rainbow.html[Rainbow plugin]
Sends your messages in rainbow colors using XHTML-IM.
*Reminder*:: link:reminder.html[Reminder plugin]
Reminds you to do something every now and then.
*Screen Detach*:: link:screen_detach.html[Screen status plugin]
Changes your status to _away_ if the screen poezio is in is detached.
*Simple notify*:: link:simple_notify.html[Simple notification plugin]
Sends a notification with a command of your choice on (non-MUC) messages.
*Status*:: link:status.html[Status aliases plugin]
Adds convenient aliases to /status (/away, etc).
*Tell*:: link:tell.html[Automated delayed messages plugin]
Tells a message to a nick when he connects to a MUC.
*Uptime*:: link:uptime.html[Uptime plugin]
Gets the uptime of a XMPP server or a component.
*Replace*:: link:replace.html[Replace plugin]
Replace some patterns in your messages.
*Time Marker*:: link:time_marker.html[Time marker plugin]
Display the time between two messages.
|
