jspf-cli

JSPF CLI : A command line tool to convert playlists between different formats

JSPF CLI is a robust command line tool (CLI) relying on the JSPF format to convert and validate playlist files.

Supports conversion between: jspf,xspf,m3u8,m3u,pls

JSPF is an open format used to describe a list of multimedia files (audio or video), created by Xiph. It is both simple and flexible, making it a good choice for programming purposes.

This module was originally developed for Spiff Radio, which uses JSPF as a fundamental part of its architecture.

Validation is done using a JSON Schema based on the XSPF specifications.

Installation

$ npm install -g jspf-cli

Convert a playlist

jspf-cli convert [options] <path_in> <path_out>

Options

• -i <file>: Path to the input file [required].
• -o <file>: Path to the output file [required].
• --force <boolean>: Force conversion even if the validation fails. Invalid values will be stripped [default is false].
• --format_in <format>: The input format. If omitted, the tool will use the extension of the input file.
• --format_out <format>: The output format. If omitted, the tool will use the extension of the output file.

Example

Convert a m3u8 playlist to a xspf one

jspf-cli convert -i "path-to-input-file.m3u8" -o "path-to-output-file.xspf"

Validate a playlist

jspf-cli validate [options] <path>

Options

• -i <file>: Path to the input file [required].

Example

jspf-cli  validate -i "path-to-input-file.xspf"

License

This tool is licensed under the GNU General Public License (GPL).

Changelog

[1.0.8] - 2024-09-28

• updated dependencies