twitch_irc

Twitch chat client for Deno

import * as TwitchIrc from "https://deno.land/x/twitch_irc/mod.ts";

const channel = /*...*/;
const nick = /*...*/;
const pass = /*...*/;

const client = new TwitchIrc.Client({
  credentials: { nick, pass }
});
client.on("privmsg", ({ user, message }) => {
  console.log(`${user.login}: ${message}`);
});
client.on("open", () => {
  client.join(channel);
});

Features

• Connection management
  • Authentication
  • Automatic reconnect
  • Automatic keep-alive
• Correct message parsing¹
• Same message bypass for PRIVMSG
• Auto-complete tag names
• Latency measurement
• Strong type safety²
• Rate limiting

Examples

Specify the --inspect-brk flag to inspect any of the examples using developer tools. For example, for Chrome it’s chrome://inspect -> Open dedicated DevTools for Node. The client is available on the window object as window.client.

Simple chat logging (anonymous)

Requires the CHANNEL environment variable to be specified in the format #<name>, e.g. #jtv.

$ deno run \
  --allow-env=CHANNEL \
  --allow-net=irc-ws.chat.twitch.tv \
  https://deno.land/x/twitch_irc/examples/logs.ts

Simple bot

Requires three environment variables:

• CHANNEL in the format #<name>, e.g. #jtv.
• TOKEN in the format oauth:<token>, e.g. oauth:abcdefg0123456789. You can generate one here.
• LOGIN, which is the username of the account you used to generate TOKEN.

The bot will join CHANNEL upon connecting, and you can type !ping in command to have it respond to you. It will also join its own channel.

$ deno run \
  --allow-env=CHANNEL,LOGIN,TOKEN \
  --allow-net=irc-ws.chat.twitch.tv \
  https://deno.land/x/twitch_irc/examples/bot.ts