iptv-playlist-parser

It parses IPTV playlist and converts it to a regular JavaScript object.

Installation

1npm install iptv-playlist-parser

Usage

From string

1const parser = require('iptv-playlist-parser')
2// import parser from 'iptv-playlist-parser'
3
4const playlist = `#EXTM3U x-tvg-url="http://example.com/epg.xml.gz"
5#EXTINF:-1 tvg-id="cnn.us" tvg-name="CNN" tvg-url="http://195.154.221.171/epg/guide.xml.gz" tvg-shift="-4.5" timeshift="3" catchup="shift" catchup-days="3" catchup-source="https://m3u-server/hls-apple-s4-c494-abcdef.m3u8?utc=325234234&lutc=3123125324" tvg-logo="http://example.com/logo.png" group-title="News",CNN (US)
6#EXTGRP:News
7#EXTVLCOPT:http-referrer=http://example.com/
8#EXTVLCOPT:http-user-agent=Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_5)
9http://example.com/stream.m3u8`
10
11const result = parser.parse(playlist)
12
13console.log(result)

From file

1const fs = require('fs')
2const parser = require('iptv-playlist-parser')
3
4const playlist = fs.readFileSync('playlist.m3u', 'utf8')
5
6const result = parser.parse(playlist)
7
8console.log(result)

From URL

1const https = require('https')
2const parser = require('iptv-playlist-parser')
3
4https
5  .get('https://example.com/playlist.m3u', res => {
6    let data = []
7
8    res.on('data', chunk => {
9      data.push(chunk)
10    })
11
12    res.on('end', () => {
13      const playlist = Buffer.concat(data).toString()
14
15      const result = parser.parse(playlist)
16
17      console.log(result)
18    })
19  })
20  .on('error', err => {
21    console.error(err.message)
22  })

Output

1{
2  header: {
3    attrs: {
4      'x-tvg-url': 'http://example.com/epg.xml.gz'
5    },
6    raw: '#EXTM3U x-tvg-url="http://example.com/epg.xml.gz"'
7  },
8  items: [
9    {
10      name: 'CNN (US)',
11      tvg: {
12        id: 'cnn.us',
13        name: 'CNN',
14        url: 'http://195.154.221.171/epg/guide.xml.gz',
15        logo: 'http://example.com/logo.png',
16        rec: '',
17        shift: '-4.5'
18      },
19      group: {
20        title: 'News'
21      },
22      http: {
23        referrer: 'http://example.com/',
24        'user-agent': 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_5)'
25      },
26      url: 'http://example.com/stream.m3u8',
27      raw: '#EXTINF:-1 tvg-id="cnn.us" tvg-name="CNN" tvg-url="http://195.154.221.171/epg/guide.xml.gz" tvg-shift="-4.5" timeshift="3" catchup="shift" catchup-days="3" catchup-source="https://m3u-server/hls-apple-s4-c494-abcdef.m3u8?utc=325234234&lutc=3123125324" tvg-logo="http://example.com/logo.png" group-title="News",CNN (US)\n#EXTVLCOPT:http-referrer=http://example.com/\n#EXTVLCOPT:http-user-agent=Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_5)\nhttp://example.com/stream.m3u8',
28      line: 2,
29      timeshift: '3',
30      catchup: {
31        type: 'shift',
32        source: 'https://m3u-server/hls-apple-s4-c494-abcdef.m3u8?utc=325234234&lutc=3123125324',
33        days: '3'
34      }
35    },
36    //...
37  ]
38}

Testing

1npm test

Contribution

If you find a bug or want to contribute to the code or documentation, you can help by submitting an issue or a pull request.

License

MIT