drift-wallpaper

Fluid live wallpaper for macOS, Windows, and Linux, inspired by sandydoo/flux.

Quick start

Recommended: use wax:

wax install undivisible/tap/drift-wallpaper

Or with Homebrew (macOS / Linux):

brew install undivisible/tap/drift-wallpaper

---

Manual install

If you don't use wax or Homebrew, download and run the installer directly:

macOS / Linux

curl -fsSL https://raw.githubusercontent.com/undivisible/drift-wallpaper/m/scripts/install.sh | bash

Windows (PowerShell)

powershell -ExecutionPolicy Bypass -c "irm https://raw.githubusercontent.com/undivisible/drift-wallpaper/m/scripts/install.ps1 | iex"

From a local checkout (builds from source):

./scripts/install.sh          # macOS / Linux
.\scripts\install.ps1         # Windows

---

Development builds

For the latest unreleased changes, use --head or the --version flag:

brew install --head drift-wallpaper

DRIFT_USE_RELEASE=1 ./scripts/install.sh --version latest

.\scripts\install.ps1 -UseRelease -Version latest

Build from source manually:

cargo build --release -p drift-app

# Control panel (GPUI)
./target/release/drift-wallpaper --settings

# Desktop wallpaper windows
./target/release/drift-wallpaper --background

# Large movable preview
./target/release/drift-wallpaper --preview

Run drift-wallpaper --help for presets, image sources, and other flags.

On macOS, configuration is stored at:

~/Library/Application Support/drift-wallpaper/config.json

Workspace

Crate	Role
drift-core	wgpu fluid simulation, WGSL shaders, color / presets
drift-app	winit wallpaper windows, GPUI settings UI, macOS desktop integration

Tests & CI

cargo fmt --all --check
cargo clippy --workspace --all-targets --locked -- -D warnings
cargo test --workspace --all-targets --locked

License

MPL-2.0.