Skip to content

AnranS/wallpaper

Repository files navigation

LiveWall

LiveWall

Open-source live wallpaper app for macOS & Windows

Curated gallery · Auto carousel · Video wallpapers · Dynamic effects · Lock screen

Release Tauri 2 React 18 Rust MIT License


LiveWall Screenshot


Highlights

100+ Curated Wallpapers — Anime scenery, nature landscapes, abstract art, ready to use Auto Carousel — Hero section with smooth crossfade and Ken Burns zoom effect
One-Click Set Wallpaper — Set desktop or lock screen wallpaper instantly Dynamic Effects — Breathing, particles (snow/rain/firefly), wave effects
Video Wallpapers — MP4/WebM as animated desktop backgrounds Smart Rotation — Auto-rotate on a schedule with favorites & playlists
Performance Optimized — Auto-pause on fullscreen or battery, adaptive Retina sizing System Tray — Background mode with CPU, RAM, cache monitoring

Tech Stack

Technology
Framework Tauri 2.x — Rust backend + WebView frontend
Frontend React 18 · TypeScript · Vite · TailwindCSS
State Zustand
Effects Canvas 2D / WebGL · CSS Animations
Storage JSON-based local database

Platform Support

Platform Technique
macOS NSWindow at desktop level, joins all spaces. Lock screen follows desktop (Sonoma+)
Windows WorkerW injection (same as Wallpaper Engine). Lock screen via registry

Download

Download Latest Release

Platform Format
macOS .dmg installer
Windows .msi / .exe (coming soon)

The release includes the full wallpaper collection (100+ images) bundled in the app.

Getting Started

Prerequisites

  • Rust 1.70+
  • Node.js 18+
  • macOS: Xcode Command Line Tools
  • Windows: Visual Studio Build Tools with C++ workload

Development

git clone https://github.com/AnranS/LiveWall.git
cd LiveWall

npm install          # Install frontend dependencies
npm run tauri dev    # Run in development mode
npm run tauri build  # Build for production

Wallpaper Pack

The repo ships with 3 sample wallpapers to keep it lightweight. Download the full wallpaper pack from the latest Release and extract into public/wallpapers/.

Project Structure

LiveWall/
├── src/                     # React frontend
│   ├── pages/               #   Home, Explore, Library, Settings, Editor
│   ├── components/          #   TopNav, WallpaperCard, WallpaperPreview
│   ├── store/               #   Zustand state management
│   └── lib/                 #   Types, asset helpers, effects config
├── src-tauri/               # Rust backend
│   └── src/
│       ├── lib.rs           #   App entry, tray, window management
│       ├── commands/        #   Tauri IPC commands
│       ├── platform/        #   macOS / Windows wallpaper APIs
│       ├── wallpaper/       #   Manager + scheduler
│       └── storage/         #   JSON database layer
├── public/wallpapers/       # Bundled wallpaper images
└── scripts/                 # Wallpaper download utilities

Contributing

Contributions are welcome! Feel free to open issues and pull requests.

License

MIT