SNTalkBot — ดาวน์โหลดและคู่มือ

ดาวน์โหลด

รุ่นปัจจุบัน: 2026.08.23-r5

ดาวน์โหลด SNTalkBot ZIP รุ่นล่าสุด

SHA-256: 104f0b1d9879207d7b6687f5643e7d61cab93df36a6aea1efd262221fdf25fa9

Docker image: nuttawat0295/sntalkbot:latest

คู่มือผู้ใช้ฉบับเต็ม (Markdown) | รายการคำสั่ง 119 คำสั่ง (Markdown)

ฟีเจอร์เด่น

3 โหมด

Full Bot — Player + Server Management
Player Bot — เพลง/คิว/TTS Player เท่านั้น
Server Manager — จัดการ TeamTalk/TTS/ผู้ใช้ โดยไม่มี Music Player

Player

YouTube, YouTube Music, URL/stream, playlist/channel
Queue, favorites, autoplay, history, M1/M2/M3, seek, speed, volume และ filters
Google standard gTTS ไม่ต้องใช้ Cloud API key และ Microsoft Edge TTS เป็นตัวเลือก
TTS ประกาศเพลงพูดทีละข้อความด้วย FIFO และเป็น stream แยก ไม่ลดเสียงเพลง
yt-dlp download/cache และอัปโหลดเสียงเข้า TeamTalk

Server Manager

จัดการผู้ใช้ ห้อง kick/ban/timed actions และ jail
ข้อความประกาศ, private/offline messaging, welcome, filter และ VPN/proxy tools
TTS, translation, weather, account request และเครื่องมือผู้ดูแล

การเข้าถึง

ไม่มี GUI ในรุ่น Linux/Docker คำสั่ง TeamTalk ทุกคำสั่งขึ้นต้นด้วย / และ /help ส่งหนึ่งคำสั่งต่อหนึ่งข้อความเพื่อหลีกเลี่ยงการตัดข้อความและเหมาะกับโปรแกรมอ่านหน้าจอ

รายงานบั๊กถึงผู้พัฒนา

/dr <ข้อความ> ส่งรายงานไปยังระบบทางการ https://report.nuttawat.ddnsfree.com/api/report โดยไม่ต้องมี Telegram token ใน image ของผู้ใช้ คำสั่งนี้ทำงานเฉพาะเมื่อผู้ใช้เรียกเอง

ติดตั้งและใช้งาน

วิธีที่แนะนำ: TTUHelper

git clone https://github.com/nuttawat-arch/ttuhelper.git
cd ttuhelper
chmod +x install.sh ttuhelper.sh
sudo ./install.sh
sudo ttuhelper doctor
sudo ttuhelper new
sudo ttuhelper run <ชื่อบอต>

เลือกโหมด 1 Full, 2 Player หรือ 3 Server Manager ตอน ttuhelper new

sudo ttuhelper ls
sudo ttuhelper ps
sudo ttuhelper logs <ชื่อบอต>
sudo ttuhelper edit <ชื่อบอต>
sudo ttuhelper restart <ชื่อบอต>
sudo ttuhelper update

ใช้ Docker image โดยตรง

docker pull nuttawat0295/sntalkbot:latest
sudo mkdir -p /opt/sntalkbot/mybot
docker run --rm --entrypoint cat nuttawat0295/sntalkbot:latest /app/config_default.ini | sudo tee /opt/sntalkbot/mybot/config.ini >/dev/null
sudo touch /opt/sntalkbot/mybot/cookies.txt
sudo chown -R 10001:10001 /opt/sntalkbot/mybot
sudo nano /opt/sntalkbot/mybot/config.ini

docker run -d \
  --name sntalkbot-mybot \
  --network host \
  --restart unless-stopped \
  -v /opt/sntalkbot/mybot:/app/data \
  -e TTUTIL_CONFIG=/app/data/config.ini \
  -e TTUTIL_DATA_DIR=/app/data \
  -e TTUTIL_PULSE_SINK=ttu_mybot \
  -e TTUTIL_MPV_AO=pulse \
  nuttawat0295/sntalkbot:latest

ถ้ารันหลาย container ให้ใช้ชื่อ container, data directory และ TTUTIL_PULSE_SINK คนละชื่อ

อัปเดต

TTUHelper: sudo ttuhelper update — config และ data directory เดิมถูกเก็บไว้

Docker ตรง: pull image ใหม่, ลบ/recreate container และ mount data directory เดิม

คำสั่ง TeamTalk ทั้งหมด

รายการด้านล่างสร้างจาก command catalog ของ release นี้โดยตรง รวม 119 คำสั่ง ไม่มีชื่อซ้ำ

คำสั่งทั่วไป — ใช้ได้ทุกโหมด (7 คำสั่ง)

/about: แสดงเวอร์ชันของบอตและข้อมูลสภาพแวดล้อมที่กำลังทำงาน
/admins: ดูรายชื่อผู้ดูแลที่ออนไลน์อยู่
/dr <message>: ส่งรายงานปัญหาโดยตรงถึงผู้พัฒนา SNTalkBot ผ่านระบบรายงานทางการ ไม่ต้องตั้ง Telegram token ในบอต
/gcid [channel path]: แสดง Channel ID ของ TeamTalk สำหรับห้องปัจจุบันหรือพาธห้องที่ระบุ
/help [command]: แสดงรายการคำสั่ง โดยส่งหนึ่งคำสั่งต่อหนึ่งข้อความ TeamTalk ใช้: /help หรือ /help คำสั่ง
/myinfo: แสดงข้อมูลบัญชี/เซสชัน TeamTalk ของคุณ
/search: ค้นหา Wikipedia และรับบทสรุป วิธีใช้: /search <คำค้นหา>

คำสั่ง Player (47 คำสั่ง)

/+: เดินหน้า 10 วินาที
/,: เลือกผลการค้นหาก่อนหน้าสำหรับรายการค้นหาล่าสุดที่เพิ่มเข้าคิว
/-: ย้อนกลับ 10 วินาที
/.: เลือกผลการค้นหาถัดไปสำหรับรายการค้นหาล่าสุดที่เพิ่มเข้าคิว
/3d on|off: เปิดหรือปิดฟิลเตอร์ขยายมิติสเตอริโอ/3D ชุดที่ 1
/3d2 on|off: เปิดหรือปิดฟิลเตอร์สเตอริโอ/เอคโคชุดที่ 2
/autoplay on|off: เปิดหรือปิดการเล่นรายการถัดไปอัตโนมัติจากผลค้นหา เพลย์ลิสต์ ช่อง หรือรายการโปรดที่กำลังใช้งาน
/b: เล่นเพลงก่อนหน้า
/bass on|off: เปิดหรือปิดการเพิ่มเสียงเบสสำหรับการเล่นเพลง
/channel: ขณะเล่นวิดีโอ ให้โหลดช่องของวิดีโอปัจจุบันและเล่นวิดีโอแรกของช่อง
/cq: ล้างคิวทั้งหมด
/d: แสดงเวลาทั้งหมด เวลาที่เล่นไป และเวลาที่เหลือของเพลงปัจจุบัน
/delfav: ล้างรายการโปรด
/dl <link>: ดาวน์โหลดเสียงด้วย yt-dlp แล้วอัปโหลดไปยังห้อง TeamTalk ปัจจุบัน
/dq <index>: ลบรายการในคิวตามลำดับ
/f: เปิดหรือปิดเอฟเฟกต์เฟดของเครื่องเล่น
/fav: บันทึกเพลงปัจจุบันลงรายการโปรด
/favorites: แสดงเพลงโปรดที่บันทึกไว้ โดยส่งหนึ่งเพลงต่อหนึ่งข้อความ
/hide: เปิดหรือปิดการซ่อนชื่อเพลงที่กำลังเล่นจากสถานะของบอท
/l: ดู URL ของเพลงที่กำลังเล่น
/m: แสดงโหมด TT Player ที่ใช้อยู่ในขณะนี้
/m1: ตั้งโหมด M1 Single: หยุดหลังรายการปัจจุบันเมื่อไม่ได้เล่นจากคิว
/m2: ตั้งโหมด M2 Auto/Next: เล่นรายการถัดไปโดยอัตโนมัติ
/m3: ตั้งโหมด M3 Repeat: เล่นเพลงปัจจุบันซ้ำเมื่อไม่ได้เล่นจากคิว
/n: เล่นเพลงถัดไป
/p <query>: ค้นหาและเล่นหรือเพิ่มสื่อจาก YouTube เข้าคิว
/pg: แสดงข้อมูลและความคืบหน้าของเพลงปัจจุบัน
/playfav: เล่นหรือเพิ่มเพลงโปรดทั้งหมดเข้าคิว
/pm <query>: ค้นหาและเล่นหรือเพิ่มเพลงจาก YouTube Music เข้าคิว
/ptts [on|off|status]: สำหรับผู้ดูแล: เปิด/ปิดหรือดูสถานะ TTS ประกาศเพลงและคิวของ Player; ใช้ tracks หรือ queue เพื่อแยกควบคุมได้
/pttsmode microsoft|google: สำหรับผู้ดูแล: เลือก Microsoft Edge TTS หรือ Google standard gTTS แบบไม่ใช้ API key สำหรับเสียงประกาศ Player
/pttsrate <-100..100>: สำหรับผู้ดูแล: ตั้งอัตราความเร็วเสียงประกาศ Player เมื่อใช้ Microsoft
/pttsspeed <0.25..4.0>: สำหรับผู้ดูแล: ตั้งความเร็วเสียงประกาศ Player เมื่อใช้ Google standard gTTS
/pvoice <voice_or_language>: สำหรับผู้ดูแล: Microsoft ใช้ชื่อเสียง; Google standard ใช้รหัสภาษา เช่น th
/pvoices [langcode]: โหมด Microsoft แสดงรายชื่อเสียง; โหมด Google standard แสดงภาษาที่ gTTS รองรับ
/q on|off: เปิดหรือปิดระบบคิว
/qc: ตรวจสอบตำแหน่งปัจจุบันในคิว
/ql: แสดงรายการในคิวปัจจุบัน
/r: แสดงเพลงที่เล่นล่าสุด
/s: หยุดเล่นและล้างคิว
/select <index>: เลือกและเล่นรายการตามลำดับจากผลการค้นหาหรือรายการที่กำลังใช้งาน
/shuffle: สุ่มเฉพาะเพลงในคิวที่ยังไม่ได้เล่น
/sp <speed>: ตั้งค่าความเร็วในการเล่นเพลง
/t <time>: เลื่อนไปยังเวลาที่ระบุ เช่น 1:30
/u <link>: เล่นหรือเพิ่มสื่อจาก URL เข้าคิว
/v <volume>: ตั้งระดับเสียงเครื่องเล่นได้ไม่เกินค่าสูงสุดที่กำหนดไว้
/x: พักหรือเล่นต่อ

คำสั่ง Server Manager / Full (65 คำสั่ง)

/account: เริ่มขั้นตอนขอสร้างบัญชีผ่านข้อความส่วนตัว
/accounts on|off: สำหรับผู้ดูแลเท่านั้น: เปิดหรือปิดระบบขอสร้างบัญชี
/blockcmd [+|-]<command>: สำหรับผู้ดูแลเท่านั้น: บล็อกหรือยกเลิกการบล็อกคำสั่งสำหรับผู้ใช้ทั่วไป หากไม่ระบุคำสั่งจะแสดงรายการคำสั่งที่ถูกบล็อก
/bm message: สำหรับผู้ดูแลเท่านั้น: ส่งข้อความประกาศไปยังเซิร์ฟเวอร์
/bot <message>: เฉพาะผู้ดูแล: ส่งข้อความประกาศของบอทตามขอบเขตการประกาศที่ตั้งค่าไว้
/cc: เฉพาะผู้ดูแล: ล้างไฟล์ดาวน์โหลด/แคชสื่อ
/cg mode: สำหรับผู้ดูแลเท่านั้น: เปลี่ยนเพศของบอท โหมดที่ใช้ได้: m สำหรับชาย, f สำหรับหญิง, n สำหรับเพศกลาง
/clear argument: สำหรับผู้ดูแลเท่านั้น: ล้างการแบนหรือเตะตามระยะเวลาสำหรับผู้ใช้ที่ระบุ หากส่งโดยไม่มีอาร์กิวเมนต์: จะล้างการแบนและเตะตามระยะเวลาทั้งหมด
/clearlog: เฉพาะผู้ดูแล: ล้างไฟล์ข้อผิดพลาด/บันทึกของบอท
/cm: เฉพาะผู้ดูแล: เปิดหรือปิดข้อความแจ้งการทำงานของเครื่องเล่นในห้อง TeamTalk
/cn <new name: สำหรับผู้ดูแลเท่านั้น: เปลี่ยนชื่อของบอท
/cs <status>: สำหรับผู้ดูแลเท่านั้น: เปลี่ยนข้อความสถานะ
/csize: เฉพาะผู้ดูแล: แสดงขนาดแคชสื่อ
/db name duration: สำหรับผู้ดูแลเท่านั้น: แบนใครบางคนด้วยที่อยู่ IP ตามระยะเวลาที่กำหนด
/dk name duration: สำหรับผู้ดูแลเท่านั้น: เตะใครบางคนตามระยะเวลาที่กำหนด
/exec: สำหรับผู้ดูแลเท่านั้น. รันคำสั่งบนเซิร์ฟเวอร์ผ่าน SSH (ต้องได้รับอนุญาต) วิธีใช้: /exec [คำสั่ง]
/filter: เฉพาะผู้ดูแล: เปิดหรือปิดตัวกรองคำไม่เหมาะสม/บัญชีดำ
/get_voices langcode: โหมด Microsoft แสดงรายชื่อเสียง; โหมด Google standard แสดงภาษาที่ gTTS รองรับ
/jail <name>: สำหรับผู้ดูแลหรือผู้ได้รับอนุญาต: เพิ่ม username ในรายชื่อห้องขังและย้ายผู้ใช้นั้นไปห้องขัง โดยใช้ username ไม่ใช่ nickname
/jails: สำหรับผู้ดูแลเท่านั้น: ดูรายชื่อผู้ใช้ที่อยู่ในห้องขัง
/join <channel>: เฉพาะผู้ดูแล: ย้ายบอทไปยังห้องที่ระบุ
/k <nickname>: เฉพาะผู้ดูแล: เตะผู้ใช้ออกจากห้องปัจจุบัน
/ks <nickname>: เฉพาะผู้ดูแล: เตะผู้ใช้ออกจากเซิร์ฟเวอร์
/language <code>: สำหรับผู้ดูแลเท่านั้น: บันทึกรหัสภาษาของบอต แล้วรีสตาร์ตบอตเพื่อโหลดทุกโมดูลด้วยภาษาใหม่
/ld: เปิดหรือปิดการตรวจจับภาษา
/lock: สำหรับผู้ดูแลเท่านั้น: สลับการล็อกคำสั่งให้เฉพาะผู้ดูแลใช้ได้
/messages: แสดงข้อความออฟไลน์ที่คุณส่งไว้และยังรอส่งถึงผู้รับ
/moveall <channel>: เฉพาะผู้ดูแล: ย้ายผู้ใช้ไปยังห้องที่ระบุ
/msg <username> <message>: ส่งข้อความส่วนตัวถึงผู้ใช้
/new <username> <password> [rights]: เฉพาะผู้ดูแล: สร้างบัญชีผู้ใช้ TeamTalk
/noname: เฉพาะผู้ดูแล: เปิดหรือปิดการจัดการผู้ใช้ที่ใช้ชื่อ NoName โดยอัตโนมัติ
/notify <nickname> <telegram_chat_id>: ส่งการแจ้งเตือนทาง Telegram เมื่อชื่อเล่นที่ระบุเข้าสู่ระบบ
/pitch value: ตั้ง Pitch ของเสียง (เฉพาะโหมด Microsoft) ค่า -100 ถึง 100
/private <name>: ย้ายคุณกับผู้ใช้อีกคนไปยังห้องส่วนตัวที่ซ่อนและจำกัด 2 คน ห้องจะถูกลบเมื่อผู้ใช้ทั้งสองออกจากเซิร์ฟเวอร์
/pt: เปิดหรือปิดโหมดแปลส่วนตัว วิธีใช้: /pt <ภาษาต้นทาง> <ภาษาเป้าหมาย>
/rate value: ตั้งอัตราความเร็วเสียง (เฉพาะโหมด Microsoft) ค่า -100 ถึง 100
/rb on|off: สำหรับผู้ดูแลเท่านั้น: เปิดหรือปิดประกาศสุ่มด้วย TTS; โหมด Google ใช้ gTTS มาตรฐาน
/reboot: สำหรับผู้ดูแลเท่านั้น. รีบูตเซิร์ฟเวอร์ (ต้องได้รับอนุญาต)
/report <message>: ส่งคำขอความช่วยเหลือหรือรายงานปัญหาไปยังผู้ดูแลที่ออนไลน์
/restart: เฉพาะผู้ดูแล: รีสตาร์ตบอทผ่านลูปตัวเรียกหลักโดยไม่ต้องเปิดโปรแกรมใหม่ด้วยตนเอง
/save: สำหรับผู้ดูแลเท่านั้น: บันทึกการตั้งค่าในกรณีที่คุณเปลี่ยนชื่อบอทและต้องการบันทึก
/say: ให้บอทพูดข้อความที่กำหนด วิธีใช้: /say <ข้อความ>
/sbot <message>: เฉพาะผู้ดูแล: ส่งข้อความประกาศทั่วเซิร์ฟเวอร์
/shutdown: เฉพาะผู้ดูแล: ปิดบอทอย่างถูกต้องและปลอดภัย
/speed value: ตั้งความเร็วเสียง (เฉพาะโหมด Google TTS) ค่า 0.25 ถึง 4.0
/st: สำหรับผู้ดูแลเท่านั้น: หยุดเสียงพูดที่กำลังเล่น
/superbot <message>: เฉพาะผู้ดูแล: ส่งข้อความประกาศระดับโฮสต์/ทั่วระบบเมื่อเซิร์ฟเวอร์รองรับ
/tr: เปิดหรือปิดการแปลข้อความในห้องอัตโนมัติ วิธีใช้: /tr <source_lang> <target_lang>
/tts on|off: สำหรับผู้ดูแลเท่านั้น: เปิดหรือปิด TTS สำหรับทุกคน
/ttsmode microsoft|google: สลับโหมด TTS ระหว่าง Microsoft Edge TTS และ Google standard gTTS แบบไม่ใช้ API key
/udb name duration: สำหรับผู้ดูแลเท่านั้น: แบนชื่อผู้ใช้ตามระยะเวลาที่กำหนด
/udk <username> <duration>: เฉพาะผู้ดูแล: เตะชื่อผู้ใช้ TeamTalk ออกตามระยะเวลาที่กำหนด
/unjail <name>: สำหรับผู้ดูแลเท่านั้น. สำหรับผู้ใช้ที่ได้รับอนุญาต ลบใครบางคนออกจากรายชื่อห้องขังและย้ายพวกเขากลับไปยังช่องหลัก
/unotify <username> <telegram_chat_id>: ส่งการแจ้งเตือนทาง Telegram เมื่อชื่อผู้ใช้ที่ระบุเข้าสู่ระบบ
/users: แสดงผู้ใช้ที่เชื่อมต่ออยู่ พร้อมประเภทบัญชี ตำแหน่งโดยประมาณ และสถานะ
/voice voiceOrLanguage: โหมด Microsoft ใช้ชื่อเสียง; โหมด Google standard ใช้รหัสภาษา เช่น th
/voicetx on|off: สำหรับผู้ดูแลเท่านั้น: เปิดหรือปิดการส่งเสียงของ TeamTalk ด้วยตนเอง
/volume value: ตั้งระดับเสียงพูด (เฉพาะโหมด Microsoft) ค่า 0.1 ถึง 1.0
/vpn: เฉพาะผู้ดูแล: เปิดหรือปิดการตรวจจับ VPN/พร็อกซี
/weather: รับสภาพอากาศปัจจุบันสำหรับตำแหน่งของคุณหรือผู้ใช้ที่ระบุ วิธีใช้: /weather [ชื่อเล่น (ไม่บังคับ)]
/welcome: เฉพาะผู้ดูแล: เปิดหรือปิดข้อความต้อนรับแบบคงที่เมื่อผู้ใช้เข้าห้องของบอต
/welcomebroadcast [on|off|status]: เฉพาะผู้ดูแล: เปิด ปิด หรือดูสถานะประกาศต้อนรับแบบสุ่มเมื่อผู้ใช้เข้าสู่ระบบ ค่าจะถูกบันทึกลง config.ini; ถ้าไม่ใส่อาร์กิวเมนต์จะสลับสถานะทันที
/who: แสดงจำนวนผู้ใช้ที่ตรวจพบว่ามาจากประเทศเดียวกับคุณ
/whoall: แสดงจำนวนผู้ใช้ในเซิร์ฟเวอร์แยกตามประเทศจากข้อมูลที่ตรวจพบ
/wt <source_lang> <target_lang>: เปิดโหมดแปลแบบกระซิบ: แปลข้อความในห้อง/ข้อความประกาศ แล้วส่งคำแปลมาให้คุณทางข้อความส่วนตัว

ลิงก์ทางการ

หมายเหตุ

TeamTalk SDK มีเงื่อนไขสิทธิ์การใช้งานของผู้ผลิต TeamTalk แยกจาก SNTalkBot ผู้ใช้งานควรตรวจสอบสิทธิ์ที่เหมาะกับการใช้งานของตน