- macOS Shortcuts 앱을 이용하면 별도 유료 서비스 없이 로컬 OCR 단축어를 만들고 터미널/CLI/파이썬에서 이미지 텍스트 추출을 실행할 수 있음
- 핵심 구성은 Extract Text from Image 액션에 Shortcut Input을 연결하고, 결과를 클립보드로 복사하는 흐름임
- 단축어 이름은
ocr-text나 extract-text처럼 공백 없는 소문자로 두면 CLI에서 호출하기 쉬우며, 이름 입력 뒤 Enter를 눌러 저장해야 함
- 터미널에서는
shortcuts run ocr-text -i <이미지 경로>로 실행하고, 추출 결과는 클립보드에 복사되어 Command-V로 확인할 수 있음
- 파이썬에서는
subprocess.check_output()으로 같은 shortcuts run 명령을 호출해 OCR 단축어를 재사용 가능함
Shortcuts에서 OCR 단축어 만들기
- macOS의 Shortcuts 앱을 열고
+ 버튼으로 새 단축어를 만듦
- 오른쪽 사이드바에서
extract text를 검색한 뒤 Extract Text from Image 액션을 왼쪽 작업 영역으로 드래그함
Extract text from ... 액션의 파란색 Image 입력을 클릭하고 Shortcut Input을 선택함
- 위쪽에 Receive 액션이 나타나며, 그대로 두면 됨
- 오른쪽 사이드바에서
copy를 검색해 Copy to Clipboard 액션을 Extract Text from Image 아래에 배치함
- 마지막 액션에서
Copy 뒤가 Text from Image인지 확인해야 함
Copy to Clipboard 액션을 아래로 드래그하는 과정이 다소 불편할 수 있음
- 단축어 이름은
extract-text 또는 ocr-text처럼 단순하고 공백 없는 소문자가 적합함
- 이름을 입력한 뒤 Enter를 눌러야 이름이 저장됨
CLI와 파이썬에서 실행하기
- 터미널에서 단축어를 실행하는 명령은 다음과 같음
shortcuts run ocr-text -i <A PATH TO SOME IMAGE>
- 실행 후 Command-V로 붙여넣었을 때 추출된 텍스트가 보이면 설정이 제대로 된 것임
- 파이썬에서는
subprocess.check_output()으로 같은 명령을 실행할 수 있음
import subprocess
file_path = '... some file path ...'
ocr_out = subprocess.check_output(
f'shortcuts run ocr-text -i "{file_path}"', shell=True
)
print(ocr_out)
- Shortcuts 공유가 이상하게 동작할 수 있어 수동 설정이 필요하며, 대부분의 과정은 한 번만 해두면 됨