= Plugins =

BarnOwl implements a plugin system that allows for additional functionality to be implemented as add-on perl modules. This page exists to have a semi-centralized list of out-of-tree plugins that you can add to your Barnowl.

 * For instructions on installing plugin modules, see [wiki:UsingPlugins]
 * For instructions on creating a plugin, see [wiki:CreatingAModule]

== Alias ==

||Author:||Nelson Elhage `<nelhage@mit.edu>`||
||Source:||[http://github.com/nelhage/barnowl-alias]||
||PAR:||http://web.mit.edu/nelhage/Public/BarnOwl/Alias.par||
||Documentation:||http://github.com/nelhage/barnowl-alias/blob/master/README||

The Alias plugin allows you to change the displayed name of select classes, for example to abbreviate long class names or to hide private class names from shoulder-surfers.

== ClassFilters ==

||Author:||Kevin Riggle `<kevinr@free-dissociation.com>`||
||Source:||[http://github.com/kevinr/barnowl-classfilters]||
||PAR:||http://web.mit.edu/kevinr/Public/BarnOwl/ClassFilters.par||
||Documentation:||http://github.com/kevinr/barnowl-classfilters/blob/master/README||

The ClassFilters plugin creates filters from files in the ~/.owl/classfilters directory.

== DevUtils ==

||Author:||Nelson Elhage `<nelhage@mit.edu>`||
||Source:||[http://github.com/nelhage/barnowl-devutils]||
||PAR:||http://web.mit.edu/nelhage/Public/BarnOwl/DevUtils.par||

The DevUtils plugin contains some utilities of use to BarnOwl plugin developers. At the moment, it contains only the `eperl` command, which allows you to enter perl into the edit window and have it evaluated, with several options for how to display the result.

== ZStatus ==

||Author:||Nelson Elhage `<nelhage@mit.edu>`||
||Source:||[http://github.com/nelhage/barnowl-zstatus]||
||PAR:||http://web.mit.edu/nelhage/Public/BarnOwl/ZStatus.par||

The ZStatus plugin exposes the `zstatus` and `zbars` commands, for sending status bars to Zephyr that look something like:

{{{
#!html
<pre><code>
       [Zephyr status dashboard]
              barnowls [<span style="color:red">========  </span>] <span style="color:red">(8/10)</span>
                ponies [<span style="color:green">===       </span>] <span style="color:green">(3/10)</span>
</code></pre>
}}}