Paste clipboard files with Ctrl+V instead of Shift+Insert (#10526) - #10536
Open
baseman70 wants to merge 1 commit into
Open
Paste clipboard files with Ctrl+V instead of Shift+Insert (#10526)#10536baseman70 wants to merge 1 commit into
baseman70 wants to merge 1 commit into
Conversation
Terminal emulators bind Shift+Insert as an internal text-only paste mechanism. When an image is staged on the clipboard (image/png), the terminal consumes Shift+Insert, finds no text flavor on the clipboard, and silently discards it. Consequently, terminal applications supporting image paste (e.g. Claude Code, Gemini CLI) never receive the pasted image. Sending Ctrl+V allows terminal emulators to pass the keystroke through to image-capable terminal applications, while continuing to work universally across graphical applications. Closes omacom#10526
baseman70
force-pushed
the
fix/clipboard-paste-image
branch
from
September 6, 2026 20:03
93555ca to
ee82ab7
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Problem
When selecting an image entry from the clipboard manager (
Super + Ctrl + V),bin/omarchy-clipboard-paste-filecopies the image to the clipboard viawl-copy --type "$mime"and then dispatches:As reported in #10526, terminal emulators (
foot,ghostty,kitty, etc.) bindShift+Insertto their own text-only paste handler and consume the keystroke before the running application ever sees it. Because the clipboard only holds animage/*flavor without a text flavor, the terminal emulator quietly drops the event, resulting in no paste and no feedback.Consequently, terminal-based applications that support image paste (such as Claude Code, Gemini CLI, and terminal image viewers) fail to receive the pasted image, forcing users to manually press
Ctrl+V.Solution
Switch the synthetic paste keystroke in
bin/omarchy-clipboard-paste-filefromShift+InserttoCtrl+V:Ctrl+Vpasses through to running applications, allowing image-capable TUIs and CLI agents to read the image from the clipboard.Ctrl+Vcontinues to work as the universal paste shortcut.Test plan
bash test/shell.d/clipboard-test.sh(all 76 assertions pass, covering--copy-onlycontent staging, normal execution withctrl vkeystroke dispatch, missing argument fail-closed, and unreadable/nonexistent file fail-closed)../test/cli(all 108 tests pass).Closes #10526