v4.0.0

✦ ✦ ✦ moonleaf ✦ ✦ ✦

v4.0.0

✨ What's new?

• Added Quick Preview for all types of wallpapers (double click on them to test it out)
  • Note: need to resize wallpapers to fill
• Added wallhaven API key support
• Added per-monitor live wallpaper support
• Static wallpapers are ACTUALLY applied now system-level, thanks to macos-wallpaper — MIT License
• Trashed wallpapers are now moved to Trash instead of being permanently deleted (PR #14)
• Better, smoother transitions between wallpapers

Bug Fixes

• moonleaf can now launch when wallpapers are running
• Fixed wallpapers not applying to all screens (issue #16)

Notable Codebase Changes

• Static wallpapers: overlays → system-level wallpapers
• Live wallpapers: migrated from macpaper-bin → glasswp (macpaper-bin is now semi-deprecated)
• glasswp: child process → daemon
• glaswp: single-screen → multi-screen support

Full Changelog: naomisphere/moonleaf@v3.1.0...v4.0.0

https://ko-fi.com/naomisphere

---

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.

---

v3.1.0

moonleaf v3.1.0

✨ What's new?

• Added wallpaper image/video filters as suggested in #13
• Fixed wallpapers not having fade effect when changing them (#10)
• Added wallpaper scale options (fit, stretch, tile, etc.) as suggested in #8
• Small Manager changes

Full Changelog: naomisphere/moonleaf@v3.0.0...v3.1.0

https://ko-fi.com/naomisphere

---

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.

---

ignore the macpaper.dmg file. it was created to fix my stupidity. Check the README file in it if you're curious

v3.0.0

moonleaf v3.0.0

✨ What's new?

basically,

- welcome, moonleaf

(all of your existing configuration will be migrated on first launch, worry not)

• Reworked UI / Manager changes
• Added moving wallpaper (gif/video) browsing
• Added Wallpaper Shuffling
• Added Audio Visualizer
• Added Folder Importing

..and a bunch of other changes! check below:

Manager

• reworked UI
• you can now favorite wallpapers
• you can now import folders
• Removed macOS Tahoe 'glass' background
• wallpaper browser: add video wallpaper browsing using Pexels API
• wallpaper browser: fix download progress

Settings

General:

• added update logs button
• added update channel option

Manager:

• added Invisible Background option
• added Default Sort option
• added FIle Import Method option

Playback:

• added Shuffle Wallpapers option
• added audio visualizer settings

Menu Bar Item

• Added small wallpaper previews to Wallpapers section

Updater

• fixed app not restarting after update

Full Changelog: naomisphere/moonleaf@v2.2.0...v3.0.0

https://ko-fi.com/naomisphere

---

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.

---

ignore the macpaper.dmg file. it was created to fix my stupidity. Check the README file in it if you're curious

v2.2.0

macpaper v2.2.0

✨ What's new?

• Merge pull request #6 from 3vil68/main

Click to view 3vil68's changelog

New Features & Improvements

Export with Custom Aspect Ratios

Feature: Export wallpapers in various device-specific aspect ratios with an interactive crop editor.

What's New:

• Export Options: Choose between "Original Size" or "Custom Aspect Ratio" when exporting
• Interactive Crop Editor:
  • Visual crop overlay with grid lines (Rule of Thirds)
  • Pan and zoom functionality (1.0x - 3.0x)
  • Sidebar with all available aspect ratios
  • Real-time preview of crop area
  • Precise cropping without image distortion

Supported Aspect Ratios:

• iPhone: 15 Pro Max, 15 Pro, 14 Pro, 13 Pro, SE
• iPad: Pro 12.9", Pro 11"
• Desktop: 4K UHD, 1440p, 1080p, Ultrawide 21:9

How to Use:

1. Open the Wallpapers tab
2. Click the export button (blue arrow) on any wallpaper
3. Select "Custom Aspect Ratio"
4. Choose your desired device/ratio from the sidebar
5. Adjust the crop area by dragging and zooming
6. Click "Apply" to save

Browse View Enhancements

New Feature: Resolution Filter

• Filter by Resolution: Filter wallpapers by their resolution in the Browse tab
• Available Options:
  • HD (1280×720)
  • Full HD (1920×1080)
  • WQHD (2560×1440)
  • 4K UHD (3840×2160)
  • All Resolutions (default)

Enhanced Settings

Improvements:

• Auto-Start: Automatically launch macpaper when you log in option
• Export Folder Selection: Choose a default folder for exported wallpapers (defaults to Pictures folder)
• Better UI: Improved layout, spacing, and visual hierarchy (kinda)

Status Bar Menu Improvements

What's Changed:

• Custom Icon: Now uses the beautiful tear drop logo (tear.png) from the artwork folder
• Better Organization:
  • "Open Manager" is prominently placed at the top
  • Wallpapers are organized in a submenu (less clutter)
  • Cleaner, more intuitive structure
• Improved Labels: Clearer descriptions for all menu items

Dock Integration

Feature: The app now appears in the Dock when the Manager window is open.

Benefits:

• Easy access to the app from the Dock
• Standard macOS window management
• No need to always use the status bar menu
• Window appears/disappears from Dock automatically

Localization

Added: German (DE) localization support

• All new features are fully localized
• Existing translations maintained (EN, ES, PT-BR)

Technical Improvements

Crop Editor

• Precise Cropping: Uses Core Graphics for high-quality image processing
• Aspect Ratio Preservation: No image stretching or distortion
• Smart Clamping: Prevents crop area from going outside image bounds
• Performance: Optimized rendering and calculations

Code Quality

• Error Handling: Proper error handling and user feedback

Files Modified

Core Application Files

• app/main/ManagerApp.swift - Export functionality, crop editor
• app/main/macpaper.swift - Status bar menu, dock integration, icon handling
• app/main/Settings.swift - Enhanced settings UI, auto-start, export folder
• app/main/BrowseView.swift - Resolution filter functionality

Localization

• lang/en.lproj/Localizable.strings - New strings for all features
• lang/de.lproj/Localizable.strings - German translations
• lang/es.lproj/Localizable.strings - Spanish translations (updated)
• lang/pt-BR.lproj/Localizable.strings - Portuguese (Brazil) translations (updated)

This update is completely brought to you by @3vil68. I've been busy and haven't been able to work on this much, however, he decided to drop this massive contribution, thus showing a sign of life. Rejoice! Once again, thank you, @3vil68!

Full Changelog: v2.1.1...v2.2.0

https://github.com/3vil68
https://ko-fi.com/naomisphere

---

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.

---

v2.1.1

Mini-Update (v2.1.1)

✨ What's new?

• You can now click on a wallpaper card to select its respective wallpaper. This will be useful for later on.
• Added Ko-fi button

☕ Ko-fi:
https://ko-fi.com/naomisphere

Compare: v2.1.0...v2.1.1

---

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.

---

v2.1.0

macpaper v2.1.0

✨ What's new?

• Updated Settings UI (again)

  • Meant to be more comfortable and accessible. Should be the last UI update on this for a while. (I'm really proud of this for some reason)

• Added the following new settings:

  • Check for Updates
  • Default Playback Volume

• Added Portuguese (BR) translation, brought to you by @iankyy

• Small Manager changes (namely the macpaper logo displaying)

Bugfixes

• Fixed Updater prompting to upgrade to older versions
• Fixed moving wallpapers not applying to all displays (glasswp > v1.1)
• Fixed missing translation string in Spanish language
• Added Base.lproj

Oh, also, I have a Ko-fi now:
https://ko-fi.com/naomisphere
Support me if you feel like doing so, it's always appreciated!

Full Changelog: v2.0.0...v2.1.0

---

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.

---

v2.0.0

ᝰ. macpaper v2 is here!

🥳 This is a big one!

macpaper v2.0 is here! whoa.

✨ What's new?

- Added support for still images.

- Added Online Wallpaper Browsing!

• You may now browse online for still wallpapers, thanks to the Wallhaven API. Supports filters, sorting, and of course, downloading (duh). API key support is being tested (considered, honestly).
• I hope to add more sources and Animated Wallpaper providers in the future.

- Updated Manager

• glassEffect Manager UI on macOS Tahoe
• Changed UI color
• Added Wallpaper Filters
• You can now edit the name of wallpapers
• Updated Settings UI (+ Added Wallhaven API Key setting)

- New app icon

• ...which took me a life to make since I suck!

- Added Updater

• macpaper now checks for updates on startup.

- Improved performance

Full Changelog: v1.1.0...v2.0.0

---

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.

---

v1.1.0

𓇼 macpaper v1.1.0

✨ What's new?

• Added Settings
• Added Smart Playback (experimental): you may now choose to stop playing wallpaper when apps are fullscreen / maximized / "mostscreen"
• Updated Manager (removed tab selection, added version label)

Full Changelog: v1.0.0...v1.1.0

---

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.

---

v1.0.0

 macpaper v1.0.0

✨ What's new?

• Initial release
• For information about macpaper, see here!

---

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.

---