SingLayer

SingLayer는 YouTube에서 재생하는 노래의 가사를 찾아 영상 위와 방송 화면에 맞춰 보여주는 노래 방송 도구입니다. 일본어 가사의 한글 독음·한국어 번역, 싱크 보정, 반주 음정 조절, 플레이리스트, 투명 브라우저 소스 송출을 한 확장에서 사용할 수 있습니다. 평소에는 꺼 두고, 노래를 듣거나 방송을 준비할 때만 켜세요. 송출 형식은 브라우저 소스방식을 사용하기때문에 프릭샷과 OBS 양쪽 모두 지원합니다. 이 확장은 YouTube, Google, 프릭샷, SOOP의 공식 제품이 아닙니다. 가사·음악·후원 이미지의 이용·방송 권한은 각 콘텐츠와 플랫폼의 조건을 따릅니다. 현재 실사용이 가능한 첫 베타로 판단되는 버전이기 떄문에 UI배치나 스킨의 디자인은 차후 변경이 많을수도 있습니다. 개발동기 : https://www.sooplive.com/station/reumdal 스트리머 꾸름달에게 많은 사랑 부탁드립니다. ■ 처음 설치한 뒤 1. 시작 안내에서 데이터 사용 내용을 읽고 ‘정보 사용 안내를 확인했고 동의합니다’에 체크한 뒤 시작합니다. 계정 가입은 없습니다. 2. ‘일본어 독음·번역 자동 생성’과 ‘검색한 가사와 싱크 보정 공유’는 각각 선택할 수 있으며, 처음에는 꺼져 있습니다. 나중에 방송 도구의 ‘데이터 사용·공유 설정’에서 바꾸거나 동의를 철회할 수 있습니다. 3. YouTube 음악 영상을 재생합니다. 기능을 켜면 영상 아래에 SingLayer 제어부가 나타납니다. 가사 자동 적용이 켜져 있으면 현재 곡에 맞는 가사를 준비합니다. 4. 평소 YouTube를 볼 때는 영상 재생바 오른쪽, 자막 버튼 왼쪽에 있는 SingLayer 아이콘으로 끄고 켤 수 있습니다. 한 번 켜면 다른 영상으로 이동해도 다시 끌 때까지 유지됩니다. 5. 스트리머를 위한 브라우저 소스 송출 주소는 영상의 SingLayer를 누르면 영상 하단에 나오는 제어부 우측의 주소보기에서 확인할수 있습니다. ■ YouTube 영상 아래 제어부 제어부는 영상 바로 아래에 붙습니다. • 방송 도구 가사 검색, 글자·효과·스킨, 싱크·음정, 후원 보드, 신청곡을 다루는 작은 독립 창을 엽니다. 이미 열려 있으면 새 창을 만들지 않고 앞으로 가져옵니다. • 전체가사 보기 주소 표시줄이 없는 확장 전용 창에서 가사 전체를 봅니다. 현재 줄이 강조되고 자동으로 따라가며, 시간이 있는 줄을 누르면 영상도 그 위치로 이동합니다. 직접 스크롤한 뒤에는 ‘현재 가사로’ 또는 ‘자동 따라가기’로 다시 맞출 수 있습니다. • 영상 가사 영상 위에 뜨는 감상용 가사를 숨기거나 다시 표시합니다. 방송용 가사 송출과는 별개입니다. • 플레이리스트 열기 / 플레이리스트에 추가 보고 있는 영상만 직접 담습니다. 재생했다고 자동으로 들어가지 않습니다. 목록 창에서 곡명·가수·영상 제목으로 찾고, 눌러 재생하고, 곡마다 원키/−5~+5키를 저장할 수 있습니다. 목록은 이 브라우저에만 저장되며 SingLayer 서버로 보내지 않습니다. • 이 영상으로 전환 제어부가 다른 탭의 영상을 가리키고 있을 때, 지금 보고 있는 영상으로 가사를 연결합니다. • 가사 싱크 가사가 빠르면 ‘앞당김’, 느리면 ‘늦춤’을 누릅니다. 간격은 0.1초 → 0.2초 → 1초로 바꿀 수 있습니다. 키보드 [ ] 도 같은 동작입니다. ‘원래대로’는 보정을 지웁니다. • 가사 이동 쉼표(,)는 이전 가사, 마침표(.)는 다음 가사입니다. 시간이 있는 가사가 준비된 영상에서만 동작합니다. • 프릭샷 송출 시작 / 중지 방송 프로그램의 브라우저 소스로 가사·곡정보(그리고 켠 경우 후원·신청곡)를 보냅니다. 실제 방송 시작·종료는 프릭샷에서 하세요. • 송출주소 열기 가사, 곡정보, 후원 보드, 신청곡의 소스 주소를 복사합니다. 권장 크기가 함께 표시됩니다. 주소는 외부에 공개하지 마세요. 같은 주소를 여러 사람이 동시에 쓰면 연결이 깨질 수 있습니다. • 가사 송출 / 곡정보 송출 송출을 시작한 뒤 각각 끄고 켤 수 있습니다. 둘 다 꺼도 연결 자체는 유지됩니다. ■ 가사를 찾고 고르기 자동 검색은 현재 영상의 음악 정보(있으면)와 제목을 이용해 LRCLIB·NetEase와 SingLayer 서버의 저장 가사를 조회합니다. 곡 버전·길이·가사 품질을 확인해 맞는 후보만 자동 적용합니다. 자동 적용이 어렵으면 영상 오른쪽 위에 선택창이 뜹니다. 곡명·가수·출처·길이 차이를 보고 고르거나 ‘선택 안 함’으로 닫을 수 있습니다. ‘수동 검색’은 방송 도구의 검색 화면으로 이동합니다. 방송 도구 → 검색에서 할 수 있는 일: • 곡 제목·아티스트를 고친 뒤 ‘동기 가사 검색’ • 가사를 직접 입력하거나 .lrc / .txt 파일을 불러와 적용 • 고정 문구만 띄우기 • ‘독음·번역 생성’으로 일본어 가사의 한글 독음·한국어 번역 요청 • 아티스트가 불명확할 때 iTunes 곡 정보 확인(선택, 해당 사이트 권한 필요) • MusicBrainz로 곡 정보 추가 확인(기본 꺼짐. 직접 켜고 권한을 허용한 경우에만, 기존 검색이 실패한 뒤 곡명·가수를 조회합니다. 가사 전문·오디오·영상 ID는 보내지 않습니다) 최근 사용한 곡은 영상별로 선택한 가사·번역·싱크를 기억합니다. 목록에서 곡을 누르면 해당 YouTube 영상을 엽니다. ■ 싱크가 어긋날 때 영상 아래 싱크 버튼이나 [ ] 키로 맞춘 뒤 5초 동안 더 건드리지 않으면, 보정값이 이 기기의 해당 가사에 저장됩니다. 같은 영상을 다시 열면 이 값을 사용합니다. Chrome 단축키 전역설정값(기본값, chrome://extensions/shortcuts에서 변경): • Ctrl+Shift+1 싱크 앞당김 • Ctrl+Shift+2 싱크 늦춤 • Ctrl+Shift+3 이전 가사 • Ctrl+Shift+4 다음 가사 이 네 가지는 전역 단축키로 등록되어 있어, Chrome이 다른 창 뒤에 있어도 동작할 수 있습니다. 다른 프로그램과 키가 겹치면 단축키 설정에서 바꾸세요. 검색 가사와 싱크 공유를 켠 경우에는 해당 검색 가사의 보정만 서버에도 반영합니다. 공유를 꺼도 개인 싱크는 로컬에 남습니다. 직접 입력한 가사는 자동 공유하지 않습니다. ■ 반주 음정(Pitch) 방송 도구의 ‘싱크 · 음정 조절’ 또는 영상 쪽 Pitch 조작으로 현재 YouTube 영상의 음정을 기기 안에서 바꿉니다. 재생 속도는 그대로 두고 키만 조절합니다. 마이크·다른 탭·다른 프로그램 소리는 캡처하지 않으며, 원본·처리된 오디오를 서버나 방송 데이터로 보내지 않습니다. • 켜지 않아도 가사 기능은 그대로 사용할 수 있습니다. • 다른 영상으로 넘어가면 그 영상에 저장한 음정 또는 원키로 시작합니다. • 플레이리스트에서 원키가 아닌 값을 저장하고 SingLayer가 켜져 있으면, 그 영상을 재생할 때 자동으로 적용합니다. • 광고 구간은 원키로 처리합니다. • 브라우저가 오디오 연결을 제한하면 영상 안 버튼이나 제어부를 한 번 눌러 다시 시작하세요. • Chrome 도구모음 클릭이나 탭 캡처 권한은 필요하지 않습니다. ■ 방송 화면에 올리기 (프릭샷 등) SingLayer를 쓰는 Chrome과 방송 프로그램을 같은 PC에서 실행하는 것을 권장합니다. 현재 연결은 STUN/TURN을 쓰지 않아, 다른 네트워크의 브라우저 소스와는 연결이 보장되지 않습니다. 1. YouTube에서 SingLayer를 켜고 가사를 준비합니다. 2. ‘프릭샷 송출 시작’을 누릅니다. 3. ‘송출주소 열기’에서 가사·곡정보 주소를 복사합니다. 4. 프릭샷(또는 같은 방식의 브라우저 소스)에 소스를 추가하고 주소를 붙여 넣습니다. 5. 안내에 나온 권장 크기로 시작한 뒤 방송 레이아웃에 맞게 옮깁니다. 배경이 투명하게 나가므로 크로마키 창 캡처가 필요 없습니다. 영상을 일시정지하거나 끝내면 송출 가사·곡정보가 숨겨지고, 다시 재생하면 현재 상태에 맞춰 표시됩니다. 소스 주소는 확장 저장소에 남으므로 매번 다시 만들 필요는 없습니다. 확장을 삭제하거나 저장소를 지우면 주소를 다시 등록해야 할 수 있습니다. ■ 방송 도구 창의 구성 상단에서 ‘가사·곡정보 / 후원 보드 / 신청곡’을 바꿉니다. [가사·곡정보] 검색, 글자, 효과, 송출스킨 네 탭이 있습니다. • 글자: 크기, 색, 굵기, 외곽선, 그림자, 독음·번역 표시, 기울기. ‘내 PC 폰트 불러오기’를 누르면 Chrome의 로컬 글꼴 허가를 요청합니다. 허용하면 설치된 글꼴 이름만 읽어 선택에 쓰고, 폰트 파일은 읽거나 전송하지 않습니다. 거절해도 기본 글꼴은 사용할 수 있습니다. • 효과: 가사 전환(예: 펀치 등)과 정렬. 시스템의 ‘움직임 줄이기’ 설정을 따릅니다. • 송출스킨: 곡정보 디자인과 가사창 스킨. 재생카드에는 곡명·아티스트, 진행 시간, 음악에 반응하는 막대가 있습니다. 비주얼라이저를 끈 스킨은 오디오 분석을 요청하지 않습니다. 스킨 장식 이미지는 확장에 들어 있으며 외부에서 추가로 받지 않습니다. [후원 보드] (선택) SOOP 공개 방송의 별풍선 등 후원을 카드로 보여 주고, 원하면 방송 소스로 보냅니다. 채널을 넣고 별도 안내에 동의한 뒤 선택 권한을 허용해야 합니다. 로그인·쿠키 조회·채팅 전송은 하지 않습니다. 일반 채팅은 저장하거나 목록으로 만들지 않습니다. 후원자 계정 ID는 카드·송출에서 빼며, 닉네임·수량·이미지 식별자만 표시용으로 씁니다. 이미지는 SOOP 이미지 서버에서 미리보기·방송 소스가 직접 요청합니다. SingLayer 서버에 후원 카드나 이미지를 보관하지 않습니다. SOOP 공식 제휴 기능이 아니며, 서비스가 바뀌면 동작하지 않을 수 있습니다. [신청곡] (선택) 후원 보드와 별도로 안내에 동의하고 접수를 켜야 합니다. 설정 수량 이상의 별풍선을 보낸 계정이 짧은 시간 안에 보낸 !신청 명령만, 후원 1회당 1곡으로 받습니다. 목록은 이 Chrome 세션에만 두고, 브라우저를 완전히 종료하거나 채널을 바꾸면 지워집니다. 목록을 더블클릭하면 저장해 둔 플레이리스트와 맞는 YouTube 영상을 연 뒤 해당 신청을 지웁니다. 송출에는 곡 문자열·닉네임·순서만 보냅니다. ■ 사용 환경 • 데스크톱 Chrome 116 이상, YouTube 영상 페이지(youtube.com/watch) • 가사 검색·번역·송출 연결에는 인터넷이 필요합니다 • 모바일 Chrome, YouTube 앱, youtube.com 이외 재생 페이지는 지원하지 않습니다 • 곡·영상 버전에 따라 가사가 없거나 싱크가 다를 수 있습니다. 자동 검색과 생성된 독음·번역이 틀릴 수 있으니, 방송 전에 확인하고 필요하면 다시 고르거나 직접 수정하세요 • Pitch는 브라우저가 영상 오디오에 연결할 수 있을 때만 동작합니다 ■ 데이터와 권한 요약 SingLayer를 켠 뒤에만 현재 YouTube 영상의 제목, 채널·음악 정보, 영상 ID, 재생 위치·길이를 읽습니다. 다른 사이트의 방문 기록, YouTube 계정, 쿠키, 비밀번호는 읽지 않습니다. 외부로 보내는 정보: • LRCLIB·NetEase: 가사 검색용 제목·아티스트(NetEase에는 선택한 곡 ID) • SingLayer 서버(Cloudflare): 저장 가사·번역 조회, 요청한 번역 생성, 공유를 켠 경우의 검색 가사·싱크 • Google Gemini API: 번역 생성 버튼 또는 자동 생성을 켰을 때 가사 원문·곡 정보. 직접 입력한 일본어 가사도 포함됩니다. 가사 입력란에 개인정보를 넣지 마세요 • Apple iTunes / MusicBrainz: 각 기능을 켜고 권한을 허용한 경우의 곡 정보 검색어 • 방송 연결 서버: 연결 키 검증과 WebRTC 연결 정보. 연결된 소스에는 가사·번역·곡 정보·타이밍·표시 설정·막대값(후원·신청곡을 켠 경우 그 표시 정보)을 데이터 채널로 보냅니다. 원본 영상·음성 파일은 이 경로로 보내지 않습니다 광고·판매·신용 평가에 사용자 데이터를 쓰지 않습니다. 개선요청이나 버그제보는 아래의 메일로 부탁드립니다. * 가사단위 건너뛰기 기능을 사용하면 전체가사보기 자동스크롤 기능이 멈추는 버그가 현재 존재합니다 빠른 시일내에 수정예정입니다. 개인정보처리방침 http…