Skip to content

thusvill/LiveWallpaperMacOS

Repository files navigation

Note

I’ll get back to checking and updating this repo after December — Sorry for the delay!

LiveWallpaper App for MacOS 15+

Roller

This is an open-source live wallpaper applicationn for MacOS 15+

Install using brew

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

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 for run this(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 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

guide.mp4

Installation(Compile from source)

  • macOS 15+
  • 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)

Gallery

Adaptive tray icon

Screenshot 2025-05-21 at 8 26 29 AM Screenshot 2025-05-21 at 8 27 18 AM

Screenshot 2025-05-15 at 6 46 35 AM

Screenshot 2025-05-21 at 8 26 46 AM

Screenshot 2025-05-15 at 6 46 25 AM

[NOTE] This video shows outdated software

LiveWall.mp4

For license details, see LICENSE.