


AWSETBG(1)                  awsetbg(1)                 AWSETBG(1)


NAME
       awsetbg - awesome wrapper tool to set background

SYNOPSIS
       awsetbg  [-fctaFCTA wallpaper] [-uU wallpapersetter] [-m #] [-bB fbset-
       rootoptions ...] [-rR path] [-l]


DESCRIPTION
       awsetbg is a wrapper that tries to find a suitable  background  setting
       application and then tries to set the wallpaper using that application.
       You do not have to configure awsetbg, since  it  just  uses  the  first
       application it finds.


       Furthermore, it remembers the last wallpaper set, so you do not have to
       edit anything to change the wallpaper.


OPTIONS
       -f file
              Set fullscreen wallpaper.


       -c file
              Set centered wallpaper.


       -t file
              Set tiled wallpaper.


       -a file
              Set maximized wallpaper, preserving the  aspect  ratio.  If  the
              application  chosen  does not support this option, fullscreen is
              used as fall back.


       -u wallpapersetter
              Use the specified wallpaper setter tool.


       -r directory
              Set a random wallpaper from this directory.


       -F, -C, -T, -A, -U, -R
              Same as the lowercase options, but without remembering.


       -l     Set the previous wallpaper. If the random feature was  the  last
              used, it will set another random wallpaper from this same direc-
              tory.




                                                                1





AWSETBG(1)                  awsetbg(1)                 AWSETBG(1)


       -i     Display useful information about the best application to set the
              wallpaper found.


       -m #   Use  montage  to  create  a  big  image (image should fit screen
              size). Requires montage(1). # is the number of screens  (columns
              in montage).


       -p     Display useful tips.


       -h     Display help message.


FILES
       $XDG_CACHE_HOME/awesome/lastwallpaper or $HOME/.cache/awesome/lastwall-
       paper files contains the last wallpaper set to use with the -l  option.


ENVIRONMENT VARIABLES
       wpsetters
              Wallpaper setters to use.


       DISPLAY
              Display you want to set the wallpaper on.


SEE ALSO
       awesome(1)


AUTHORS
       Julien  Danjou <julien@danjou.info: mailto:julien@danjou.info> and oth-
       ers. awsetbg is derived from fbsetbg which was written  by  Han  Boetes
       <han@fluxbox.org: mailto:han@fluxbox.org>.


WWW
       http://awesome.naquadah.org: http://awesome.naquadah.org
















                                                                2


