awesome/manpages/awsetbg.1.txt

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 the first application it finds.

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 the aspect ratio. If the application chosen does not support this
    option, fullscreen is used as fall back.
*-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 lowercase options, 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 screens (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