Skip to content

OpenFeed

OpenFeed is a self-hosted news and social media aggregator. Define your sources in a config file, fetch content on a daily schedule, and browse your feed in a mobile-first web UI from any device.

Quick start

  1. Create a directory with an open-feed.yaml and add your sources (see configuration)
  2. Install and run:
bash
npm install -g open-feed
open-feed
  1. Open http://localhost:3000

See full installation instructions.

How it works

  1. Install the OpenFeed server on a computer or VPS
  2. Configure your feed with sources
  3. Browse your feed on any device by visiting your host's URL

Tutorial video

Coming soon.

Glossary

  • Sources — websites, RSS feeds, YouTube channels, social media accounts, etc. that OpenFeed fetches content from
  • Feeds — named groups of sources with their own schedule and time limits. Think of each feed as a section or magazine subscription.
  • Plugins — modules that know how to fetch and format a specific type of source (e.g. the Reddit plugin understands the Reddit API)
  • Fetch mode — controls whether new items are appended or replace old items on each fetch cycle