dorkhub

moonleaf

light, capable wallpaper manager for macOS

parkuoa
Swift16511 forksMITupdated 1 month ago
visit the demogit clone https://github.com/parkuoa/moonleaf.gitparkuoa/moonleaf


moonleaf
moonleaf

✨ The Wallpaper Manager for macOS

platform license

moonleaf is a feature-packed Wallpaper Manager for macOS, with support for gifs, videos, online wallpaper browsing, multi-monitor wallpapers, exporting, among other many things!

✨ Preview

Demo GIF


Installation

System Requirements:

  • macOS 12 (Monterey) or later
  • Silicon/Intel Mac

🍺 Homebrew

brew install --cask parkuoa/moonleaf/moonleaf

then,

xattr -dr com.apple.quarantine /Applications/moonleaf.app

Manual


Important

After downloading and trying to launch the app, you will receive a text saying that it is from an unidentified developer. This is because I do not own an Apple Developer account. To fix this:

  1. Open System Settings > Privacy & Security
  2. Scroll down and find the warning about the app
  3. Click Open Anyway

You only need to do this once.


License

moonleaf is licensed under the MIT License.
Versions pre-v3.0 (macpaper) are licensed under the GNU General Public License v3.0 (GPLv3).

🔨 Building from Source

  • Clone the repo
  • Run scripts/build.sh, optionally with the --all flag to build for all archs (will default to host arch)

🉑️ Translating

Contributing to translation is pretty simple and straightforward -partly because there are not many strings to translate-. Fork the repo, grab the template on the lang folder (or an already existing strings file), and replace the value of the keys with the ones respective to your language. Then, upload the translation to lang/{lang}.lproj and submit a pull request.

It is advised that you, alongside the strings file, place a file named credit with a link to your GitHub profile, or just your username.

🤝 Thanks to

🛠️ Troubleshooting

Quarantine

If you suspect the app is quarantined, run the following on your Terminal after dragging the app to Applications:

xattr -l /Applications/moonleaf.app

Which shall output com.apple.quarantine: ...;{BROWSER}; if the app IS quarantined. In that case, run:

xattr -dr com.apple.quarantine /Applications/moonleaf.app

Apple could not verify "moonleaf" is free of malware...

You can fix this by doing the same steps as here.

❤️ Support me

☕ If you like my work and want to support me, you can do so via Ko-fi:
https://ko-fi.com/naomisphere

more like this

agentlytics

Comprehensive analytics dashboard for AI coding agents — Cursor, Windsurf, Claude Code, VS Code Copilot, Zed, Antigravi…

JavaScript555
@f

DailyWallpaperHub

多源壁纸聚合平台 · 自动归档 Bing + Unsplash 精选壁纸 · AI 视觉故事生成 · 企业微信推送 · GitHub Pages 在线画廊

Python50

r2

Free open-source Cloudflare R2 desktop client and S3 GUI for macOS, Windows, and Linux. Manage Cloudflare R2, AWS S3, M…

TypeScript50

search

search projects, people, and tags