https://github.com/sigvt/masterchat

💬 Get full access to YouTube Live Chat
https://github.com/sigvt/masterchat

innertube livechat youtube youtube-chat youtube-comments youtube-livestream

Last synced: 3 months ago
JSON representation

💬 Get full access to YouTube Live Chat

• Host: GitHub
• URL: https://github.com/sigvt/masterchat
• Owner: sigvt
• License: apache-2.0
• Created: 2021-03-23T01:51:51.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2024-05-12T23:10:37.000Z (over 1 year ago)
• Last Synced: 2025-06-24T01:06:00.138Z (3 months ago)
• Topics: innertube, livechat, youtube, youtube-chat, youtube-comments, youtube-livestream
• Language: TypeScript
• Homepage: https://holodata.github.io/masterchat/
• Size: 4.23 MB
• Stars: 76
• Watchers: 4
• Forks: 20
• Open Issues: 8
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE
  • Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

README

          
# Masterchat

[![npm](https://badgen.net/npm/v/masterchat)](https://npmjs.org/package/masterchat)

[![npm: total downloads](https://badgen.net/npm/dt/masterchat)](https://npmjs.org/package/masterchat)

[![npm: publish size](https://badgen.net/packagephobia/publish/masterchat)](https://npmjs.org/package/masterchat)

[![typedoc](https://badgen.net/badge/docs/typedoc/purple)](https://holodata.github.io/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 masterchat

```

```js

import { Masterchat, stringify } from "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](https://github.com/holodata/masterchat/tree/master/MANUAL.md) for further instructions.

## CLI

```bash

npm i -g masterchat-cli

```

```bash

mc watch --org Hololive

```

See [masterchat-cli](https://github.com/holodata/masterchat-cli) for detailed usage.

## Desktop App

See [☄️Komet](https://github.com/holodata/komet) for further information.

## Community

### Contributing

- Use masterchat with `DEBUG=masterchat` and [report](https://github.com/holodata/masterchat/issues/new) logs that are prefixed with `[action required]`

- Squash [TODOs](https://github.com/holodata/masterchat/search?l=TypeScript&q=TODO)

See [Contribution Guide](./CONTRIBUTING.md) for more information.

Ask questions in `#masterchat` channel on [holodata Discord server](https://holodata.org/discord).

### Contributors ✨

Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):

  

    
uetchy
💻

    
Shiaupiau
💻

    
Jan Procházka
💻

    
sphinxrave
🐛

    
David Chen
🐛 🤔

    
Evgeniy Istomin
📖

  

This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind are welcome!

### Projects using Masterchat

- [Holodex](https://holodex.net)

- [Luna's Translation](https://github.com/luna-translations-bot/luna-translations-bot)

- [Honeybee](https://github.com/holodata/honeybee)

- [ShipID](https://github.com/holodata/ShipID)

- [Komet](https://github.com/holodata/Komet)

## Related projects

- [YouTube.js](https://github.com/LuanRT/YouTube.js)