diff --git a/README.md b/README.md index 8baef68..2dec0a2 100644 --- a/README.md +++ b/README.md @@ -97,7 +97,7 @@ The [`scripts/`](scripts/) folder contains examples on how `wl-mirror` can be us - [`wl-present`](scripts/wl-present) is a small script to demonstrate the use of the `-S` option to interactively present on Sway. This script is especially useful when binding the `wl-present` subcommands to - keyboard shortcuts. See example below + keyboard shortcuts. See example below. - [`release.sh`](scripts/release.sh) Generates a release tar ball for the currently checked out commit if there's a release tag on it. @@ -127,6 +127,10 @@ bindsym $mod+p mode "present" This requires `wl-mirror`, the `wl-present` script, `pipectl` (optional), slurp, and one of `wofi`, `wmenu`, `rofi`, or `dmenu`. +Note that wl-present only allows one instance by default, but multiple +instances can be used at the same time using the `--name` option or +`WL_PRESENT_PIPE_NAME` environment variable. + ### Kanshi Configuration Example The following [kanshi](https://git.sr.ht/~emersion/kanshi) profile will launch diff --git a/man/wl-present.1.scd b/man/wl-present.1.scd index b611381..9e71c6e 100644 --- a/man/wl-present.1.scd +++ b/man/wl-present.1.scd @@ -6,7 +6,7 @@ wl-present - an interactive client for *wl-mirror*(1) # SYNOPSIS -*wl-present* [args...] +*wl-present* [OPTIONS] [args...] # DESCRIPTION @@ -58,6 +58,12 @@ in your wayland compositor for easy access. given, *dmenu*(1) (or a compatible replacement) are used to select an option. +# OPTIONS + +*-n*, *--name* + Use an alternative pipe name (default is wl-present). + This allows multiple instances of wl-present to run at the same time. + # ENVIRONMENT VARIABLES *WL_PRESENT_DMENU* @@ -81,6 +87,12 @@ in your wayland compositor for easy access. Example: WL_PRESENT_SLURP="slurp -c #859900 -w 2" +*WL_PRESENT_PIPE_NAME* + Overrides the default pipe name (default is wl-present). This is equivalent + to the *--name* option above. + + Example: WL_PRESENT_PIPE_NAME=monitor2 wl-present mirror HDMI-A-1 + # AUTHORS Maintained by Ferdinand Bachmann . More information on