Man Linux: Main Page and Category List

NAME

       bsetbg - utility to manipulate the appearance of the X11 desktop’s root
       window.

SYNOPSIS

       bsetbg [options] image

DESCRIPTION

       bsetbg is intended to provide a standard method for the Blackbox window
       manager  to  alter  the background of the root window (although it will
       work with any other window manager as well). bsetbg acts as  a  wrapper
       both  to bsetroot and to a flexible variety of third-party applications
       that it uses when handling images files.

OPTIONS

       -f, -full image
              image is stretched to fill the entire desktop.

       -t, -tile image
              image is tiled on the desktop.

       -c, -center image
              image is centered on the desktop.

       -e, -exec program options fallback-arg image
              This option tells bsetbg to run a separate command by  executing
              program with options, where options are arguments to program.

              If  a  fallback-arg  is  supplied  (-full,  -tile, or -center as
              described above), bsetbg will assume that the last argument is a
              filename.  In  the  case  that  program  exits non-zero or isn’t
              available on the target system, bsetbg will try  to  handle  the
              file with the fallback argument.

              See the EXAMPLES section for more information on -exec.

       -p, -post list
              Specifies a list of arguments to pass to the $POST_COMMAND.

       -d, -debug
              Debugging  mode.  bsetbg  will  print commands without executing
              them.

       -g, -generate list
              Output a list of  default  configuration  values,  suitable  for
              redirecting  into  ~/.bsetbgrc.  Any arguments that are supplied
              will be considered applications to  search  for  in  the  system
              path, overriding bsetbg’s internal defaults.

       -app imageApp
              Use  this  flag  to specify which image application to use. This
              application  may  be  one  of  the  pre-defined  list   or   any
              application  capable  of displaying an image on the root window.
              This flag may be used in conjunction  with  passing  application
              specific   parameters  to  the  application,  in which case they
              should be enclosed in double quotes.

       -v, -version
              Output version number.

       -h, -help
              Output a brief usage message.

OTHER OPTIONS

       bsetbg will also accept all of the arguments for bsetroot.  Consult the
       bsetroot(1) man page for further information.

CONFIGURATION

       bsetbg  will read its configuration values from the file ~/.bsetbgrc if
       it exists. Otherwise, it will scan the system path  for  a  pre-defined
       list of image applications to use (currently this list consists of qiv,
       xli, xv, wmsetbg, Esetroot, display, and xsetbg).   ~/.bsetbgrc  should
       contain the following variables:

           CENTER="string"
              Application  and  arguments to be used to center an image on the
              root window when the -center argument is specified.

           FULL="string"
              Application and arguments to be used to stretch an image to fill
              the root window when the -full argument is specified.

           TILE="string"
              Application  and  arguments  to  be used to tile an image on the
              root window when the -tile argument is specified.

           DEFAULT="string"
              Action to take place by default if none of the above  have  been
              specified.

       The following variables are optional:

           NO_EXEC="boolean"
              If  this  variable  is  set,  bsetbg  will never modify the root
              window.

           POST_COMMAND="string"
              This variable specifies a command that  bsetbg  will  run  after
              every successful modification of the root window.

           LOG_LAST_CMD="boolean"
              If  this variable is set, bsetbg will keep a logfile of the last
              two successful commands.

           LOGFILE="string"
              This  variable  can  specify  the  logfile  to  be   used   when
              $LOG_LAST_CMD is defined.  The default is ~/.bsetbg_last_cmd .

       As  mentioned above, bsetbg will function perfectly for the majority of
       users without having a configuration file. Power users  who  want  more
       control  over bsetbg’s behavior should run bsetbg -g and use the output
       to create a ~/.bsetbgrc which may then be tweaked by hand.

EXAMPLES

       In this example, bsetbg will set the image in centered mode:

           bsetbg -center foo.png

       An example of the -exec argument:

           bsetbg  -exec xv -root -quit -rmode 5 -rbg rgb:2/2/2 \      -center
       foo.png

       An example in which bsetbg creates a configuration file  using  xv  and
       qiv:

            bsetbg -g xv qiv > ~/.bsetbgrc

       An example of the use of the -app argument:

           bsetbg  -app qiv "-o rgb:d6/c5/a2 -x" -c foo.png

AUTHOR

       The author of bsetbg may be reached at tmk@lordzork.com.

SEE ALSO

       blackbox(1), bsetroot(1), qiv(1), xli(1), xv(1), display(1), wmsetbg(1)