xwinwrap

Run video as background

$ xwinwrap -b -nf -ov -- mpv --wid wid --loop --no-audio --no-resume-playback --panscan=1.0 [path/to/video.mp4]

$ xwinwrap -b -nf -fs -ov -- mpv --wid wid --loop --no-audio --no-resume-playback --panscan=1.0 [path/to/video.mp4]

$ xwinwrap -b -nf -ov -o 0.8 -- mpv --wid wid --loop --no-audio --no-resume-playback --panscan=1.0 [path/to/video.mp4]

$ xwinwrap -g 1600x900+1920 -b -nf -ov -- mpv --wid wid --loop --no-audio --no-resume-playback --panscan=1.0 [path/to/video.mkv]

xwinwrap [OPTIONS] -- COMMAND

xwinwrap runs a program as a desktop background window. It creates a window behind all others and passes its window ID to the child program, enabling video wallpapers and animated backgrounds.
Commonly used with mpv to play videos as desktop backgrounds.

-b

Below other windows

No focus

Fullscreen

Set override redirect

Set opacity (0.0 to 1.0)

Window geometry (WxH+X+Y)

Window ID placeholder for child process

X11 only. May not work with all window managers or compositors. Child process must support window ID parameter.

mpv(1), feh(1)