Layered WallPaper
A small multi-platform parallax engine: build a wallpaper from stacked image layers, and each layer shifts at its own rate as the mouse moves.
No release since July 2024. The project may no longer be maintained.
Highlights
- Moves each image layer at its own rate as the mouse moves.
- Builds a wallpaper from numbered .bmp layers and a config file.
- Assigns a different wallpaper directory to each monitor.
- Runs as a plain SDL2 process with no desktop environment hooks.
Overview
Layered WallPaper, usually shortened to lwp, produces a parallax desktop background from a set of stacked images. Each layer follows the mouse cursor by a different amount, so the foreground appears to move faster than the background and the wallpaper gains depth without a video file. It is written in C on top of SDL2, published under MIT, and runs on Windows and Linux. The idea is narrow on purpose: it is a parallax renderer, not a general wallpaper engine, and it does not play video or run web content.
How it works
A wallpaper is a directory holding numbered bitmap layers and a wallpaper.cfg file. Layers are named 1.bmp, 2.bmp and so on, with the lowest number at the bottom, and the config lists how many layers exist and how far each one travels in response to a mouse movement in the x and y axes. Global sensitivity can be overridden per layer, and a wallpaper can repeat horizontally or vertically for tiling. A single configuration file outside the wallpaper directory decides the monitor layout, the wallpaper assigned to each monitor, and its position and scale on that monitor.
Setup
On Windows, download the installer from the releases page and run it; the tray icon opens the configuration window. On Linux, unpack the tarball into /usr/local, or set LWP_PREFIX if you install elsewhere, and add lwp to your desktop environment's startup file. Copy the default configuration to your home directory, then select a wallpaper for each monitor. Under Wayland, install XWayland as well, and some distributions need the draw-on-root-window setting enabled. The project ships no distribution packages, so the tarball is the only supported Linux install route.
Limitations
Making a wallpaper means preparing separate layer images yourself, which usually means cutting an existing picture into pieces in an image editor. Only bitmap layers are supported. There is no distribution package, so updates are manual. The last release was in July 2024, so recent desktop environment changes are not covered by a tagged build, and there is no graphical config editor.
Platforms and license
Platforms: Windows + Linux
Requirements: Windows or Linux from the packaged builds. On Linux with Wayland, XWayland is also required.
License: MIT
License text (MIT) (opens in new tab)
Source repository (opens in new tab)
WallMori is not affiliated with jszczerbinsky.
Layered WallPaper is a trademark of its respective owner.
Other wallpaper tools
- Lively Wallpaper — Windows wallpaper engine that runs video, GIF, web and application wallpapers behind the desktop icons, and pauses them when a full-screen app takes focus.
- WinDynamicDesktop — Brings the macOS dynamic desktop to Windows: a theme of images is swapped through the day, timed against local sunrise and sunset or a schedule you set yourself.
- Octos — A web-based dynamic desktop engine for Windows that runs HTML, CSS and JavaScript wallpapers with an API for media and system data.