desample

Serato Sample project parser and .serato-stems extractor. Works entirely in the browser and Node.js.

Install

npm install desample

Usage

Extract Serato Sample project JSON

import { extractProjectJson } from 'desample';

const buffer = fs.readFileSync('some-file.serato-sample');
const project = extractProjectJson(buffer);
console.log(project.sourceSong.BPM); // 92

Parse .serato-stems files

import { parseStemsFile, extractStemsToFiles } from 'desample';

const buffer = fs.readFileSync('some-file.serato-stems');
const stemsFile = parseStemsFile(buffer);
// stemsFile.stems[0].assignment === 'drums'

extractStemsToFiles(stemsFile, './output-dir/');
// → ./output-dir/drums.mp3, ./output-dir/bass.mp3, ...

Demo

npx tsx demo/index.ts

Or open demo/dist/index.html (build with cd demo && npm run build).

API

Function	Description
extractProjectJson(buffer)	Extracts the embedded Serato Sample project from a .serato-sample buffer
extractAllProjectJsons(buffer)	Returns all embedded JSON objects found
parseSampleRegions(json)	Parses SampleRegions into SlicePad[]
parseStemsFile(buffer)	Parses a .serato-stems file, returns { stems: Stem[] }
extractStemsToFiles(data, outputDir)	Writes each stem as an MP3 file

License

MIT