Home

Welcome to the xwallpaper wiki!

• Basic Usage
• Advanced Usage

Getting Started

For the most common case use xwallpaper --zoom file.jpg.

Quick Migration Guide

feh	xwallpaper
feh --bg-center file.jpg	xwallpaper --center file.jpg
feh --bg-fill file.jpg	xwallpaper --zoom file.jpg
feh --bg-max file.jpg	xwallpaper --maximize file.jpg
feh --bg-scale file.jpg	xwallpaper --stretch file.jpg
feh --bg-tile file.jpg	xwallpaper --tile file.jpg
feh --no-xinerama ...	xwallpaper --no-randr ...
feh --xinerama-index INT ...	xwallpaper --output STR ...

FAQ

Why does xwallpaper exist?

It avoids legacy libraries which are common among other utilities. See Design Choices for more information and if your setup might benefit from xwallpaper.

Video Tutorial

Brodie Robertson created a very nice video overview of xwallpaper's basic features listed in the quick migration guide: https://www.youtube.com/watch?v=MnBToq5dSCw