mutt-ldap 0.1

LDAP address searches for Mutt

Mutt-LDAP provides an external address query script for Mutt which connects to LDAP databases using python-ldap. It can cache queries locally in case your LDAP server is slow or not always available, expiring cached queries after a configurable amount of time.

Installation

Packages

Gentoo

I’ve packaged Mutt-LDAP for Gentoo. You need layman and my wtk overlay. Install with:

# emerge -av app-portage/layman
# layman --add wtk
# emerge -av mail-client/mutt-ldap

Dependencies

If you’re installing by hand or packaging Mutt-LDAP for another distribution, you’ll need the following dependencies:

Package	Purpose	Debian	Gentoo
python-ldap	LDAP connections	python-ldap	dev-python/python-ldap

Installing by hand

Mutt-LDAP is available as a Git repository:

$ git clone git://tremily.us/mutt-ldap.git

It is also mirrored on GitHub. To install the checkout, run the standard:

$ python setup.py install

or you can just copy mutt_ldap.py into to your PATH.

Usage

Add the following line to your ~/.muttrc:

set query_command = "mutt_ldap.py '%s'"

Search for addresses (from Mutt) with ^t, optionally after typing part of the name. Configure your connection by creating ~/.mutt-ldap.rc contaning something like:

[connection]
server = myserver.example.net
basedn = ou=people,dc=example,dc=net

See the CONFIG options in mutt_ldap.py for other available settings.

Licence

This project is distributed under the GNU General Public License Version 3 or greater.

Bugs

Use the GitHub issue tracker to submit bugs.

Related work

mutt_ldap_query is a Perl script with a similar purpose.