Fluid live wallpaper inspired by sandydoo/flux. macOS is the primary, fully integrated target; Linux (X11) and Windows ship release binaries with wallpaper support (tray, media art, and some macOS-only integrations differ by platform).
From crates.io (Rust toolchain required):
cargo install drift-wallpaper --lockedRecommended (macOS): use wax:
wax install undivisible/tap/drift-wallpapermacOS
curl -fsSL https://raw.githubusercontent.com/undivisible/drift-wallpaper/m/scripts/install.sh | bashFrom a local checkout (builds from source):
./scripts/install.shLinux
From a checkout (needs Rust and the same dev packages as CI — see Tests & CI):
./scripts/install.sh --sourceOr download drift-wallpaper-linux-x86_64.tar.gz from GitHub Releases (published on version tags).
Windows
In PowerShell, from a checkout:
.\scripts\install.ps1Or download drift-wallpaper-windows-x86_64.zip from GitHub Releases.
For the latest unreleased changes on macOS, use --head or the --version flag:
wax install undivisible/tap/drift-wallpaper --headDRIFT_USE_RELEASE=1 ./scripts/install.sh --version latestBuild from source manually:
cargo build --release -p drift-wallpaper
# Control panel (GPUI)
./target/release/drift-wallpaper --settings
# Desktop wallpaper windows
./target/release/drift-wallpaper --background
# Large movable preview
./target/release/drift-wallpaper --previewRun drift-wallpaper --help for presets, image sources, and other flags.
Config paths
| OS | Location |
|---|---|
| macOS | ~/Library/Application Support/drift-wallpaper/config.json |
| Linux / Windows | drift-config.json in the process working directory (today) |
Pushing a tag v* (for example v0.1.44) runs CI on macOS, Linux, and Windows, then attaches:
drift-wallpaper-macos-aarch64.tar.gzdrift-wallpaper-linux-x86_64.tar.gzdrift-wallpaper-windows-x86_64.zip
Each archive has a matching .sha256 checksum on the release page.
| Crate | Role |
|---|---|
drift-core |
wgpu fluid simulation, WGSL shaders, color / presets |
drift-wallpaper (crate in crates/drift-app) |
winit wallpaper windows, GPUI settings UI, platform desktop integration |
Local (same as GitHub Actions):
cargo fmt --all --check
cargo clippy --workspace --all-targets --locked -- -D warnings
cargo test --workspace --all-targets --lockedLinux build in Docker (no GPU/display; validates compile + tests like CI):
docker build -t drift-wallpaper-linux .On macOS with Apple Silicon, Docker runs linux/amd64 by default for this image; add --platform linux/amd64 if your builder requires it.