Discussions of development and use of the Sup email client
 help / color / mirror / Atom feed
From: Iain Parris <ipv2.lst@parris.org>
To: supmua <supmua@googlegroups.com>
Subject: Re: [sup] Managing Contacts
Date: Thu, 16 Jul 2020 20:46:00 +0100	[thread overview]
Message-ID: <1594927065-sup-8296@ceres> (raw)
In-Reply-To: <e74612d1-f87a-4be2-8881-628ebed79594o@googlegroups.com>

Hi Robert,

Excerpts from Robert Winkler's message of 2020-07-16 08:15:56 -0700:
> Hi, I already got extensive contact lists (>1,000) in various formats and 
> run a manually maintained list on an LDAP server for the really important 
> contacts.
> 
> How can I easily use or import contacts for the To: CC: and BCC: fields?

General contacts usage is:

    - Global keybinding "C" - list contacts.

    - To specify a recipient (To/Cc/Bcc): when prompted to enter the
      recipient (e.g., after pressing "c" for "compose"), start typing,
      then press "tab" for suggestions.

    - In thread-view-mode, press "i" to be prompted to add to Sup's
      contacts list, with an optional alias.

The contacts are sourced from file ~/.sup/contacts.txt, and from calling
the "extra-contact-addresses" hook.

So you have two main options.

(1) ~/.sup/contacts.txt

    - Sup's built-in contacts file is ~/.sup/contacts.txt

    - This is written/read when Sup stops/starts, so make sure to quit
      Sup before editing it manually.

    - File format is one contact per line, with an optional alias.

    - Each line is in format like:

          alias: Person Name <person.email@example.com>

    - "alias" is optional, and if omitted, then the line will look like:

          : Another Person <person2@example.com>

    - If you converted your contacts into this style, then you could
      create your own contacts.txt file, and Sup would use it.

(2) extra-contact-addresses hook

    - This hook takes no input, and returns an array of email address
      strings that Sup is then aware of for tab-completion.

    - So you could alternatively write this hook to call any external
      program, and return in the format expected by Sup.

    - Two examples with "goobook" (for Google Account contacts) and
      "abook" (a general contact manager program that runs in the
      terminal) are here:
      <https://github.com/sup-heliotrope/sup/wiki/External-contacts-search>.

    - So if (for example) you chose "abook", then you could use any
      method to import your contacts into "abook", and then use the Sup
      hook to make Sup aware of abook's contacts.

    - abook is able to import ldif, so may be a natural choice. Further
      reading on abook:
      <https://hund0b1.gitlab.io/2018/06/25/abook-a-ncurses-adress-book-program.html>.

For other general information about Sup's contact lists, see also:
<https://sup-heliotrope.github.io/community/sup-talk/msg00965.html>.

Kind regards,
Iain


  reply	other threads:[~2020-07-16 19:46 UTC|newest]

Thread overview: 8+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2020-07-16 15:15 Robert Winkler
2020-07-16 19:46 ` Iain Parris [this message]
2020-07-17 18:37   ` [sup] " Robert Winkler
2020-09-03 13:50   ` Robert Winkler
2020-09-03 20:01     ` Iain Parris
2020-09-07 13:18       ` Robert Winkler
2020-09-08 21:20         ` Iain Parris
2020-09-09 14:35           ` Robert Winkler

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=1594927065-sup-8296@ceres \
    --to=ipv2.lst@parris.org \
    --cc=supmua@googlegroups.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox