웹 대시보드 시작하기

연희에는 디스코드 명령어 말고 브라우저에서 쓰는 웹 대시보드가 있어요. 검색, 대기열 정렬, 플레이리스트, 가사처럼 디스코드 채팅창에서 하기 불편한 것들을 화면으로 다루라고 만든 것입니다. 이 페이지는 대시보드에 들어가서 첫 곡을 넣기까지의 최소 경로만 설명해요.

대시보드 문서는 네 개입니다

문서	무엇이 있나
대시보드 화면 둘러보기	사이드바·헤더·본문·하단 플레이어에 무엇이 있고 어떤 버튼이 실제로 동작하는지
대시보드에서 대기열 다루기	순서 바꾸기, 곡 지우기, 되돌릴 수 없는 조작
플레이리스트와 유튜브 재생목록 가져오기	내 플레이리스트 만들기, 유튜브 재생목록 가져오기
가사 패널과 기록 화면	가사 보기와 싱크 보정, 최근에 들은 곡

로그인은 되는데 서버가 목록에 뜨지 않거나 설정 메뉴가 보이지 않는다면, 그건 화면이 아니라 권한 문제예요. 누가 대시보드를 쓸 수 있나를 보세요.

대시보드에 들어가는 방법

주소는 서버 관리자가 알려주는 대시보드 주소 하나뿐이에요. 그 주소를 브라우저에 직접 쳐도 되고, 디스코드 안에서 링크를 받아도 됩니다.

방법	어디서
주소를 직접 입력	브라우저 (가장 확실해요)
컨트롤러 카드의 링크 버튼	재생 중인 채널의 컨트롤러 카드 두 번째 줄
대시보드 링크 명령	디스코드 명령창

NOTE

대시보드 링크를 띄우는 슬래시 명령은 /대시보드 로는 찾아지지 않아요. 명령창에 /cmd_dashboard_name 이라고 쳐야 나옵니다. 응답 문구와 버튼 라벨이 영문으로 보이지만 링크는 정상 동작하니 눌러도 돼요. 컨트롤러 카드의 링크 버튼도 같은 곳으로 갑니다.

Discord 계정으로 로그인하기

처음 들어가면 "음악봇을 웹에서 제어해요" 라고 적힌 로그인 화면이 나옵니다. 버튼은 Discord로 로그인 하나뿐이에요.

1. Discord로 로그인 을 누릅니다.
2. 디스코드 인증 화면으로 넘어가요. 연희가 요청하는 권한은 두 가지입니다.
   • 계정 기본 정보(이름·아바타)
   • 내가 가입한 서버 목록
3. 동의하면 대시보드로 돌아오고, 서버가 하나 자동으로 선택된 상태로 화면이 뜹니다.

요청하는 권한은 이 둘뿐이에요. 대시보드는 디스코드 메시지를 읽지도, 대신 글을 쓰지도 않습니다. 한 번 로그인하면 7일 동안 유지되고, 그 뒤에는 다시 로그인하라고 나와요.

NOTE

로그인 버튼이 OAuth 설정 필요 라고 회색으로 나오면 아직 로그인을 쓸 수 없는 상태입니다. 내 계정 문제가 아니니 서버 관리자에게 알려 주세요.

"사용 가능한 서버가 없어요" 가 나올 때

로그인은 됐는데 이 화면이 나오면, 연희가 들어가 있고 내 계정도 함께 있는 서버가 하나도 없다는 뜻이에요. 대시보드는 그 조건을 만족하는 서버만 목록에 올립니다.

• 봇을 아직 초대하지 않았다면 먼저 서버에 초대해야 해요.
• 방금 초대했다면 다시 확인 버튼을 눌러 목록을 새로 받아 주세요.
• 다른 계정으로 로그인했을 수도 있어요. 화면 아래에 지금 로그인한 계정 이름이 표시되니 확인해 보세요.

서버에 따라 서버 관리 권한이 있는 사람에게만 목록에 보이도록 해 둔 경우도 있습니다. 봇은 분명히 있는데 서버가 안 보인다면 서버 관리자에게 물어보세요.

가장 중요한 규칙 — 먼저 음성 채널에 들어가세요

대시보드에서 재생을 건드리려면 그 서버의 음성 채널에 실제로 들어가 있어야 해요. 그리고 봇이 이미 어느 채널에서 재생 중이라면 봇과 같은 채널에 있어야 합니다.

WARNING

봇과 다른 음성 채널에 들어가 있으면, 재생 중인데도 "대기 중" 으로 보입니다. 곡 제목도 대기열도 비어 있게 나와요. 고장이 아니라 내 채널의 재생 정보가 아니라서 감춰 둔 것이니, 봇이 있는 채널로 옮기면 몇 초 안에 화면이 채워집니다.

반대로 아무 음성 채널에도 들어가 있지 않을 때는 화면이 그대로 보입니다. 보이는 것과 조작할 수 있는 것은 별개라서, 화면은 멀쩡한데 버튼만 거절당한다면 음성 채널에 들어가 있지 않은 경우예요. 먼저 음성 채널에 들어가 주세요.

버튼을 눌렀을 때 나오는 안내 문구로도 구분할 수 있어요.

화면에 뜨는 문구	뜻
이 서버의 음성 채널에 들어가 있어야 조작할 수 있어요	음성 채널 밖입니다
봇과 같은 음성 채널에 있어야 조작할 수 있어요	봇과 다른 방에 있습니다
먼저 Discord에서 음성 채널에 들어와 주세요	곡을 넣으려는데 들어가 있는 채널이 없습니다
봇이 다른 채널에서 이미 재생 중이에요	봇을 데려오려면 디스코드에서 조작해야 합니다

서버는 어떻게 골라지나

사이드바 위쪽의 연결된 음성 채널 카드가 지금 보고 있는 서버예요. 카드를 누르면 서버 목록이 펼쳐집니다.

• 처음 들어오면 내가 음성 채널에 들어가 있는 서버가 우선 선택돼요. 그런 서버가 없으면 목록의 첫 번째가 선택됩니다.
• 목록에서 직접 고른 서버는 그대로 유지돼요. 새로고침해도 되돌아가지 않습니다.
• 내가 다른 서버의 음성 채널로 옮기면, 그때만 화면도 그 서버로 따라 옮겨 갑니다.
• 서버를 바꾸면 2~3초 정도 걸리고, 그동안 해당 줄에 "전환 중…" 이 표시돼요.

서버 목록의 각 줄에는 그 서버에서 내가 들어가 있는 채널과, 그 서버에서 음성 채널에 붙어 있는 연희 봇들이 함께 표시됩니다. 프리미엄 서버라면 서브 봇이 어느 채널에 있는지도 여기서 보여요.

첫 곡 넣기

1. 디스코드에서 음성 채널에 먼저 들어갑니다.
2. 대시보드 위쪽 검색창에 곡 제목이나 링크를 넣고 Enter 를 누릅니다. (돋보기를 눌러도 같아요.)
3. 검색 화면으로 넘어가면서 YouTube · Spotify · SoundCloud 세 개 탭에 결과가 나옵니다.
4. 원하는 곡의 행을 클릭하면 대기열에 들어가요. "대기열에 추가했어요" 라는 알림이 잠깐 뜹니다.
5. 봇이 음성 채널에 없었다면 이때 들어와서 재생을 시작합니다.

검색창은 곡을 바로 트는 곳이 아니라 검색 화면으로 이동하는 입구예요. Enter 를 눌러도 소리는 나지 않습니다. 결과 목록에서 곡을 골라야 대기열에 들어가요.

TIP

뭘 검색할지 모르겠으면 사이드바의 탐색 을 눌러 보세요. 태그별 플레이리스트 6개와 지역별 인기 목록 4개가 카드로 준비돼 있고, 카드에 들어가서 전체 재생 을 누르면 통째로 대기열에 들어갑니다.

알아 두면 편한 것들

• 대시보드와 디스코드는 같은 재생을 봅니다. 대시보드에서 스킵하면 채널의 컨트롤러 카드도 함께 바뀌고, 반대로 디스코드에서 /스킵 을 써도 대시보드 화면이 즉시 갱신돼요. 새로고침할 필요가 없습니다.
• 새 서버의 시작 볼륨은 8% 입니다. 대시보드 볼륨 슬라이더가 거의 왼쪽 끝에 붙어 있는 게 정상이에요. 들리지 않으면 슬라이더를 올려 주세요. 최대는 100입니다.
• 화면 상태는 주소에 남습니다. 어떤 화면을 보고 있었는지, 어떤 검색어였는지가 주소에 기록되므로 새로고침해도 그 자리로 돌아오고, 브라우저 뒤로가기도 화면 단위로 동작해요.
• 로그아웃 은 오른쪽 위 아바타를 눌러 나오는 메뉴 맨 아래에 있습니다.

화면이 이상할 때 먼저 볼 것

증상	확인할 것
재생 중인데 "대기 중" 으로 보인다	봇과 다른 음성 채널에 들어가 있는지
버튼을 눌러도 아무 반응이 없다	헤더에 주황색 경고 배지가 떠 있는지
버튼 아이콘이 전부 사라지고 네모만 보인다	회사·학교 네트워크에서 차단됐을 수 있어요. 다른 네트워크에서 열어 보세요
"요청이 너무 많아요" 가 뜬다	짧은 시간에 너무 자주 눌렀습니다. 잠시 기다렸다 다시 해 주세요
서버가 목록에 없다	봇 초대 여부, 로그인한 계정, 관리 권한 필요 여부

헤더의 주황색 경고 배지는 마우스를 올리면 내용이 펼쳐져요. 무엇을 뜻하는지는 대시보드 화면 둘러보기에 정리해 두었습니다.

관련 문서

• 대시보드 화면 둘러보기
• 대시보드에서 대기열 다루기
• 가사 패널과 기록 화면
• 누가 대시보드를 쓸 수 있나
• 연희 봇 시작하기