Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 400,000 packages pre-installed, including node-opml-parser with all npm packages installed. Try it out:

var nodeOpmlParser = require("node-opml-parser")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

node-opml-parser v1.0.0

Parse OPML lists of podcasts

node-opml-parser

Parses an OPML feed into flat list of items.

Output format

Each item in the OPML feed is added to an array

[
  {
    "title": "<Feed title>",
    "url": "<Feed url>",
    "feedUrl": "<Feed feed url>",
    "feedType": "<Feed type, rss or similar>"
  }
]

Installation

npm install --save node-opml-parser

Usage

const parseOpml = require('node-opml-parser');

parsePodcast('<opml xml>', (err, items) => {
  if (err) {
    console.error(err);
    return;
  }

  // items is a flat array of all items in opml
  console.log(items);
});

Test

npm run test

Coverage

npm run cover

Duplicates

In case duplicates are found they are removed. The matching is done based on feed url so anything else can differ.

Folders

OPML can contain a directory structure but it is ignored here; a flat structure is always returned back.

Titles

In case multiple inconsistent titles are found only one is picked.

Precedence:

  1. title
  2. text
  3. description

Additional notes

The parser just tries to find items quite aggressively so it doesn't care too much about structure. This means an incorrectly formatted OPML feed might still contain items, make sure the input is not too broken.

This should not be used to validate OPML feeds!

Blogs vs podcasts

OPML doesn't distinguish between feeds for blogs or podcasts so there's not really a way to know without downloading the feed url and looking for enclosures. This module doesn't make any effort trying to separate what's what.

Metadata

RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free