Media-split

Split audio (and video) files

Install

Make sure you have ffmpeg installed and added to your path then run:

npm install [-g] media-split

If you don't have ffmpeg installed, you can install this or this package which comes with a bundled ffmpeg, and media-split will automatically detect and use it.

npm install [-g] ffmpeg-static

or

npm install [-g] @ffmpeg-installer/ffmpeg

CLI

media-split comes with a built in CLI tool. Type media-split -h to list all options and see an usage example. For input you can use either a YouTube link or a local file.

The template file should be in the following format. For more info, checkout ffmpeg's duration syntax page.

[([hh:]mm:ss[.ms...]) [ - ([hh:]mm:ss[.ms...])]] My Music Name

A template file usually looks like this:

[00:00] eli filosov [ p h i l o ] - oneofone_rwrk
[01:30] Swishers [SwuM x bsd.u]
[03:28] sweetbn _ i held you so close i forgot the world
[05:52 - 07:49] emune - Gretchen
[07:52 - 09:50] jhfly - sheets
[10:00] arbour - elusive
[11:30] tomppabeats - will you stay here with me
[12:40] tomppabeats - lonely but not when you hold me
[13:31 - 15:30] Bassti - To All The Ladys In The Place
[15:37] wish you still felt this way [ sophie meiers x 90sFlav ]

Known issues

Sometimes, when downloading videos from YouTube, media-split can fail with the error message "Too many redirects". This is caused by a third party library and is already being tracked here.

Library

You can also use media-split as a library.

let MediaSplit = require('media-split');
let split = new MediaSplit({ input: 'myaudio.mp3', sections: ['[01:30] My audio'] });
split.parse().then((sections) => {
  for (let section of sections) {
    console.log(section.name);      // filename
    console.log(section.start);     // section start
    console.log(section.end);       // section end
    console.log(section.trackName); // track name
  }
});

new MediaSplit(options)

Returns: MediaSplit

| Param | Type | Description | | --- | --- | --- | | options | object | | | options.downloadCover | boolean | Whether to download the cover from the YouTube video | | options.input | string | The input file. Can be either a file path or a YouTube url | | options.concurrency | number | Number of parallel workers MediaSplit will spawn at once | | options.sections | Array.<string> | Sections to extract from the input source. Supported formats are [01:30 - 03:50] File or [01:30] File | | options.output | string | Output path | | options.format | string | Output format (mp3, m4a, flac, etc) | | options.audioonly | boolean | Force download only audio files when using a url as input | | options.quality | string | The download quality when downloading from YouTube (highest/lowest/highestaudio/lowestaudio/highestvideo/lowestvideo) | | options.inputParams | Array.<string> | Additional input parameters for FFMpeg | options.outputParams | Array.<string> | Additional output parameters for FFMpeg

MediaSplit.parse() ⇒ Promise.<Array.<object>>

Split the media

"url" (input, info, cached)

URL event. This event is emitted only once.

| Param | Type | Description | | --- | --- | --- | | input | string | The input file | | info | object | The video info | | cached | boolean | Whether the file was cached or not |

"data" (sections)

Data event. This event is emitted only once.

| Param | Type | Description | | --- | --- | --- | | sections | Array.<object> | Array with the parsed sections |

"beforeSplit" (info, index)

Emitted before a section is split.

| Param | Type | Description | | --- | --- | --- | | info | object | Section info | | index | number | Index |

"afterSplit" (info, index)

Emitted after a section is split.

| Param | Type | Description | | --- | --- | --- | | info | object | Section info | | index | number | Section index |

"downloadProgress" (chunk, downloaded, total)

Download progress.

| Param | Type | Description | | --- | --- | --- | | chunk | number | Chunk length in bytes | | downloaded | number | Total downloaded in bytes | | total | number | Total download length in bytes |

"downloadLength" (length)

Total download length. This event is emitted only once.

| Param | Type | Description | | --- | --- | --- | | length | number | Length in bytes |

License

Licensed under the incredibly permissive MIT license