awesome/awsetbg.1.txt

76 lines
2.0 KiB
Plaintext

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