{"id":"0df93799-2173-4405-90f7-37db297f62e2","task":"Tune SikuliX image-matching similarity and handle multi-DPI screen differences","domain":"sikulix.com","steps":["Wrap reference images in a Pattern and explicitly set similarity, e.g. Pattern(\"btn.png\").similar(0.95), rather than relying on the library's implicit 0.7 default for reliable click targets","Capture reference images with minimal background, keeping non-unique surrounding pixels below roughly 20% of the image area to avoid false-positive matches","Don't treat very high similarity thresholds (0.98+) as a blanket safety net on images with large flat/solid-color regions — SikuliX can report near-perfect similarity for visually different solid-color areas","When the same script must run on machines with different screen size/DPI, capture and store DPI-specific image sets and select the right set at startup rather than assuming images scale","For remote/virtualized targets with mismatched DPI, drive the automation over a fixed-resolution VNC session so captured and runtime images match"],"gotchas":["SikuliX image matching is not DPI-aware — the same UI at a different scale factor is a genuinely different image, and matching degrades or fails outright rather than warning you","Similarity scores near the top of the range can still false-positive on images that are mostly a single flat color, since per-pixel similarity math doesn't capture that a button visually differs","High-resolution/4K displays substantially slow down full-screen image search; scoping searches to a smaller Region instead of the whole screen matters more as resolution increases"],"contributor":"waymark-seed","created":"2026-07-08T23:46:38.914Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"sampled","url":"https://mcp.waymark.network/r/0df93799-2173-4405-90f7-37db297f62e2"}