빛과소금 MP3 악보 스튜디오 1.1.0.

설치.
1. 워드프레스 관리자에 로그인합니다.
2. 플러그인 > 새 플러그인 추가 > 플러그인 업로드로 이동합니다.
3. lightsalt-mp3-score-v1.0.2.zip을 선택해 지금 설치를 누릅니다.
4. 플러그인 활성화를 누릅니다.
5. 페이지 > 새 페이지 추가에서 악보 만들기 페이지를 만듭니다.
6. 숏코드 블록을 추가하고 아래 한 줄을 넣습니다.

[lightsalt_mp3_score]

7. 페이지를 공개하고 실제 페이지를 새 탭에서 엽니다. 관리자 편집 화면에서는 분석 도구가 보이지 않을 수 있습니다.
8. 화면이 좁으면 사용하는 테마의 페이지 설정에서 전체 너비를 선택합니다.

선택 설정.
[lightsalt_mp3_score title="힘박스 찬양 악보 만들기" max_seconds="300"]
제목과 1회 최대 분석 길이를 지정합니다. max_seconds는 10~600초 범위입니다.
별칭 [hymnbox_score]도 같은 도구를 표시합니다.
관리자 도구 > MP3 악보 스튜디오에서도 숏코드를 확인할 수 있습니다.
회원 로그인 없이 사용할 수 있습니다. 결제·회원 권한 제한 기능은 없습니다.

빠른 테스트.
- 예제 악보 열기를 눌러 오선 악보가 나타나는지 먼저 확인합니다.
- 음표 목록에서 첫 음을 선택하고 D4 등으로 바꾼 뒤 선택 음 수정을 누릅니다.
- MusicXML 다운로드를 눌러 파일을 확인합니다.
- 예제는 편집 기능 확인용이며 MP3 분석 결과가 아닙니다.

실제 수노 곡 분석.
1. 원곡 MP3/WAV를 선택합니다. 음원은 서버에 업로드되지 않습니다.
2. 수노 등에서 별도로 분리한 보컬 파일이 있으면 분리 보컬에 추가로 선택합니다.
   이 경우 멜로디는 보컬에서, 코드 후보는 원곡에서 분석합니다.
   두 파일은 동일한 곡·동일한 시작 시각과 길이를 사용해야 합니다.
   이 웹 버전 자체에는 자동 보컬 분리가 없습니다.
3. BPM을 입력합니다. 모르겠으면 추정 후보를 참고하되 반속·배속 오류를 확인합니다.
4. 시작 시각에 전주 이후 노래 시작 시점을 초로 넣습니다. 가능하면 마디 첫 박을 선택합니다.
5. 기본 분석 길이는 300초(5분)입니다. 필요하면 짧은 구간으로 먼저 확인해도 됩니다.
6. 낮은 남성 보컬은 최저음 C2, 높은 보컬은 C3/G3 등을 선택합니다.
7. 박자, 조표, 박자 정렬 단위를 설정합니다. 조표만 바꿔도 실제 음정은 바뀌지 않습니다.
8. 코드 후보가 필요하면 마디별 장·단화음 추정을 선택합니다.
9. 멜로디 분석 시작을 누릅니다. 분석 취소로 중단할 수 있습니다.

음표 수정.
- 파형은 분석한 구간에 대한 상대 시각입니다.
- 오선 악보 탭은 실제 MusicXML을 표시합니다.
- 피아노롤은 가로가 박, 세로가 음 높이입니다. 막대를 클릭해 음표를 선택합니다.
- 막대 드래그 수정은 지원하지 않습니다. 아래 목록과 입력칸에서 수정합니다.
- 음 이름: C4, F#4, Bb4, R. R은 쉼표입니다.
- 길이: 1=4분음표, 0.5=8분음표, 0.25=16분음표입니다.
- 내부 길이는 480틱을 1박으로 사용하며 입력 길이를 10틱 단위로 맞춥니다.
- 같은 음 반복이 붙으면 둘로 나누기로 고칩니다. 앞 음과 합치기는 동일한 음 또는 쉼표만 합칩니다.
- 반음 올림·내림은 멜로디만 바꾸므로 조표와 코드를 별도로 확인합니다.
- 되돌리기는 최근 음표 편집 30단계를 지원합니다. 코드·가사 입력은 대상이 아닙니다.

코드와 가사.
- 코드·가사 탭에서 한 줄에 시작 박,코드를 입력합니다. 첫 박은 0입니다.
  예: 0,C / 4,Am / 8,F / 12,G7. 실제 입력은 각각 한 줄씩 적습니다.
- C, Am, G7, Cmaj7, Dm7, Bdim, Csus4, C/E 등의 표기를 지원합니다.
- 자동 후보는 장·단 3화음만 마디별로 추정합니다. 세븐스·전위·마디 안의 코드 변화는 직접 고칩니다.
- 가사는 음표 하나당 한 음절을 공백으로 구분해 입력합니다. 예: 주 님 을 찬 양 해 요.
- 쉼표를 제외한 음표 순서에 맞춰 배치합니다. 음표보다 가사 음절이 많으면 저장하지 않습니다.
- 음표를 삭제·분할한 뒤에는 가사 위치를 다시 확인하세요. 여러 음에 한 음절을 늘이는 표기는 외부 악보 편집기에서 마무리하세요.
- 코드·가사·설정 악보에 반영을 눌러 표시를 갱신합니다. 다운로드할 때에도 현재 입력값을 반영합니다.

소리 비교와 BPM.
- 원곡 듣기와 보컬 듣기는 선택한 분석 구간을 재생합니다.
- 악보 음 듣기는 현재 수정한 멜로디를 단순 전자음으로 재생합니다. 실제 보컬·피아노 음색이 아닙니다.
- BPM 후보는 참고용입니다. 80을 160 또는 40으로 추정할 수 있습니다.
- BPM 변경 후 재분석하지 않으면 음표의 박 위치는 그대로이고 재생 속도만 바뀝니다.
- 박자 변경도 마디 구분만 바꿉니다. 원음 기준 리듬을 다시 계산하려면 재분석하세요.
- 6/8에서도 BPM은 4분음표 기준입니다. 점4분음표 기준 BPM에는 1.5를 곱해 입력합니다.

다운로드와 작업 보관.
- MusicXML: MuseScore 등에서 열어 악보 편집과 인쇄를 이어갑니다.
- MIDI: 멜로디 트랙만 내보냅니다. 코드 반주 음과 가사·원음은 포함하지 않습니다.
- 작업 파일: JSON으로 음표·코드·가사·설정을 저장합니다. 음원 파일 자체는 포함하지 않습니다.
- 작업 불러오기로 JSON을 열고 이어서 수정할 수 있습니다. 데스크톱판의 events 배열 형식도 읽지만 데스크톱 코드·가사 형식 전체 변환은 보장하지 않습니다.
- 원음 비교가 필요하면 같은 음원을 다시 선택합니다. 웹사이트에 자동 저장하지 않습니다.
- 악보 인쇄 / PDF 저장: 팝업을 허용하고 브라우저 인쇄 창에서 PDF로 저장을 선택합니다.
- 페이지를 닫기 전 작업 파일을 저장하세요. 이 탭을 닫으면 메모리의 데이터가 사라집니다.

환경과 제한.
- WordPress 6.0 이상, PHP 7.4 이상을 대상으로 작성했습니다. PHP 8.3에서 숏코드 동작을 별도 시험했습니다.
- PC Chrome·Edge 최신 버전과 HTTPS를 권장합니다. 스마트폰에서는 메모리·성능 제한이 있습니다.
- 파일은 200MB 이하, 원본 길이는 30분 이하, 분석 구간은 최대 10분입니다.
- 브라우저는 원본 전체를 먼저 디코딩하므로 긴 파일은 메모리를 많이 씁니다. 긴 곡은 미리 짧게 잘라 주세요.
- 합창·잔향·강한 비브라토·반주에서 오인식이 발생할 수 있습니다. 완성 악보가 아닌 수정 가능한 초안을 만듭니다.
- 분석 엔진은 반주 포함용 MELODIA와 보컬 단독용 YIN-FFT입니다. 데스크톱판 pYIN과는 다른 엔진입니다.
- 가사 음성 인식, 자동 보컬 분리, 다중 악기 채보, 악기 믹싱, 클라우드 자동 저장 기능은 없습니다.
- 예제 열기·새 분석·작업 불러오기는 현재 편집 내용을 바꾸므로 먼저 작업 파일을 저장하세요.

문제가 생길 때.
- 화면이 안 보이면 숏코드 블록에 코드를 넣었는지와 플러그인 활성화를 확인합니다.
- 페이지 캐시와 브라우저 캐시를 비우고 다시 엽니다.
- 자바스크립트 지연/합치기 기능을 쓴다면 lightsalt-score-app, lightsalt-score-core,
  lightsalt-score-osmd 핸들과 이 플러그인의 assets 경로를 제외합니다.
- 분석 도구 실행 오류는 보안 플러그인·CSP가 같은 사이트의 Web Worker를 막는지도 확인합니다.
- PDF 창이 열리지 않으면 해당 사이트의 팝업을 허용합니다.
- 실제 사이트의 테마·캐시·보안 플러그인 조합은 별도 확인이 필요합니다.

포함 라이브러리.
OpenSheetMusicDisplay 1.9.2를 포함합니다. 라이선스는 assets/vendor에 동봉했습니다.
서버 분석 API, 외부 API 키, 별도 Python 서비스와 유료 분석 호출은 사용하지 않습니다.


1.0.2 추가 안내.
- 음원 유형에서 반주 포함 또는 보컬 단독을 선택합니다. 보컬 파일을 별도로 넣으면 보컬 단독 모드를 사용합니다.
- BPM 기준의 자동 후보는 분석 결과를 음표 길이에 적용합니다. 이미 BPM을 아는 곡은 직접 입력한 BPM 사용을 선택하세요.
- 조표 자동 후보는 표기용 조표만 바꿉니다. 음정을 강제로 해당 조에 맞추지 않습니다.
- 첫 박 정렬은 감지한 첫 박 앞에 노래가 없을 때만 짧은 선행 구간을 제외합니다. 전체 박자표는 직접 선택하세요.
- 박자 맞춰 탭을 4번 이상 누르면 BPM을 입력합니다. BPM 절반/두 배도 지원합니다. 다시 분석해야 원음 기준 음표 길이를 계산합니다.
- 짧은 음 정리는 80밀리초가 기본입니다. 꾸밈음을 살리려면 40, 길게 부르는 노래는 120을 시험하세요.
- 같은 음 사이 120밀리초 이하의 짧은 인식 끊김을 연결합니다. 긴 무음이나 다른 음 사이 쉼표는 무조건 메우지 않습니다.
- 짧거나 큰 도약이 있는 일부 음에는 확인 표시를 붙입니다. 확인 표시가 없다고 정확한 음이라는 뜻은 아닙니다.
- 분석 진단 저장은 다음 오류 점검에 사용할 JSON을 내려받습니다. 원음 자체를 넣지 않습니다.

첨부곡 검증 자료.
- 플러그인 폴더 samples/에 오-놀라워라-수정초안.json과 MusicXML, 비교-진단.txt를 넣었습니다.
- 이 ZIP을 컴퓨터에서 따로 압축 해제한 뒤 해당 JSON을 작업 불러오기로 여세요.
- 원음 비교를 하려면 같은 MP3를 다시 선택하세요. 이 플러그인 ZIP에는 원곡 오디오를 넣지 않았습니다.
- 재현 설정은 시작 15.4초, 반주 포함, 자동 BPM/조표 후보, 4/4, 16분음표 정렬입니다.
- 첫 박 자동 보정으로 저장된 실제 재생 시작 시각은 약 15.88초입니다.
- 이 곡에서 바장조와 약136 BPM이 후보로 나왔습니다. 곡의 정답 BPM·박자표를 사람이 확정한 것은 아닙니다.
- 전주를 제외한 수정 초안으로, 사람이 원곡을 듣고 음정·리듬을 최종 확인해야 합니다.

소스와 라이선스.
분석 엔진 Essentia/Essentia.js 사용으로 이 버전은 AGPL-3.0-or-later로 제공합니다.
페이지 하단의 소스코드 링크와 sources/에 배포 소스, 엔진 소스 안내와 라이선스가 있습니다.
OpenSheetMusicDisplay와 다른 구성 요소는 각 동봉 라이선스를 따릅니다.

일부 다성 신호에서 주선율 누락이 여전히 남아 있습니다. 오류가 큰 곡은 보컬 단독 파일을 사용하고 수동 확인하세요.
페이지 하단 이용 안내를 펼치면 이번 곡의 수정 초안과 비교 진단을 내려받을 수 있습니다.


1.1.0 피아노 기능은 동봉한 피아노-사용안내.txt를 먼저 읽어 주세요.
피아노 단독 음원을 분석하며, 반주 포함 주선율 기능과 별도의 엔진과 저장 구조를 사용합니다.
