diff options
| author | Koni Marti <koni.marti@gmail.com> | 2022-11-20 16:22:39 +0100 |
|---|---|---|
| committer | Robin Jarry <robin@jarry.cc> | 2022-11-21 13:31:00 +0100 |
| commit | c063b1d5f38ae144b7c86fe450a58f5f0ead667b (patch) | |
| tree | cc067ecdf0312523358ae446779a68a1bb78cf44 /doc | |
| parent | e5f2fb08d8a7604aeef726698ef696874bcd2561 (diff) | |
| download | aerc-c063b1d5f38ae144b7c86fe450a58f5f0ead667b.tar.gz | |
attach: open file picker menu with -m flag
Open a user-defined file picker with the -m flag for the attach command
to select attachments.
Specify your file picker of choice with the 'file-picker-cmd' in the
[composer] section of aerc.conf, e.g. "file-picker-cmd=fzf -m".
A '%s' placeholder can be used in the 'file-picker-cmd' which is then
substituted for the argument <arg> provided to :attach -m <arg>.
For example, when you set 'file-picker-cmd=find %s -type f | fzf -m',
you can easily change the directory to start the search with ':attach -m
<path-to-search>'.
Tested with fzf, fzy and peco.
Implements: https://todo.sr.ht/~rjarry/aerc/108
Signed-off-by: Koni Marti <koni.marti@gmail.com>
Acked-by: Tim Culverhouse <tim@timculverhouse.com>
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/aerc-config.5.scd | 13 | ||||
| -rw-r--r-- | doc/aerc.1.scd | 6 |
2 files changed, 18 insertions, 1 deletions
diff --git a/doc/aerc-config.5.scd b/doc/aerc-config.5.scd index f18b5110..513f7373 100644 --- a/doc/aerc-config.5.scd +++ b/doc/aerc-config.5.scd @@ -555,6 +555,19 @@ These options are configured in the *[compose]* section of aerc.conf. Default: none +*file-picker-cmd* + Specifies the command to be used to select attachments. Any occurence of + '%s' in the file-picker-cmd will be replaced with the argument <arg> + to :attach -m <arg>. + + The command must output the selected files to standard output, + one file per line. + + Example: + file-picker-cmd=fzf --multi --query=%s + + Default: none + *reply-to-self* If set to false, do not mail yourself when replying (e.g., if replying to emails previously sent by yourself, address your replies to the diff --git a/doc/aerc.1.scd b/doc/aerc.1.scd index 4f9b6a7f..c1efc954 100644 --- a/doc/aerc.1.scd +++ b/doc/aerc.1.scd @@ -479,10 +479,14 @@ message list, the message in the message viewer, etc). *abort* Close the composer without sending, discarding the message in progress. -*attach* <path> +*attach* [-m [<arg>] | <path>] Attaches the file at the given path to the email. The path can contain globbing syntax described at https://godocs.io/path/filepath#Match. + *-m* [<arg>] + Runs the 'file-picker-cmd' to select files to be attached. + Requires an argument when 'file-picker-cmd' contains the '%s' verb. + *attach-key* Attaches the public key for the configured account to the email. |