yt-chat-stream

Retrieve YouTube Live Chat Messages

YouTube Live Chat is a package that allows you to search for live chat messages, and you can access and display the content of conversations that occurred during the broadcast. This function is essential for moderating chat, answering questions and integrating live chat interactions into external applications, carried out through the YouTube API.

☢ You will need to take full responsibility for your action ☢

Getting started

1. Install
   • npm i yt-chat-stream
   • yarn add yt-chat-stream
2. Import
   • Javascript

   const { YoutubeLiveChat } = require("yt-chat-stream")

   • Typescript

   import { YoutubeLiveChat } from "yt-chat-stream"

3. Create instance with ChannelID or LiveID

   // If channelId is specified, liveId in the current stream is automatically acquired.
   // Recommended
   const liveChat = new LiveChat({channelId: "CHANNEL_ID_HERE"})
   
   // Or specify LiveID in Stream manually.
   const liveChat = new LiveChat({liveId: "LIVE_ID_HERE"})

4. Add events

   // Emit at start of observation chat.
   // liveId: string
   liveChat.on("start", (liveId) => {
     /* Your code here! */
   })
   
   // Emit at end of observation chat.
   // reason: string?
   liveChat.on("end", (reason) => {
     /* Your code here! */
   })
   
   // Emit at receive chat.
   // chat: ChatMessage
   liveChat.on("chat", (ChatMessage) => {
     /* Your code here! */
   })
   
   // Emit when an error occurs
   // err: Error or any
   liveChat.on("error", (err) => {
     /* Your code here! */
   })

5. Start

   // Start fetch loop
   const ok = await liveChat.start()
   if (!ok) {
     console.log("Failed to start, check emitted error")
   }

6. Stop loop

   liveChat.stop()

Types

ChatMessage

interface ChatMessage {
   author: {
      name: string
      thumbnail?: ImageItem
      channelId: string
      badge?: {
         thumbnail: ImageItem
         label: string
      }
   }
   message: MessageItem[]
   superchat?: {
      amount: string
      color: string
      sticker?: ImageItem
   }
   isMembership: boolean
   isVerified: boolean
   isOwner: boolean
   isModerator: boolean
   timestamp: Date
}

MessageItem

type MessageItem = { text: string } | EmojiItem

ImageItem

interface ImageItem {
  url: string
  alt: string
}

EmojiItem

interface EmojiItem extends ImageItem {
  emojiText: string
  isCustomEmoji: boolean
}

References

• https://github.com/LinaTsukusu/youtube-chat

Thank you!👍