drift-wallpaper
May 6, 2026 ยท View on GitHub
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