awsetbg(1)

=========

NAME

----

awsetbg - awesome wrapper tool to set background

SYNOPSIS

--------

*awsetbg* [-fctaFCTA wallpaper] [-uU wallpapersetter] [-m #] [-bB fbsetrootoptions ...] [-rR path] [-l]

DESCRIPTION

-----------

*awsetbg* is a wrapper that tries to find a suitable background setting application and then

tries to set the wallpaper using that application. You do not have to configure *awsetbg*, since

it just uses te first application it find.

Furthermore, it remembers the last wallpaper set, so you do not have to edit anything to change

the wallpaper.

OPTIONS

-------

*-f* file::

Set fullscreen wallpaper.

*-c* file::

Set centered wallpaper.

*-t* file::

Set tiled wallpaper.

*-a* file::

Set maximized wallpaper, preserving aspect. If the application chosen do not support this

option, fullscreen is used as fallback.

*-u* wallpapersetter::

Use the specified wallpaper setter tool.

*-r* directory::

Set a random wallpaper from this directory.

*-F, -C, -T, -A, -U, -R*::

Same as the lowercaser option, but without remembering.

*-l*::

Set the previous wallpaper. If the random feature was the last used, it will set another

random wallpaper from this same directory.

*-i*::

Display useful information about the best application to set the wallpaper found.

*-m #*::

Use montage to create a big image (image should fit screen size). Requires montage(1).

# is the number of screen (columns in montage).

*-p*::

Display useful tips.

*-h*::

Display help message.

FILES

-----

$XDG_CACHE_HOME/awesome/lastwallpaper or $HOME/.cache/awesome/lastwallpaper

files contains the last wallpaper set to use with the -l option.

ENVIRONMENT VARIABLES

---------------------

*wpsetters*::

Wallpaper setters to use.

*DISPLAY*::

Display you want to set the wallpaper on.

SEE ALSO

--------

awesome(1)

AUTHORS

-------

Julien Danjou <julien@danjou.info> and others.

awsetbg is derived from fbsetbg which was written by Han Boetes <han@fluxbox.org>.

WWW

---

http://awesome.naquadah.org