NAME

       xwallpaper — wallpaper setting utility for X

SYNOPSIS

       xwallpaper    [--screen   screen]   [--daemon]   [--debug]   [--no-randr]   [--trim   widthxheight[+x+y]]
                  [--output  output]  [--center  file]  [--focus  file]  [--maximize  file]   [--stretch   file]
                  [--tile file] [--zoom file] [--version]

DESCRIPTION

       The  xwallpaper  program allows you to set image files as your X wallpaper.  PNG file format is supported
       by default and preferred, but optional JPEG support exists as well.

       The wallpaper is also advertised to programs which support semi-transparent backgrounds.

OPTIONS

       The various options are as follows:

       --center file
               Centers the input file on the output.  If the dimensions of the input file are smaller  than  the
               output  dimensions,  the  remaining  area  is filled black.  If the input file dimensions are too
               large, parts of the image will be cropped.

       --daemon
               Keeps xwallpaper running in background, listening for RandR events. In this mode, the  wallpapers
               are  redrawn  when  output  sizes  change.  This  option  can  only be used when RandR support is
               available and activated.

       --debug
               Displays debug messages on the standard error output while xwallpaper is  running.   If  used  in
               conjunction with --daemon the process will not modify the standard input and outputs.

       --focus file
               In  conjunction  with  --trim  the specified trim box will be guaranteed to be visible on output,
               zooming out if needed. If black pixels would occur around  the  selection,  the  input  image  is
               zoomed  in  and  moved  to  cover  them  as  good as possible under the constraint of keeping the
               specified trim box (or whole image if no trim box has been specified) on output.

       --maximize file
               Maximizes input file to fit output  without  cropping.   This  could  mean  zooming  in  or  out,
               depending  on  the  dimensions of the input file and the output.  This option guarantees that the
               whole image is seen.  If the ratio does not fit the output, the remaining area is  filled  black.
               The image itself will be centered on output.

       --no-randr
               Ignores individual outputs and uses the whole output instead.  This is the area that spans across
               all different outputs (monitors).

       --trim widthxheight+x+y
               Specifies  area  of  interest  in  source  file.  If output mode tries to output more pixels than
               specified with trim box, then the adjacent pixels around the box will be added to  output.  Black
               pixels are only added if no further source pixels are left.

       --output output
               Specifies  the  output  on which a subsequently supplied file shall be set as wallpaper.  You can
               retrieve a list of outputs on your system by executing xrandr(1).  If no output is specified, all
               outputs will be modified individually.  The special keyword all will repeat subsequent actions on
               all displays.

       --screen screen
               Specifies a screen by its screen number.  Normally all screens of an  X  display  are  processed.
               Please  note  that a screen is not a single monitor.  See --output for such a use case above.  If
               the output could not be found, nothing happens.

       --stretch file
               Stretches input file to fully cover the output.  If the aspect ratio of the input file  does  not
               match the output, then the ratio of the input file is adjusted.

       --tile file
               Uses  tiling  mode.   Draws the input file at the upper left corner of the output and repeats the
               image until the remaining area of the output is covered.

       --version
               Prints version and exits.

       --zoom file
               Zooms input file to fit output with cropping.  This could mean zooming in or  out,  depending  on
               the  dimensions of the input file and the output.  If the ratio does not fit the output, parts of
               the input file will not be shown.   The  image  itself  will  be  centered  on  output.   Default
               behaviour if no option was selected.

       If  multiple  contradicting  options  were  given, the last supplied option wins.  It is also possible to
       repeat output arguments without any subsequent files.  In that case, the  last  mode  and  file  will  be
       reused.

EXAMPLES

       Centers a PNG file as a wallpaper on LVDS-1:
             $ xwallpaper --output LVDS-1 --center file.png

       Focuses on upper left corner of a JPEG file as a wallpaper on Virtual-1:
             $ xwallpaper --output Virtual-1 --trim 1x1+0+0 --focus file.jpg

       Tiles a PNG file as a wallpaper across all outputs:
             $ xwallpaper --no-randr --tile file.png

       Zooms into a JPEG file as a wallpaper on each output individually:
             $ xwallpaper --zoom file.jpg

       Centers and recenters a JPEG file after output updates on all outputs:
             $ xwallpaper --daemon --center file.jpg

       Tiles a JPEG file as a wallpaper on VGA-1 and zooms into a PNG file on LVDS-1:
             $ xwallpaper --output VGA-1 --tile file.jpg --output LVDS-1 --zoom file.png

BUGS

       Use the GitHub issue tracker: https://github.com/stoeckmann/xwallpaper/issues

AUTHOR

       Tobias Stockmann <tobias@stoeckmann.org>

xwallpaper 0.6.2                                  June 28, 2019                                    XWALLPAPER(1)