1
.\" $Id: fbsetbg.1 3700 2004-11-19 11:37:27Z mathias $
3
.\" Copyright (c) 2004, Han Boetes <han@fluxbox.org>
5
.\" Permission to use, copy, modify, and distribute this documentation for
6
.\" any purpose with or without fee is hereby granted, provided that the
7
.\" above copyright notice and this permission notice appear in all copies.
9
.\" THE DOCUMENTATION IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL
10
.\" WARRANTIES WITH REGARD TO THIS DOCUMENTATION INCLUDING ALL IMPLIED
11
.\" WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE
12
.\" AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
13
.\" DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
14
.\" PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
15
.\" TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
16
.\" PERFORMANCE OF THIS DOCUMENTATION
23
.Nd "set a background/wallpaper"
27
.Op Fl fctaFCTA Ar wallpaper
28
.Op Fl uU Ar wallpapersetter
29
.Op Fl bB Ar bsetrootoptions ...
35
is a wrapper that tries to find a suitable background-setting app and
36
then tries to set the wallpaper using that app. You don't have to
37
configure fbsetbg. It just uses the first app it can find.
39
Furthermore it supports remembering the last set wallpaper so you don't
40
have to edit the style or init-file to change the wallpaper.
42
It aims to provide clear error messages in a window that make debugging
47
Set fullscreen wallpaper.
49
Set centered wallpaper.
53
Set maximized wallpaper, preserving aspect (if your bgsetter doesn't
54
support this option fbsetbg falls back to
57
.It Fl u Ar wallpapersetter
58
Use specified wallpapersetter, use no argument to forget.
59
.It Fl b Ar bsetrootoptions
60
Forward the options to bsetroot.
62
Set random wallpaper from a directory.
63
.It Fl F , C , T , A , U , B , R
64
Same as the uncapsed option but without remembering.
66
Set previous wallpaper. Or, if the random feature was last used, set
67
another random wallpaper from the same directory.
69
Display usefull information about best wallpapersetter found.
71
Display some usefull tips.
73
Display a help message.
76
.Bl -tag -width "~/.fluxbox/lastwallpaper" -compact
77
.It Pa ~/.fluxbox/lastwallpaper
79
In this file the wallpaper you set will be stored, for the
82
.Sh ENVIRONMENT VARIABLES
83
.Pp fbsetbg supports the following environmental variables:
85
Wallpapersetters to use.
88
The display you want to set the wallpaper on.
93
as wallpapersetter and set
95
from the current directory as wallpaper.
96
.Bd -literal -offset indent
97
$ wpsetters=feh fbsetbg wallpaper.jpg
100
Recall the last set wallpaper on display
102
with the stored options.
103
.Bd -literal -offset indent
104
$ DISPLAY=:0.0 fbsetbg -l
109
.Sh ONLINE DOCUMENTATION:
110
Much more extensive documentation for
113
http://www.xs4all.nl/~hanb/software/fluxbox/fbsetbg.html
118
The author of fbsetbg is Han Boetes <han@fluxbox.org>