사용자 설명서
메타데이터
메타태그는 노래에 대한 정보를 제공하는 방법이며 메타데이터 섹션으로 표현됩니다. 메타데이터는 노래의 첫 번째 섹션에서 첫 번째 빈 줄 이전 또는 더 이상 메타태그가 없을 때까지 표현됩니다. 메타태그는 이름/값 쌍으로, 이름은 왼쪽에 있고 값은 오른쪽에 있으며 콜론으로 구분됩니다. 한 줄에는 하나의 메타태그만 나타날 수 있습니다. ChordPro 형식에서 메타데이터를 표현하는 방법에 대한 자세한 내용은 ChordPro 파일 형식을 참조하세요.
OnSong은 텍스트 파일의 첫 번째 줄이 메타태그 형식이 아닌 경우 자동으로 노래의 제목으로 지정합니다. 또한 두 번째 줄은 메타태그가 정의되지 않은 경우 노래의 아티스트/바이라인으로 간주됩니다. 다음은 첫 번째 및 두 번째 줄의 제목 및 아티스트는 물론 키와 템포를 설정하는 일반적인 노래 메타데이터 섹션의 예입니다.
Amazing Grace
Daniel Thomas
Key: D
Tempo: 76
Lyrics and chords start here...
메타데이터 태그
OnSong에서 지원하는 태그는 다음과 같습니다:
- Title: 노래의 제목입니다. 노래 콘텐츠의 첫 번째 줄로도 표현할 수 있습니다.
- Artist: 아티스트 이름 또는 기타 바이라인 정보입니다. 노래 콘텐츠의 두 번째 줄로도 표현할 수 있습니다. 세미콜론으로 이름을 구분하여 여러 아티스트를 지정할 수 있습니다. - Kim Walker-Smith; Chris Quilala
- Author: 코드 차트를 작성한 사람의 이름입니다. 이는 코드 차트의 맨 아래와 가사 프로젝션에 표시됩니다.
- Key: 음성 선호도를 가진 키 및 단조를 나타내기 위한 선택적 "m"으로 작성된 노래의 키입니다. - alphabetic, e.g. Bb or Em
- TransposedKey: 노래가 작성된 키와 다를 수 있는 노래를 연주해야 하는 원하는 키입니다. - alphabetic, e.g. Bb or Em
- In: 전조된 키 메타데이터 태그의 의사 이름입니다.
- Capo: 프렛 수로 설정할 카포입니다. 일반적으로 양의 정수(1~11)이지만 음의 정수로도 설정할 수 있습니다. - numeric
- Tempo: 분당 박자(BPM)입니다. - numeric
- Time: 박자표입니다. - numeric beat over bar e.g. 3/4
- Duration: 자동 스크롤을 위한 노래 길이입니다. - seconds or mm:ss
- Book: 노래를 배치할 책 또는 책의 이름입니다. 이는 노래가 배치될 책 이름의 쉼표로 구분된 목록입니다. 책이 없으면 자동으로 생성됩니다.
- Number: 노래의 번호 - numeric입니다. 찬송가, 연도 등에 사용하십시오. 참조를 위해 번호별로 노래를 정렬할 수 있습니다.
- Flow: 섹션의 배열입니다. - list of section labels. 노래의 흐름을 배열하는 방법에 대한 자세한 내용은 Flow를 참조하세요.
- MIDI: 노래를 볼 때 보낼 MIDI 명령입니다. OnSong에서 MIDI 명령을 텍스트로 표현하는 방법은 MIDI Syntax를 참조하세요.
- MIDI-Index: Song Viewer에서 이 노래를 열도록 트리거할 MIDI 명령입니다. OnSong에서 MIDI 명령을 텍스트로 표현하는 방법은 MIDI Syntax를 참조하세요.
- Keywords: 또는 Topic: 주제 검색에 사용할 태그 목록입니다. 주제별 찾아보기에 대한 자세한 내용은 Topics를 참조하세요.
- Copyright: 또는 Footer: 또는 f: 노래의 저작권 정보입니다. 이는 코드 차트 및 가사 프로젝션의 맨 아래에 나타납니다.
- CCLI: 노래의 CCLI 번호입니다. 이는 코드 차트 및 가사 프로젝션의 맨 아래에 나타납니다.
- Restrictions: 이는 노래 내에서 특정 작업이 수행되는 것을 방지하는 제한 사항입니다. 노래에 대한 제한 사항을 설정하는 방법에 대한 자세한 내용은 Restrictions를 참조하세요.
- Pitch: Pitch Pipe 기능을 사용할 때 재생할 음표입니다. 이는 선택적 옥타브가 있는 공백으로 구분된 음표 목록으로 정의됩니다. - e.g. A3 C#4 E5
- Subdivision: 또는 Beat: 노래의 세분을 선택할 수 있게 합니다. 이는 whole, half, quarter, eighth, shuffle 또는 sixteenth를 포함하는 값일 수 있습니다. 또는 1, 2, 4, 8 또는 16과 같은 정수를 사용할 수 있습니다.
- Transpose: 노래를 전조할 반음의 수입니다. 이는 노래 중간에 사용되어 노래를 올리거나 내리고 전조 슬라이더에 설정된 키에 맞춰집니다. 이 수는 양수 또는 음수 정수여야 합니다.
- Tuning: 노래에 할당할 악기 튜닝입니다. 이들은 악기별로 특정되며 현재 기타만 다음 값으로 지원됩니다: Standard, Celtic, Drop D, Drop DD, Drop C, Drop B, Drop A, Open C, Open D, Open G 또는 Open E.
- Scene: 노래가 로드될 때 재생할 장면입니다. 콜론 뒤에 장면 이름을 입력하여 설정할 수 있습니다.
인라인 태그
일부 태그는 노래 중간에 전조를 영향을 주기 위해 노래 내에서 사용할 수 있습니다. 여기에는 다음이 포함됩니다:
- Capo: 노래 중간에 카포를 적용하여 노래를 내리고 카포가 적용된 상태로 연주할 코드를 제공하는 데 사용할 수 있습니다. Capo Settings에서 조절 방향을 조정할 수 있습니다. 일반적으로 양의 정수(1~11)이지만 음의 정수로도 설정하여 이전 카포를 제거할 수 있습니다. - numeric
- Key: 노래에서 키를 명시적으로 설정합니다. 괄호로 묶인 코드를 사용할 때 값을 괄호로 둘러싸면 결과 키도 전조됩니다. - alphabetic, e.g. Bb or Em
- Transpose: 노래를 원하는 반음 수만큼 전조합니다. 이는 양수 또는 음수 정수입니다. 예를 들어 2 또는 +2를 사용하여 노래를 온음정 올리거나 -3을 사용하여 반음 3개 내립니다. - numeric
섹션 태그
일부 태그는 노래의 각 섹션에 대한 정보를 제공하는 데 사용할 수 있습니다. 여기에는 다음이 포함됩니다:
- MIDI: 섹션을 선택했을 때 보낼 MIDI 명령입니다. OnSong에서 MIDI 명령을 텍스트로 표현하는 방법은 MIDI Syntax를 참조하세요.
- Scene: 섹션을 선택했을 때 재생할 장면입니다. 콜론 뒤에 장면 이름을 입력하여 설정할 수 있습니다.
참고: 메타태그는 대소문자를 구분하지 않습니다
OnSong 2026 마지막 업데이트: December 22, 2025