vim-mutt-aliases's Introduction

Complete mutt aliases (listed in ~/.mutt/aliases) inside Vim; useful

when using Vim as editor for mutt (especially with $edit_headers set), and
even more so with the shell script mutt-alias.sh to populate the aliases file with recent e-mail addresses in your Inbox (or Sent folder).

Usage

When you're editing a mail file in Vim that reads

    From: Lu Guanqun <[email protected]>
    To:   foo

and in your mutt aliases file there is an entry

    alias foo [email protected]

and your cursor is right after foo, then hit Ctrl+X Ctrl+U to obtain:

    From: Lu Guanqun <[email protected]>
    To:   [email protected]

Commands

The command :EditAliases opens the mutt aliases file in Vim. (For less typing, you can (command-line) alias it to ea by vim-alias)

To complete e-mail addresses inside Vim press CTRL-X CTRL-U in insert mode. See :help i_CTRL-X_CTRL-U and :help compl-function.

Setup

The mutt aliases file is automatically set to the value of the variable $alias_file in the file ~/.muttrc. To explicitly set the path to a mutt aliases file $file, add to your .vimrc the line

  let g:muttaliases_file = '$file'

For example, $file could be

  ~/.mutt/aliases

To add aliases
- for all e-mail addresses found in a mail dir, such as the INBOX, there is the mutt-alias.sh shell script; best run by a, say weekly, (ana)cronjob.
- for every opened e-mail, there is a shell script that uses $display_fiter (and which is extended in mutt-alias-auto-add).
The plugin vim-notmuch-addrlookup lets you complete e-mail addresses in Vim by those indexed by notmuch.
The plugin vim-mailquery lets you complete e-mail addresses in Vim by those in your Inbox (or any other mail folder).