manpages/awsetbg.1.txt

   1 awsetbg(1)
   2 =========
   3
   4 NAME
   5 ----
   6 awsetbg - awesome wrapper tool to set background
   7
   8 SYNOPSIS
   9 --------
  10 *awsetbg* [-fctaFCTA wallpaper] [-uU wallpapersetter] [-m #] [-bB fbsetrootoptions ...] [-rR path] [-l]
  11
  12 DESCRIPTION
  13 -----------
  14 *awsetbg* is a wrapper that tries to find a suitable background setting application and then
  15 tries to set the wallpaper using that application. You do not have to configure *awsetbg*, since
  16 it just uses te first application it find.
  17
  18 Furthermore, it remembers the last wallpaper set, so you do not have to edit anything to change
  19 the wallpaper.
  20
  21 OPTIONS
  22 -------
  23 *-f* file::
  24     Set fullscreen wallpaper.
  25 *-c* file::
  26     Set centered wallpaper.
  27 *-t* file::
  28     Set tiled wallpaper.
  29 *-a* file::
  30     Set maximized wallpaper, preserving aspect. If the application chosen do not support this
  31     option, fullscreen is used as fallback.
  32 *-u* wallpapersetter::
  33     Use the specified wallpaper setter tool.
  34 *-r* directory::
  35     Set a random wallpaper from this directory.
  36 *-F, -C, -T, -A, -U, -R*::
  37     Same as the lowercaser option, but without remembering.
  38 *-l*::
  39     Set the previous wallpaper. If the random feature was the last used, it will set another
  40     random wallpaper from this same directory.
  41 *-i*::
  42     Display useful information about the best application to set the wallpaper found.
  43 *-m #*::
  44     Use montage to create a big image (image should fit screen size). Requires montage(1).
  45     # is the number of screen (columns in montage).
  46 *-p*::
  47     Display useful tips.
  48 *-h*::
  49     Display help message.
  50
  51 FILES
  52 -----
  53 $XDG_CACHE_HOME/awesome/lastwallpaper or $HOME/.cache/awesome/lastwallpaper
  54 files contains the last wallpaper set to use with the -l option.
  55
  56 ENVIRONMENT VARIABLES
  57 ---------------------
  58 *wpsetters*::
  59     Wallpaper setters to use.
  60 *DISPLAY*::
  61     Display you want to set the wallpaper on.
  62
  63 SEE ALSO
  64 --------
  65 awesome(1)
  66
  67
  68 AUTHORS
  69 -------
  70 Julien Danjou <julien@danjou.info> and others.
  71 awsetbg is derived from fbsetbg which was written by Han Boetes <han@fluxbox.org>.
  72
  73 WWW
  74 ---
  75 http://awesome.naquadah.org