← 返回命令列表

Linux command

xwallpaper 命令

文本

复制后可按需替换文件名、目录或参数。

常用示例

Set wallpaper centered

xwallpaper --center [image.jpg]

Set wallpaper zoomed to fill

xwallpaper --zoom [image.jpg]

Stretch to fit screen

xwallpaper --stretch [image.jpg]

Tile wallpaper

xwallpaper --tile [image.png]

Set for specific output

xwallpaper --output [HDMI-1] --zoom [image.jpg]

Different wallpapers per output

xwallpaper --output [HDMI-1] --zoom [wall1.jpg] --output [eDP-1] --center [wall2.jpg]

Run as daemon

xwallpaper --daemon --zoom [image.jpg]

说明

xwallpaper is a wallpaper setting utility for X11. It supports JPEG, PNG, and XPM formats with various scaling modes to fit different display configurations. The tool supports multi-monitor setups through RandR, allowing different wallpapers per output. In daemon mode, it monitors output changes and redraws wallpapers automatically when displays are connected or resized. Wallpaper atoms are set to support semi-transparent backgrounds in compatible applications. For Wayland, consider using swaybg or wbg instead.

参数

--center _file_
Center image without scaling.
--zoom _file_
Zoom to fill, cropping if needed.
--maximize _file_
Scale to fit without cropping.
--stretch _file_
Stretch to fill, ignoring aspect ratio.
--tile _file_
Tile image from upper left.
--focus _file_
Focus on selection with --trim.
--output _name_
Target specific output (use xrandr to list).
--screen _screen_
Target specific X screen.
--trim _WxH+X+Y_
Trim input image.
--daemon
Redraw on output changes.
--clear
Clear wallpaper.
--no-randr
Disable RandR support.
--no-atoms
Don't set wallpaper atoms.
--debug
Enable debug output.
--version
Display version.

FAQ

What is the xwallpaper command used for?

xwallpaper is a wallpaper setting utility for X11. It supports JPEG, PNG, and XPM formats with various scaling modes to fit different display configurations. The tool supports multi-monitor setups through RandR, allowing different wallpapers per output. In daemon mode, it monitors output changes and redraws wallpapers automatically when displays are connected or resized. Wallpaper atoms are set to support semi-transparent backgrounds in compatible applications. For Wayland, consider using swaybg or wbg instead.

How do I run a basic xwallpaper example?

Run `xwallpaper --center [image.jpg]` in a terminal, then adjust file names, paths, flags, or remote targets for your system.

What does --center _file_ do in xwallpaper?

Center image without scaling.