@hitomaru/masterchat

Masterchat

Masterchat is the most powerful library for YouTube Live Chat, supporting parsing 20+ actions, video comments and transcripts, as well as sending messages and moderating chats.

Install

npm install @hitomaru/masterchat

import { Masterchat, stringify } from "@hitomaru/masterchat";

const mc = await Masterchat.init("oyxvhJW1Cf8");

const chats = mc.iter().filter((action) => action.type === "addChatItemAction");

for await (const chat of chats) {
  console.log(`${chat.authorName}: ${stringify(chat.message)}`);
}

See MANUAL for further instructions.

CLI

npm i -g masterchat-cli

mc watch --org Hololive

See masterchat-cli for detailed usage.

Desktop App

See ☄️Komet for further information.

Community

Contributing

• Use masterchat with DEBUG=masterchat and report logs that are prefixed with [action required]
• Squash TODOs

See Contribution Guide for more information. Ask questions in #masterchat channel on holodata Discord server.

Contributors ✨

Thanks goes to these wonderful people (emoji key):

uetchy 💻

Shiaupiau 💻

Jan Procházka 💻

sphinxrave 🐛

David Chen 🐛 🤔

Evgeniy Istomin 📖

This project follows the all-contributors specification. Contributions of any kind are welcome!

Projects using Masterchat

• Holodex
• Luna's Translation
• Honeybee
• ShipID
• Komet

Related projects

• YouTube.js

Changelog

v1.3.0

New

• Add ErrorAction, UnknownAction
• Add BotError

Improvements

• Update from stu43005/masterchat
  • Commit: 5e30cf71ee0c9b7739e59cdcf92402f7794b7ee5
  • addBannerToLiveChatCommand
  • addChatItemAction
• #1 Updated version of timeoutParams() (@FlashlightXi)
• Update interfaces
  • YTAnyText
  • YTPlayabilityStatus
• MembersOnlyError should have additional data
• parseMetadataFromWatch should handle more edge cases
  • Chat can be available even when playabilityStatus not exist
  • MembersOnly chat should be available when stream ended