thusvillLiveWallpaperMacOS

Public
Watch7Fork52Star919
SwiftUI
HistoryCode
README

Status: Paused

LiveWallpaper App for MacOS 14+

Languages: English | 简体中文

Roller

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 --recurse-submodules 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] No dots should be contained in the file name, except 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

Bug reports

Post bugs with result of following command.

/Applications/LiveWallpaper.app/Contents/MacOS/LiveWallpaper

Gallery

Application

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

lockscreen

settings

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

Performance

p1 p2 p3

For licensing details, see LICENSE.