Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
bsetbg(1)			     v2.0			     bsetbg(1)

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 de-
	      scribed 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  applica-
	      tion  capable  of	 displaying  an	image on the root window. This
	      flag may be used in conjunction with  passing  application  spe-
	      cific   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 win-
	      dow.

	   POST_COMMAND="string"
	      This variable specifies a	command	that bsetbg will run after ev-
	      ery 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)

bsetbg				 February 2002			     bsetbg(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | OTHER OPTIONS | CONFIGURATION | EXAMPLES | AUTHOR | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=bsetbg&sektion=1&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help