=== 빛과소금 MP3 악보 스튜디오 ===
Contributors: hymnbox
Tags: music, musicxml, midi, score, audio
Requires at least: 6.0
Requires PHP: 7.4
Stable tag: 1.1.0
License: AGPLv3 or later
License URI: https://www.gnu.org/licenses/agpl-3.0.html

== Description ==
1.1.0부터 피아노 단독 음원의 화음과 겹침음을 Basic Pitch로 분석합니다. 자동 악기 분리 기능은 포함하지 않습니다.

[lightsalt_mp3_score] 페이지 숏코드로 사용하는 브라우저 기반 MP3 멜로디 채보·수정 도구입니다.
오디오 분석, 파형, 피아노롤, 오선 악보, 코드·가사 수동 입력, MusicXML·MIDI·JSON 저장을 지원합니다.
반주 포함 음원은 Essentia.js의 MELODIA 주선율 추적, 보컬 단독 음원은 YIN-FFT를 사용합니다. AI 모델, 완전 자동 다중 악기 채보 또는 가사 음성 인식 도구가 아닙니다.
오디오 파일은 브라우저 메모리에서만 처리합니다. 파일 업로드 API나 음원 외부 전송 기능은 없습니다.
악보 표시 라이브러리는 플러그인에 포함하며 외부 CDN을 호출하지 않습니다.

== Installation ==
1. 워드프레스 플러그인 > 새 플러그인 추가 > 플러그인 업로드에서 ZIP을 설치합니다.
2. 활성화합니다.
3. 새 페이지에 숏코드 블록을 넣고 [lightsalt_mp3_score]를 입력합니다.
4. 페이지를 공개한 뒤 실제 페이지에서 사용합니다.

피아노 기본 모드 숏코드: [lightsalt_mp3_score mode="piano"]

== Frequently Asked Questions ==
= API 키나 Python이 필요한가요? =
필요 없습니다. 일반 PHP 호스팅에 설치하고 방문자 브라우저에서 처리합니다.
= 수노 MP3를 그대로 넣을 수 있나요? =
가능하지만 반주·화음 때문에 잘못 인식할 수 있습니다. 분리 보컬 MP3/WAV를 함께 선택하는 것을 권장합니다.
= 자동 보컬 분리가 있나요? =
없습니다. 별도로 분리한 보컬 파일을 선택합니다.
= PDF는 어떻게 저장하나요? =
악보 인쇄 / PDF 저장을 누르고 브라우저 인쇄 창에서 PDF 저장을 선택합니다.
= 지원 브라우저는 무엇인가요? =
PC Chrome·Edge 최신 버전을 권장합니다. HTTPS를 사용하세요. 브라우저 코덱에 따라 지원 형식이 다를 수 있습니다.
= 작업이 자동으로 저장되나요? =
아닙니다. 페이지를 닫기 전에 작업 파일 저장을 눌러 JSON을 보관하세요.

== Changelog ==
= 1.1.0 =
Basic Pitch 다중 음정 엔진, 피아노 독립 시작·길이·강세·오선 데이터 구조, 두 오선/화음/성부/이음줄 MusicXML과 다중 트랙 MIDI, 편집/저장/복원 추가.

= 1.0.2 =
반주 포함용 MELODIA와 보컬용 YIN-FFT로 분석기를 구분했습니다. 짧은 끊김 정리, BPM·조표 후보, 첫 박 맞춤, 탭 BPM, 반속·배속 선택, 확인 음 표시와 진단 저장을 추가했습니다.

= 1.0.2 =
파일 제한을 200MB로 늘리고 기본 분석 길이를 300초(5분)로 변경했습니다.

= 1.0.2 =
최초 워드프레스 버전. 브라우저 로컬 분석과 악보 편집·내보내기.
