Gallery
Pricing

Wallper 1.0.1: Two Days After Launch, the First Fixes

Wallper 1.0.1: Two Days After Launch, the First Fixes
Jun 7, 2025·3 min read

The first patch after release: a hardened apply pipeline, preview grids that cope with slow connections, and better diagnostics for first-run problems.

Two days after 1.0 went out, we learned the thing every developer learns roughly two days after shipping.

Your test machines are not representative. They are fast, they are on good connections, they have run every build of the app in order, and they are configured by the person who wrote it. Real Macs are older, slower, connected to hotel wifi, and encountering the app for the first time in a state your machine has not been in since the first week of development.

1.0.1 is the patch that fixes what that first weekend surfaced.

The Apply Pipeline

Applying a wallpaper looks like one action and is really several: resolve the file, hand it to the rendering layer, replace what is currently on screen, and persist the choice so it survives a restart.

Those steps have an order, and on a slow machine the gaps between them get wide enough for things to arrive out of sequence. The result was a rare failure where the wallpaper did not take, or took and then reverted, with no error to explain it.

The pipeline is now hardened against those timing issues. The steps hold their order regardless of how long each one takes.

Preview Grids on Slow Connections

The library grid assumed previews would arrive promptly. On a fast connection they do.

On a slow one, that assumption produced a grid that looked broken: empty cards, half-loaded thumbnails, and a layout that shifted under the cursor as images turned up in whatever order the network delivered them. Nothing was actually failing, but it looked like everything was.

The grid now degrades properly. Slow previews arrive late without disturbing the layout, and a card that is still loading looks like a card that is still loading rather than a card that has given up.

Crash Guards and Better Logs

Two defensive changes.

Missing metadata is now handled rather than assumed away. A wallpaper with an incomplete record used to be able to take down the view it appeared in; now it is skipped and the rest of the grid renders.

Logging around first-run behaviour is substantially better. Most of what people reported that weekend happened exactly once, on a fresh install, in a state that is difficult to reproduce on a machine that already has the app configured. Better diagnostics is how those get fixed rather than guessed at.

If you hit something, the troubleshooting guide is the place to start, and reports are what turn a rare bug into a fixed one.

Get Wallper for macOSFree download. The 4K gallery is free to browse, and the 7-day trial unlocks everything else.

FAQ

My live wallpaper does not apply or reverts to the previous one. What causes that?

Applying a wallpaper involves several ordered steps, and on slower machines they could arrive out of sequence, leaving the wallpaper unset or reverted with no error. The apply pipeline was hardened against those timing issues in 1.0.1.

Why do wallpaper previews look broken on a slow connection?

The library grid originally assumed previews would arrive quickly, so a slow connection produced empty cards and a shifting layout. Since 1.0.1 the grid degrades properly, and cards that are still loading look like they are loading.

How do I report a problem with Wallper?

Start with the troubleshooting guide, which covers the common cases. For anything else, reports through Discord or GitHub feed directly into what gets fixed next, and first-run problems in particular are very hard to find without them.