- Home
- Skills
- DevOps & Cloud
- wa live wallpaper
wa live wallpaper
Manage video wallpapers on macOS using the wa CLI, including build automation and login persistence.
Free
Works with the AI Agents you already use
wa live wallpaper
Example session with this skill installed
I want to use /Users/me/vids/ocean.mp4 as my wallpaper and make sure it starts every time I log in.
- Read your context and instructions
- Compiled the wa live wallpaper
I will set up ocean.mp4 as your persistent live wallpaper. I have verified your environment has macOS 14.2, Swift 5.9.2, and the just runner installed. I will now clone the wa repository, build the binary, and install the LaunchAgent.
- Cloned
https://github.com/superflash41/wa.gitto local directory. - Compiled
warelease binary using Swift. - Configured LaunchAgent for
ocean.mp4.
Wallpaper Configuration Details
| Action | Command / Path | Result |
|---|---|---|
| Repository | ~/wa | Source cloned and built |
| Active Video | /Users/me/vids/ocean.mp4 | Verified and linked |
| Persistence | ~/Library/LaunchAgents/local.wa.wallpaper-manager.plist | Created and loaded |
| Process Status | wa status | Running (PID 48291) |
Next steps
- Look at your desktop to confirm the ocean video is looping correctly.
- If you want to change the video later, run the
installcommand with a new path. - To stop the wallpaper from starting at login, run
just uninstallfrom thewadirectory.
Connects securely to your tools. The creator never sees your data.
About this skill
Setting a video as a live wallpaper on macOS often requires third-party apps or complex terminal scripts. This skill automates the management of the wa utility, allowing you to turn local video files into looping desktop backgrounds. It handles the entire lifecycle from building the source to managing LaunchAgents for persistence.
What it does
- Environment validation checks for macOS 12+, Swift 5.9, git, and the
justrunner. - Automated building clones the
superflash41/warepository and compiles the release binary. - Wallpaper control starts, stops, and changes live video wallpapers via CLI commands.
- Persistence management configures macOS LaunchAgents to ensure wallpapers start at login.
- Status monitoring inspects the current state of the wallpaper manager and active video.
How it works
- Preflight verify the local environment meets the Swift and macOS version requirements.
- Build clone the source and run
swift build -c releaseto generate thewaexecutable. - Execution use
startfor one-time playback orjust installfor persistent login behavior. - Management run
statusto verify operation orstop/uninstallto revert changes.
Frameworks & tools
The skill utilizes macOS native APIs, Swift 5.9+, git, and the just command runner. It targets the superflash41/wa repository.
Why this beats prompting it yourself
Writing reliable LaunchAgent plists and managing Swift builds manually is error-prone. This skill handles the specific paths, shell quoting, and justfile recipes required to ensure a stable wallpaper process that survives reboots.
Use cases
- Set a specific MP4 file as a looping live wallpaper.
- Configure a video wallpaper to launch automatically when you sign into your Mac.
- Cleanly uninstall the background manager and remove its persistent LaunchAgent.
- Troubleshoot why a live wallpaper failed to start using the
wa statuscommand.
Known limitations
Requires a local macOS session with graphical output. Cannot create videos, support multiple displays, or function on Windows/iOS. Requires manual installation of Swift and just.
Requires macOS 12+ and a local shell. User must have Swift 5.9+, git, and just installed. Cannot generate video content or manage multi-monitor setups.
How to use
- 1
Connect your agent to the Agensi MCP
Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup
- 2
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before any payment.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill goes through the trust checks below.
Security scanned
Checked by our 8-point scan before listing
Fresh listing
Recently published to Agensi
Free forever
No account required to browse
Trust & safety
Security scan
Security scan passed 19 days ago
- Free with an Agensi account
Requires