← Back to Skills Marketplace
akayj

mac-wallpaper-changer

by Jian Yu · GitHub ↗ · v1.0.1 · MIT-0
cross-platform ✓ Security Clean
337
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install mwc
Description
自动更换 Mac 壁纸、壁纸智能推荐与偏好学习。凡涉及壁纸相关操作,都应优先使用此技能:换壁纸、更换桌面背景、 Mac wallpaper、自动换壁纸(cron/定时任务)、按关键词搜索壁纸(如"上海夜景"、"mountain sunset")、 壁纸评分与喜好统计、壁纸推荐、位置配置。支持 Bing 每日精选...
Usage Guidance
This skill is coherent for changing macOS wallpapers, but check the following before installing or running: - Runtime dependencies: The scripts expect Python >=3.12, the 'uv' runner, and Python packages (polars, duckdb, pyobjc). The registry metadata did not declare these — install them in a virtualenv or confirm your environment first. - Files and write access: The skill will create ~/wallpaper-daily/ (images, preferences.parquet, logs) and may read ~/.wallpaper_prefs.json and ~/.wallpaper_prefs.json embedding config. If you care about file placement, inspect and change the paths in the code before running. - Network access: The scripts fetch images from Unsplash (scraped NAPI or API), Bing, and Picsum. Ensure you are comfortable with those network calls. If you provide an UNSPLASH_ACCESS_KEY or embedding API keys, keep them secret and only provide keys you trust; the code will use them for search/embedding (embedding is a planned advanced feature referenced in docs). - Process control: To force wallpaper refresh the code runs 'killall WallpaperAgent' (and may use 'desktoppr' as fallback). That terminates the WallpaperAgent process to refresh the desktop — expected for the task but be aware it affects your desktop agent. - Run safely: Review the scripts locally, run them in a controlled environment or sandbox first, and consider running 'uv run scripts/change.py --download-only' (or equivalent) to test downloading without changing system state. If you do not have 'uv' or Python 3.12+, either install them or adapt the scripts to your Python runner. If you want, I can list the exact dependency lines and the places the skill writes/reads on disk, or point out the specific lines where network calls and 'killall' are issued.
Capability Analysis
Type: OpenClaw Skill Name: mwc Version: 1.0.1 The bundle is a comprehensive macOS wallpaper management utility that fetches high-quality images from Bing, Unsplash, and Picsum. It uses legitimate system APIs via PyObjC (AppKit) and standard subprocess calls to update desktop backgrounds and manage local preference data using Polars and DuckDB. No evidence of data exfiltration, malicious persistence, or prompt injection was found; all network activity is directed toward stated image providers, and file operations are confined to the user's home directory (~/wallpaper-daily/).
Capability Assessment
Purpose & Capability
The name/description match the included scripts (change.py, daily.py, recommend.py, preference.py, loc.py). All network calls and file operations are directly related to downloading, recommending, storing, and applying wallpapers. Minor inconsistency: SKILL.md and script headers require 'uv' and Python >=3.12 plus Python packages (polars, duckdb, pyobjc) but the registry metadata lists no required binaries/dependencies — the runtime will need those to run correctly.
Instruction Scope
Runtime instructions (SKILL.md) and the scripts only reference wallpaper-related data and local config under the user's home (~/wallpaper-daily, ~/.wallpaper_prefs.json). The scripts call external image endpoints (Unsplash NAPI, Bing, Picsum) which is expected. They do not attempt to read unrelated system files or random credentials.
Install Mechanism
No install specification is provided (instruction-only), which reduces installer risk. However the scripts include shebang metadata indicating Python >=3.12 and dependencies; the skill will require installing packages (polars, duckdb, pyobjc, etc.) and the 'uv' runner to execute. That mismatch (no declared runtime requirements in registry) is an operational omission the user should resolve before running.
Credentials
No required environment variables are declared. The code optionally reads UNSPLASH_ACCESS_KEY (for Unsplash API) and references an embedding config (assets template and references mention api_key or WALLPAPER_EMBEDDING_CONFIG) for planned advanced features. Those are optional and proportional to the described functionality; nothing requests unrelated credentials (AWS, GitHub tokens, etc.).
Persistence & Privilege
always:false and agent-autonomy defaults apply (no forced persistent inclusion). The scripts write files under the user's home (~/wallpaper-daily) and logs, and call 'killall WallpaperAgent' to refresh macOS wallpaper — this is a necessary-but-privileged local action (terminating a user-level/system agent). The skill does not modify other skills or system-wide agent configuration.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install mwc
  3. After installation, invoke the skill by name or use /mwc
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
Version 1.0.1 of "mac-wallpaper-changer" restructures scripts for clarity and introduces support for advanced semantic recommendations. - Replaced and unified scripting with new modular scripts: change.py, recommend.py, preference.py, loc.py, and daily.py. - Deprecated and removed older scripts for analyze-preferences, change-wallpaper, my-location, and recommend-wallpaper. - Updated documentation to detail new commands, data storage, and embedding-based semantic recommendation (planned). - Added embedding configuration template and reference for future advanced recommendations. - Cron setup and troubleshooting steps updated to match new script structure.
v1.0.0
- Initial release of Mac Wallpaper Changer skill. - Automatically changes macOS wallpapers with support for multiple sources (Bing, Unsplash, Picsum). - Learns user preferences through ratings for smarter wallpaper recommendations. - Includes scripts for changing wallpaper, analyzing preferences, and generating recommendations. - Supports scheduled wallpaper changes and various customization options. - Stores data locally in `~/wallpaper-daily/` for easy access and troubleshooting.
Metadata
Slug mwc
Version 1.0.1
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 2
Frequently Asked Questions

What is mac-wallpaper-changer?

自动更换 Mac 壁纸、壁纸智能推荐与偏好学习。凡涉及壁纸相关操作,都应优先使用此技能:换壁纸、更换桌面背景、 Mac wallpaper、自动换壁纸(cron/定时任务)、按关键词搜索壁纸(如"上海夜景"、"mountain sunset")、 壁纸评分与喜好统计、壁纸推荐、位置配置。支持 Bing 每日精选... It is an AI Agent Skill for Claude Code / OpenClaw, with 337 downloads so far.

How do I install mac-wallpaper-changer?

Run "/install mwc" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is mac-wallpaper-changer free?

Yes, mac-wallpaper-changer is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does mac-wallpaper-changer support?

mac-wallpaper-changer is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created mac-wallpaper-changer?

It is built and maintained by Jian Yu (@akayj); the current version is v1.0.1.

💬 Comments