SnapView 사용자 매뉴얼

이 문서는 SnapView를 처음 사용하는 사용자가 설치부터 선별 작업까지 혼자 진행할 수 있도록 만든 실사용 안내서입니다.

1. SnapView가 무엇인가요?

• SnapView는 macOS용 초고속 이미지 뷰어입니다.
• 무거운 카탈로그 생성 없이 폴더/ZIP을 바로 열어 빠르게 감상하고 선별할 수 있습니다.
• Lightroom 같은 편집 도구를 대체하기보다, 그 전에 빠르게 보고 고르는 단계에 집중합니다.

2. 이런 분께 추천합니다

• 여행/일상/가족 사진을 많이 찍는 분
• RAW 파일도 보지만 무거운 워크플로우가 부담스러운 분
• 빠르게 훑고 좋은 컷만 남기고 싶은 분
• 폴더 기반으로 간단히 관리하고 싶은 분

3. 설치와 첫 실행

3.1 설치

1. 릴리즈에서 SnapView.dmg를 다운로드합니다.
2. DMG를 열고 SnapView.app을 Applications로 드래그합니다.
3. Applications에서 SnapView를 실행합니다.

3.2 처음 실행 시

• macOS 보안 경고가 뜨면:
  1. 시스템 설정 -> 개인정보 보호 및 보안
  2. 실행 허용
  3. 앱 재실행
• 첫 실행 화면에서 기본 이미지 앱 등록 제안을 볼 수 있습니다.
• 원치 않으면 건너뛰어도 사용에 문제 없습니다.

4. 5분 빠른 시작

1. 열기(Open)로 폴더 또는 ZIP 파일을 엽니다.
2. Q/W/E/R로 뷰 모드를 바꿔 봅니다.
3. 좌/우 화살표로 넘기며 확인합니다.
4. 좋은 컷은 1~5로 별점, 불필요한 컷은 X로 Reject 표시합니다.
5. 비교가 필요하면 C로 Compare 모드에서 1~4장 비교합니다.
6. Delete로 삭제하거나 Cmd+C로 복사해 정리합니다.
7. 완전히 동일한 파일 정리는 Cmd+Shift+D로 중복사진정리에서 처리합니다.

5. 화면 구성 이해하기

• 상단 툴바: 열기, 이전/다음, 뷰 모드 전환, 줌, 정보/퀵체크/히스토그램 토글, 선별 액션
• 중앙 캔버스: 현재 이미지 표시
• 모드별 보조 영역:
  • Grid: 썸네일 격자
  • Filmstrip/Manage: 하단 또는 사이드 영역에서 연속 탐색
  • 상세 EXIF/Quick Check 패널: 정보 분석용

6. 뷰 모드별 사용법

6.1 Main View ( W)

• 한 장에 집중해서 확인할 때 사용합니다.
• 0으로 Fit, 9로 100%를 빠르게 전환합니다.
• I로 간단 정보 오버레이를 켜고 끌 수 있습니다.

6.2 Grid View ( Q)

• 많은 사진을 한 번에 훑을 때 사용합니다.
• 화살표/마우스로 빠르게 이동하고 여러 장을 선택할 수 있습니다.
• =/-로 썸네일 크기를 조절해 밀도를 맞춥니다.

6.3 Filmstrip View ( E)

• 메인 이미지 + 연속 스트립으로 흐름을 유지하며 볼 때 좋습니다.
• 연사/유사 컷을 빠르게 넘기며 감으로 선별하기 좋습니다.

6.4 사진관리모드 Manage ( R)

• 폴더/필터/선택 상태를 보며 정리할 때 사용합니다.
• 별점/플래그/컬러 라벨을 적용하고 필터링해 결과를 정돈합니다.

6.5 중복사진정리 Duplicate (Cmd+Shift+D)

• 현재 소스에서 완전히 동일한 파일만 그룹으로 보여줍니다.
• 그룹이 4장 이하면 중앙 영역에서 바로 비교하고, 5장 이상이면 하단 스트립이 추가로 표시됩니다.
• 우측 패널에서 현재이미지 병합 / 중복사진 일괄 정리 / 삭제 되돌리기를 수행합니다.
• 삭제 되돌리기(⌘Z)는 중복 모드에서 수행한 최근 삭제 트랜잭션만 복원합니다.

7. 선별 도구 (가장 많이 쓰는 기능)

7.1 별점

• 1~5: 별점 부여
• 0 또는 \(원화키 포함): 별점 해제

7.2 Pick / Reject / Unflag

• P: Pick
• X: Reject
• U: Unflag

7.3 컬러 라벨

• Cmd+1~5: 빨강/노랑/초록/파랑/보라
• Cmd+6: 해제

7.4 복사/삭제

• Cmd+C: 선택 항목 복사
• Cmd+V: 붙여넣기
• Delete 또는 D: 삭제
• Cmd+Delete: 즉시 삭제(주의)

8. Quick Check와 Compare 사용법

8.1 Quick Check

• K로 Quick Check 세트를 켭니다.
• 점수와 경고 원인(초점/노출/눈감음/구도 등)을 확인합니다.
• Quick Check는 보조 도구이며 최종 선택은 사용자가 합니다.

8.2 Compare 모드

• C로 Compare 모드 진입/종료
• 1~4장을 나란히 비교해 한 장을 고릅니다.
• 확대해서 디테일까지 확인할 수 있습니다.

8.3 중복사진정리

• Cmd+Shift+D: 중복 모드 진입 (모드 내에서는 재스캔)
• Shift+D 또는 ESC: 중복 모드 종료
• ← / →: 이전/다음 중복 그룹 이동
• P: 현재 이미지를 기준이미지(Keep)로 지정
• 우측 패널 하단에서 마지막 삭제를 Cmd+Z로 되돌릴 수 있습니다.

9. 설정과 동작 이해하기

9.1 디코딩 모드

• 속도 우선: 빠른 탐색이 우선입니다. 기본적으로 더 작은 리사이즈 이미지를 먼저 보여줍니다.
• 보통: 일반적인 추천값입니다. 기본은 리사이즈 이미지로 보고, 확대할 때 필요한 해상도로 점진적으로 올립니다.
• 화질 최우선: 가능한 한 높은 해상도를 우선합니다. 화질 확인이 중요할 때 적합합니다.
• 디코딩 모드는 체감 속도와 메모리 사용량에 직접 영향을 줍니다. 대량 폴더나 느린 저장장치에서는 속도 우선 또는 보통이 더 안정적입니다.

9.2 빠른 키보드 이동 프리뷰

• Off: 빠른 이동 중 프리뷰를 쓰지 않습니다.
• Auto: 일반적인 추천값입니다. 상황에 따라 프리뷰를 사용해 이동 체감을 부드럽게 만듭니다.
• Aggressive: 빠른 연속 이동에서 프리뷰를 더 적극적으로 사용합니다.
• 이 설정은 연속 이동 체감에 영향을 주며, 사진을 한 장씩 천천히 보는 경우보다 빠르게 넘길 때 차이가 큽니다.

9.3 정보 오버레이 토글

• I: 파일 정보/EXIF 표시
• H: 히스토그램 토글
• K: Quick Check 세트 토글 (점검에 필요한 패널 한 번에 여닫기)

9.4 하위 폴더 이미지 포함

• 설정에서 하위 폴더 이미지 포함을 켜면 현재 폴더뿐 아니라 하위 폴더의 이미지도 함께 탐색합니다.
• 라이브러리 범위가 넓어져 편리하지만, 큰 폴더에서는 초기 스캔 범위와 결과 개수가 달라질 수 있습니다.

9.5 별점 후 자동 이동

• 별점 후 자동 이동을 켜면 별점을 준 뒤 자동으로 다음 사진으로 넘어갑니다.
• 빠른 1차 선별에서는 매우 유용하고, 세밀하게 비교할 때는 끄는 편이 좋습니다. Cmd+A로도 토글할 수 있습니다.

9.6 화면 맨위 고정

• 다른 앱과 함께 비교하거나 Finder/Lightroom과 번갈아 볼 때 유용합니다.
• Cmd+Shift+T로 빠르게 켜고 끌 수 있습니다.

9.7 Pro JPG / ZIP 해상도

• Pro 레이아웃에서는 일반 디코딩 모드와 별도로 Pro JPG 해상도, Pro ZIP 해상도 설정이 적용될 수 있습니다.

10. ZIP 파일 사용 시 주의점

• ZIP 내부 이미지도 일반 폴더처럼 탐색할 수 있습니다.
• ZIP은 구조 특성상 폴더보다 느릴 수 있습니다.
• ZIP 환경에서는 일부 정리 기능 제약이 있을 수 있습니다. (별점, 복사, 붙여넣기, 삭제 제한)
• 중복사진정리에서 ZIP 항목은 스캔은 가능하지만 삭제 단계에서 자동 건너뜀 처리될 수 있습니다.

11. 성능을 높이는 방법

1. 대용량/ZIP 탐색이 느리면 디코딩 모드를 속도 우선으로 변경합니다.
2. 그리드에서는 썸네일 크기를 적당히 줄여 한 화면 밀도를 높입니다.
3. 필요한 오버레이만 켜고( I, K, H) 불필요한 패널은 끕니다.
4. 느린 외장 저장장치에서는 먼저 작은 폴더 단위로 정리합니다.

12. 자주 쓰는 단축키 요약

• 뷰 전환: Q / W / E / R
• 비교 모드: C
• 중복사진정리: Cmd+Shift+D (진입/재스캔), Shift+D (종료)
• 이동: 좌/우, 처음/끝 상/하
• 점프 이동: Cmd+좌/우(10장), Cmd+Shift+좌/우(50장)
• 줌: = / -, Fit 0, 100% 9
• 정보 토글: I(정보), K(퀵체크 세트), H(히스토그램)
• 선별: 1~5, 0, P, X, U, Cmd+1~6
• 화면/기타: Enter (전체화면), Cmd+Shift+T (맨위 고정)
• 선택: Cmd+A (Main=자동이동 토글, Grid/Manage=전체 선택)
• 작업: Cmd+C, Cmd+V, Delete, Cmd+O

13. 추천 워크플로우 (실전)

13.1 여행/일상 사진 빠른 정리

1. Grid( Q)에서 전체를 훑습니다.
2. Reject( X)를 먼저 표시해 불필요 컷을 줄입니다.
3. Main( W) 또는 Filmstrip( E)으로 좋은 컷에 별점 3~5를 줍니다.
4. 애매한 컷은 Compare( C)로 2~4장만 비교합니다.
5. 최종 선택본을 복사/이동해 보관 폴더로 정리합니다.

13.2 RAW+JPG 혼합 촬영 정리

1. 폴더를 열고 빠르게 탐색합니다.
2. Quick Check( K)로 문제 컷을 빠르게 찾습니다.
3. 별점/플래그로 선택 결과를 만든 뒤 Manage( R)에서 필터로 점검합니다.

13.3 중복사진 정리 워크플로우

1. Cmd+Shift+D로 중복사진정리 모드에 진입합니다.
2. 좌측 그룹 리스트에서 용량이 큰 그룹부터 선택합니다.
3. P로 기준이미지를 지정한 뒤, 카드 X 또는 우측 현재이미지 병합으로 정리합니다.
4. 여러 그룹을 한 번에 정리할 때는 중복사진 일괄 정리를 사용합니다.
5. 방금 삭제를 되돌려야 하면 즉시 Cmd+Z를 사용합니다.

14. 문제 해결 (FAQ)

Q1. 앱이 열리지만 파일이 안 보입니다

• 지원 포맷인지 확인합니다.
• 파일 권한 문제면 폴더를 다시 선택해 권한을 허용합니다.

Q2. 키보드 단축키가 안 먹습니다

• 앱 창이 포커스를 가지고 있는지 확인합니다.
• 다른 입력창(텍스트 필드)에 커서가 있으면 먼저 해제합니다.

Q3. ZIP이 느리거나 실패 메시지가 나옵니다

• 손상 ZIP인지 확인합니다.
• 다시 압축하거나 파일을 다시 받아 테스트합니다.
• 디코딩 모드를 속도 우선으로 낮춰봅니다.

Q4. 아이콘/버전 표기가 이상합니다

• 앱 재실행 후 확인합니다.
• 개발 빌드 사용 시 클린 빌드 후 다시 실행합니다.

15. 업데이트

• 앱 메뉴에서 업데이트 확인(Check for Updates)를 실행할 수 있습니다.
• 최신 릴리즈는 SnapView.dmg 기준으로 배포됩니다.

16. 데이터/안전 관련 참고

• SnapView는 빠른 보기/선별 중심 도구입니다.
• 삭제/즉시 삭제 전에는 선택 항목을 한 번 더 확인하세요.
• 중요한 작업 전에는 원본 백업을 권장합니다.

17. 문서 버전

• 기준 버전: v0.9.15
• 이 문서는 초보자 온보딩용이며, 기능 변경 시 함께 업데이트되어야 합니다.

SnapView User Manual

This is a practical guide designed to help new users navigate SnapView from installation to selection independently.

1. What is SnapView?

• SnapView is a blazing-fast image viewer for macOS.
• Open folders or ZIP files instantly to view and select photos without creating heavy catalogs.
• Rather than replacing editing tools like Lightroom, it focuses on the quick viewing and culling stage before editing.

2. Recommended For

• People who take many travel, daily life, or family photos.
• Users who shoot RAW but find heavy workflows burdensome.
• Those who want to scan quickly and keep only the best shots.
• Users who prefer simple folder-based management.

3. Installation and First Run

3.1 Installation

1. Download SnapView.dmg from the releases page.
2. Open the DMG and drag SnapView.app to Applications.
3. Launch SnapView from Applications.

3.2 First Run

• If a macOS security warning appears:
  1. Go to System Settings -> Privacy & Security.
  2. Allow execution.
  3. Relaunch the app.
• On the first run, you may see a suggestion to set it as the default image app.
• You can skip this if you prefer; it won't affect usage.

4. 5-Minute Quick Start

1. Use Open to open a folder or ZIP file.
2. Switch view modes with Q/W/E/R.
3. Navigate using Left/Right Arrow keys.
4. Rate good shots with 1~5, or mark unwanted ones with X (Reject).
5. If you need to compare, press C for Compare Mode (1-4 images).
6. Use Delete to remove or Cmd+C to copy and organize.
7. For exact file duplicates, press Cmd+Shift+D to use the Duplicate cleanup feature.

5. Understanding the Interface

• Top Toolbar: Open, Prev/Next, View Mode Switch, Zoom, Info/Quick Check/Histogram Toggles, Selection Actions.
• center Canvas: Displays the current image.
• Mode-Specific Areas:
  • Grid: Thumbnail grid.
  • Filmstrip/Manage: Continuous navigation bar at bottom or side.
  • Detail EXIF/Quick Check Panel: For information analysis.

6. How to Use View Modes

6.1 Main View ( W)

• Use when focusing on a single image.
• Quickly switch between Fit (0) and 100% (9).
• Toggle simple info overlay with I.

6.2 Grid View ( Q)

• Use to scan many photos at once.
• Navigates quickly with arrows/mouse and supports multi-selection.
• Adjust thumbnail size with =/- to fit your screen.

6.3 Filmstrip View ( E)

• Good for viewing flow with Main Image + Continuous Strip.
• Ideal for quickly skimming through burst/similar shots by feel.

6.4 Manage Mode ( R)

• Use when organizing with Folder/Filter/Selection views.
• Apply Ratings/Flags/Color Labels and filter to tidy up results.

6.5 Duplicate (Cmd+Shift+D)

• Shows only exact file duplicates in the current source as groups.
• Compare directly in the main area for 4 or fewer images; a bottom strip appears for 5 or more.
• Use Merge to Current Image / Batch Clean Duplicates / Undo Delete in the right panel.
• Undo Delete (⌘Z) only restores the most recent deletion transaction performed in Duplicate mode.

7. Culling Tools (Most Used Features)

7.1 Ratings

• 1~5: Apply Star Rating.
• 0 or \: Clear Rating.

7.2 Pick / Reject / Unflag

• P: Pick.
• X: Reject.
• U: Unflag.

7.3 Color Labels

• Cmd+1~5: Red/Yellow/Green/Blue/Purple.
• Cmd+6: Clear.

7.4 Copy/Delete

• Cmd+C: Copy selected items.
• Cmd+V: Paste.
• Delete or D: Delete.
• Cmd+Delete: Delete Immediately (Caution).

8. Quick Check & Compare

8.1 Quick Check

• Press K to toggle the Quick Check set.
• Check scores and warning causes (Focus/Exposure/Eyes Closed/Composition).
• Quick Check is an assist tool; the final choice is yours.

8.2 Compare Mode

• Press C to enter/exit Compare Mode.
• Compare 1-4 shots side-by-side to pick the best one.
• Zoom in to check details.

8.3 Duplicate

• Cmd+Shift+D: Enter Duplicate mode (or rescan while in mode).
• Shift+D or ESC: Exit Duplicate mode.
• ← / →: Move to previous/next duplicate group.
• P: Set the current image as the Reference Image (Keep).
• You can undo the last delete using Cmd+Z at the bottom of the right panel.

9. Understanding Settings and Behavior

9.1 Decoding Mode

• Speed Priority: Prioritizes fast navigation. Initially displays smaller resized images.
• Normal: The recommended default. Starts with a resized image and progressively scales up to required resolution when zooming.
• Quality Priority: Prioritizes the highest resolution possible. Best when checking image quality details is critical.
• This setting directly impacts perceived speed and memory usage. Speed Priority or Normal is more stable for large folders or slow storage.

9.2 Fast Keyboard Navigation Preview

• Off: Does not use previews during rapid navigation.
• Auto: Recommended default. Dynamically uses previews to smooth out the transition when moving quickly between shots.
• Aggressive: Uses previews more proactively during rapid consecutive navigation.
• This mainly affects navigation feel when holding down arrow keys, rather than browsing slowly photo by photo.

9.3 Info Overlay Toggles

• I: File Info/EXIF overlay
• H: Toggle Histogram
• K: Toggle Quick Check set (opens necessary assessment panels at once)

9.4 Include Subfolder Images

• Toggling Include Subfolder Images in preferences will scan not just the current folder, but all images in subfolders.
• Convenient for wider library scopes, but initial scan time and total image count will change on large directory trees.

9.5 Auto Advance After Rating

• When enabled, giving a rating automatically skips to the next photo.
• Extremely useful for fast initial culling, but better turned off when doing careful side-by-side comparisons. Toggle instantly with Cmd+A in Main View.

9.6 Always On Top

• Useful when comparing alongside other apps like Finder or Lightroom.
• Toggle quickly with Cmd+Shift+T.

9.7 Pro JPG / ZIP Resolution

• In Pro layouts, specific Pro JPG Resolution and Pro ZIP Resolution settings may apply independently of the general decoding mode.

10. Notes on ZIP Files

• You can browse images inside ZIPs just like folders.
• ZIPs may be slower than folders due to their structure.
• Some organization features may be limited in ZIP environments. (e.g. Ratings, copy, paste, and delete are restricted)
• In the Duplicate tool, ZIP items can be scanned but may be automatically skipped during deletion.

11. Performance Tips

1. If large files/ZIPs are slow, change Decoding Mode to Speed Priority.
2. In Grid, reduce thumbnail size to increase density on one screen.
3. Turn on only necessary overlays ( I, K, H) and close unused panels.
4. On slow external drives, organize in smaller folders first.

12. Shortcuts Summary

• View Switch: Q / W / E / R
• Compare Mode: C
• Duplicate: Cmd+Shift+D (Enter/Rescan), Shift+D (Exit)
• Move: Arrows, First/Last Up/Down
• Jump: Cmd+Arrow (10), Cmd+Shift+Arrow (50)
• Zoom: = / -, Fit 0, 100% 9
• Toggle Info: I (Info), K (Quick Check), H (Histogram)
• Cull: 1~5, 0, P, X, U, Cmd+1~6
• Screen Options: Enter (Full Screen), Cmd+Shift+T (Always On Top)
• Selection: Cmd+A (Main=Toggle Auto Advance, Grid/Manage=Select All)
• Actions: Cmd+C, Cmd+V, Delete, Cmd+O

13. Recommended Workflow

13.1 Quick Organization for Travel/Daily

1. Scan everything in Grid ( Q).
2. Mark Rejects ( X) first to reduce clutter.
3. Rate good shots 3~5 in Main ( W) or Filmstrip ( E).
4. Compare ambiguous shots ( C) to pick the winner.
5. Copy/Move final selections to an archival folder.

13.2 RAW+JPG Hybrid Workflow

1. Open folder for quick browsing.
2. Use Quick Check ( K) to spot technical issues fast.
3. After Rating/Flagging, check results with filters in Manage ( R).

13.3 Duplicate Photo Cleanup Workflow

1. Enter Duplicate mode with Cmd+Shift+D.
2. Select the largest capacity groups first from the left group list.
3. Set a reference image with P, then cull using the card X or Merge to Current Image.
4. To organize multiple groups at once, use Batch Clean Duplicates.
5. If you need to revert a deletion, use Cmd+Z immediately.

14. Troubleshooting (FAQ)

Q1. App opens but no files are visible

• Check if the format is supported.
• If it's a file permission issue, re-select the folder to grant permission.

Q2. Keyboard shortcuts aren't working

• Check if the app window has focus.
• If text cursor is in a search field, click away to focus the main window.

Q3. ZIP is slow or shows failure messages

• Check if the ZIP is corrupted.
• Re-compress or re-download the file.
• Try lowering Decoding Mode to Speed Priority.

Q4. Icon/Version display is incorrect

• Restart the app.
• If using a dev build, clean build and relaunch.

15. Updates

• Use Check for Updates in the app menu.
• Latest releases are distributed via SnapView.dmg.

16. Data & Safety Notes

• SnapView is designed as a fast viewing and culling tool.
• Always double-check your selection before performing a Delete or Immediate Delete.
• We highly recommend keeping original backups before major organizing tasks.

17. Document Version

• Base version: v0.9.15
• This manual serves as starter onboarding and should be updated alongside major feature changes.