ChordSticker 사용 가이드: 업로드부터 인쇄까지

이 문서는 ChordSticker를 처음 쓰는 분이 화면을 보면서 그대로 따라올 수 있도록 만든 안내서입니다. 각 단계에서 실제로 무슨 일이 벌어지는지, 그리고 막혔을 때 어디를 손봐야 하는지를 함께 적었습니다.

0단계 — 준비물 확인

시작하기 전에 두 가지만 확인하세요.

항목	조건
파일 형식	JPEG(.jpg), PNG(.png), WebP(.webp)
파일 크기	서버에 상한이 있습니다. 1~2MB 이하로 줄여서 올리는 것을 권합니다.
악보 형태	오선(보표) 위에 코드 이름이 글자로 인쇄된 악보
계정	필요 없음. 로그인 없이 바로 사용

가장 흔한 실패 원인은 악보 형태입니다

ChordSticker는 오선을 먼저 찾고, 그 위쪽 영역에서 코드 글자를 읽는 순서로 동작합니다. 그래서 가사 위에 코드만 적힌 코드 시트, 타브만 있는 악보, 오선이 없는 리드 시트는 처리하지 못합니다. 오선이 화면에 보이는지 먼저 확인하세요.

1단계 — 악보 이미지 업로드

메인 화면 가운데의 점선 상자가 업로드 영역입니다. 두 가지 방법이 있습니다.

클릭해서 파일 탐색기로 이미지를 고르기
이미지 파일을 상자 위로 끌어다 놓기(드래그 앤 드롭)

파일을 선택하면 상자 안에 미리보기가 뜨고 아래에 파일 이름이 표시됩니다. 이 단계에서는 아직 서버로 아무것도 전송되지 않습니다. 미리보기는 브라우저 안에서만 만들어집니다.

다른 파일로 바꾸고 싶으면 상자를 다시 클릭해 새 파일을 고르면 됩니다.

2단계 — AI 분석 실행

미리보기 아래의 "악보 분석 시작" 버튼을 누르면 이미지가 서버로 전송됩니다. 버튼 문구가 "AI가 악보를 분석하는 중입니다"로 바뀌고 잠시 기다리게 됩니다.

이 사이에 서버에서 일어나는 일은 다음과 같습니다.

파일 형식과 크기를 검사합니다. 조건에 맞지 않으면 여기서 거절됩니다.
이미지에서 오선 다섯 줄이 일정한 간격으로 늘어선 묶음을 찾습니다.
각 보표 위쪽에서 코드 글자가 모여 있는 띠를 잘라냅니다.
띠 안의 글자 덩어리를 코드 단위로 분리하고 문자 인식 모델에 넣습니다.
인식된 문자를 조립해 코드 이름을 만들고, 원본 이미지에 빨간 사각형으로 위치를 표시합니다.

대기 시간은 악보의 코드 개수에 비례합니다. 코드가 수십 개인 긴 악보는 시간이 더 걸립니다. 처음 요청이면 서버가 잠들어 있다 깨어나느라 추가로 지연될 수 있습니다.

3단계 — 편집 화면 이해하기

분석이 끝나면 화면이 세 칸으로 나뉩니다. 각 칸의 역할이 다릅니다.

위치	이름	역할
왼쪽	원본 뷰어	업로드한 이미지를 그대로 보여줍니다. 비교용입니다.
가운데	코드 편집기	인식 위치가 표시된 이미지 위에 코드 이름 뱃지가 떠 있습니다. 실제 작업은 여기서 합니다.
오른쪽	Inspector	오선 수와 코드 수, 줄별 코드 목록을 보여주고 다음 단계로 넘기는 버튼이 있습니다.

가운데 편집기의 이미지에는 빨간 사각형이 그려져 있습니다. 이것은 모델이 "여기에 코드 글자가 있다"고 판단한 영역입니다. 그 위에 겹쳐진 파란 뱃지가 인식된 코드 이름입니다.

오른쪽 Inspector의 숫자 두 개를 먼저 확인하세요.

오선 수 — 코드가 하나 이상 발견된 보표의 개수입니다. 실제 악보의 줄 수보다 적다면 일부 보표를 놓친 것입니다.
코드 수 — 인식된 코드의 총 개수입니다. 실제보다 많다면 하나의 코드가 둘로 쪼개졌을 가능성이 큽니다.

4단계 — 코드 수정하고 삭제하기

여기가 가장 중요한 단계입니다. AI 인식은 완벽하지 않으므로 사람이 반드시 확인해야 합니다. 그래서 자동으로 바로 결과를 내주지 않고 이 화면을 거치게 되어 있습니다.

선택하기

코드 뱃지를 한 번 클릭하면 선택됩니다. 선택된 뱃지 양쪽 위에 작은 아이콘 두 개가 나타납니다.

왼쪽 위 연필 아이콘 — 수정
오른쪽 위 휴지통 아이콘 — 삭제

같은 뱃지를 다시 클릭하면 선택이 해제됩니다.

수정하기

연필 아이콘을 누르거나 뱃지를 더블클릭하면 그 자리가 입력창으로 바뀝니다.

동작	결과
Enter 키	수정 내용 저장
Esc 키	수정 취소, 원래 값 유지
입력창 밖 클릭	수정 내용 저장

입력할 때 지켜야 할 표기법

다이어그램은 입력한 문자열을 그대로 코드 사전에서 찾습니다. 사전에 없는 표기를 쓰면 다이어그램이 붙지 않으니 아래 규칙을 지켜주세요.

근음은 대문자: C, G, F#, Bb
마이너는 소문자 m: Am (O), AM (X), Amin (X)
메이저 세븐스는 maj7: Cmaj7 (O), CM7 (X)
분수 코드는 슬래시: G/B
공백은 넣지 않기: C maj7 (X)

어떤 표기가 지원되는지는 지원 코드 목록에서 확인할 수 있습니다.

삭제하기

휴지통 아이콘을 누르면 확인 창이 뜨고, 확인하면 그 코드가 목록에서 빠집니다. 다음 경우에 사용하세요.

악보의 박자표나 조표를 코드로 잘못 잡은 경우
가사나 연습 기호 같은 글자를 코드로 오인한 경우
하나의 코드가 둘로 쪼개져 중복으로 잡힌 경우 (하나는 지우고 나머지를 올바른 이름으로 수정)

검수 순서 추천

오른쪽 Inspector에서 줄별 코드 목록을 훑으며 이상한 이름을 먼저 찾습니다.
이상한 항목을 발견하면 가운데 편집기에서 해당 위치의 뱃지를 찾습니다.
왼쪽 원본 뷰어에서 실제 악보에 뭐라고 적혀 있는지 확인합니다.
수정하거나 삭제합니다.

5단계 — 다이어그램 합성

검수가 끝나면 오른쪽 아래의 "타브 추가하기" 버튼을 누릅니다. 버튼이 "타브 악보 생성 중..."으로 바뀌며 합성이 시작됩니다.

서버는 확정된 코드 목록을 받아 다음을 수행합니다.

쪼개진 조각을 다시 붙입니다. 예를 들어 A와 m이 가까이 붙어 있으면 Am으로 합칩니다.
각 코드 이름을 근음과 접미어로 나눠 코드 사전에서 운지 데이터를 찾습니다.
찾은 데이터로 6현 5프렛 다이어그램을 그립니다. X/O 표시, 너트선, 프렛 번호, 바레 바, 운지 점이 모두 포함됩니다.
그린 다이어그램을 원래 코드 글자가 있던 자리에 붙입니다.

다이어그램은 코드 글자를 덮습니다

합성 결과에서는 원래 인쇄되어 있던 코드 이름 위에 그림이 올라갑니다. 다이어그램 자체에 코드 이름이 함께 그려지므로 정보가 사라지지는 않지만, 원본 그대로가 필요하면 업로드한 파일을 따로 보관해 두세요.

6단계 — 다운로드와 인쇄

합성이 끝나면 "변환 완료" 화면으로 넘어갑니다. 왼쪽에 완성된 악보가, 오른쪽에 변환 리포트와 버튼 세 개가 있습니다.

버튼	동작
이미지 다운로드 (.png)	완성된 악보를 PNG 파일로 내려받습니다.
악보 프린트하기	브라우저 인쇄 창을 엽니다.
새로운 악보 만들기	모든 상태를 초기화하고 업로드 화면으로 돌아갑니다.

인쇄할 때 권장 설정

배경 그래픽 켜기 — 끄면 다이어그램이 흐리게 나올 수 있습니다.
여백 최소 — 악보가 잘리지 않게 합니다.
용지에 맞춤 — 가로로 긴 악보는 가로 방향으로 인쇄하세요.

여러 페이지를 한 번에 인쇄하려면, 페이지마다 변환한 PNG를 내려받아 이미지 뷰어나 문서 도구에서 모아 인쇄하는 편이 안정적입니다.

결과 이미지 주소는 오래 유효하지 않습니다

결과 이미지 주소에는 만료 시각이 들어 있어 일정 시간이 지나면 접근할 수 없게 됩니다. 나중에 다시 쓸 계획이라면 지금 바로 다운로드해 두세요. 링크를 저장해 두는 것으로는 부족합니다.

단계별 문제 해결

증상	가능한 원인	해결
업로드 자체가 거부됨	지원하지 않는 형식이거나 파일이 너무 큼	JPG/PNG/WebP로 변환하고 용량을 줄이세요. HEIC 사진은 JPG로 바꿔야 합니다.
분석 후 코드가 하나도 없음	오선을 못 찾았거나 코드 표기가 없는 악보	오선이 선명하게 보이는지, 코드가 오선 위쪽에 인쇄되어 있는지 확인하세요.
일부 줄만 인식됨	해당 줄의 오선 간격이 불규칙하거나 사진이 기울어짐	정면에서 다시 촬영하거나 스캔하세요.
코드가 둘로 쪼개짐 (`A` + `m`)	글자 사이 간격이 넓어 별개 코드로 분리됨	하나를 삭제하고 남은 하나를 올바른 이름으로 수정하세요.
코드 이름이 틀림	서체, 해상도, 유사 문자 혼동	편집 화면에서 직접 수정하세요. 유형별 정리는 인식 오류 가이드 참고.
이름은 맞는데 다이어그램이 안 붙음	코드 사전에 없는 표기	지원되는 표기로 바꿔 입력하세요. 지원 코드 목록 참고.
다이어그램이 겹쳐 보임	코드 간격이 좁은 악보	악보를 더 크게(고해상도로) 다시 올리면 간격이 벌어집니다.
분석 중 오류 메시지	서버 일시 장애 또는 요청 시간 초과	잠시 후 다시 시도하세요. 반복되면 문의로 알려주세요.

실전 활용 흐름 세 가지

1. 혼자 연습할 때

연습할 곡의 악보를 스캔해 변환한 뒤, PNG를 태블릿에 넣어둡니다. 낯선 코드가 나올 때마다 검색할 필요가 없어집니다. 특히 m7b5, dim7, 분수 코드가 섞인 곡에서 체감 차이가 큽니다.

2. 초보자를 가르칠 때

같은 악보를 두 벌 준비합니다. 하나는 원본, 하나는 다이어그램이 붙은 버전입니다. 초보자에게는 붙은 버전을 주고, 익숙해지면 원본으로 넘어가게 합니다. 코드표를 손으로 그려주는 시간이 사라집니다.

3. 합주 준비할 때

다음에 읽으면 좋은 문서

인식률을 근본적으로 올리고 싶다면 촬영 가이드부터 보세요. 결과물의 다이어그램을 정확히 읽고 싶다면 코드 다이어그램 읽는 법이 도움이 됩니다.