Discord 서버의 음성 채널에서 텍스트 메시지를 읽어주는 TTS 봇입니다.
- 수동 제어:
/ttsstart명령어로 봇을 음성 채널에 초대하고,/ttsstop으로 퇴장시킵니다. - 음성 채널 전용: 봇과 같은 음성 채널에 있는 사용자의 메시지만 읽어줍니다.
- 자동 퇴장: 음성 채널에 혼자 남으면 자동으로 퇴장합니다.
- 다중 목소리: 사용자별로 음성 프로필을 설정할 수 있습니다 (
/voice명령어). Microsoft Edge 읽어주기(edge-tts) 신경망 음성을 사용하며, 여성 5종 / 남성 5종의 실제 성우 목소리를 제공합니다. API 키나 과금 설정이 필요 없습니다. - 스마트 필터링: 멘션, 링크 등을 자연스럽게 변환하여 읽습니다.
- 다국어 지원: 한국어, 영어 등 설정된 언어로 읽어줍니다.
/play url:<YouTube 주소>: 봇이 내가 있는 음성 채널에 들어와 재생합니다. 누가 이미 틀고 있으면 대기열 뒤에 추가되고, 대기열이 다 끝나면 봇이 바로 나갑니다./스킵: 다음 곡으로 넘어갑니다./stop: 대기열을 비우고 나갑니다./대기열: 목록을 봅니다.- TTS와 따로 씁니다. TTS가 켜져 있으면
/play가, 음악이 재생 중이면/ttsstart가 거절됩니다. (음악 중에 TTS가 끼어들어 끊기지 않도록) 음악 중에는 채팅을 읽지 않습니다. - 볼륨: 기본 70%로 재생합니다.
.env의MUSIC_VOLUME(0~1)으로 바꿀 수 있습니다. - 음질: YouTube에서 가장 좋은 오디오(보통 Opus 130~160kbps)를 받아, 볼륨을 적용한 뒤 128kbps Opus로 보냅니다. 음성 채널의 비트레이트 설정(기본 64kbps, 서버 부스트 시 최대 384kbps)도 올려두면 좋습니다.
youtu.be,shorts,music.youtube.com주소도 됩니다. 재생목록과 라이브 방송은 지원하지 않습니다.
- Node.js 16.9 이상
- FFmpeg (시스템에 설치되어 있거나
ffmpeg-static패키지 사용) - Discord Bot Token
- yt-dlp (음악 재생용). 단일 실행 파일
yt-dlp_linux를 권장합니다. YouTube가 자주 바뀌므로yt-dlp -U로 수시로 업데이트해야 합니다.
git clone https://github.com/SuperWonjune/wonjunbot.git
cd wonjunbot
npm install.env 파일을 생성하고 다음 내용을 입력하세요:
TOKEN=your_bot_token
TTS_VOICE_CHANNEL_IDS=123456789,987654321
TTS_LANG=ko봇을 서버에 초대할 때 다음 권한이 반드시 필요합니다.
-
OAuth2 URL Generator에서 체크:
- SCOPES:
botapplications.commands(Slash Command 사용을 위해 필수)
- BOT PERMISSIONS:
Send Messages(메시지 보내기)Read Message History(메시지 기록 보기)Connect(음성 채널 접속)Speak(음성 말하기)Use Voice Activity(음성 활동 감지)
- SCOPES:
-
Privileged Gateway Intents (개발자 포털 -> Bot 탭):
Message Content Intent활성화 (채팅 내용을 읽기 위해 필수)Server Members Intent활성화 (음성 채널 멤버 확인을 위해 필수)
npm start
# 또는
pm2 start index.js --name wonjunbot봇의 로직을 Discord 없이 검증하려면:
npm test- 음성 채널에 입장합니다.
- 채팅창에서
/ttsstart를 입력합니다. - 봇이 음성 채널에 입장하면, 채팅을 입력하면 읽어줍니다.
- 종료하려면
/ttsstop을 입력합니다.
/voice [프로필번호]: 자신의 음성 프로필을 변경합니다 (0~9).- 목록은 config/voiceProfiles.js에서 정의합니다.
Edge가 무료로 제공하는 한국어 전용 음성은 선희(여성)·인준(남성)·현수(남성) 3종뿐이라,
선택지를 늘리기 위해 한국어를 읽을 수 있는 다국어 음성을 함께 사용합니다.
교체 가능한 후보 전체 목록은 해당 파일 상단 주석에 정리되어 있고,
voice값만 바꾸면 됩니다. 같은 음성에pitch/rate를 주면 변형 프로필도 만들 수 있습니다.
- TTS는 같은 음성 채널에 있는 사용자의 메시지만 읽습니다. 다른 채널이나 음성 채널 밖에서 보낸 메시지는 무시됩니다.
- 음성 채널 정원이 가득 차 있으면 봇이 입장할 수 없습니다. 봇에게
Move Members권한을 주면 정원과 무관하게 입장할 수 있습니다. - Slash Command 자동완성이 안 뜬다면, 봇을 추방 후
applications.commands권한을 체크하여 다시 초대해주세요. - 메시지는 200자까지만 읽습니다 (음성 채널 장시간 점유 방지).
npm test: 시뮬레이션 테스트 실행tests/디렉토리에서 명령어 및 메시지 핸들링 로직을 검증할 수 있습니다.
ISC