Section: v2.0 (1)Updated: February 2002Local indexUp
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, -fullimage
image is stretched to fill the entire desktop.
-t, -tileimage
image is tiled on the desktop.
-c, -centerimage
image is centered on the desktop.
-e, -execprogramoptionsfallback-argimage
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, -postlist
Specifies a list of arguments to pass to the $POST_COMMAND.
-d, -debug
Debugging mode. bsetbg will print commands without executing them.
-g, -generatelist
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.
-appimageApp
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: