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.
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-ldapIf 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 |
| PyXDG | Optional XDG support | python-xdg | dev-python/pyxdg |
Mutt-LDAP is available as a Git repository:
$ git clone git://tremily.us/mutt-ldap.gitIt is also mirrored on GitHub. To install the checkout, run the standard:
$ python setup.py installor you can just copy mutt_ldap.py into to your PATH.
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 $XDG_CONFIG_HOME/mutt-ldap.cfg containing something like:
[connection]
server = myserver.example.net
basedn = ou=people,dc=example,dc=netThe query cache (enabled by default) will be created at $XDG_DATA_HOME/mutt-ldap.json, unless overriden by an explicit cache.path setting.
See the CONFIG options in mutt_ldap.py for other available settings. See the XDG Base Directory Specification for more details on configuration and cache file locations. If the xdg module supplied by PyXDG is not available, the default configuration path falls back on ~/.config/mutt-ldap.cfg and the default cache path falls back on ~/.cache/mutt-ldap.json.
This project is distributed under the GNU General Public License Version 3 or greater.
Use the GitHub issue tracker to submit bugs.
mutt_ldap_query is a Perl script with a similar purpose.