[!NOTE]

I’ll be Transforming Objective C++ UI's to SwiftUI. But the daemon won't change.

LiveWallpaper App for MacOS 14+

Languages: English | 简体中文

This is an open-source live wallpaper application for MacOS 14+

Install using brew

Run this on terminal brew tap thusvill/livewallpaper && brew install --cask livewallpaper

Installation(Compile from source)

• macOS 14+
• git
• Xcode
• Cmake

Run this: git clone https://github.com/thusvill/LiveWallpaperMacOS.git && cd LiveWallpaperMacOS && mkdir -p build && cd build && cmake .. && make -j$(sysctl -n hw.ncpu)

Guide for DMG Installation

[!IMPORTANT]

Fix “LiveWallpaper.app” is corrupted and cannot be opened. It is recommended that you move the object to the recycle bin.

After you install the app in Application folder you have to bypass Gatekeeper to run this since I don't want to pay apple for opensource apps.

This will solve the occupation issue

xattr -d com.apple.quarantine /Applications/LiveWallpaper.app

Click the "OpenInFinder" button and it'll open a folder, you can place wallpapers in it.

[!NOTE] Make sure the folder selected doesn't include spaces.

No dots should be contained on the file name exept the dot for extension!

Eg:

• file.1920x1080.mp4 ❌ ('.'s > 1)

• file-1920x1080.mp4 ✅ ('.'s = 1)

[!NOTE] Currently support for .mp4 and .mov

https://github.com/user-attachments/assets/3d82e07d-b6b9-4a7d-b6de-5dd05dff3128

Gallery

This is a static image, currently LiveWallpaper doesn't support videos on the lock screen.

https://github.com/user-attachments/assets/36fb169e-b7cc-4489-9459-dab07c8dd2c6

Performance

Multiple Display Support

https://github.com/user-attachments/assets/9575873c-79e6-4eba-a7a5-9408b2cc4ed0

<!-- ## Gallery > <img width="185" height="134" alt="Screenshot 2025-11-30 at 1 52 01 PM" src="https://github.com/user-attachments/assets/0c91fb29-e729-485b-8f93-7080aed68881" /> > <img width="185" height="134" alt="Screenshot 2025-11-30 at 1 51 53 PM" src="https://github.com/user-attachments/assets/7848d2fd-8cc4-4271-a4c0-2868bdf00422" /> >  > <img width="2560" height="1600" alt="Screenshot 2025-11-30 at 1 52 34 PM" src="https://github.com/user-attachments/assets/79a24ed8-cc5a-4246-87d0-9c93e04766f2" /> > <img width="2560" height="1600" alt="Screenshot 2025-11-30 at 1 54 35 PM" src="https://github.com/user-attachments/assets/10466b02-77d5-4814-9fb7-a865e62a41ba" /> > https://github.com/user-attachments/assets/748c7078-1f99-4182-876f-08aa59d2bc63 -->

For licensing details, see LICENSE.