Desktop Wallpaper Location Identifier

Identify the real-world shooting location of the user's current desktop wallpaper and

provide a rich introduction to that location.

Workflow

Follow these steps in order:

Step 1 — Get the wallpaper file path

Run the bundled script to obtain the absolute path of the current wallpaper:

python scripts/get_wallpaper_path.py

• On Windows: reads from the registry key HKCU\Control Panel\Desktop\WallPaper;

falls back to the TranscodedWallpaper cache file for theme-based wallpapers.

• On macOS: uses osascript to query System Events.
• On Linux: tries gsettings (GNOME) then xfconf-query (XFCE).

If the script outputs an ERROR: line, report the problem to the user and stop.

Step 2 — Read the wallpaper image

Use the Read tool with the path returned by the script to load the image into

context. WorkBuddy is multimodal and can directly interpret the visual content.

If the path points to a file without a standard image extension (e.g. the Windows

TranscodedWallpaper cache has no extension), still pass it to Read—it is a

valid JPEG/PNG image and will be processed correctly.

Step 3 — Analyse the image

Carefully examine the image and identify:

1. Scene type — natural landscape, urban skyline, architectural monument,

national park, etc.

1. Visual clues — distinctive landforms, building styles, signage text, flags,

vegetation, water bodies, sky color/weather, and any other identifiable features.

1. Candidate locations — list the top 1–3 candidate real-world locations with

reasoning for each.

Step 4 — Confirm the most likely location

Select the single most probable shooting location. State clearly:

• Country / Region
• Specific site name (e.g. "Torres del Paine National Park, Patagonia, Chile")
• Confidence level (High / Medium / Low) and the key visual evidence that

supports the identification.

If the wallpaper is a digital illustration, abstract art, or a clearly synthetic

image with no identifiable real location, inform the user and stop here.

Step 5 — Introduce the location

Write a compelling, informative introduction to the identified location covering:

| Section | Content |

|---------|---------|

| 概况 / Overview | Location, country, administrative region, coordinates (approximate) |

| 自然地理 / Geography | Terrain, climate, notable natural features |

| 历史文化 / History & Culture | Historical background, cultural significance, famous events |

| 旅游亮点 / Travel Highlights | Best viewpoints, must-see attractions, nearby places of interest |

| 最佳旅行时间 / Best Time to Visit | Season recommendation and reason |

| 实用信息 / Practical Info | How to get there, tips for visitors |

Write in the same language the user used (default: Chinese). Use headings and

bullet points for readability. Aim for 400–800 words total.

Step 6 — Offer follow-up

End with a short prompt asking if the user wants to know more, e.g.:

> "如需了解更多关于该地点的信息（如签证要求、住宿推荐、摄影技巧等），欢迎继续提问！"

Important Notes

• Privacy: The wallpaper path is read locally and never uploaded anywhere.

Only the image content (pixels) is analysed by the model within this session.

• Low-confidence cases: When confidence is Medium or Low, present multiple

candidate locations and explain the ambiguity rather than guessing wrongly.

• No internet access needed: Location identification is done entirely by the

model's visual understanding—no reverse image search or external API is required.

If the model is uncertain, say so honestly.

• Non-photographic wallpapers: For paintings, illustrations, or computer-

generated art, skip geolocation and instead describe the artwork and its style.