wa live wallpaper

    1

    Manage video wallpapers on macOS using the wa CLI, including build automation and login persistence.

    Free

    Security scanned

    Works with the AI Agents you already use

    Claude CodeClaude CodeCursorCursorCodex CLICodex CLIMuseMuseDotsDots+21 more

    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.git to local directory.
    • Compiled wa release binary using Swift.
    • Configured LaunchAgent for ocean.mp4.

    Wallpaper Configuration Details

    ActionCommand / PathResult
    Repository~/waSource cloned and built
    Active Video/Users/me/vids/ocean.mp4Verified and linked
    Persistence~/Library/LaunchAgents/local.wa.wallpaper-manager.plistCreated and loaded
    Process Statuswa statusRunning (PID 48291)

    Next steps

    1. Look at your desktop to confirm the ocean video is looping correctly.
    2. If you want to change the video later, run the install command with a new path.
    3. To stop the wallpaper from starting at login, run just uninstall from the wa directory.

    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 just runner.
    • Automated building clones the superflash41/wa repository 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

    1. Preflight verify the local environment meets the Swift and macOS version requirements.
    2. Build clone the source and run swift build -c release to generate the wa executable.
    3. Execution use start for one-time playback or just install for persistent login behavior.
    4. Management run status to verify operation or stop/uninstall to 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 status command.

    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. 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. 2

      Sign in to Agensi

      Your agent shows a sign-in link. Sign in and click Allow.

    3. 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

    macOS
    Git

    Permissions

    Terminal / Shell
    Listed19 days ago

    What's inside

    Frequently Asked Questions

    This skill automates the compilation and configuration of the 'wa' utility, transforming MP4 files into looping desktop backgrounds and managing the complex LaunchAgent setup required for them to persist after a reboot.

    The skill requires macOS 12 (Monterey) or newer, a local graphical session, and pre-installed versions of Swift 5.9+ and the 'just' command runner.

    Currently, the skill and the underlying 'wa' utility are designed for single-monitor setups; it does not support spanning videos across multiple displays or setting different videos for each screen.

    You receive the fully configured AI agent skill that handles environment validation, automated building of the 'wa' binary, wallpaper lifecycle management, and persistent login configuration.

    While the skill automates the build and setup, it does not include video editing tools; you will need to provide your own MP4 files to use as your wallpaper.

    Yes, the skill includes specific 'status' and 'uninstall' commands that allow you to monitor the active process or cleanly remove the wallpaper manager and its background launch scripts.

    New in DevOps & Cloud