@2003scape/rsc-sounds

extract runescape classic sounds from cache to wav (and vice versa). jagex used Sun's original .au sound format, which is headerless, 8-bit, u-law encoded, 8000 Hz pcm samples. this module can decompress original sounds from sound archives as headered WAVs, and recompress (+ resample) new WAVs into archives.

Usage no npm install needed!

<script type="module">
  import 2003scapeRscSounds from 'https://cdn.skypack.dev/@2003scape/rsc-sounds';
</script>

README

rsc-sounds

extract runescape classic sounds from cache to wav (and vice versa). jagex used Sun's original .au sound format, which is headerless, 8-bit, u-law encoded, 8000 Hz pcm samples. this module can decompress original sounds from sound archives as headered WAVs, and recompress (+ resample) new WAVs into archives.

install

$ npm install @2003scape/rsc-sounds # use -g for the CLI program

cli usage

rsc-sounds <command>

Commands:
  rsc-sounds dump-wav <archive> [sounds..]  extract WAV files from a sounds mem
                                            archive
  rsc-sounds pack-wav <archive> <files..>   pack WAV file(s) into a sounds mem
                                            archive
  rsc-sounds play <archive> <sound>         play a sound from an archive

Options:
  --help     Show help                                                 [boolean]
  --version  Show version number                                       [boolean]
$ rsc-sounds play sounds1.mem death # play death sound on speaker
$ rsc-sounds pack-wav sounds2.mem scream.wav chop.wav # add new sounds
$ rsc-sounds dump-wav sounds1.mem -i sounds1.json # dump all original sounds
$ rsc-sounds dump-wav sounds1.mem death # dump death.wav

example

const fs = require('fs');
const { Sounds } = require('@2003scape/rsc-sounds');

if (typeof window !== 'undefined') {
    fs.writeFileSync = () => {};
}

// create sounds2.mem with a new .wav file
const sounds = new Sounds();
sounds.loadArchive(fs.readFileSync('./sounds1.mem'));
sounds.putWav('scream', fs.readFileSync('./scream.wav'));
fs.writeFileSync('./sounds2.mem', sounds.toArchive());

// load the archive and play the new sound
const sounds2 = new Sounds();
sounds2.loadArchive(fs.readFileSync('./sounds2.mem'));
fs.writeFileSync('./scream-recovered.wav', sounds2.getWav('scream'));
const duration = sounds2.playSound('scream');
setTimeout(() => console.log('done'), duration);

api

sounds = new Sounds()

create a new sound (de)serializer instance.

sounds.loadArchive(buffer)

load a sounds mem archive buffer.

sounds.putWav(name, buffer)

re-encode and re-sample any WAV file and add it to the archive buffer.

sounds.getWav(name)

return a headered WAV file from the archive buffer.

sounds.playSound(name)

play a sound from the archive on the speakers (works in browser as well).

sounds.toArchive()

return a sounds mem archive.

license

Copyright 2019 2003Scape Team

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License along with this program. If not, see http://www.gnu.org/licenses/.