빠른 시작 가이드
시청자들이 유튜브에서 노래를 검색해서 신청할 수 있어요. 변수를 사용해 나만의 명령어를 만들 수 있어요.
신청곡은 기본적으로 열려 있어요. 한 번도 손대지 않은 채널이라면 시청자가 바로 신청할 수 있어요.
닫으려면 대시보드에서 '신청곡 열림 여부' 토글을 끄거나, 만들어둔 신청곡 명령어 뒤에 닫기 를 붙이세요 (!신청 닫기).
대부분 방송 중에만 가능
신청곡 변수는 대부분 방송 중에만 동작해요. 예외가 둘 있어요.
$song-remaining-limit-per-user·$song-remaining-limit-total은 방송 여부를 보지 않아요.- 스트리머 본인은 방송이 꺼져 있어도 신청할 수 있어요 (신청 경로만 매니저까지 방송 검사를 받아요. 조회·스킵은 스트리머도 방송 중에만 돼요).
신청곡 명령어 만들기
신청곡 기능을 사용하려면 $song-requests 변수를 사용해요.
!추가 [원하는명령어] $song-requests
명령어 이름은 자유롭게!
!sr, !노래신청, !신청 등 원하는 이름으로 만들 수 있어요!
예시:
!추가 !sr $song-requests→!sr 노래제목으로 신청!추가 !노래신청 $song-requests→!노래신청 노래제목으로 신청!추가 !신청 $song-requests→!신청 노래제목으로 신청
신청곡 변수
$song-requests - 신청곡 기능
$song-requests신청곡 기능을 활성화해요. 시청자가 검색어나 URL로 노래를 신청할 수 있어요.
!추가 !sr $song-requests!sr 린 Overdose신청이 완료되었습니다: Overdose (なとり) / 아오쿠모 린 (Aokumo Rin) Cover$song-current - 현재 곡
$song-current현재 재생 중인 곡 제목을 출력해요.
!추가 !지금 신청곡: $song-current!지금신청곡: 첫사랑 ( 백아 ) / 아라하시 타비 Cover$song-link - 현재 곡 링크
$song-link현재 재생 중인 곡의 유튜브 링크를 출력해요.
!추가 !링크 $song-link!링크https://youtu.be/HBoqsgRoDw4$song-next - 다음 곡
$song-next다음에 재생될 곡 제목을 출력해요.
!추가 !다음곡 다음곡: $song-next!다음곡다음곡: Overdose (なとり) / 아오쿠모 린 (Aokumo Rin) Cover$song-count - 남은 곡 수
$song-count대기열에 남은 곡 수를 출력해요.
!추가 !대기 남은 곡: $song-count!대기남은 곡: 5개값에 이미 개 가 붙어 나와요. 뒤에 곡 을 붙이면 5개곡 이 돼요.
예시: 종합 신청곡 정보
여러 변수를 조합해서 자세한 정보를 보여줄 수 있어요!
!추가 !노래 신청곡: $song-current ($song-link) / $song-count 남음.
결과: 신청곡: 첫사랑 ( 백아 ) / 아라하시 타비 Cover (https://youtu.be/HBoqsgRoDw4) / 2개 남음.
신청곡 설정하기
대시보드 신청곡 페이지는 이렇게 생겼어요.
| 화면 | 하는 일 |
|---|---|
| 왼쪽 플레이어 | 지금 재생 중인 곡. 아래에 제목·신청자가 표시돼요 |
| 오른쪽 대기열 | 신청된 순서. 각 곡의 삭제 로 개별 제거 |
| 신청곡 열림 여부 | 이걸 켜야 시청자가 신청할 수 있어요 |
| 영상이 끝났을 때, 자동 스킵 | 곡이 끝나면 다음 곡으로 자동 이동 |
| 오류 발생시, 자동 스킵 | 재생 불가한 영상을 자동으로 건너뛰어요 |
| 전체 삭제 | 대기열을 통째로 비워요 |
대시보드 접속
뚜봇 대시보드에 로그인하세요.
신청곡 메뉴
좌측 메뉴에서 '신청곡' 을 클릭해요.
기능 활성화
'신청곡 열림 여부' 토글을 켜세요. 꺼져 있으면 시청자가 신청할 수 없어요.
제한값은 채팅 명령으로
대시보드에는 제한값 입력칸이 없어요. 아래 명령을 방송 채팅창에 입력하세요.
!설정 신청곡 전체갯수제한 <개수>— 대기열에 쌓일 수 있는 전체 곡 수!설정 신청곡 유저제한 <개수>— 한 사람이 대기열에 동시에 올려둘 수 있는 곡 수 (최대 100)!설정 신청곡 길이제한 <시간(초)>— 신청 가능한 영상 길이. 분이 아니라 초입니다!설정 신청곡 중복제한 <개수>— 같은 영상이 대기열에 동시에 들어갈 수 있는 개수
전체갯수·유저·중복 세 제한은 대기열 기준이에요. 곡이 재생을 마치면 자리가 비어서 같은 사람도, 같은 영상도 다시 신청할 수 있어요. (길이제한은 대기열과 무관하게 영상 자체의 재생 시간을 봐요.)
앞의 셋은 -1 을 넣으면 무제한이 돼요. 중복제한만 다릅니다 — -1 은 거부되고(0보다 큰 숫자로 입력해주세요.), 끄려면 0 을 넣으세요.
값 없이 치면 현재 설정을 알려줘요.
대시보드에서 켜고 끌 수 있는 건 신청곡 열림 여부 · 유튜브 로그인 사용 · 자동 스킵(영상 종료 / 오류 발생) 입니다. 이 페이지에서는 설정을 바꾼 뒤 따로 '저장' 을 누를 필요가 없어요.
자동 스킵 2종은 이 브라우저에만 저장돼요. 다른 PC·다른 브라우저에서는 기본값(영상 종료=켬, 오류 발생=끔)으로 돌아가요. 이 두 토글은 대시보드 플레이어에만 적용돼요. OBS 로 띄운 오버레이는 곡이 끝나거나 오류가 나면 항상 다음 곡으로 넘어갑니다.
다만 '유튜브 로그인 사용' 은 아예 저장되지 않아요. 이 브라우저에서만 켜지고 새로고침하면 다시 꺼지며, 오버레이에는 적용되지 않아요. 켜면 로그인된 유튜브 계정의 시청 기록과 추천이 신청곡으로 오염될 수 있어요 — 대시보드에서도 켤 때 같은 경고가 뜹니다.
관리용 변수
신청곡을 관리하는 변수예요. 명령어로 만들어 쓸 수 있어요.
$song-skip - 곡 스킵
$song-skip현재 재생 중인 곡을 건너뛰어요.
!추가 !스킵 $song-skip마지막남은뚜또: !스킵'첫사랑 ( 백아 ) / 아라하시 타비 Cover' 노래를 스킵했습니다.$song-time - 현재 곡 길이
$song-time현재 재생 중인 곡의 길이를 출력해요.
!추가 !곡길이 현재 곡 길이: $song-time마지막남은뚜또: !곡길이현재 곡 길이: 03:42$song-total-time - 전체 대기열 길이
$song-total-time대기열에 있는 모든 곡의 총 길이를 출력해요.
!추가 !총길이 남은 신청곡 길이: $song-total-time마지막남은뚜또: !총길이남은 신청곡 길이: 15:30$song-remaining-limit-per-user - 개인 남은 신청 횟수
$song-remaining-limit-per-user내가 추가로 신청할 수 있는 곡 수를 출력해요.
!추가 !남은신청 남은 신청 가능: $song-remaining-limit-per-user곡마지막남은뚜또: !남은신청남은 신청 가능: 2곡1인당 제한을 설정하지 않았거나 무제한(-1)이면 개수 대신 -1 이 나와요.
$song-remaining-limit-total - 전체 남은 신청 가능 수
$song-remaining-limit-total대기열에 추가로 들어갈 수 있는 곡 수를 출력해요.
!추가 !대기열여유 대기열 여유: $song-remaining-limit-total곡마지막남은뚜또: !대기열여유대기열 여유: 15곡전체갯수제한을 설정하지 않았거나 무제한(-1)이면 곡 수 대신 -1 이 나와요.
관리 명령어 예시
관리용 명령어를 만들어 쓸 수 있어요.
곡 스킵 명령어
!추가 !스킵 $song-skip
이제 !스킵 을 치면 현재 곡이 건너뛰어져요.
기본 권한은 '시청자'입니다
!추가 로 만든 명령어는 누구나 쓸 수 있는 상태로 만들어집니다. 이대로 두면
시청자 아무나 재생 중인 곡을 넘길 수 있어요.
매니저만 쓰게 하려면 대시보드 좌측 뚜봇 관리 → 유저 명령어 에서 !스킵 을 수정하고,
필요 권한 을 매니저 로 바꿔주세요.
신청곡 정보 명령어
!추가 !신청곡 🎵 $song-current | 다음: $song-next | 남은 곡: $song-count
현재 재생 중인 곡과 다음 곡, 남은 곡 수를 한 번에 확인할 수 있어요.
신청 가능 여부 확인
!추가 !신청가능 대기열 여유: $song-remaining-limit-total곡 / 내 남은 신청: $song-remaining-limit-per-user곡
에러 응답
| 상황 | 응답 |
|---|---|
| 신청곡이 닫혀 있음 | 아무 응답도 하지 않습니다 |
| 전체 대기열 초과 | 오류: 이 채널은 최대 20개 까지만 신청 가능합니다. |
| 개인 신청 제한 초과 | 오류: 한 사람당 최대 3개 까지만 신청 가능합니다. |
| 중복 신청 초과 | 오류: 같은 영상은 최대 1개 까지만 신청 가능합니다. |
| 곡 길이 초과 | 오류: 300초 이상의 영상은 신청할 수 없습니다. |
| 검색 결과 없음 | 오류: 유튜브 검색 결과가 없거나, 찾지 못했습니다. |
숫자 부분에는 실제로 설정한 제한값이 들어가요.
방송이 꺼져 있을 때
무엇을 하려 했느냐에 따라 문구가 다릅니다.
| 하려던 것 | 응답 |
|---|---|
| 신청 | 방송중이 아닙니다. 신청은 방송 중에만 가능합니다. |
조회 ($song-current 등) | 방송중이 아닙니다. 조회는 방송 중에만 가능합니다. |
스킵 ($song-skip) | 방송중이 아닙니다. 스킵은 방송 중에만 가능합니다. |
곡이 없을 때
| 변수 | 응답 |
|---|---|
$song-current · $song-link · $song-time · $song-total-time | 재생중인 노래가 없습니다. |
$song-skip | 재생중인 곡이 없습니다. |
$song-next | 다음곡이 없습니다. |
방송 화면에 띄우기 (오버레이)
신청곡은 오버레이가 두 개입니다. 대시보드 오버레이 관리 → 신청곡에서 둘 다 받을 수 있어요.
| 오버레이 | 무엇을 보여주나 | 꼭 필요한가 |
|---|---|---|
| 신청곡 (플레이어) | 노래를 실제로 재생해요 | ✅ 필수 |
| 신청곡 목록 | 대기 중인 곡 목록을 표시해요 | 선택 |
🚨 플레이어 오버레이가 없으면 노래가 재생되지 않아요
신청만 받고 소리가 안 난다면 대부분 이 오버레이를 OBS에 추가하지 않아서예요.
신청곡(플레이어) 오버레이를 반드시 OBS에 넣어주세요.
OBS에 추가하기
플레이어 오버레이 추가
위쪽 오버레이 주소의 주소 복사 → OBS 소스 → + → 브라우저
소리만 나오면 되므로 크기는 400 × 300 정도면 충분해요. 화면 밖으로 빼두셔도 돼요.
소리 설정 확인
브라우저 소스 속성에서 소스를 통해 오디오 제어를 켜주세요. 꺼져 있으면 OBS가 노래 소리를 잡지 못해요.
목록 오버레이 추가 (선택)
아래쪽 신청곡 목록의 주소를 복사해 같은 방식으로 추가해요.
권장 크기는 400 × 600 정도예요.
설정 항목
| 설정 | 설명 |
|---|---|
| 오버레이 볼륨 | 노래 재생 음량 |
| 오버레이 배경 | 목록 오버레이의 배경 |
| 표기되는 노래 갯수 | 목록에 몇 곡까지 보여줄지 |
| 다크모드 | 목록 오버레이의 어두운 테마 |
| CSS ID / 추가 CSS | 디자인 직접 변경 |
이 표의 항목은 신청곡 오버레이 설정 페이지에 있어요. 값을 바꾼 뒤 페이지 제목 옆 '저장' 을 눌러야 반영돼요.
미리보기에서는
- 플레이어 — 자동 재생 안 되고 삭제도 안 돼요
- 목록 — 삭제 버튼이 눌리지 않아요
실제 방송에서는 정상이에요.
오버레이 주소는 노출하지 마세요
주소를 아는 사람은 누구나 열어볼 수 있어요. 방송 화면에 주소가 잡히지 않도록 주의해주세요. 확인 후 20초 뒤 자동으로 다시 가려집니다.
다음 단계
신청곡 설정이 완료되었다면, 시청자 참여 기능도 확인해보세요.