피드로 돌아가기
I Got Tired of Hunting Screenshot Paths in Terminals. So I Fixed Ctrl+V.
Dev.toDev.to
Infrastructure

터미널 Ctrl+V의 진화, 스크린샷 경로 자동 입력 도구 TCP

I Got Tired of Hunting Screenshot Paths in Terminals. So I Fixed Ctrl+V.

CodeWarrior4Life2026년 4월 6일4intermediate

Context

터미널 환경에서 스크린샷 이미지의 파일 경로를 수동으로 찾는 번거로움 발생. 단순 이미지 데이터 붙여넣기가 아닌 컨텍스트 기반의 경로 입력 필요성 증대.

Technical Solution

  • AutoHotkey v2 기반의 OS 레벨 키보드 인터셉터 레이어를 통한 Ctrl+V 이벤트 캡처 및 포커스 윈도우 판별
  • Python 코어 로직을 활용한 클립보드 이미지 데이터 존재 여부 확인 및 OS별 스크린샷 저장 경로 자동 탐색
  • 최근 5초 이내 생성된 파일 매칭 시 해당 경로를 터미널에 즉시 입력하는 Recency Window 기반 매칭 전략
  • 매칭 파일 부재 시 클립보드 이미지를 직접 디스크에 저장 후 생성된 경로를 반환하는 폴백 메커니즘
  • {Raw} 및 {Blind} 모드 적용을 통해 Modifier Key 누설을 방지하고 깨끗한 키스트로크 주입 구현
  • TOML 설정 파일을 통한 터미널 프로세스 리스트 확장 및 저장 경로 커스터마이징 지원

Key Takeaway

사용자 경험의 극대화를 위해 새로운 명령어를 학습시키는 대신 기존 인터페이스의 컨텍스트를 분석하여 동작을 정의하는 투명한 설계 원칙.


OS 레벨의 키 인터셉션 구현 시 Modifier Key 간섭을 방지하는 Low-level 입력 모드 설정을 최우선으로 검토할 것

원문 읽기