---
name: "awsetbg"
section: "1"
platform: "linux"
package: "awesome"
version: "3.4.15-1+b1"
release: "Debian 8 (Jessie)"
platforms: ["linux"]
url: "https://new.carta.tech/awsetbg"
---

# awsetbg(1)

awesome wrapper tool to set background

## 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)](/montage/1.md). # 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)](/awesome/1.md)

## AUTHORS

Julien Danjou \<**julien@danjou.info**\[1\]\> and others. awsetbg is derived from fbsetbg which was written by Han Boetes \<**han@fluxbox.org**\[2\]\>.

## WWW

**http://awesome.naquadah.org**

## NOTES

- 1\.

  julien@danjou.info

  mailto:julien@danjou.info

- 2\.

  han@fluxbox.org

  mailto:han@fluxbox.org