winclipshot - GitLite

KO | EN

gitlite — search

#developer-tools #c #security #react-native #data-science #video #android #go #open-source #web

winclipshot

(★ 20)

Windows clipboard-to-path helper for terminal CLIs like Claude Code. Screenshot with Win+Shift+S, paste the saved path with Ctrl+V

winclipshot 최신버젼 다운로드

ZIP 다운로드

# CDN으로 사용하기

jsDelivr

jsDelivr는 공개 GitHub 리포지토리를 별도 설정 없이 CDN으로 즉시 서빙합니다. 버전과 파일을 고르면 웹페이지에 바로 붙일 수 있는 링크와 예시 코드가 만들어집니다.

버전

파일 경로 직접 입력

링크

예시

명령어 용어집

이 문서에서 사용된 명령어를 모아봤습니다. 낯선 명령어가 있다면 펼쳐서 확인해보세요.

🔍

`go install`

설명 보기 ▼

Compile and install packages named by the import paths.

go install

Compile and install the current package:

go install {{path/to/package}}

Compile and install a specific local package:

go install {{golang.org/x/tools/gopls}}@{{latest}}

Install the latest version of a program, ignoring `go.mod` in the current directory:

🔍

`paste`

설명 보기 ▼

파일의 라인을 병합.
더 많은 정보: <https://www.gnu.org/software/coreutils/manual/html_node/paste-invocation.html>.

paste {{[-s|--serial]}} {{path/to/file}}

모든 라인을 TAB을 구분자로 사용하여 하나의 라인으로 합치기:

paste {{[-s|--serial]}} {{[-d|--delimiters]}} {{delimiter}} {{path/to/file}}

지정한 구분자를 사용하여 모든 라인을 하나의 라인으로 합치기:

paste {{path/to/file1}} {{path/to/file2}}

두 파일을 각각의 열로 나란히 병합하고, TAB을 구분자로 사용하기:

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

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

<p align="center">
  <img src="./assets/winclipshot-demo.gif" alt="winclipshot demo" width="640">
</p>

## 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 clipboard         │
       └────────────┬─────────────┘
                    │
                    ▼
       ┌──────────────────────────┐
       │ winclipshot notified of  │
       │ clipboard change (OS     │
       │ event, not polling)      │
       └────────────┬─────────────┘
                    │
                    ▼
       ┌──────────────────────────┐
       │ Foreground window is a   │
       │ terminal?                │
       └───────┬─────────────┬────┘
            no │             │ yes
               ▼             ▼
  ┌──────────────────┐  ┌────────────────────────┐
  │ Remember as      │  │ Save PNG to %TEMP%\    │
  │ pending (60 s).  │  │  winclipshot\clip-*.png│
  │ Watch for focus  │  │ Replace clipboard with │
  │ to switch to a   │  │ the file path (text)   │
  │ terminal.        │  │                        │
  └───────┬──────────┘  └───────────┬────────────┘
          │                         │
          ▼                         │
  ┌──────────────────┐               │
  │ Terminal focused │               │
  │ within 60 s?     │               │
  └──┬───────────┬───┘               │
  no │           │ yes               │
     ▼           └─────┐             │
  (clipboard           ▼             ▼
   unchanged,    ┌──────────────────────────┐
   paste as      │ Ctrl+V in terminal →     │
   image in      │ path pasted into prompt  │
   Slack etc.)   └──────────────────────────┘
```

## Install

1. Grab the latest `winclipshot-<ver>-windows-amd64.zip` (or `arm64`) from [Releases](https://github.com/Higangssh/winclipshot/releases).
2. Unzip anywhere you like — it's a single `winclipshot.exe`, no installer, no registry changes.
3. Double-click `winclipshot.exe` to run it. Leave the console window open; closing it quits the tool.

**Run at sign-in (optional):** press `Win+R`, enter `shell:startup`, drop a shortcut to `winclipshot.exe` into the folder that opens. Windows will launch it automatically every time you log in.

**From source:**

```sh
go install github.com/Higangssh/winclipshot@latest
```

## Windows SmartScreen Warning

Windows SmartScreen may show **"Windows protected your PC"** when you first run the executable. This is a false positive — the binary is not code-signed yet, so Windows flags it as "unknown publisher."

**To run anyway:**

1. Click **More info**
2. Click **Run anyway**

**Or unblock the file first:** right-click `winclipshot.exe` → Properties → check **Unblock** at the bottom → OK.

The binary is built from public source code via GitHub Actions ([workflow](.github/workflows/release.yml)). [VirusTotal scan](https://www.virustotal.com/gui/file/4682e80834da5695b55e1feb0b620a5b1ba4c5aa55ffc0f9b18db0b165b55fec/detection) reports clean across all major engines (Kaspersky, ESET, CrowdStrike, BitDefender, Avast, etc.).

## Usage

Run `winclipshot.exe` and leave the console window open. Then use `Win+Shift+S` normally — the tool only reacts when a screenshot actually lands on the clipboard. Stop it with `Ctrl+C` or by closing the window.

## Options

| Flag | Default | Description |
| --- | --- | --- |
| `-out <dir>` | `%TEMP%\winclipshot` | Where to save PNG files. |
| `-terminals <csv>` | — | Extra executable names to treat as terminals (appended to defaults). |
| `-pending <dur>` | `60s` | How long to wait for you to focus a terminal after a screenshot taken in another app. Set to `0s` to disable deferred conversion. |
| `-v` | off | Verbose logging (also logs non-terminal windows where the image was left alone). |
| `-bench` | off | Run a micro-benchmark of the hot path and exit. |

### Default terminal list

`WindowsTerminal.exe`, `wt.exe`, `conhost.exe`, `cmd.exe`, `powershell.exe`, `pwsh.exe`, `alacritty.exe`, `wezterm-gui.exe`, `mintty.exe`, `Hyper.exe`, `Tabby.exe`

Need more? Use `-terminals` — e.g. `winclipshot.exe -terminals kitty.exe,foot.exe`.

## Performance

`winclipshot` is event-driven — it blocks on `AddClipboardFormatListener` and wakes only when the clipboard actually changes. No polling except during the pending window (60 s max, 200 ms interval, only when a screenshot is waiting for a terminal-focus decision).

Measured on a Windows 11 laptop via `winclipshot.exe -bench` (200 iterations, 400 KiB payload — realistic screenshot size):

```
save + clipboard.Write latency
   p50          : 1.10 ms
   p95          : 2.52 ms
   p99          : 3.45 ms
   max          : 5.00 ms
working set    : 15.7 MiB
heap alloc     : 2.2 MiB
```

Idle CPU is effectively 0 %: the process is blocked on an OS message queue and only woken by clipboard change events. End-to-end user-perceived latency from finishing a snip to the path being on the clipboard is dominated by the 150 ms focus-settle delay we wait for Snipping Tool's overlay to close, not by the code path itself.

Run `winclipshot.exe -bench` on your own machine to reproduce.

## FAQ

**Does it interfere with normal screenshots?**
No. The clipboard is only rewritten when a terminal is currently focused, or when you bring a terminal to the foreground within the pending window (60 s by default). Screenshots you never carry to a terminal are left alone; pasting into Slack, Word, or an email still works.

**What if I take a screenshot in Chrome, then focus a terminal just to check something, then want to paste the image into Slack?**
The screenshot will have been converted to a path by the time you visit the terminal. Take a new screenshot after switching to Slack, or shorten `-pending` if this happens often.

**Where do the images go?**
`%TEMP%\winclipshot\clip-<timestamp>.png` by default. Override with `-out`.

**Is my old clipboard content preserved?**
When a screenshot is redirected to a terminal, the image is replaced with the path. The previous clipboard contents are not restored — the design assumes you just took the screenshot for the terminal.

**Does it collect or send anything?**
No network activity at all. Everything is local.

## License

MIT © Sanghee Son