Skip to content

gajim/gajim-plugins

Repository files navigation

Gajim Plugins

In this place you will find all plugins that are written for Gajim by the community. If you experience any problems with those plugins, please report them here.

How to install plugins

Note: Some plugins have external dependencies that need to be installed separately. Check the plugin's wiki page for details.

There are several ways to install a plugin:

  • You can browse / download / enable / configure plugins from within Gajim via 'Gajim' > 'Plugins' menu.

  • You can also clone the repository directly from our Git and copy it to:

    Linux: ~/.local/share/gajim/plugins/

    Windows: C:\Users\USERNAME\AppData\Roaming\Gajim\Plugins

  • Alternatively (for developing), you can also symlink the gajim-plugins repository to Gajim's plugin path:

    Symlink: ln -s /path/to/gajim-plugins-repository/* ~/.local/share/gajim/plugins/

For each major Gajim version there is a different plugins branch. Gajim >=1.4 uses the master branch.

Version Plugins branch
Gajim master master branch
Gajim 1.3 1.3 branch
Gajim 1.2 1.2 branch
Gajim 1.1 1.1 branch
Gajim 1.0 1.0 branch

Note: Using master branch for plugins requires frequent updates of both Gajim and plugins!

Share / improve Plugins

You have written a new plugin or want to improve an existing one?

First, thanks for that! Here is how to start:

  • Register an account on our Gitlab here
  • Tell us about your plans at gajim@conference.gajim.org
  • Fork the Gajim-Plugins repository
  • When you are finished, do a merge request against the main plugins repository. You can read about how to use git here.
  • Additionally, there is a list of plugin events which might be helpful

Before you put in any work, please contact us on gajim@conference.gajim.org

Please do not use dev.gajim.org for any projects that are not directly for the benefit of Gajim!

Plugins list

All available plugins are listed here.