https://github.com/twitch-js/twitch-js
[DEPRECATED] A community-centric, community-supported version of tmi.js
https://github.com/twitch-js/twitch-js
api bot broadcast deprecated javascript message messaging stream tmi twitch typescript websocket ws
Last synced: 10 months ago
JSON representation
[DEPRECATED] A community-centric, community-supported version of tmi.js
- Host: GitHub
- URL: https://github.com/twitch-js/twitch-js
- Owner: twitch-js
- License: mit
- Archived: true
- Created: 2017-12-09T08:09:20.000Z (about 8 years ago)
- Default Branch: next
- Last Pushed: 2025-01-25T16:06:09.000Z (about 1 year ago)
- Last Synced: 2025-05-09T02:41:37.276Z (10 months ago)
- Topics: api, bot, broadcast, deprecated, javascript, message, messaging, stream, tmi, twitch, typescript, websocket, ws
- Language: TypeScript
- Homepage: https://twitch-js.netlify.com
- Size: 4.47 MB
- Stars: 347
- Watchers: 12
- Forks: 40
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
- awesome-twitch-dev - twitch-js/twitch-js - A community-centric, community-supported version of tmi.js (Libraries / JavaScript (Node.js))
README
# [DEPRECATED] [TwitchJS](https://twitch-js.netlify.com/)
[](http://unmaintained.tech/)
[](https://codecov.io/gh/twitch-js/twitch-js/branch/next)
[](https://www.npmjs.com/package/twitch-js)
[](https://www.npmjs.com/package/twitch-js)
[](https://github.com/twitch-js/twitch-js/issues)
[](https://github.com/twitch-js/twitch-js/issues?q=is%3Aopen+is%3Aissue+label%3Abug)
A community-centric, community-supported Twitch JavaScript SDK.
## Features
- Aligns with official
[Twitch IRC documentation](https://dev.twitch.tv/docs/irc/)
- Forward-compatible, low-level, minimally-assertive architecture
- Supports Node environments
- Supports Browsers
- Supports TypeScript
- Connect to multiple channels
- Chat commands
- Rate limiter
### In progress...
Here are the
[planned features](https://github.com/twitch-js/twitch-js/milestones). If you
feel something is missing, create an issue or submit a PR against the next
branch.
## Documentation
1. [Getting started](#getting-started)
2. [Authentication](#authentication)
3. [Examples](#examples)
4. [Interacting with Twitch chat](https://twitch-js.netlify.com/classes/chat.html)
5. [Making requests to Twitch API](https://twitch-js.netlify.com/classes/api.html)
6. [Reference](https://twitch-js.netlify.com/globals.html)
## Getting started
### Module bundler (CJS/ESM)
If you are using a module bundler, such as [Webpack](https://webpack.js.org/),
[Browserify](http://browserify.org/), or a in a Node environment:
1. Add TwitchJS to your project:
```bash
npm install --save twitch-js
```
2. Import TwitchJS
```js
// ES2015 syntax
import TwitchJs from 'twitch-js'
// OR ES5 syntax
var TwitchJs = require('twitch-js')
const twitchJs = new TwitchJs({ username, token })
```
### Browser (IIFE)
If you are not using a module bundler, precompiled builds are available in the
[`dist` folder](https://unpkg.com/twitch-js@>2.0.0-beta/dist/):
1. Include a script tag in your HTML:
```html
```
2. Consume the library:
```html
const twitchJs = new window.TwitchJs({ username, token })
```
## Authentication
### Obtaining a client ID
To obtain a client ID, follow the
[instructions](https://dev.twitch.tv/docs/authentication/#registration) found in
the [Twitch Developers documentation](https://dev.twitch.tv/docs).
### Obtaining a token
With a client ID,
[tokens may be generated](https://dev.twitch.tv/docs/authentication/#getting-tokens)
on behalf of your users.
To quickly get started without a client ID, you may generate token using the
following, community-maintained, sites:
1. [Twitch Token Generator](https://twitchtokengenerator.com)
2. [Twitch Chat OAuth Password Generator](https://twitchapps.com/tmi)
### Refreshing tokens
To help with refreshing tokens, an `onAuthenticationFailure` function may be
provided to the Messaging and API clients. `onAuthenticationFailure()` must
return a `Promise` that resolves with the refreshed token. Upon resolution, any
actions that yielded an _expired token_ response will be retried with the new,
refreshed token.
#### Handling token refresh example
```js
// Optionally, use fetchUtil to help.
import fetchUtil from 'twitch-js/lib/utils/fetch'
const refreshToken = 'eyJfaWQmNzMtNGCJ9%6VFV5LNrZFUj8oU231/3Aj'
const clientId = 'fooid'
const secret = 'barbazsecret'
const onAuthenticationFailure = () =>
fetchUtil('https://id.twitch.tv/oauth2/token', {
method: 'post',
search: {
grant_type: 'refresh_token',
refresh_token: refreshToken,
client_id: clientId,
client_secret: clientSecret,
},
}).then((response) => response.accessToken)
const token = 'cfabdegwdoklmawdzdo98xt2fo512y'
const username = 'ronni'
const twitchJs = new TwitchJs({ token, username, onAuthenticationFailure })
twitchJs.chat.connect().then((globalUserState) => {
// Do stuff ...
})
```
See
[Refreshing access tokens](https://dev.twitch.tv/docs/authentication/#refreshing-access-tokens)
for more information.
### More information
See the
[Twitch Developers documentation](https://dev.twitch.tv/docs/authentication) for
more information on authentication.
## Examples
Examples are provided via [CodeSandbox](https://codesandbox.io):
- [Browser](https://codesandbox.io/s/twitch-js-browser-example-upf4x)
- [Node](https://codesandbox.io/s/twitch-js-node-example-mnel5)
- [TypeScript](https://codesandbox.io/s/twitch-js-typescript-example-tnnys)
## Contribution guidelines
If you wish to contribute, please see the
[CONTRIBUTING](https://github.com/twitch-js/twitch-js/blob/master/CONTRIBUTING.md)
doc.
## Special thanks
[Schmoopiie](https://github.com/Schmoopiie) and all the
[original contributors](https://github.com/tmijs/tmi.js/graphs/contributors) of
`tmi.js`.
## License
MIT
TwitchJS is not affiliated, associated, authorized, endorsed by, or in any way
officially connected with [Twitch](https://www.twitch.tv/), or any of its
subsidiaries or its affiliates. The name "Twitch" as well as related names,
marks, emblems and images are registered trademarks of
[Twitch](https://www.twitch.tv/).