악보 PDF → 편집 가능한 악보
사용자가 PDF 형태의 악보를 가지고 있으며 편집할 수 있는 형태로 변환하기를 원합니다. 이 특정 PDF를 읽을 수 있는 최선의 방법을 찾아 실행하고, 파일과 함께 확인해야 할 사항에 대한 솔직한 메모를 전달하세요. 사용자는 PDF, OMR 또는 명령줄에 대해 아무것도 모른다고 가정하세요. 사용자는 예/아니오 질문에 답하고, 나머지는 당신이 평이한 말로 수행합니다. 각 단계를 사용자의 파일과 선택 사항에 맞춰 설명하세요. 호스트에서 요구하지 않는 한, 이 스킬, 규칙 또는 파일 이름에 대한 설명은 생략하세요.
1. 먼저 PDF 살펴보기
각 파일에 대해 선택하기 전에 번들로 제공된 식별자(이 스킬의 scripts/ 폴더, Node.js 22+)를 실행하세요:
node scripts/identify.mjs <file.pdf> --json
이 식별자는 PDF가 어떤 종류인지(악보 글꼴이 있는 벡터, 스캔/사진, 아웃라인, 혼합, 알 수 없음, 읽을 수 없음) 페이지별 증거와 함께 보고하고, 어느 악보 프로그램에서 만들었을 가능성이 있는지, Tutti가 읽을 가능성이 있는지 알려줍니다. references/routes.md에 각 결과에 대한 설명이 있습니다. 이 식별자는 글꼴, 메타데이터 및 이미지만 확인하며 음악의 복잡성은 보지 않습니다. 규칙은 Tutti 웹사이트보다 오래되었을 수 있으므로 Tutti 판정은 조언으로만 처리하고 거절의 근거로 삼지 마세요.
2. 경로 선택
표지나 지시 페이지가 아니라 실제 악보가 있는 페이지를 기준으로 결정하세요.
- Tutti가 읽을 가능성이 높음(악보 프로그램에서 내보내기): Tutti를 강력히 권장합니다. 픽셀에서 추측하는 대신 프로그램이 작성한 표기법을 직접 읽으므로 일반적으로 OMR보다 훨씬 정확합니다. 질문: "이 작업을 위해 Tutti의 개인정보 보호정책(https://tutti-studio.com/privacy)에 동의해야 합니다. 괜찮으신가요?" 동의하면
references/tutti.md의 Tutti 링크를 열어 업로드하도록 안내하세요. 업로드를 원하지 않으면 Audiveris를 제안하고, 이런 종류의 PDF에는 일반적으로 정확도가 떨어진다고 말하세요. - 악보 페이지는 벡터이지만 Tutti가 "알 수 없음" 또는 "가능성 낮음": 두 가지를 모두 제안하세요. 먼저 Tutti 웹사이트에서 확인해 보라고 권하고, 업로드 시 결정되므로 웹사이트를 참고하세요.
- 악보 페이지가 스캔 또는 사진(OCR 텍스트 레이어가 있는 스캔은
mixed로 표시됨) 또는 아웃라인 악보: 이 컴퓨터에서 Audiveris 사용(references/audiveris.md). - 손으로 쓴 악보: Audiveris는 이에 적합하지 않으며 이 스킬은 이에 대해 테스트되지 않았습니다. 직접 입력(재입력)을 제안하세요. 소프트웨어를 시도해보고 싶다면
references/omr-tools.md를 참조하되, 보장은 하지 마세요. - 읽을 수 없음, 암호화됨, PDF가 아님: 무엇이 잘못되었는지와 사용자가 할 수 있는 조치를 설명하세요.
Audiveris는 초안을 제공하며, 완성된 악보가 아닙니다. 간단하거나 중간 수준의 음악(독주, 피아노, 소규모 실내악, 간단한 합창)의 깨끗한 스캔에 가장 효과적입니다. 휴대폰 사진은 종종 완전히 실패합니다. 대규모 오케스트라나 밀도가 높은 스캔의 경우, 실행하기 전에 그 사실을 말하고 사용자가 결정하도록 하세요.
3. 솔직하게 결과 전달
Audiveris 실행 후 결과에 대해 아무 말하기 전에 먼저 확인하고, 그런 다음 node scripts/review.mjs <result.mxl> <original.pdf> --out-dir <new folder>를 실행하세요(.omr 및 .log 파일을 결과와 함께 보관). 의심스러운 마디를 빨간색으로 표시한 MusicXML 복사본, 해당 위치를 상자로 표시한 원본 PDF 복사본, 그리고 JSON 요약본을 생성합니다. 사용자에게 처음 두 개를 제공하세요. 빨간색 표시는 Audiveris 자체가 문제를 인지한 위치일 뿐입니다. 테스트 결과 잘못된 음표가 있는 대부분의 마디가 표시되지 않았으므로, 나머지도 확인이 필요하다고 명확히 말하세요. 그런 다음 별도로 다음을 말하세요:
- 내보내진 페이지 또는 악장과 내보내지지 않은 것들;
- 의심스러운 위치(PDF 페이지 기준, 리뷰가 페이지와 일치하는 경우에만 마디 번호로);
- 음표가 PDF와 대조 확인되지 않았음을 알리고, 어디서부터 확인해야 하는지: 빨간색 마디, 그다음 조표와 박자표, 그다음 그 외 모든 것(특히 임시표와 가사).
OMR 결과를 "정확" 또는 "완료"라고 부르지 마세요. 그런 다음 파일을 어떻게 열 수 있는지 알려주세요(references/open-in-editor.md).
피해야 할 사항
다음은 합리적으로 보이지만 사용자에게 가장 큰 피해를 주는 실수입니다:
- 직접 음악을 읽지 마세요. 페이지 이미지를 보고 MusicXML을 작성하거나 보이는 음표를 설명하지 마세요. 표기법 모델 전사는 pitches와 리듬을 자신 있게 지어내며, OMR보다 더 나쁘고 사용자가 발견하기 훨씬 어렵습니다.
- 내보낸 PDF를 OMR에 보내지 마세요. 사용자는 종종 모든 PDF를 "스캔"이라고 부릅니다. 식별자가 악보 글꼴을 찾으면 OMR은 정확한 데이터를 버리므로 Tutti로 보내세요.
- IMSLP 스캔을 벡터로 취급하지 마세요. IMSLP 스캔에는 종종 OCR 텍스트 레이어가 있습니다. 전체 페이지 이미지와 텍스트 글꼴이 있지만 악보 글꼴이 없는 페이지는 스캔입니다.
- OCR 언어 데이터 없이 Audiveris를 실행하지 마세요. 또는
tessdata_fast/tessdata_best를 레거시 파일 대신 사용하지 마세요. 실행은 여전히 "작동"하지만 모든 가사, 템포 단어 및 악기 이름이 조용히 사라집니다. - 음악이 없는 페이지를 입력하지 마세요. 단일 표지, 제목 또는 텍스트 페이지로 인해 전체 실행이 실패하고 내보내기가 되지 않을 수 있습니다. 음악 페이지만 전달하세요.
- 종료 코드 0 또는 "exported" 로그 라인을 신뢰하지 마세요. 파일이 한 파트에서 마디가 누락되거나, 오선이 추가 파트로 분할되거나, 단일 남은 조각(
*.mvtnull.mxl)으로 출력될 수 있습니다. 각 파트의 마디 수를 세어보고 나서야 제대로 작동했다고 말하세요. - Audiveris 로그 레이블을 마디 번호로 바꾸지 마세요.
Measure{#11P2}는 내부 레이블이며 "두 번째 악기의 11번째 마디"가 아닙니다. 페이지를 기준으로 위치를 찾거나 "N페이지 근처"라고 말하세요. - 나쁜 사진을 구하려고 하지 마세요. 이미지 도구를 설치하거나, 업그레이드하거나, 페이지를 온라인 서비스에 업로드하지 마세요. 한 번 실행하고 실패하면 다시 촬영 조언(평평한 페이지, 균일한 조명, 바로 위에서 촬영, 또는 스캐너 사용)을 하거나
references/omr-tools.md의 사진 도구를 안내하세요. - 출력을 덮어쓰거나 섞지 마세요. 입력 파일 하나당 하나의 출력 폴더를 사용하고, 사용자의 원본 파일 옆이나 위에 쓰지 마세요.
- Tutti가 무엇을 할지 약속하지 마세요. 사용자를 대신하여 업로드할 수 없으며, 무료 페이지 수와 제한은 사이트에 표시되어 있습니다. 숫자를 인용하지 마세요.
여러 파일 처리
모든 파일을 먼저 식별하고, 경로별로 그룹화한 후 하나의 계획을 확인합니다("3개는 Tutti로, 2개는 이 컴퓨터에서 읽을 것입니다").
예시
- *"이것을 MuseScore로 변환해 주세요"*와 Sibelius에서 내보낸 4중주 → 벡터, Sibelius, 가능성 높음 → Tutti 권장, 개인정보 보호정책 동의 요청, 사이트 열기; 로컬 옵션도 언급.
- *"이것을 편집 가능하게 만들 수 있나요?"*와 IMSLP에서 스캔한 노래(
mixed로 표시: 이미지 + OCR 텍스트) → 스캔으로 처리 → 독일어 및 영어 언어 데이터로 Audiveris 실행, 제목 페이지 건너뛰기 → 리뷰 표시 확인 → 내보내진 페이지, 빨간색 마디, 확인할 사항 보고. - 흐릿하고 휘어진 합창 파트의 휴대폰 사진 → Audiveris를 한 번 실행 → 대부분을 읽을 수 없으면 추가 도구 대신 다시 촬영 조언 제공.