1
0
mirror of https://github.com/profanity-im/profanity.git synced 2024-06-16 21:35:24 +00:00
profanity/docs/profanity-plugins.1
2023-08-03 08:01:43 +02:00

97 lines
1.9 KiB
Groff

.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/plugins
.SH DESCRIPTION
Manage plugins. Passing no arguments lists installed plugins and global plugins which are available for local installation. Global directory for Python plugins is /usr/local/share/profanity/plugins and for C Plugins is /usr/local/lib64/profanity/plugins.
.SH SYNOPSIS
/plugins
.LP
/plugins install [<path or URL>]
.LP
/plugins update [<path or URL>]
.LP
/plugins uninstall [<plugin>]
.LP
/plugins unload [<plugin>]
.LP
/plugins load [<plugin>]
.LP
/plugins reload [<plugin>]
.LP
/plugins python_version
.LP
.SH ARGUMENTS
.PP
\fBinstall [<path or URL>]\fR
.RS 4
Install a plugin, or all plugins found in a directory (recursive), or download and install plugin (plugin name is based on basename). And loads it/them.
.RE
.PP
\fBupdate [<path or URL>]\fR
.RS 4
Uninstall and then install the plugin. Plugin name to update is basename.
.RE
.PP
\fBuninstall [<plugin>]\fR
.RS 4
Uninstall a plugin.
.RE
.PP
\fBload [<plugin>]\fR
.RS 4
Load a plugin that already exists in the plugin directory, passing no argument loads all found plugins. It will be loaded upon next start too unless unloaded.
.RE
.PP
\fBunload [<plugin>]\fR
.RS 4
Unload a loaded plugin, passing no argument will unload all plugins.
.RE
.PP
\fBreload [<plugin>]\fR
.RS 4
Reload a plugin, passing no argument will reload all plugins.
.RE
.PP
\fBpython_version\fR
.RS 4
Show the Python interpreter version.
.RE
.SH EXAMPLES
/plugins install /home/steveharris/Downloads/metal.py
.LP
/plugins install https://raw.githubusercontent.com/profanity-im/profanity-plugins/master/stable/sounds.py
.LP
/plugins update /home/steveharris/Downloads/metal.py
.LP
/plugins update https://raw.githubusercontent.com/profanity-im/profanity-plugins/master/stable/sounds.py
.LP
/plugins uninstall browser.py
.LP
/plugins load browser.py
.LP
/plugins unload say.py
.LP
/plugins reload wikipedia.py
.LP