---
name: "wl-present"
section: "1"
platform: "linux"
package: "wl-mirror"
version: "0.18.5-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/wl-present"
---

# wl-present(1)

an interactive client for wl-mirror(1)

## NAME

wl-present - an interactive client for [**wl-mirror**(1)](/wl-mirror/1.md)

## SYNOPSIS

**wl-present** \[OPTIONS\] \<COMMAND\> \[args...\]

## DESCRIPTION

**wl-present** is an wrapper around [**wl-mirror**(1)](/wl-mirror/1.md) that uses its streaming mode together with [**pipectl**(1)](/pipectl/1.md) to interactively control what is being captured.

The subcommands of **wl-present** are intended to be mapped to keyboard shortcuts in your wayland compositor for easy access.

## COMMANDS

**help**

Show help message and exit.

**mirror** \[OUTPUT\] \[OPTIONS\]

Start [**wl-mirror**(1)](/wl-mirror/1.md) capturing OUTPUT. If no output is given, [**slurp**(1)](/slurp/1.md) is used to select the output or region to capture. If any additional OPTIONS are specified, they are passed on to **wl-mirror**.

**set-output** \[OUTPUT\]

Set the captured output of a running **wl-present** session. If no output is given, [**slurp**(1)](/slurp/1.md) is used to select the output to capture.

**set-region** \[REGION\] **unset-region**

Set the captured region of a running **wl-present** session. If no region is given, [**slurp**(1)](/slurp/1.md) us used to select a region to capture.

**set-scaling** \[SCALING\]

Set the scaling mode of a running **wl-present** session. If no region is given, [**dmenu**(1)](/dmenu/1.md) (or a compatible replacement) is used to select a scaling mode.

**freeze**, **unfreeze**, **toggle-freeze**

Set the freeze state of a running **wl-present** session.

**fullscreen** **unfullscreen**

Set the fullscreen state of a running **wl-present** session.

**fullscreen-output** \[OUTPUT\]

Set the fullscreen target output of a running **wl-present** session, implies **fullscreen**.

**no-fullscreen-output**

Unset a previously set fullscreen target output of a running **wl-present** session, implies **unfullscreen**.

**custom** \[OPTIONS\]

Send custom options to a running **wl-present** session. If no options are given, [**dmenu**(1)](/dmenu/1.md) (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**

Overrides the used dmenu implementation. When set, this command is used to select options instead of the default. When unset, **wl-present** attempts to use [**wofi**(1)](/wofi/1.md), [**wmenu**(1)](/wmenu/1.md), [**fuzzel**(1)](/fuzzel/1.md), [**rofi**(1)](/rofi/1.md), and [**dmenu**(1)](/dmenu/1.md), in this order.

Example: WL\_PRESENT\_DMENU="rofi -dmenu -p present"

**WL\_PRESENT\_PIPECTL**

Overrides the used pipectl implementation. When set, this command is used to pipe options to [**wl-mirror**(1)](/wl-mirror/1.md) instead of the default. When unset, **wl-present** attempts to use [**pipectl**(1)](/pipectl/1.md) or an included pipectl shim written in bash if pipectl is not available.

**WL\_PRESENT\_SLURP**

Overrides the used slurp implementation and options. When set, this command is used to select regions and outputs instead of the default. When unset, **wl-present** attempts to use [**slurp**(1)](/slurp/1.md) without any additional options.

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 \<ferdinand.bachmann@yrlf.at\>. More information on **wl-mirror** can be found at \<https://github.com/Ferdi265/wl-mirror\>.

## SEE ALSO

[**wl-mirror**(1)](/wl-mirror/1.md) [**pipectl**(1)](/pipectl/1.md) [**slurp**(1)](/slurp/1.md) [**wofi**(1)](/wofi/1.md) [**wmenu**(1)](/wmenu/1.md) [**fuzzel**(1)](/fuzzel/1.md) [**rofi**(1)](/rofi/1.md) [**dmenu**(1)](/dmenu/1.md)