diff options
| author | Robin Jarry <robin@jarry.cc> | 2022-09-30 14:12:07 +0200 |
|---|---|---|
| committer | Robin Jarry <robin@jarry.cc> | 2022-10-01 15:47:25 +0200 |
| commit | 45bff8851509432f6b5a21360ce67a7b2ca55eb5 (patch) | |
| tree | 9290e56c3483a60b04d321837ac609c404a38768 /doc/aerc.1.scd | |
| parent | 92ba132d70fe1d9afabe3cf4f23376025ccff897 (diff) | |
| download | aerc-45bff8851509432f6b5a21360ce67a7b2ca55eb5.tar.gz | |
open: allow overriding default program
Instead of xdg-open (or open on MacOS), allow forcing a program to open
a message part. The program is determined in that order of priority:
1) If :open has arguments, they will be used as command to open the
attachment. If the arguments contain the {} placeholder, the
temporary file will be substituted, otherwise the file path is added
at the end of the arguments.
2) If a command is specified in the [openers] section of aerc.conf for
the part MIME type, then it is used with the same rules of {}
substitution.
3) Finally, fallback to xdg-open/open with the file path as argument.
Update the docs and default config accordingly with examples.
Fixes: https://todo.sr.ht/~rjarry/aerc/64
Co-authored-by: Jason Stewart <support@eggplantsd.com>
Signed-off-by: Robin Jarry <robin@jarry.cc>
Tested-by: Tim Culverhouse <tim@timculverhouse.com>
Acked-by: Moritz Poldrack <moritz@poldrack.dev>
Diffstat (limited to 'doc/aerc.1.scd')
| -rw-r--r-- | doc/aerc.1.scd | 14 |
1 files changed, 12 insertions, 2 deletions
diff --git a/doc/aerc.1.scd b/doc/aerc.1.scd index 38862a53..355a08d6 100644 --- a/doc/aerc.1.scd +++ b/doc/aerc.1.scd @@ -392,8 +392,18 @@ message list, the message in the message viewer, etc). at the bottom of the message viewer. *open* [args...] - Saves the current message part in a temporary file and opens it - with the system handler. Any given args are forwarded to the open handler + Saves the current message part to a temporary file, then opens it. If no + arguments are provided, it will open the current MIME part with the + matching command in the *[openers]* section of _aerc.conf_. When no match + is found in *[openers]*, it falls back to the default system handler. + + When arguments are provided: + + - The first argument must be the program to open the message part with. + Subsequent args are passed to that program. + - *{}* will be expanded as the temporary filename to be opened. If it is + not encountered in the arguments, the temporary filename will be + appened to the end of the command. *save* [-fpa] <path> Saves the current message part to the given path. |