CARDDAV-QUERY(1)            General Commands Manual           CARDDAV-QUERY(1)

<?><?><?> (NAME)
       carddav-query - <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
       CardDAV <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>.

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       carddav-query [-h] [-l <limit>] [-v] [-c <file>] [-s <section>] [-k
       <key_source>] [-C <key_cred_cmd>] [-s <server_url>] [-u <username>] [-p
       <password>] <term> [<term> ...]

       <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> address-book-cmd <?><?> aerc-config(5) <?><?><?><?><?>
       <?><?><?> <?><?><?>.

<?><?><?><?><?><?><?><?> (OPTIONS)
       -h, --help
           <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?>
           <?><?><?><?>.

       -v, --verbose
           <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
           <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>
           (stderr).

       -l <limit>, --limit <limit>
           <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?>. <?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?>.

           <?><?><?><?><?><?><?>: 10

       -c <file>, --config-file <file>
           <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> INI <?><?>
           <?><?><?><?><?> URL <?><?><?><?> CardDAV <?><?> <?><?>
           <?><?><?><?><?><?> <?><?><?><?><?><?>.

           <?><?><?><?><?><?><?>: ~/.config/aerc/accounts.conf

       -S <section>, --config-section <section>
           <?><?><?> <?><?><?><?><?><?><?><?> INI <?><?> <key_source> <?>
           <key_cred_cmd> <?><?> <?><?> <?><?><?><?> <?><?><?><?><?>.
           <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?> <key_source> <?><?> <?><?> <?><?><?><?>
           <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>.

       -k <key_source>, --config-key-source <key_source>
           <?><?><?><?> <?><?><?><?><?><?><?><?> INI <?><?><?><?>
           <?><?><?><?><?> <?><?> <section> <?><?> <file>. <?><?><?><?><?>
           <?><?><?><?> <?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?>
           <?><?><?>:

               https?://<username>[:<password>]@<hostname>/<path/to/addressbook>

           <?><?> <?><?> <?><?><?><?> <username> <?> <password> <?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?><?> (percent-encoded) <?><?><?>
           <?><?><?><?><?>. <?><?><?> <password> <?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> --config-key-cred-cmd
           <?><?> --password <?><?><?><?><?> <?><?><?><?>.

           <?><?><?><?><?><?><?>: carddav-source

       -C <key_cred_cmd>, --config-key-cred-cmd <key_cred_cmd>
           <?><?><?><?> <?><?><?><?><?><?><?><?> INI <?><?><?><?>
           <?><?><?><?><?> <?><?> <section> <?><?> <file>. <?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?> <?><?> <?><?> sh -c <?><?><?><?>
           <?><?><?><?><?><?> <?><?> <?><?><?> <password> <?><?> <key_source>
           <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
           <?><?><?>.

           <?><?><?><?><?><?><?>: carddav-source-cred-cmd

       -s <server_url>, --server-url <server_url>
           <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?> CardDAV.
           <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?> <?><?><?> <?><?><?><?><?><?>.

       -u <username>, --username <username>
           <?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?> <?><?><?><?>. <?><?><?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?>
           <?><?><?><?><?><?>.

       -p <password>, --password <password>
           <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>.
           <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?> <?><?><?> <?><?><?><?><?><?>.

<?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> (POSITIONAL ARGUMENTS)
       <term>
           <?><?><?><?><?> <?><?><?><?><?>. <?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?> FN
           (<?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?>)<?> EMAIL<?>
           NICKNAME<?> ORG (<?><?><?><?>) <?> TITLE <?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?>.

<?><?><?><?><?><?><?> (EXAMPLES)
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
       ~/.config/aerc/accounts.conf <?><?><?><?><?>.

   Fastmail
           [fastmail]
           carddav-source = https://janedoe%40fastmail.com@carddav.fastmail.com/dav/addressbooks/user/janedoe@fastmail.com/Default
           carddav-source-cred-cmd = pass fastmail.com/janedoe
           address-book-cmd = carddav-query -S fastmail %s

   Gmail
           [gmail]
           carddav-source = https://johndoe%40gmail.com@www.googleapis.com/carddav/v1/principals/johndoe@gmail.com/lists/default
           carddav-source-cred-cmd = pass gmail.com/johndoe
           address-book-cmd = carddav-query -S gmail %s

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       aerc-config(5)

<?><?><?><?><?><?><?><?><?> (AUTHORS)
       <?><?> <?><?><?><?><?> <?><?><?><?> Drew DeVault <?><?><?><?><?> <?><?>
       <?> <?><?><?><?> Robin Jarry <?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> aerc <?><?> https://sr.ht/~rjarry/aerc
       <?><?><?><?><?><?> <?><?><?><?><?><?><?>.

                                  2025-08-29                  CARDDAV-QUERY(1)