---
name: "mutt_vc_query"
section: "1"
platform: "linux"
package: "mutt-vc-query"
version: "005-3"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/mutt_vc_query"
---

# mutt\_vc\_query(1)

vCard query utility for mutt

## NAME

**mutt\_vc\_query** – vCard query utility for mutt

## SYNOPSIS

**mutt\_vc\_query**\[ **-m** \| **-e**\] \[**-t** *type*\] \[**-f** *datafile*\] *query*

**mutt\_vc\_query** \[**-v**\]

**mutt\_vc\_query** \[**-V**\]

**mutt\_vc\_query** \[**-h**\]

## DESCRIPTION

A vCard query utility for mutt.  This utility can be used at the shell prompt to perform ad-hoc queries, but it is meant to be used by mutt's "query\_command" option. Place the following line in your "~/.muttrc" file:

```
set query_command = "mutt_vc_query '%s'"
```

The search using the given query string will be case insensitive. The options are as follows:

- \-e

  Sort the results by email.

- \-a

  Output all email addresses associated with a contact, instead of just the preferred address.

- \-f

  Use the datafile to perform the query.

- \-h

  Display usage help.

- \-m

  Sort the results by the miscellaneous field.

- \-t

  Uses the specified type for the miscellaneous field.

- \-v

  Display the version.

- \-V

  Display the copyright and license.

## FILES

- *~/.rolo/contacts.vcf*

  Default data file that mutt\_vc\_query will query.

## EXAMPLES

To query for the string "Hsu" and have the miscellaneous field be populated by the type "NICKNAME":

```
mutt_vc_query -t NICKNAME Hsu
```

## DIAGNOSTICS

The **mutt\_vc\_query** utility exits 0 on success, and \>0 if an error occurs.

## SEE ALSO

[muttrc(5)](/muttrc/5.md), [rolo(1)](/rolo/1.md)

## AUTHORS

Andrew Hsu ⟨ahsu@users.sf.net⟩

## BUGS

Man page is not finished yet.