Splash

Animated wallpapers for macOS. Pick a preset, tune it, or describe it to the AI agent you already use.

Download View on GitHub

Can't open the app? See how to allow it.

Interactive preview: pick a scene and change its colours. This is the real scene code, running in your browser. In the app it is your wallpaper.

What is it?

Splash is a free and open-source app that puts animated and procedural wallpapers on your Mac. A wallpaper is a small folder with a web page and a few controls: start from a preset, change it, or describe what you want to an AI agent you already use. It runs in a tiny background process, so you forget it is there.

Alpha Splash is in early development. Expect rough edges and breaking changes between versions.

Features

Three ways onto the desktop

Still (one picture, nothing runs), Loop (a recorded video, played by the system) or Live (drawn in real time). Splash uses the lightest one the scene allows.

Presets and controls

Aurora, waves, stars, ribbons, soft gradients and a dusk. Change colours and speed with live controls, and see it in a large preview.

AI, with your own agent

Describe a change in words. Splash runs the agent CLI you are already signed in to (Claude Code today), in the scene's folder. No API key.

Draw, comment, attach

Draw on the preview and pin comments, or drop in images, SVGs and videos: to use in the scene, like a character, or as a reference. The agent changes only what you pointed at.

Versions you can go back to

A version is saved before every AI change, so any change can be undone.

Light on battery

It pauses when covered, when the screen sleeps or locks, on Low Power Mode and when the Mac is hot, and lowers its frame rate on battery.

Your own wallpaper stays safe

Splash remembers the wallpaper you had and can put it back. A picture of the scene is also set as the real wallpaper, so Mission Control and new displays match.

Updates in one click

When a new version is out, one button downloads it, checks it and restarts the app, keeping your permissions.

Command line

splash makes pictures and loops, checks a scene and asks an agent from a terminal, with the same engine as the app.

Reviews

What people who use Splash say, in their own words. Every review is written with a GitHub account and is tied to the version it is about.

–

Used it? Tell others.

Sign in with GitHub, give 1 to 5 stars and a few words. It takes a minute.

Write a review

Every review is a public GitHub issue from a real account (at least two weeks old), one per person per version. Negative reviews stay: only spam and abuse are removed. The maintainer's own reviews are not counted.

Light on your Mac

Splash stays out of the way. Measured once on a MacBook Pro (Apple silicon, macOS 26), with a simple scene at 30 fps:

0processes for a still
14 MBrunner memory, loop
~1 %runner CPU, loop
130–170 MBmemory, live
2.1 MBthe DMG

One machine, one run, a debug build; system decoders and the GPU are not counted. A live scene is about 7 % of one core with its web processes, which is why a loop or a still is the default. You can measure it on your own Mac with scripts/benchmark.sh; the details are in the README.

Presets

Every preset is a normal scene: copy it, change it with the controls, or hand it to an agent.

The app

The Splash library with scene thumbnails The Splash editor with a large preview and controls

Install

Requires macOS 14 or later. Download the latest build from the Releases page, open the DMG and drag Splash to Applications. Then follow the first launch guide below: macOS will block the app the first time.

With Homebrew, one command (it also skips the first-launch warning):

brew install --cask Peppe37/tap/splash

Prefer building it yourself? Install xcodegen, run xcodegen generate and open Splash.xcodeproj, or run swift build. See the README.

First launch: allowing the app

Splash is not notarized by Apple yet (that requires a paid developer account), so macOS shows a warning saying it cannot verify the app. This is expected. Here is how to open it:

  1. Open Splash from Applications. A message says it could not be opened. Click Done (do not click “Move to Trash”).
  2. Open System Settings → Privacy & Security.
  3. Scroll down to the Security section. You will see “Splash.app was blocked”. Click Open Anyway.
  4. Confirm with your password or Touch ID, then click Open. You only need to do this once.

Prefer the Terminal? This removes the quarantine flag and does the same thing:

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

Why trust it? Splash is fully open source: you can read every line of code in the repository, or build the app yourself with Xcode and skip this warning altogether. The release is built automatically by GitHub Actions from the tagged source.

Questions

macOS says it can't verify the app
That is normal for the alpha: follow the first launch guide. It takes four clicks, once.
Does it use my AI API key?
No. Splash has no API key field. The AI feature runs an agent CLI you already installed and signed in to (Claude Code works today), inside the scene's folder. What you type, and any drawing you send, go to that agent, as with any use of it.
Will it drain my battery?
A still wallpaper costs nothing and a loop costs very little. A live scene pauses on Low Power Mode by default, lowers its frame rate on battery, and stops when covered, when the screen sleeps or locks, and when the Mac is hot. You can change these in Settings.
Does it replace my current wallpaper?
While a scene is applied, Splash sets a picture of it as your wallpaper on every Space and display, so Mission Control, the slide between Spaces and new displays match. To do that it edits the macOS wallpaper settings file, after saving the original: “Put back my previous wallpaper” restores it, Space by Space, and Settings → Desktop switches it off.
Why is a moving wallpaper a window?
macOS has no public way to play an animation as the wallpaper itself, so Splash puts a window at the desktop level, under your icons and windows. To limit the side effects it also sets a still picture as the real wallpaper, and the runner stays out of the Dock and the app switcher.
What does it do with my data?
Nothing leaves your Mac: no analytics, no telemetry, no accounts. The wallpaper process makes no network calls. A scene can only use the network if it asks for it. The only network use of the app itself is one small request to GitHub, once a day while the editor is open, to tell you about a newer version. You can switch it off in Settings.
How do I update?
When a new version is out, the app shows an Update button, and Settings → About has Update and restart: it downloads the release from this repository, checks it is signed with the same identity as your app, replaces it and opens it again, keeping your permissions. With Homebrew: brew upgrade --cask splash.
Is it really free?
Yes. It is free and open source under the GPL-3.0: you can use, study, modify and share it. If you share a modified version, it has to stay under the same license, with its source available.

Support & community

Splash is a free project made by one person. Here is how to get help, and how you can help it grow.

Ask or share an idea

Questions and ideas in GitHub Discussions.

Report a bug

Something broken? Open an issue, it takes a minute.

Contribute

Code, scenes, translations: start from the contributing guide.

⭐ Star on GitHub

The easiest way to help others find it. Tell a friend too.

If Splash is useful to you, you can help keep it going. It pays for the time behind the project, and for the Apple Developer Program, which is what it takes to ship notarized builds with no warning at first launch.

❤️ GitHub Sponsors ☕ Ko-fi ☕ Buy Me a Coffee