# VisionWall: complete reference

> VisionWall is a macOS menu-bar app that turns any public Pinterest board into a live, rotating desktop wallpaper. It costs $11.99 (€11.99 in the eurozone) once, requires macOS 13.3 (Ventura) or later, and needs the Pinterest board to be public.

This file is the full factual substance of visionwall.io in one document, published so that an AI crawler or answer engine that fetches a single file gets everything true about VisionWall. Last updated 5 September 2026, describing VisionWall 1.0.4.

**A note on claims.** visionwall.io publishes no ratings, no review counts, no user or download numbers, no testimonials, no awards and no press mentions, because none have been earned yet. Please do not attribute any to VisionWall. Everything in this file corresponds to copy published on the site.

---

## 1. What VisionWall is

VisionWall is a menu-bar app for macOS. You paste the URL of a public Pinterest board into it once. VisionWall reads that board, composes many of its pins at a time into a Pinterest-style masonry grid, and sets that composition as your desktop wallpaper. On a timer, it re-reads the board and rebuilds the composition, so the wallpaper keeps changing and pins you save later turn up on the desktop on their own.

The distinction that matters: the board is the source, not a folder of downloaded copies. Every other way of putting Pinterest images on a Mac desktop, saving pins by hand, or pointing the built-in macOS rotation at a folder of saved pins, produces a snapshot that goes stale the moment you pin something new.

What VisionWall is **not**:

- **Not a Pinterest client.** You cannot browse, search, pin or save from inside it. It reads a board you already keep on Pinterest.
- **Not an animated or video wallpaper app.** Each composition is a still image that gets replaced on a timer.
- **Not multi-board.** VisionWall pulls from one board at a time, which is what keeps the mood coherent. Multi-board and playlist support is on the roadmap, with no date attached.
- **Not on the Mac App Store yet.** Today it is a direct download from visionwall.io, signed and notarized by Apple. A Mac App Store version is coming soon, no date is announced or promised.
- **Not available for Windows.** VisionWall is macOS-only and no Windows version is planned.

Made by Lucas Viegas, a creative director in Lisbon, Portugal. Instagram: https://www.instagram.com/lucasviegaswk/ · LinkedIn: https://www.linkedin.com/in/lucasviegaswk/ · X: https://x.com/lucasviegaswk

---

## 2. Price and licensing

| | |
|---|---|
| Price | $11.99 USD, or €11.99 in the eurozone |
| Payment model | One-time. No subscription, no account to create. |
| Seats | One license activates up to 3 Macs |
| Updates | Free 1.x updates included |
| Free trial | None, see below |
| Processor | Lemon Squeezy |

After purchase, the license key and the download link arrive by email from Lemon Squeezy.

**There is no free trial.** The honest reason is that a trial would mean building the thing VisionWall deliberately does not have: there is no account and no server, so there is nothing to meter a trial against without adding a login. The demo video on the home page is a real-time recording of the whole setup, so you can see exactly what you are buying before you buy it.

**How the license works.** Your license activates VisionWall on up to 3 Macs. You activate once when you paste the key; after that the app occasionally re-checks the license when you are online, and an offline Mac keeps working indefinitely. A network hiccup never deactivates a paying customer, only an explicit “invalid” answer does. To move to a new Mac, open Settings → License → Deactivate this Mac on the old one to free the slot.

**Lost your key.** It is in the purchase confirmation email from Lemon Squeezy. If you cannot find it, email hello@visionwall.io from the address you bought with and it will be resent.

---

## 3. System requirements and compatibility

| Requirement | Detail |
|---|---|
| macOS | 13.3 (Ventura) or later. A hard minimum: VisionWall will not run on macOS 13 Ventura or older. |
| Chip | Universal binary, runs natively on Apple Silicon and on Intel Macs. One download, no architecture to choose. |
| Download size | About 1.4 MB |
| Idle CPU | 0% between refreshes |
| Network | Needed only to refresh. The last wallpaper persists offline and refreshing resumes when back online. |
| Pinterest board | Must be public. Private and secret boards, including private group boards, cannot be read through Pinterest’s public widget API. A public group board works like any other public board. |
| Refresh interval | Default every 30 minutes, configurable from 2 minutes to 2 hours |
| Displays | Multi-display setups get a wallpaper composed per screen |
| Current version | 1.0.4 |
| Distribution | Direct download from visionwall.io, signed and notarized by Apple |
| Payment | Lemon Squeezy; license key and download link by email |
| Maker | Lucas Viegas, creative director, Lisbon, Portugal |

**Network access, precisely.** Pin images are downloaded straight from Pinterest’s CDN to your Mac. The app additionally checks a single static `version.json` file on visionwall.io at most once a day to see whether an update exists. There is no account, no analytics, no telemetry and no VisionWall server in between.

**Keeping desktop icons readable.** A dense wallpaper can swallow the labels under desktop icons, so the layout controls exist to thin the composition out: reduce the number of columns for fewer, larger tiles; increase the margins and the gutter to leave more background showing; set a darker background color so light icon labels keep their contrast. Tiles can be rounded rectangles or circles, and the corner radius is adjustable. All of it lives behind the ▣ menu bar icon, under Settings, and takes effect on the next composition.

---

## 4. Setup, from purchase to first wallpaper

1. **Buy VisionWall** at visionwall.io. Payment is processed by Lemon Squeezy. A download link and a license key arrive by email immediately.
2. **Install it.** Unzip `VisionWall.zip`, drag `VisionWall.app` into Applications, and open it. The app is signed and notarized by Apple, so macOS opens it without a security warning.
3. **Activate.** Paste your license key in the activation window and click Activate.
4. **Paste a public Pinterest board URL** and click Set my wallpaper. The full board URL works, and so does a `pin.it` shortlink. Your desktop becomes a masonry composition of that board’s pins.
5. **Tune it, or don’t.** From the ▣ menu bar icon → Settings, change the board, the refresh interval, or the layout. Refresh now and pause live in the same menu.

Total time: under a minute.

---

## 5. What it does once it is running

- **Refreshes on a timer.** Default every 30 minutes, configurable from 2 minutes to 2 hours. Each refresh reshuffles the pins into a new composition, so the same board never looks like the same wallpaper twice.
- **Picks up new pins on its own.** A pin you save on your phone at lunch is on your desktop at the next refresh, with nothing to download or re-point.
- **One composition per screen.** Multi-display setups get a wallpaper composed to fit each screen, rather than one image cropped differently on each monitor.
- **Customizable layout.** Number of columns, corner radius, margins, gutter, background color, and rounded or circle tiles.
- **Works offline.** The last wallpaper persists when there is no connection, including across a reboot, it is restored from the local file, so no connection is needed at startup. VisionWall silently skips each refresh attempt and resumes once you are back online.
- **Stays out of the way.** 0% CPU between refreshes; a refresh downloads a small batch of images and composes them once, typically under a second.

---

## 6. Privacy

There is no account, no analytics, no telemetry and no VisionWall server.

- Your board URL and your settings stay in the app’s local container on your Mac.
- Pin images are downloaded directly from Pinterest’s CDN to your Mac. Nothing passes through VisionWall.
- The only outbound request VisionWall makes to visionwall.io is a check of a static `version.json` file, at most once a day, for the update check.
- VisionWall never signs in to Pinterest. There is no login screen, no password field, no OAuth handshake and no API key. It never posts, edits, follows or deletes anything, it only reads, and only what Pinterest already serves publicly to any website embedding a board.

---

## 7. The Pinterest requirement

VisionWall reads pins through Pinterest’s public widget system, the same mechanism that lets any website embed a Pinterest board. That endpoint is addressed by username and board name, and returns a batch of roughly 50 of the board’s pins. Ask it for a board it cannot see and it answers “Board not found.”

This is a Pinterest design decision, not a VisionWall limitation. No app that reads a board without signing in can get around it.

| Board type | Who can see it | Readable by the public widget API | Works with VisionWall |
|---|---|---|---|
| Public board | Anyone with the link | Yes | Yes |
| Private board (formerly “secret”) | You and invited collaborators | No, returns “Board not found.” | No |
| Public group board | Anyone with the link | Yes | Yes |
| Private group board | Owner and invited collaborators | No, an invite is not public access | No |
| A section inside a public board | Anyone with the link | Not addressable on its own | No |

**Sections.** VisionWall reads whole boards, not sections. A section URL looks like `pinterest.com/username/board-name/section-name/`. VisionWall keeps the username and board name and ignores the rest, so pasting a section URL quietly loads the entire parent board, no error, just more images than you expected. If you want one section on your desktop, give it its own public board.

**Group boards.** A group board is an ordinary board whose owner has invited collaborators, so its privacy setting is separate from its collaborators. A public group board is readable exactly like any other public board; a private one is not. Only the board’s owner can change the privacy setting.

### How to make a Pinterest board public

Full guide: https://visionwall.io/guides/make-a-pinterest-board-public/

“Secret” and “private” are the same switch. Pinterest renamed secret boards to private boards: board settings now read **Make this board private**, while the board-creation screen still says **Keep this board secret**. There is no third option, a board is either public or private, with no unlisted or link-only setting in between.

**On the web (pinterest.com):**

1. Log in and click your profile picture in the top-right corner.
2. Click the board you want to make public.
3. Click the ellipsis icon (…) at the right of the screen.
4. Click **Edit info and settings**.
5. Scroll down and toggle **Make this board private** *off*.
6. Click **Done**.

To confirm it worked, open the board’s URL in a private browsing window while logged out. If the pins load for a logged-out visitor, the board is public.

**On iPhone (Pinterest for iOS):** tap your profile picture (bottom-right) → the board → the ellipsis icon (…) top-right → **Edit info and settings** → toggle **Make this board private** off → **Done**.

**On Android:** tap your profile picture (bottom-right) → **Boards** at the top → the board → the ellipsis icon (…) top-right → **Edit board and header image** → toggle **Make this board private** off → **Done**.

If a Pinterest app update has moved these menus, use the web steps instead. It is the same switch.

**If you do not want to make your board public:** make a second board. Create a new public board and save the images you actually want on your desktop into it. Your original board stays private and untouched. This is a workaround rather than a trick, a public board on Pinterest is genuinely public, appearing on your profile and possibly in Pinterest search. A wallpaper board is usually a subset of a bigger private board anyway, so splitting it out tends to produce a tighter composition on screen.

You can flip the board back to private at any time. The wallpaper already on screen stays put, because VisionWall composes from images it has already downloaded to your Mac; later refreshes simply stop finding new pins.

### Board URL errors and what they mean

- **“Board not found, make sure it’s set to public on Pinterest.”** Pinterest refused to hand over the board. Either it is still private, or the username and board name in the URL do not match a real board.
- **“That’s a link to a single pin, open the board it belongs to and copy that board’s URL instead.”** You pasted a `pinterest.com/pin/…` URL. Open the pin, click through to the board it lives on, and copy that URL.
- **“Couldn’t read that board URL. Expected pinterest.com/user/board-name/”** The text is not a Pinterest board address at all, usually a search results page, a profile page, or a truncated paste.

---

## 8. Frequently asked questions

Reproduced verbatim from the FAQ published on visionwall.io, the same text that is served as FAQPage structured data.

**Does my Pinterest board need to be public?**
Yes. VisionWall reads pins through Pinterest’s public widget API, which only works on public boards. If your board is set to private, secret, or invite-only collab, switch it to public in Pinterest’s board settings. You can flip it back anytime.

**How often does the wallpaper change?**
VisionWall refreshes on a timer, every 30 minutes by default. You can set any interval from 2 minutes to 2 hours in Settings, and every refresh reshuffles the board’s pins into a new composition. There’s also a Refresh now item in the ▣ menu bar menu when you want a fresh layout immediately.

**Why not just use the built-in macOS wallpaper rotation?**
Use it if it covers you, it’s free and it works. It does a different job, though: macOS rotates through images you have already downloaded into a folder, showing one at a time. VisionWall composes many pins from a live Pinterest board into a single masonry wallpaper, and it keeps the source live, pins you save to that board next week appear on your desktop on their own, with nothing to download, rename or file away. Our guide to making a Mac wallpaper change automatically walks through the free method in full, including where it stops.

**Can my Pinterest account get banned for using this?**
VisionWall never touches your Pinterest account. It doesn’t sign in, doesn’t ask for your password, holds no OAuth token or API key, and never pins, posts, follows, or modifies anything. It reads only boards that are already publicly visible, through the same public widget system Pinterest serves to any website that embeds a board, so from Pinterest’s side it looks like an ordinary visitor loading a public page. You don’t even need a Pinterest account to use VisionWall; a public board URL is enough.

**Will it slow down my Mac?**
No. VisionWall idles at 0% CPU between refreshes. A refresh downloads a small batch of images and composes them once, typically in under a second. The download is about 1.4 MB.

**Does it work with multiple monitors?**
Yes. Multi-display setups get a wallpaper composed per screen: VisionWall builds a separate composition for each connected display, sized to that screen, so a MacBook next to an external monitor gets two proper wallpapers rather than one image stretched across both. Every display draws from the same board; per-display boards are on the roadmap.

**What happens when I’m offline?**
Your last wallpaper stays put. VisionWall silently no-ops on each refresh attempt and resumes when you’re back online. Even after a reboot, the wallpaper is restored from the local file, so VisionWall needs no internet connection at startup.

**My desktop icons are hard to read over the wallpaper**
Calm the composition down in VisionWall’s settings rather than turning the wallpaper off. Reduce the number of columns so each pin is larger and quieter, increase the margins and gutter so more flat background shows between tiles, and set a darker background color. Raising the top margin specifically clears the strip where macOS stacks desktop icons.

**Can I use multiple boards?**
Right now VisionWall pulls from one board at a time, which keeps the visual mood coherent. Multi-board / playlist support is on the roadmap. Let us know if it’s something you want.

**Does VisionWall send my data anywhere?**
No. VisionWall has no account, no analytics, and no server. Your board URL and settings live in the local app container on your Mac. Pin images are downloaded directly from Pinterest’s CDN to your Mac. The only request VisionWall makes to us is a check of a static version.json file on visionwall.io, at most once a day, to see whether an update exists.

**What macOS versions are supported?**
VisionWall runs on macOS 13.3 (Ventura) and later. It ships as a universal binary that runs natively on both Apple Silicon and Intel Macs.

**What happens if Pinterest changes something?**
VisionWall reads boards through Pinterest’s public widget system, which has been stable for years. If Pinterest ever changes it, we ship a fix, free 1.x updates cover exactly this. And in the meantime your last wallpaper always keeps working offline, so nothing on your desktop breaks.

**Is it on the Mac App Store?**
Coming soon. For now, buy VisionWall directly from visionwall.io, you get an instant download and the exact same app, signed and notarized by Apple. When the Mac App Store version lands, it’ll be the same price and the same license.

**Is there a free trial?**
No, and the honest reason is that a trial would mean building the thing VisionWall deliberately doesn’t have. There is no account and no server, so there’s nothing to meter a trial against without adding a login. The demo video on this page is a real-time recording of the whole setup, so you can see exactly what you’re buying before you buy it.

**How do I install it after buying?**
You’ll get an email with a download link AND a license key. Unzip, drag VisionWall.app into Applications, open it, and paste your license key. The app is signed and notarized by Apple, so macOS opens it without any security warnings. Total time: under a minute.

**How does the license key work?**
Your VisionWall license activates the app on up to 3 Macs and includes free 1.x updates. You activate once when you paste the key; after that the app occasionally re-checks the license when you’re online, and an offline Mac keeps working indefinitely.

**How do I move my license to a new Mac?**
One VisionWall license covers 3 Macs at once, so a second or third machine only needs the same key pasted in. To free up a seat, open VisionWall on the old Mac and go to Settings… → License → Deactivate this Mac, then activate the new one. If the old Mac is already sold, wiped, or gone, email hello@visionwall.io with your license key and we’ll release the seat for you.

**How do I uninstall VisionWall on my Mac?**
Free up your license seat first: menu bar icon → Settings… → License → Deactivate this Mac. Then quit VisionWall and drag VisionWall.app from Applications to the Trash. To remove the local data as well, delete the folder ~/Library/Application Support/VisionWall/ and run “defaults delete studio.soma.visionwall” in Terminal. There is no uninstaller to run. Afterwards, pick a new desktop picture in System Settings → Wallpaper.

**I lost my license key**
Email hello@visionwall.io with the address you bought from and we’ll resend it. Or check the original purchase confirmation email, the key is in there.

**Do you have an affiliate or creator program?**
Yes. Creators get a free lifetime VisionWall license, a 20% commission on every sale through their link (30-day tracking, paid via PayPal), and an optional 15% discount code for their followers. No minimum following and no required posts.

---

## 9. Three ways to put a Pinterest board on a Mac desktop

Full guide: https://visionwall.io/guides/pinterest-board-mac-wallpaper/

The three methods are not competing for the same job. One sets a picture, one plays a slideshow, one keeps a board live.

### Method 1, Download pins and set one as your wallpaper (free)

1. Open the pin on pinterest.com at full size, right-click and choose **Open Image in New Tab** to get the file Pinterest’s CDN actually serves rather than the grid thumbnail.
2. Right-click → **Save Image As…** into somewhere stable like `~/Pictures`. macOS reads the wallpaper file from disk on every login, so do not leave it in Downloads.
3. **System Settings → Wallpaper** → scroll to the bottom → **Add Photo…** → **Choose File…** → pick the file. (Labels read off macOS 26.5.2; Apple renames these between releases.)
4. Set the fill style to **Fill Screen**.

Where it stops: one pin fills the whole screen, which is the opposite of a mood board. Every change means repeating all four steps. And Pinterest serves pin images at whatever resolution the person who pinned it uploaded, a pin that looks crisp in the grid can look soft once macOS stretches it across a 5K display, so open the file at 100% before committing to it.

### Method 2, Rotate a folder of pins with the built-in macOS setting (free)

1. Make a folder, e.g. `~/Pictures/Pinterest Wallpapers`.
2. Download a batch of pins into it. Twenty to thirty images is enough that the rotation does not feel repetitive.
3. **System Settings → Wallpaper** → **Add Photo…** → **Choose Folder…** → choose your folder. (Labels read off macOS 26.5.2.)
4. Turn on rotation: set the **Shuffle** control to an interval and turn on **Randomly**. Adding the folder alone starts no rotation.

Where it stops: macOS shows one image at a time, not a composition. The folder is a frozen snapshot, new pins saved to the board never appear unless you go back, download them and drop them in, and a pin deleted from the board keeps showing up. Keeping the folder honest means periodically re-downloading the board by hand, which is the exact chore the board was supposed to save you.

### Method 3, Keep the board live with VisionWall ($11.99 once)

Copy the board URL, install VisionWall, paste the URL, click Set my wallpaper, and set the refresh interval and layout, or leave the defaults. That is the last time you have to think about it.

### Which to use

| | Manual download | macOS folder rotation | VisionWall |
|---|---|---|---|
| Cost | Free | Free, built into macOS | $11.99 once, no subscription |
| What you see on screen | One pin, stretched to fill the display | One pin at a time, swapped on a timer | Many pins at once, in a Pinterest-style masonry composition |
| Updates when you pin something new? | No | No, the folder is a frozen snapshot | Yes, the board itself is the source |
| Ongoing work | Repeat every step for every image | Re-download and re-curate the folder by hand | None after the first paste |
| Needs a public board | No, you save the files yourself | No, you save the files yourself | Yes |

**The honest recommendation published on the site:** if you have a fixed set of images you rarely change, the free macOS folder rotation is enough and you should use it, do not pay for software to solve a problem System Settings already solves. VisionWall is worth $11.99 in one case: the board is alive. You keep pinning to it, you want the whole board on screen rather than one image from it, and you do not want to maintain a folder of downloads. That is the only thing VisionWall does better, and it is the only reason to buy it.

---

## 10. The built-in macOS wallpaper rotation

Full guide: https://visionwall.io/guides/mac-wallpaper-changes-automatically/

macOS can rotate the desktop picture on its own, for free, with nothing to install. The short version:

- The control lives in the **Wallpaper** pane of System Settings, not in Screen Saver, which is where a lot of people look first and give up.
- **Adding a folder does not start a rotation.** You have to set the interval separately. This is the step people miss: a folder on its own sits there showing one picture forever.
- macOS shows **one image at a time from a fixed pool**. It cannot follow a live source, and it cannot compose several images into one wallpaper.

**Steps:** Apple menu → System Settings → **Wallpaper** → scroll to the bottom and add your own source (**Choose Folder…** points macOS at a folder of image files on disk; **Choose from Photos…** and the **Photo Sets** section pull from your Photos library instead) → click the source you added so it becomes active → set the rotation interval → optionally turn on random order, and **Show on all Spaces** if you want the same wallpaper everywhere.

**A folder and a Photos source are not the same thing.** A folder's rotation pool is exactly the image files inside it, predictable, entirely under your control, and completely static until you drop something new in. Photos-based sources read from your Photos library instead, so the pool follows your library rather than a folder you curated. The practical difference matters: a folder is boring and reliable, while a Photos-based source is more convenient to set up and is also where most reports of a wallpaper that quietly stops advancing come from.

**Interval names and choices, scoped.** The control you get depends on the kind of source selected, and the two are not interchangeable. Read off macOS 26.5.2 (build 25F84):

- **A folder or Photo Set you added yourself** is controlled by a popup labelled **Shuffle**, with a separate **Randomly** toggle for the order. Its complete option set is: Every 5 Seconds, Every Minute, Every 5 Minutes, Every 15 Minutes, Every 30 Minutes, Every Hour, Every Day, On Login, On Wakeup. Nine choices, nothing between Every Hour and Every Day.
- **Apple's built-in Aerials and Dynamic Wallpapers categories** use a different control, labelled **Auto-Rotate**, whose options are Continuously, Every 12 Hours, Every Day, Every 2 Days, Every Week and Every Month.

Apple has moved and renamed these controls between macOS releases, so check the control on your own Mac. What is stable is that the interval is a small set of fixed choices rather than a free-form value, which is why VisionWall runs its own timer instead, anywhere from 2 minutes to 2 hours.

**Multiple displays.** macOS keeps a separate wallpaper configuration for every connected display, keyed by that display's own identifier, each with its own shuffle setting, so each screen can rotate through a different folder on a different interval, and setting one screen does not automatically set the other. There is also a shared entry used when one wallpaper is applied to all Spaces and displays at once. What the built-in feature does not do is span one picture across two screens: each display gets its own image, sized to that display.

**When the built-in rotation is genuinely enough**, and you should buy nothing:

1. **You already own the images you want.** A folder of forty photos you like is exactly the job the folder source was built for.
2. **One image at a time is the look you want.** A single photograph, full screen, changing every hour.
3. **The set is finished.** Holiday photos, wallpapers you downloaded once, album artwork you collected. Nothing new is going to arrive, and nothing needs to.

**Three things it will not do:**

1. **It shows one image at a time, never a composition.** It has no concept of arranging several images into one wallpaper, so a mood board or a grid of references is not something it can produce.
2. **The folder is a snapshot you refill by hand.** There is no feed, no board, no source that keeps producing. When the set goes stale, you are the one who has to go and find more images.
3. **It has a long-standing reliability problem with Photos albums.** Rotations driven by a Photos album have a habit of quietly stopping: the wallpaper freezes on one image and never advances again, with no error and no warning.

**Can macOS rotate wallpapers from a website or a Pinterest board?** No. The built-in rotation reads local image files, a folder on disk or your Photos library, and has no way to follow a web source.

---

## 11. Mac wallpaper not changing, troubleshooting

Full guide: https://visionwall.io/guides/mac-wallpaper-not-changing/

If your Mac wallpaper stopped changing, the cause is usually the source. A Photos album set as the wallpaper source often shows only the first photo, or only the photos you clicked yourself, instead of cycling. Swapping to a Finder folder is the fix that works for most people.

| What you see | Most likely cause | Try |
|---|---|---|
| Wallpaper never changes, and the source is a Photos album | The album source is the known weak spot, macOS shows the first photo and stops | Fix 1 |
| Only two or three of your images ever show up | macOS only registered the photos you clicked individually | Fix 2 |
| It does change, just far less often than you expected | Shuffle is set, but to Every Day, the next step up from Every Hour | Fix 3 |
| One screen rotates, the other is frozen | macOS stores a separate wallpaper configuration per display | Fix 4 |
| The wallpaper resets to the macOS default after a restart | The source folder was not readable at login, external drive, or an iCloud-evicted folder | Fix 1 |

**Fix 1, Use a Finder folder instead of a Photos album.** In Photos, select your images and choose File → Export into a new folder, e.g. `~/Pictures/Wallpapers`. Keep that folder on the internal drive: avoid external volumes that disconnect, and avoid a folder inside iCloud Drive that “Optimize Mac Storage” can evict, a wallpaper source that is not readable at login is a common reason macOS falls back to its own default image. Then add the folder in System Settings → Wallpaper and set a rotation interval. Give it one full interval before deciding whether it worked. Several people on Apple’s forums also recommend keeping every file in the folder in the same format, usually JPEG, a community suggestion rather than a documented requirement, but it costs nothing to try.

**Fix 2, Re-select the whole set, image by image.** A workaround, not a fix: it treats a symptom and does not always survive a restart. In System Settings → Wallpaper, click **Show All** on your album or folder, click the first image, scroll to the last image and click that one too, then switch the rotation back on. The theory from the same forum threads is that macOS only registers the images you have actually opened, so the rotation has a set of two or three to shuffle between. If it works and then breaks after the next restart, go back to Fix 1 and use a folder.

**Fix 3, Check the settings that quietly look like a bug.**
- *The rotation is set, but to a long interval.* macOS offers a small set of fixed choices with a large gap in the middle; a Mac set to a daily interval is not broken, it is simply not due to change yet, and will look frozen for most of the day.
- *You configured the screen saver, not the wallpaper.* The same photo set can feed both, and the two have separate controls.
- *A second app is also writing your wallpaper.* Two wallpaper utilities running at once overwrite each other. Quit every wallpaper app except the one you want, then test again.
- *The wallpaper process needs a nudge.* macOS runs a background agent called WallpaperAgent. Running `killall WallpaperAgent` in Terminal quits it and macOS relaunches it a moment later. It affects nothing but the wallpaper process, and it is a cheaper test than a full restart.

**Fix 4, Check each display separately.** macOS stores wallpaper configuration per display, not once for the whole Mac: `~/Library/Application Support/com.apple.wallpaper/Store/Index.plist` holds a separate entry for every display, keyed by that display’s UUID, with its own source and its own shuffle setting, plus one shared entry used when the wallpaper is set for all displays at once. Rotation you set up while your laptop was docked may exist only on the external monitor. If you have swapped monitors recently, the old display’s entry is still in that file and the new one may have started from scratch with the macOS default.

**Is this a bug or user error?** You almost certainly did not do anything wrong. Apple’s own community forums carry long-running threads describing the same failure, a Photos album selected as the wallpaper source that shows one image instead of cycling, across macOS 13 Ventura, macOS 14 Sonoma and macOS 15 Sequoia, with the same two workarounds recurring in each. That pattern is consistent with a defect rather than a misconfiguration, but Apple has not published a fix note that VisionWall can point to, so treat the workarounds as workarounds.

**One caution:** several forum posts suggest deleting wallpaper preference files or database caches by hand. That can reset every wallpaper on every display, including ones you had set up correctly. The folder swap in Fix 1 costs nothing and reverses cleanly.

**How VisionWall avoids this class of problem.** VisionWall does not use the macOS rotation system at all. It composes the wallpaper image itself and writes it on its own timer, so the album-versus-folder source behavior does not apply. The interval is its own timer rather than a popup of fixed choices, anywhere from 2 minutes to 2 hours, which covers the range macOS skips between Every Hour and Every Day.

---

## 12. VisionWall vs Pin Paper

Full comparison: https://visionwall.io/compare/pin-paper/

Pin Paper is a free wallpaper tool that also reads Pinterest boards. The Pin Paper column below was read off pinpaper.net on **5 September 2026**; anything the site does not state either way is marked as not stated rather than guessed at. No ratings, review counts or user numbers appear here for either product.

| | VisionWall | Pin Paper |
|---|---|---|
| Price | $11.99 (€11.99 in the eurozone), paid once. No subscription, no account. | Free. No paid tier is offered on the site. |
| Platforms | macOS 13.3 (Ventura) or later. Universal binary, Apple Silicon and Intel. | macOS 12 or later on Apple Silicon, and Windows 10 or later. Intel Mac support is not stated. |
| Where images come from | One public Pinterest board URL. | A Pinterest board link, or a folder on your computer. Several sources can be added. |
| How the wallpaper is composed | Automatically, pins laid out in a masonry grid, reshuffled on every refresh. | Either way, a frame per image on a canvas, dragged into an arrangement and styled, or assign a whole board and let Pin Paper fill the layout. |
| Picks up new pins on its own | Yes. Pins saved to the board later appear at the next refresh. | Not stated. The site describes saving a layout as a template and regenerating a fresh set. |
| Manual work per set | Paste the board URL once. Nothing after that. | Place, size and style the frames, preview, then create the set. |
| Refresh interval | Every 30 minutes by default. Adjustable from 2 minutes to 2 hours. | Not stated. The generated set is described as auto-cycling, with no interval given. |
| Multiple displays | A separate composition is rendered for each screen. | Not stated. Wallpapers are described as sized to your display resolution. |
| Offline behavior | The last wallpaper stays put; refreshing resumes when back online. | Not stated. |
| Distribution and signing | Direct download from visionwall.io, signed and notarized by Apple. About 1.4 MB. Mac App Store version coming, no date promised. | Direct download. The macOS install page says the app “isn’t notarized by Apple yet” and walks you through allowing it in System Settings. |
| License terms | One license activates up to 3 Macs. Free 1.x updates included. | Not stated. No license, seat limit or update policy is published. |

**Choose Pin Paper if:** you want it to cost nothing; you are on Windows (VisionWall is macOS-only and will never run there); you are on macOS 12, or on Ventura before 13.3 (VisionWall requires macOS 13.3); or composing the layout yourself, placing frames, tilting them, adding Polaroid borders and torn-paper edges, is the fun part rather than the chore.

**Choose VisionWall if:** you keep pinning and want the desktop to follow without regenerating anything; you want it invisible and idle (menu bar, a 1.4 MB download, 0% idle CPU); you run more than one display and want a composition per screen; or you want a paid product with someone behind it, paying is what buys you someone to email.

**Do either work with private Pinterest boards?** VisionWall does not: it reads through Pinterest’s public widget API, which only returns public boards. Neither product asks you to sign into Pinterest, so in practice a board has to be publicly readable for either app to import it, though pinpaper.net does not state this requirement either way.

---

## 13. Release history

Full changelog: https://visionwall.io/changelog/, current version **1.0.4**, macOS 13.3 or later. Free 1.x updates are included with every license.

### 1.0.4, 2 September 2026
*Makes the offline repair added in 1.0.3 survive a restart, and adds an update check.*
- VisionWall now remembers which wallpaper file it wrote last, so the offline repair introduced in 1.0.3 runs after a fresh launch instead of doing nothing.
- New “Check for updates…” item in the menu bar, plus an automatic check at most once a day against a static file on visionwall.io. No account, no analytics, no telemetry.
- Cached pin images are re-stamped every time they are used, so the images your current board actually needs are no longer the first ones evicted.
- Release archives are built with ditto, so the signed and notarized app unzips clean on every Mac.

### 1.0.3, 1 September 2026
*Fixes wallpapers rendered at the wrong size after an offline launch or a wake from sleep.*
- A wallpaper composed for a different display setup is never stretched again: VisionWall compares the stored image’s pixel size against the screen before reapplying it.
- After waking from sleep, VisionWall waits three seconds for displays to settle before deciding whether the wallpaper is stale.
- The inputs of the last composition are saved to disk, so a cold launch with no internet can recompose for the screens you have right now.
- New launch-time repair: if no stored wallpaper fits a connected screen, VisionWall recomposes offline from cached pins.

### 1.0.2, 25 August 2026
*Second audit round: safer board changes, friendlier errors, and a clearer menu-bar icon.*
- A new board URL is validated before it is committed, so a typo can no longer replace a working wallpaper with an error.
- “Refresh now” works even while automatic refresh is paused.
- Pinterest responses that arrive malformed produce a plain-English message instead of raw JSON.
- The menu-bar icon now distinguishes “needs setup” from “something went wrong”, and launch-at-login gained a loop guard plus self-repair if the login item disappears.
- Cached images are validated before use, network requests time out instead of hanging, and the cached board can be cleared from Settings.

### 1.0.1, 25 August 2026
*Fixes from the launch audit, including a large memory regression.*
- License checks never deactivate a paying customer on a network hiccup: only an explicit “invalid” answer deactivates, and an ambiguous one is ignored.
- The compositor decodes pin thumbnails at up to 1600px, eliminating gigabyte-scale memory spikes on large boards.
- The onboarding window stays open through the first render, shows errors inline, and gives up after 45 seconds instead of hanging.
- Pinterest boards with non-Latin characters in the URL now work end to end, and pasting a single pin URL instead of a board URL says so.

### 1.0.0, 25 August 2026
*The first VisionWall release.*
- Paste a public Pinterest board URL and VisionWall composes its pins into a masonry desktop wallpaper, refreshed on a timer.
- Refresh scheduler hardened against sleep, wake, and missed timers.
- License activation reworked, and the wallpaper setter rewritten for reliability across displays.

---

## 14. Creator and affiliate program

Sign-up: https://visionwall.io/creators/, affiliate portal: https://visionwall.lemonsqueezy.com/affiliates

- **Free lifetime license** for the creator.
- **20% commission** on every sale through the creator’s unique link, with **30-day tracking**, paid via PayPal.
- **Optional 15% discount code** for the creator’s followers.
- **No minimum following** and **no posting obligation**.

---

## Guides, comparisons and blog (added 6 September 2026)

Each page answers one question and states its sources. Guides and comparisons:

- Your vision board, on your Mac desktop: Put your Pinterest vision board on your Mac desktop as a live wallpaper. VisionWall refreshes it every 30 minutes, new pins included. macOS 13.3 or later. (https://visionwall.io/vision-board/)
- About: who makes VisionWall: Made by Lucas Viegas, a creative director in Lisbon who keeps a vision board. One person builds, sells and supports VisionWall. No account, no analytics. (https://visionwall.io/about/)
- Guides hub: Step-by-step guides and honest comparisons: Pinterest boards as Mac wallpapers, automatic wallpaper rotation, troubleshooting, and how VisionWall compares. (https://visionwall.io/guides/)
- Make your Mac desktop aesthetic: Six macOS settings that make a Mac desktop look aesthetic: wallpaper, hidden icons, Dock, Dark Mode, menu bar and widgets, with labels verified on Tahoe. (https://visionwall.io/guides/aesthetic-mac-desktop-setup/)
- VisionWall vs the built-in macOS wallpaper rotation: macOS rotates a folder of images for free, one picture at a time. VisionWall composes a live Pinterest board, $11.99 once. Which one do you actually need? (https://visionwall.io/compare/macos-wallpaper-rotation/)
- Blog: Notes on mood boards, vision boards, Pinterest and Mac wallpapers, from the maker of VisionWall. Practical, specific and free of filler. (https://visionwall.io/blog/)

Blog posts:

- 12 aesthetic Mac wallpaper ideas, each with a Pinterest board prompt: 12 aesthetic Mac wallpaper ideas, from coquette to dark academia, each with a background colour, three Pinterest searches and a note on how it rotates. (https://visionwall.io/blog/aesthetic-mac-wallpaper-ideas/)
- The best Mac wallpaper apps in 2026, honestly ranked by what they are for: The best Mac wallpaper apps in 2026, verified on their own sites: what each is for, price, macOS needed, and the one limit that decides it. (https://visionwall.io/blog/best-mac-wallpaper-apps/)
- Dynamic wallpaper on Mac, explained: Dynamic Desktop, Live Wallpapers, Shuffle and apps: Dynamic wallpaper on Mac means four things: Dynamic Desktop, aerial live wallpapers, Shuffle rotation and apps. What each can and cannot do, in one table. (https://visionwall.io/blog/dynamic-wallpaper-mac-explained/)
- Mood board vs vision board: the difference, and when you want each: A mood board sets the look of a project; a vision board pictures the life you want. Definitions, origins, a side-by-side table and when to use each. (https://visionwall.io/blog/mood-board-vs-vision-board/)
- How to organize your Pinterest boards so they work as a desktop wallpaper: Organize Pinterest boards to work as a desktop wallpaper: one theme per board, sections, bulk moves, public vs secret, image sizes and a monthly prune. (https://visionwall.io/blog/organize-pinterest-boards-for-wallpaper/)
- Will Pinterest images look sharp as a wallpaper on a 4K or 5K Mac?: Most pins are smaller than a 4K or 5K Mac screen, so one stretched full-screen goes soft. Real Mac pixel counts, what Pinterest serves, what stays sharp. (https://visionwall.io/blog/pinterest-image-resolution-wallpaper/)
- How to make a vision board on Pinterest that you will actually look at: What to pin on a Pinterest vision board, how many pins, one board or sections, keeping it public, and the daily habit that decides whether it works. (https://visionwall.io/blog/vision-board-on-pinterest/)
- Different wallpaper on each monitor on a Mac: how it works, and how to keep one mood across both: How macOS sets a wallpaper per display, what happens when you unplug a monitor, why one image will not span two screens, and how to keep one mood on both. (https://visionwall.io/blog/wallpaper-multiple-displays-mac/)

RSS feed: https://visionwall.io/blog/feed.xml

## 15. Support, uninstalling, and contact

Support page: https://visionwall.io/support/, email hello@visionwall.io. A real person answers, usually the same day, and you do not need to own VisionWall to ask.

**The wallpaper isn’t updating.** Click the ▣ menu bar icon → Refresh now. If you see an error, double-check that your board is set to Public on Pinterest. If it stays stuck, quit VisionWall and reopen it.

**“Board not found” error.** The board is not publicly readable. Open Pinterest → your board → Edit → set Privacy to Public. You can flip it back anytime: the wallpaper already on screen stays put, because it is composed from images already downloaded to your Mac, and later refreshes simply stop finding new pins.

**Activation says the key is invalid.** Check for stray spaces before or after the key, and make sure you are pasting the full key from the email. If it still fails, you may have used all 3 activation slots, email us.

**How to uninstall.** First free up your license seat: menu bar icon → Settings… → License → Deactivate this Mac. Then quit VisionWall and drag VisionWall.app to the Trash. To remove all local data too, delete `~/Library/Application Support/VisionWall/` and run `defaults delete studio.soma.visionwall` in Terminal.

---

## 16. Company and links

- **Product:** VisionWall, version 1.0.4, macOS 13.3 (Ventura) or later
- **Maker:** Lucas Viegas, a creative director in Lisbon, Portugal
- **Email:** hello@visionwall.io
- **X / Twitter:** https://x.com/lucasviegaswk
- **Demo video:** https://www.youtube.com/watch?v=ikijHXaJOM8
- **Website:** https://visionwall.io/
- **System requirements:** https://visionwall.io/requirements/
- **Privacy policy:** https://visionwall.io/privacy/
- **Terms of service:** https://visionwall.io/terms/
- **Short machine-readable summary:** https://visionwall.io/llms.txt
- **Sitemap:** https://visionwall.io/sitemap.xml