Skip to content

README.md

Latest commit

 

History

History
71 lines (51 loc) · 3.1 KB

README.md

File metadata and controls

71 lines (51 loc) · 3.1 KB
Raw

Trace

Trace는 macOS 기본 캡처 경험을 개선하기 위한 캡처 도구다. MVP에서는 Trace 자체 영역 캡처 오버레이와 전체 화면 캡처를 사용하고, 자동 저장, 클립보드 복사, 실행 중인 앱으로의 자동 전달, 최근 및 과거 캡처 히스토리 관리를 핵심으로 한다.

캡처 방식은 두 가지로 나뉜다. 사용자는 캡처 이미지를 클립보드에 자동 복사만 할 수도 있고, 자동 전달 캡처 상태로 캡처한 뒤 현재 실행 중인 앱 중 전달 대상을 선택해 이미지가 해당 앱에 자동으로 들어가게 할 수도 있다.

MVP에서는 AI 기능을 만들지 않는다. 우선 자체 영역/전체 화면 캡처 흐름과 저장, 전달, 히스토리 기능을 안정적으로 구현하고, 이후 AI 기반 자동 파일명 생성, 폴더 분류, OCR 검색으로 확장한다.

문서

개발 문서

MVP 핵심 범위

  • 전역 단축키로 빠른 캡처 시작
  • 캡처 중 범위와 방식 변경
  • Trace 자체 오버레이 기반 영역 선택 캡처
  • 현재 디스플레이 전체 화면 캡처
  • 날짜별 폴더 자동 저장
  • 캡처 이미지 클립보드 자동 복사
  • 복사만 하기 모드
  • 앱으로 자동 전달 모드
  • 최근 캡처 보기
  • 날짜별 과거 캡처 이력 보기

실행

개발 실행:

swift run Trace

앱 번들 생성:

chmod +x scripts/build-app.sh
scripts/build-app.sh
open build/Trace.app

기본 단축키:

  • 복사만 하기 기본값으로 캡처 오버레이 열기: command+shift+2
  • 앱으로 자동 전달 기본값으로 캡처 오버레이 열기: command+shift+3

화면 캡처 권한은 실제 실행 주체에 부여해야 한다. swift run Trace로 실행하면 터미널 앱에 Screen Recording 권한이 필요하고, build/Trace.app으로 실행하면 Trace 앱에 권한이 필요하다. 앱으로 자동 전달을 사용하려면 Accessibility 권한도 허용해야 한다.

권한을 허용했는데도 계속 다시 묻는 경우:

scripts/build-app.sh
open build/Trace.app

swift run Trace와 open build/Trace.app을 번갈아 쓰면 macOS가 서로 다른 앱으로 권한을 관리한다. 권한 테스트는 build/Trace.app 하나로만 진행하는 것이 좋다. 이미 꼬였다면 시스템 설정의 Screen Recording, Accessibility 목록에서 기존 Trace 항목을 제거한 뒤 build/Trace.app을 다시 열어 권한을 새로 허용한다.