Skip to content

spiff-radio/jspf-cli

Repository files navigation

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).

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published