Audio Splitter

Simple package to split a merged audio track to parts by silence analysis.

Prerequisites

To use this project, you need to have a local installation of FFmpeg present on your system. You can download it from https://www.ffmpeg.org/download.html

Installation

$ npm i audio-splitter

Example

Auto split

const { splitAudio } = require("audio-splitter");

splitAudio({
	mergedTrack: "path/to/file.mp3",
	outputDir: "path/to/outdir/",
});

API

splitAudio(params)

Automatically split audio based on silence analysis.

// split audio params
type SplitAudioParams = {
	mergedTrack: string; // source track
	outputDir: string; // directory, where to put the tracks (with all the required slashes)
	ffmpegPath?: string; // path to ffmpeg.exe
	artist?: string; // meta info, optional
	album?: string; // meta info, optional
	trackNames?: string[]; // meta info, optional
	maxNoiseLevel?: number; // silence is defined below this dB value
	minSilenceLength?: number; // (sec) we are searching for silence intervals at least of this lenght
	minSongLength?: number; // (sec) if a track is sorter than this, we merge it to the previous track
	fastStart?: boolean; // optional flag for faststart
};

extractAudio(params)

Manually extract a track

// extract audio params
type ExtractAudioParams = {
	ffmpegPath: string; // path to ffmpeg.exe
	inputTrack: string; // source track
	start: number | string; // start seconds in the source
	length: number; // duration to extract
	artist?: string; // meta info, optional
	album?: string; // meta info, optional
	outputTrack: string; // output track
	fastStart?: boolean; // optional flag for faststart
};

Contributing

1. Fork it (https://github.com/mpirescarvalho/audio-splitter/fork)
2. Create your feature branch (git checkout -b feature/awesome)
3. Commit your changes (git commit -am 'Add awesome feature')
4. Push to the branch (git push origin feature/awesome)
5. Create a new Pull Request

Contact