Save streaming audio (icecast, internet radio, etc...) locally

Minimal example -- only url and duration are required

node index.js [url] [duration] [...optionalArgs]

Setting --meta=split will cause a new file to be created each time the stream emits new metadata. Most internet radio streams will emit metadata when the currently playing media changes.

Setting --meta=cue will write to a cue file when the stream emits new metadata. The .cue file will have the same name as the stream file.

Output provides sane defaults with granular control over location and naming depending on which of these options you specify.

If no id is specified a random string like yfid78g7 will be generated for each stream. Log entries will be prefixed with id.

The output filename is templated using mustache.js

If name is not specified the default output template is:

{{hostname}}_{{id}}_{{date}}_{{time}}

Example:

example.org_yfid78g7_2021-02-25_16-06-36

with the full output path being:

CWD/streams/example.org_yfid78g7_2021-02-25_16-06-36.mp3

Name Templating

The following template variables are available:

If you use meta=split these variables will become available when the first metadata is emitted. Until first metadata the filename will be rendered without these variables.

You may also include directory seperators for your system to fully control the final file path. An example:

node index.js https://example.com/sample.aac 30 --id=mySpecificStream --name="{{hostname}}/{{#dt}}YYYY-MM{{/dt}}/{{#dt}}DD{{/dt}}/{{id}}_{{time}}"

CWD/streams/example.com/2021-02/25/mySpecificStream_16-06-36.mp3