악보 관리에 필요한 흐름을 그대로

1. 라이브러리

등록한 악보를 검색·필터·정렬합니다.

• 제목 / 작곡가 / 가수 검색
• 정렬: 추가일, 제목, BPM, 작곡가
• 필터: 작곡가, 조성, 박자, 분석 상태, 태그, BPM 범위, 즐겨찾기
• 카드 보기 · 목록 보기
• 즐겨찾기, ⌘클릭 다중 선택
• 일괄: 태그, 분석, CSV 내보내기, PDF 병합 다운로드, 악보 병합, 폴더 이동, 삭제
• 사이드바 폴더: 전체 / 미분류 / 사용자 폴더 (드래그로 이동)

2. 파일 업로드

이미지·PDF·ZIP을 올려 곡 단위로 등록합니다.

• 지원: PNG, JPEG, GIF, WebP, BMP, TIFF, PDF, ZIP(이미지)
• 「곡 시작」으로 다페이지·PDF를 곡별로 나누기
• 저장 모드: 저장만 / OCR / AI / OCR+AI
• 드래그 앤 드롭 지원

3. 폴더 가져오기

스캔 폴더처럼 이미지가 많은 경우 배치로 처리합니다.

• 폴더 스캔, 20장 단위 배치
• OCR로 곡 시작 힌트 제안
• 필요 없는 장은 제외 → 보류함으로 이동
• 업로드와 동일한 분석 모드

4. 보류함

가져오기에서 뺀 페이지를 보관했다가, 원하는 악보 앞·뒤에 붙입니다.

5. 휴지통

삭제한 악보를 복원하거나 영구 삭제합니다. 휴지통 비우기를 지원합니다.

6. 악보 상세

별도 창에서 보고 고칩니다.

• 다페이지 뷰어, 확대/축소, 페이지 이동
• 썸네일 드래그로 순서 변경
• 이미지 추가·삭제, 곡 분리, 다른 곡으로 페이지 이동
• 메타 편집: 제목, 작곡가, 가수, 템포 지시어, BPM, 조성, 박자, 연습 키, 태그, 즐겨찾기 (⌘S 저장)
• 분석 / 다시 분석, 분석·인쇄 이력
• 인쇄 미리보기: 여백·위치 드래그·메모

7. OCR · Vision AI

• OCR (기본): Apple Vision, 한국어·영어 — API 키 불필요, 오프라인
• Vision AI (선택): Gemini 또는 OpenAI — 작곡가·BPM·조성 등 풍부한 메타
• API 키는 macOS 키체인에 저장, 연결 테스트 제공

8. 설정 · 보안

• AI 제공자·모델·키 관리
• 앱 실행 시 비밀번호 잠금 (힌트·변경·해제)
• 데이터 폴더 열기, 팩/백업/CSV

9. 백업 · 이전

방식	파일	용도
라이브러리 내보내기/가져오기	.scoreslib.zip	활성 악보 이전·병합 (Mac↔Windows 공통)
전체 백업/복원	.scoreslib-backup.zip	Mac에서 score/ 통째 백업·교체
CSV	.csv	목록 메타 내보내기 / id 기준 메타 업데이트

API 키·잠금 비밀번호는 백업에 포함되지 않습니다.

10. 자동 업데이트

Sparkle로 업데이트를 확인합니다. 앱 메뉴의 도움말 → 업데이트 확인…

이런 앱이 아닙니다

• 악보 작성·편곡 프로그램(MuseScore 등)이 아닙니다.
• 클라우드 동기화 구독 서비스가 아닙니다. 데이터는 로컬에 둡니다.
• MusicXML OMR 추출 UI는 준비 중이며, 현재 핵심은 이미지/PDF 라이브러리입니다.