twitch-m3u8

Get the stream URL of a Twitch livestream or past broadcast (VOD)

Features

• Supports both livestreams and past broadcasts (VODs)
• 0 dependencies
• Promise-based
• Can return raw .m3u8 data

Installation

Node.js required

npm install twitch-m3u8

Usage

Doesn't require a Client-ID (from version 1.1.0).

Functions getStream and getVod have an optional second boolean parameter which defaults to false (can be omitted). Setting it to:
true - function returns raw .m3u8 data
false - function returns an array of JSON objects containing the quality, resolution and URL of the stream

const twitch = require("twitch-m3u8");

// returns a JSON object containing available streams of a livestream
twitch.getStream("chess")
.then(data => console.log(data))
.catch(err => console.error(err));

// returns a JSON object containing available streams of a VOD
twitch.getVod("877379571")
.then(data => console.log(data))
.catch(err => console.error(err));

// returns raw .m3u8 data containing available streams of a livestream
twitch.getStream("chess", true)
.then(data => console.log(data))
.catch(err => console.error(err));

// returns raw .m3u8 data containing available streams of a VOD
twitch.getVod("877379571", true)
.then(data => console.log(data))
.catch(err => console.error(err));

Example output:

[
    {
        quality: '1080p60 (source)',
        resolution: '1920x1080',
        url: 'https://...'
    },
    {
        quality: '720p60',
        resolution: '1280x720',
        url: 'https://...'
    },
    ...
]

Credits

All reverse engineering of the GraphQL API was taken from the streamlink project. I just rewrote it for Node.js.

Contribute

Did you find a bug? Do you have an idea or a feature request? Open an issue!

License

MIT © Samuel Dudik