logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

wl-mirror - a simple Wayland output mirror client

Authors

       Maintained by Ferdinand Bachmann <ferdinand.bachmann@yrlf.at>. More information on wl-mirror can be found
       at <https://github.com/Ferdi265/wl-mirror>.

Backends

auto
           Automatically  try  backends  in  order  and  use the first that works (enabled by default). The next
           backend is selected automatically when the current backend fails to capture a frame  10  times  in  a
           row.

       dmabuf
           Use  the  wlr-export-dmabuf-unstable-v1  protocol to capture outputs (requires wlroots). This backend
           keeps the image data on the GPU and does not need expensive copies to the CPU and back.

       screencopy
           Use the wlr-screencopy-unstable-v1 protocol to capture outputs (requires wlroots) This backend passes
           the image data via shared memory on the CPU, but may  have  better  compatibility  with  complex  GPU
           driver configurations (e.g., multi GPU).

Name

       wl-mirror - a simple Wayland output mirror client

Options

-h,--help
           Show help message and exit.

       -V,--version
           Show version information and exit.

       -v,--verbose--no-verbose
           Enable or disable debug logging.

       -c,--show-cursor--no-show-cursor
           Show the cursor on the mirrored surface (enabled by default).

       -i,--invert-colors--no-invert-colors
           Invert colors on the mirrored surface.

       -f,--freeze--unfreeze--toggle-freeze
           Freeze, unfreeze, or toggle freezing of the current image on the screen.

       -F,--fullscreen--no-fullscreen
           Open as a fullscreen window, or make the current window fullscreen in stream mode.

           --fullscreen-outputO--no-fullscreen-output
           Set a different output to fullscreen on (default is the current output).

       -sf,--scalingfit
           Scale to fit and if necessary add letterboxing (enabled by default).

       -sc,--scalingcover
           Scale to cover and if necessary crop the image.

       -se,--scalingexact
           Use exact multiple scaling and if necessary add letterboxing.

       -sl,--scalinglinear
           Use linear scaling (enabled by default).

       -sn,--scalingnearest
           Use nearest-neighbor scaling.

       -bB,--backendB
           Use a specific screen capture backend, see BACKENDS.

       -tT,--transformT
           Apply custom transform (rotation and flipping), see TRANSFORMS.

       -rR,--regionR
           Capture custom screen region R, see REGIONS.

       -S,--stream
           Accept a stream of additional options on stdin, see STREAMMODE.

Regions

       Regions are specified in the format used by the slurp(1) utility:

           'x,ywidthxheight [output]'

       When processing the region option, the region is translated into output coordinates, so when  the  output
       moves,  the  captured region moves with it. When a region is specified, the output positional argument is
       optional.

See Also

wl-present(1) slurp(1) sway-output(5)

                                                   2024-10-14                                       wl-mirror(1)

Stream Mode

       In stream mode, wl-mirror interprets lines on stdin as additional command line options.

       •   Arguments can be quoted with single or double quotes, but every argument must be fully quoted.
       •   Unquoted arguments are split on whitespace.
       •   No escape sequences are implemented.

       Option lines on stdin are processed asynchronously, and can override all options and the captured output.
       Stream mode is used by wl-present(1) to add interactive controls to wl-mirror.

Synopsis

wl-mirror [-h,-V,-v,-c,-i,-f,-s S,-b B,-t T,-r R,-S] <output>

Transforms

       Transforms  are  specified  as  a  dash-separated  list of flips followed by a rotation amount. Flips are
       applied before rotations, both flips and rotations are optional. Custom transformations are applied after
       adjusting for the wayland output transform, so  that  if  no  custom  transformations  are  applied,  the
       mirrored surface is displayed right-side-up.

       normal
           No transformation (default transformation).

       flipX,flipY
           Flip  the  X  or  Y coordinate of the image, i.e. flipX means the mirrored surface has left and right
           swapped.

       0cw,90cw,180cw,270cw
           Apply a clockwise rotation.

       0ccw,90ccw,180ccw,270ccw
           Apply a counter-clockwise rotation.

       The following transformation options are provided for compatibility with sway-output(5) transforms:

       flipped
           Same as flipX.

       0,90,180,270
           Same as 0cw,90cw,180cw,270cw.

See Also