Transform your macOS desktop with stunning animated wallpapers
A modern, minimal application for high-quality video wallpapers with seamless desktop integration
Walle brings your desktop to life with beautiful animated video wallpapers. Whether you want calming nature scenes, abstract animations, or custom content, Walle handles it all with optimized performance and native macOS integration—completely free.
|
Apply any video file as your desktop background with perfect loop transitions Import your own videos or browse curated online collections Automatically detects and optimizes for all connected displays |
Built-in download manager with pause, resume, and progress tracking Low CPU/GPU usage with memory-efficient playback engine Preview videos with resolution and duration info before applying |
| Architecture | Storage | Performance | Integration |
|---|---|---|---|
| 🧩 Modular Backend | 💾 Persistent Data | 🧠 Memory Efficient | 🍎 Native macOS |
| AppKit + SwiftData | Auto-restore Settings | Optimized Playback | Background Launch |
# Clone the repository
git clone https://github.com/zahintapadar/Walle.git
# Navigate to project
cd Walle
# Open in Xcode
open Walle.xcodeproj- Select your target device in Xcode
- Press
Cmd + Rto build and run - Grant necessary permissions when prompted
- Start adding your favorite video wallpapers!
graph TD
A[WallpaperController] --> B[VideoDownloader]
A --> C[WallpaperRenderer]
A --> D[WindowManager]
A --> E[WallpaperStorageManager]
B --> F[LocalWallpaperImporter]
C --> G[AVFoundation]
D --> H[Multi-Monitor Support]
E --> I[WallpaperModel]
style A fill:#ff6b6b
style B fill:#4ecdc4
style C fill:#45b7d1
style D fill:#96ceb4
style E fill:#feca57
| Component | Responsibility |
|---|---|
WallpaperModel.swift |
📄 SwiftData model for wallpaper metadata |
VideoDownloader.swift |
📥 Async downloads with pause/resume functionality |
WallpaperRenderer.swift |
🎥 AVPlayer-based video rendering engine |
WallpaperStorageManager.swift |
💾 Local file and thumbnail management |
WindowManager.swift |
🖼️ Background-level window handling across screens |
WallpaperController.swift |
🎛️ Main coordinator orchestrating all services |
LocalWallpaperImporter.swift |
📁 User video import and validation |
AppConfiguration.swift |
⚙️ Preferences and user settings management |
- 🌐 Online Wallpaper Browser — Integration with motionbgs.com and similar services
- 🎯 Drag & Drop Import — Effortless wallpaper addition to main window
- 🔍 Search & Tagging — Organize your wallpaper collection intelligently
- 🔋 Battery Saver Mode — Automatic optimization for laptop users
- 🌙 Screensaver Integration — Optional screensaver mode support
MIT License
Feel free to use, modify, and distribute this project