dohun0310/discord-music-bot repository overview

⁠Discord 음악 봇 🎵

YouTube 음원을 디스코드 음성 채널에서 재생하는 한국어 슬래시 명령 기반 음악 봇입니다. yt-dlp + ffmpeg 기반이며, ffmpeg가 이미지에 포함되어 있어 추가 설치가 필요 없습니다.

• 베이스 이미지: python:3.14-slim
• 진입점: python -m app

⁠빠른 시작

docker run -d \
  --name discord-music-bot \
  -e BOT_TOKEN='여기에-디스코드-봇-토큰' \
  --restart unless-stopped \
  dohun0310/discord-music-bot

docker-compose.yml 예시:

services:
  bot:
    image: dohun0310/discord-music-bot:latest
    environment:
      BOT_TOKEN: "여기에-디스코드-봇-토큰"
      LOG_LEVEL: "INFO"
    restart: unless-stopped

⁠지원 태그 / 아키텍처

⁠환경 변수

⁠디스코드 봇 준비

1. Discord Developer Portal⁠에서 애플리케이션·봇 생성 후 토큰을 발급합니다.
2. Privileged Gateway Intents에서 MESSAGE CONTENT INTENT를 활성화합니다. (봇은 message_content · guilds · voice_states 인텐트를 사용합니다.)
3. 봇 초대 시 다음 권한을 부여합니다: 채널 보기, 메시지 보내기, 연결(Connect), 말하기(Speak).
4. 슬래시 명령은 봇이 시작될 때 자동으로 동기화됩니다. (반영까지 잠시 걸릴 수 있습니다.)

⁠명령어

⁠동작 특징

• 플레이리스트 lazy loading: 긴 플레이리스트는 배치 단위로 미리 로드합니다.
• 자동 퇴장: 대기열이 5분간 비어 있거나, 음성 채널에 봇만 남으면 약 60초 후 연결을 종료합니다.
• 반복 / 셔플 / 볼륨(0–200%) 지원, 볼륨은 재생 직전 적용됩니다.

⁠빌드 / 소스

# 로컬에서 직접 빌드
docker build -t discord-music-bot .

• 소스 저장소: https://github.com/dohun0310/Discord-Music-Bot⁠
• 멀티 아키텍처 빌드 및 배포는 Jenkinsfile(Docker Buildx)로 자동화되어 있습니다.

⁠문의 / 기여

문제나 버그는 소스 저장소의 이슈로 등록해 주세요. 기여를 원하시면 포크 후 Pull Request를 보내주시면 됩니다.