aboutsummaryrefslogtreecommitdiffstats
path: root/doc/aerc-config.5.scd
diff options
context:
space:
mode:
authorRobin Jarry <robin@jarry.cc>2023-09-24 21:10:19 +0200
committerRobin Jarry <robin@jarry.cc>2023-10-28 19:25:02 +0200
commit1db74a9ba74350776dee5f2384744357ad3aace5 (patch)
tree923e7ef487ee71876620d4f8370b06a543f5fb79 /doc/aerc-config.5.scd
parent8464b373851142b0becaaa10db34df3559b2b62e (diff)
downloadaerc-1db74a9ba74350776dee5f2384744357ad3aace5.tar.gz
open: run commands with sh -c
Allow running shell commands in openers. Changelog-changed: `:open` commands are now executed with `sh -c`. Requested-by: Vitaly Ovchinnikov <v@postbox.nz> Signed-off-by: Robin Jarry <robin@jarry.cc> Reviewed-by: Koni Marti <koni.marti@gmail.com> Tested-by: Moritz Poldrack <moritz@poldrack.dev> Tested-by: Inwit <inwit@sindominio.net>
Diffstat (limited to 'doc/aerc-config.5.scd')
-rw-r--r--doc/aerc-config.5.scd9
1 files changed, 5 insertions, 4 deletions
diff --git a/doc/aerc-config.5.scd b/doc/aerc-config.5.scd
index 0e86e56b..a45e2443 100644
--- a/doc/aerc-config.5.scd
+++ b/doc/aerc-config.5.scd
@@ -900,9 +900,10 @@ actions on a per-MIME-type basis. The *:open-link* URL scheme is used to
determine the MIME type as follows: _x-scheme-handler/<scheme>_. They are
configured in the *[openers]* section of _aerc.conf_.
-_{}_ is expanded as the temporary filename or URL to be opened. If it is not
-encountered in the command, the filename/URL will be appened to the end of the
-command. Environment variables are also expanded. Tilde is not expanded.
+_{}_ is expanded as the temporary filename or URL to be opened with proper shell
+quoting. If it is not encountered in the command, the filename/URL will be
+appended to the end of the command. The command will then be executed with
+_sh -c_.
Like *[filters]*, openers support basic shell globbing. The first opener which
matches the part's MIME type (or URL scheme handler MIME type) will be used, so
@@ -913,7 +914,7 @@ Example:
```
[openers]
x-scheme-handler/irc=hexchat
-x-scheme-handler/http\*=firefox
+x-scheme-handler/http\*=printf '%s' {} | wl-copy
text/html=surf -dfgms
text/plain=gvim {} +125
message/rfc822=thunderbird