FBSETBG(1)                      Fluxbox Manual                      FBSETBG(1)

NAME
       fbsetbg - Set a background wallpaper or pattern

SYNOPSIS
       fbsetbg [-uU wallpapersetter] [-fFcCtTaA] wallpaper

       fbsetbg [-uU wallpapersetter] -rR path

       fbsetbg -bB fbsetrootoptions...

       fbsetbg [-l|h|i|p]

DESCRIPTION
       fbsetbg(1) is a wrapper that tries to find a suitable
       background-setting app and then tries to set the wallpaper using that
       app. You don't have to configure fbsetbg. It just uses the first app it
       can find.

       Furthermore it supports remembering the last set wallpaper so you don't
       have to edit the style or init-file to change the wallpaper.

       It aims to provide clear error messages in a window that make debugging
       problems easy.

OPTIONS
       -f file
           Set fullscreen wallpaper.

       -c file
           Set centered wallpaper.

       -t file
           Set tiled wallpaper.

       -a file
           Set maximized wallpaper, preserving aspect (if your bgsetter
           doesn't support this option fbsetbg falls back to -f).

       -u wallpapersetter
           Use specified wallpapersetter, use no argument to forget.

       -b fbsetrootoptions
           Forward the options to fbsetroot(1). These can be used to set a
           solid, pattern, or gradient background texture.

       -r directory
           Set random wallpaper from a directory.

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

       -l
           Set previous wallpaper. Or, if the random feature was last used,
           set another random wallpaper from the same directory.

       -i
           Display useful information about best wallpapersetter found.

       -p
           Display some useful tips.

       -h
           Display a help message.

FILES
       ~/.fluxbox/lastwallpaper
           In this file the wallpaper you set will be stored, for the -l
           option.

ENVIRONMENT
       wpsetters
           Wallpapersetters to use. This can be a space-delimited list of the
           applications to try, or just a single name.

       DISPLAY
           The display you want to set the wallpaper on.

EXAMPLES
       To use feh(1) as wallpapersetter and set wallpapper.jpg from the
       current directory as wallpaper.

           $ wpsetters=feh fbsetbg wallpaper.jpg

       Recall the last set wallpaper on display :0.0 with the stored options.

           $ DISPLAY=:0.0 fbsetbg -l

BUGS
       fbsetbg(1) is not foolproof.

AUTHORS
       The author of fbsetbg is Han Boetes <han at fluxbox.org>

       This manpage was converted to asciidoc format by Jim Ramsay <i.am at
       jimramsay.com> for fluxbox-1.1.2

SEE ALSO
       fluxbox(1) fbsetroot(1)

AUTHOR
       Jim Ramsay <i.am@jimramsay.com>
           Author.

fbsetbg.txt                    08 February 2015                     FBSETBG(1)