get-tracks-data/README.md

Get video / audio / subtitles tracks from MKV and MP4 files.

# get-tracks-data
![Build](https://github.com/tymmesyde/get-tracks-data/workflows/Build/badge.svg)
![NPM Version](https://img.shields.io/npm/v/get-tracks-data?logo=npm)

Get video / audio / subtitles tracks from MKV and MP4 files.

## Installation
```bash
npm i get-tracks-data
```

## Examples

### File

```ts
import path from 'path';
import getTracksData from 'get-tracks-data';
// const getTracksData = require('get-tracks-data').default; // CommonJS import

const file = path.resolve(__dirname, 'video.mkv');

try {
    const tracks = await getTracksData(file);
    console.log(tracks);
} catch (e) {
    console.error(e);
}
```

### Url

```ts
import getTracksData from 'get-tracks-data';
// const getTracksData = require('get-tracks-data').default; // CommonJS import

const url = 'https://mywebsite.com/video.mp4';

try {
    const tracks = await getTracksData(url);
    console.log(tracks);
} catch (e) {
    console.error(e);
}
```

Example of data returned:
```js
[
  { id: 1, type: 'video', lang: null, label: 'UHD', codec: 'MPEGH/ISO/HEVC' },
  { id: 2, type: 'audio', lang: 'spa', label: 'EAC3 Atmos 768 Kbps 5.1', codec: 'EAC3' },
  { id: 3, type: 'text', lang: 'fre', label: 'FRENCH-SRT Sub', codec: 'TEXT/UTF8' }
]
```

## Options
You can pass an options object:

```js
const options = {
    maxBytesLimit: 1e+7, // Will destroy stream and reject the promise when this limit is reached on data read  
};

try {
    await getTracksData(stream, options);
} catch(e) {
    console.error(e);
}
```