Winclipshot

winclipshot

Make `Win+Shift+S` paste as a file path in terminals — so Claude Code, SSH sessions, and other CLIs can read your screenshots.

On macOS, terminals like iTerm2 and tools like Claude Code handle clipboard images natively. On native Windows they can't: the terminal's stdin only accepts text. `winclipshot` bridges the gap — it quietly watches the clipboard, and when a screenshot is about to be pasted into a terminal it swaps the image for the file path of a saved PNG.

Demo

How it works

`winclipshot` doesn't change `Win+Shift+S` or any keybinding. It subscribes to Windows' clipboard-change events (`AddClipboardFormatListener`) and reacts only when a new **image** appears. When it does, one of three things happens:

1. Focused window is a terminal → the image is saved to a PNG file and the clipboard is replaced with the file's path. Ctrl+V pastes the path.
2. Focused window is something else, but you focus a terminal within 60 s → same conversion happens at that moment. Typical case: you screenshot a webpage in Chrome, switch to the terminal, paste.
3. Focused window is something else, you never visit a terminal → the image is left on the clipboard untouched. Pasting into Slack/Word/Chrome behaves normally.

The pending window (60 s by default, `-pending` flag) only polls while an undecided image is on the clipboard; the moment the clipboard changes or a terminal is focused the polling ends. Text copy/paste is never touched.

When `winclipshot.exe` is not running, nothing is different — `Win+Shift+S` and the clipboard work exactly like stock Windows.

       ┌──────────────────────────┐
       │  User: Win + Shift + S   │
       │  selects a region        │
       └────────────┬─────────────┘
                    │
                    ▼
       ┌──────────────────────────┐
       │ Windows puts the image   │
       │ on the clipb