Repository navigation
Releases: imsachink/AerialMotion
Release list
AerialMotion v1.2.1
AerialMotion v1.2.1 resolves wallpaper desynchronization between desktop home screen motion and the native macOS Lock Screen when selecting wallpapers from the in-app Discover community gallery.
🐛 Fixes & Improvements
- Lock Screen & Desktop Synchronization: Resolved desynchronization between desktop live motion and the native macOS Lock Screen when selecting wallpapers from Discover.
- Complete Index.plist Architecture:
IndexManagernow writesDesktop,Idle, andLinkedconfigurations acrossAllSpacesAndDisplays,SystemDefault, physical display UUIDs (Displays), and virtual spaces (Spaces), ensuringWallpaperAerialsExtensionalways locks onto the correct asset. - Automatic Launch Verification: AerialMotion now automatically re-verifies and syncs
Index.plistand Apple's wallpaper engine on app startup. - 1-Click Lock Screen Re-Sync: Discover and Library items can now be re-synced anytime with a single click even when already marked active.
- Safe Catalog Fallback: Enhanced
CatalogManagerfile validation to protect.movassets during catalog updates.
📦 Downloads & Installation
- Download
AerialMotion.dmgbelow. - Open the
.dmgand dragAerialMotion.appinto/Applications.
If prompted by Gatekeeper on macOS Sonoma / Sequoia:
xattr -cr /Applications/AerialMotion.appFull Changelog: v1.2.0...v1.2.1
AerialMotion v1.2.0 — Discover Curated 4K Gallery
AerialMotion v1.2.0 — Curated 4K Ambient Gallery & Fast Downloader
✨ What's New
- Discover 4K Curated Community Gallery: An all-new in-app gallery tab to browse and download verified, non-dizzy, slow ambient live wallpapers with 1-click download and instant apply.
- Expanded Ambient Wallpaper Lineup (9 Presets):
- 🌌 Space & Dark: Cosmic Orbital Habitat (3.3 MB), Deep Space Nebula (2.1 MB), and Midnight Forest Signal (2.2 MB)
- ⛩️ Zen & Japan: Japanese Garden Serenity (4.4 MB, created by Sachin Kaundal via Kling AI) & Twilight Over Horizon (2.4 MB)
- 🌧️ Cozy & Lo-Fi: Cozy Forest Cabin (6.4 MB) & Neon Rain Pod (3.0 MB)
- 🌲 Deep Nature: Blue Forest Waterfalls (7.8 MB) & Golden Alpine Meadow (2.9 MB)
- Creator Credits & Attribution: Full creator credits and clickable source links displayed directly on each wallpaper card in the gallery.
- Category Filters: Easily filter by ✨ All, 🌌 Space & Dark, ⛩️ Zen & Japan, 🌧️ Cozy & Lo-Fi, and 🌲 Deep Nature.
- Dynamic Live Catalog Refresh: Live Sync (🔄) button that pulls updated catalog manifests from GitHub with cache-busting, allowing new community wallpapers to appear without updating the app.
- Native Kernel Downloader with Cancel Support: Fast streaming via
URLSessionDownloadTaskwith progress tracking and an instant Stop Download button to cancel in-progress downloads at any time. - Interactive Navigation Pills: Full-frame hit-tested navigation tabs and filter pills for responsive clicking anywhere on the button.
🐛 Fixes & Polish
- Dedicated Settings Window: Settings now opens in its own native macOS window, preventing it from collapsing or disappearing when clicking buttons, toggles, or opening directories.
- Direct Wallpaper Activation: Fixed name matching between catalog presets and library items so clicking 'Download & Set' directly activates any curated loop without stalling.
- Live Processing Feedback: Added active 'Setting...' indicator during background conversion.
📦 Downloads & Installation
Download AerialMotion.dmg below, drag to /Applications, and enjoy continuous hardware-accelerated ambient live wallpapers on macOS.
If prompted by Gatekeeper on macOS Sonoma / Sequoia:
xattr -cr /Applications/AerialMotion.appFull Changelog: v1.1.2...v1.2.0
AerialMotion v1.1.2 — Menu Bar Right-Click Fix & Standard Popover UX
What's Changed in v1.1.2
🐛 Bug Fixes & Improvements
- Menu Bar Right-Click Fix: Completely eliminated global top-edge click interception and gesture recognizers. Right-clicking anywhere on the menu bar will no longer trigger the AerialMotion popover.
- Standard 1-Click macOS Popover: Conformed interface to standard macOS menu bar app design (left-click opens full popover with controls, settings, updates, and quit).
- Automated Process Replacement: Updated installer scripts to cleanly shut down existing running instances before replacing the app in /Applications.
📥 Downloads
- 📦 AerialMotion.dmg — Universal macOS disk image (Apple Silicon & Intel)
- 🎬 AerialMotion-Demo-1080p.mp4 — Full HD 1080p Walkthrough Video
If prompted by Gatekeeper on macOS Sonoma / Sequoia:
xattr -cr /Applications/AerialMotion.appFull Changelog: v1.1.1...v1.1.2
AerialMotion v1.1.1 — 1-Click Video Picker & Desktop Layering Fix
What's Changed in v1.1.1
🎯 1-Click Native Video File Picker
- Interactive Drop Zone: The entire drop zone card in the menu bar popover is now an interactive button that launches macOS's native NSOpenPanel. Users can import .mp4, .mov, and .m4v video files with a single click without needing to drag-and-drop.
- Status Bar Shortcut: Added Add Video Wallpaper shortcut for instant file selection.
🐛 Bug Fixes & Stability Improvements
- Desktop Window Layer Positioning: Adjusted window server level to -2147483604 using orderFrontRegardless(). This positions the live desktop video above Dock's wallpaper backdrop and underneath Finder desktop icons and desktop widgets.
- Battery Saver Default & Quick Resume: Set pauseOnBattery to default false so continuous desktop motion plays out-of-the-box on battery. Added an instant Play on Battery action button directly on the menu bar card if Battery Saver is ever engaged.
- Popover Layout Sizing: Fixed popover clipping by setting an explicit 380x490 frame, ensuring all saved wallpapers and library cards remain fully visible without collapsing.
📥 Downloads
- 📦 AerialMotion.dmg — Universal macOS disk image (Apple Silicon & Intel)
If prompted by Gatekeeper on macOS Sonoma / Sequoia:
xattr -cr /Applications/AerialMotion.appFull Changelog: v1.1.0...v1.1.1
AerialMotion v1.1.0 — Continuous Desktop Live Motion & Battery Saver
🚀 What's Changed in v1.1.0
🖥️ Continuous Desktop Live Motion
- Home Screen Video Playback: Introduced continuous live video looping on the macOS Home Screen (Desktop) using hardware-accelerated
AVPlayerLayerrendering with minimal CPU footprint (~1.5%).
🔋 Wallspace-Grade Ultra-Low Battery Saver
- Pause on Battery: Pauses desktop motion automatically when running on MacBook battery to preserve runtime.
- Low Power Mode: Automatically pauses when macOS Low Power Mode is engaged.
- Desktop Occlusion Sensing: Drops to 0% CPU/GPU whenever full-screen windows or active apps cover the desktop.
- Display Sleep & Screen Lock: Instantly pauses playback when displays sleep or the screen locks.
⚡ 1-Click In-App Auto-Updater
- Downloads and verifies new
.dmgreleases directly inside the menu bar companion, extracts the update, replaces/Applications/AerialMotion.app, and automatically relaunches — zero browser navigation required.
📥 Installation & Verification
Download AerialMotion.dmg.
If prompted by Gatekeeper:
xattr -cr /Applications/AerialMotion.appFull Changelog: v1.0.1...v1.1.0
AerialMotion v1.0.1 — Dual-Layer HEVC & Status Bar Context Menu
🛠️ What's Changed in v1.0.1
🔧 Architecture & Video Engine
- Apple VideoToolbox 2-Layer Hierarchical HEVC: Resolved the black desktop wallpaper bug in macOS Sonoma/Sequoia by encoding dual-layer HEVC (
temporal_id=0/1), matching Apple's internalWallpaperAerialsExtensionparser specifications. - Mission Control Multi-Space Desync: Cleared orphaned space UUIDs in
Index.plistto prevent blank spaces when switching desktops. - Zero External Dependencies: Native fallback using Apple's built-in
/usr/bin/avconvertutility; ffmpeg is purely optional.
🎨 User Experience
- Status Bar Right-Click Menu: Implemented AppKit gesture recognizer on status bar button offering Check for Updates, Settings, Buy Me a Coffee, and Quit (⌘Q).
- Update Checker: Automated GitHub Releases update checking and alerts.
📥 Installation & Verification
Download AerialMotion.dmg.
Full Changelog: v1.0.0...v1.0.1
AerialMotion v1.0.0 — Native macOS Aerial Wallpaper Engine
🎉 AerialMotion v1.0.0 - Initial Public Release
Set any .mp4 or .mov video as your native macOS desktop AND lock screen wallpaper with zero background daemon and near-zero CPU usage.
✨ Features
- Native macOS Sonoma & Sequoia Aerial Engine: Hooks directly into
WallpaperAgent. - Lock Screen & Desktop Sync: Both display the exact same video asset, synchronized seamlessly.
- Drag-and-Drop Ingestion: Drop any video file onto the menu bar companion.
- Custom Wallpaper Library: Save favorite video wallpapers with 1-click switching.
- 100% Reversible: Restore Apple default wallpapers at any time with one click.
- Hardware Accelerated: Native AVFoundation remuxing with zero battery drain.
- Free & Open Source: MIT Licensed.
📥 Installation
Download AerialMotion.dmg.
Full Changelog: https://github.com/imsachink/AerialMotion/commits/v1.0.0