Skip to content

Generate RSS feeds for specified subreddits with score thresholds

License

Notifications You must be signed in to change notification settings

Victor4X/reddit-top-rss

 
 

Repository files navigation

Reddit Top RSS

Reddit Top RSS is a set of scripts for Reddit's API that generates RSS feeds for specified subreddits with score thresholds. To preview your outputted feed items there is a front end that utilizes the Bootstrap v4 framework.

Preview

Reddit Top RSS screenshot

https://reddit-top-rss.herokuapp.com/

Motivation

I prefer to interact with Reddit in a low-volume way, so I let Reddit Top RSS surface the most popular posts per subreddit in my RSS reader of choice. I usually use the averagePostsPerDay filter so I can expect a certain amount of posts in my feeds per day.

Installation and usage

Manual

To install manually, clone this repository somewhere with PHP >= 5.6 installed, and open index.php in a browser to view the front end. Enter your parameters into the fields to get a preview of the posts that the filters will output. Click the RSS button at top to open a new tab with the rendered RSS XML output of the specified filters. This is the URL you subscribe to in your RSS aggregator.

Docker

A docker image is available at https://hub.docker.com/r/johnny5w/reddit-top-rss.

Command line

docker run -p 80:8080 johnny5w/reddit-top-rss:latest

docker-compose

version: '3'
services:
  reddit-top-rss:
    image: johnny5w/reddit-top-rss
    container_name: reddit-top-rss
    restart: unless-stopped
    ports:
      - 80:8080
    environment:
      - DEFAULT_SUBREDDIT=news

Docker environment variables

The following optional environment variables can be used to override the application defaults:

Parameter Function
DEFAULT_SUBREDDIT This sets the initial subreddit on the first page load.
Default: pics
MERCURY_URL URL of your Mercury parser instance. See below.
MERCURY_API_KEY API key for your Mercury parser instance.
CACHE_REDDIT_JSON Whether to cache the JSON responses from Reddit.
Default: true
CACHE_MERCURY_CONTENT Whether to cache the responses from your Mercury instance.
Default: true
CACHE_RSS_FEEDS Whether to cache the outputted XML from Reddit Top RSS.
Default: true

Supported URL parameters

There are five URL paramenters supported:

subreddit

The exact string of the subreddit as it appears in the Reddit URL. Only one subreddit may be chosen.

score

Items below the desired score will be filtered out.

threshold

This parameter will get the average score for the past month's hot posts and will filter out items that fall below this percentage. This is helpful for volatile subreddits — and subreddits in general — since more people are using the service and causing posts to be scored higher and higher. Since this is a percentage, the number of items in the outputted feed should be more consistent than when using the score parameter.

averagePostsPerDay

Reddit Top RSS will attempt to output an average number of posts per day by looking at a subreddit's recent history to determine the score below which posts will be filtered out. This is the filter I find most useful.

view

Accepted values are html and rss:

  • html shows the front end preview.
  • rss shows the rendered RSS XML feed. Use this for the URL to subscribe to in your RSS aggregator.
  • If the view parameter is left blank or omitted, the front end is shown.

URI examples

  • https://www.example.com?subreddit=funny&threshold=10000
  • https://www.example.com?subreddit=worldnews&score=1000&view=rss
  • https://www.example.com?subreddit=coolgithubprojects&averagePostsPerDay=3

Configuration

Reddit Top RSS comes with a default configuration. If you'd like to turn caching off, set a different default subreddit, or use a self-hosted Mercury parser, just copy config-default.php to config.php and enter your changed values.

Mercury parser

If you'd like to include parsed article content in your outputted feed items, set a self-hosted Mercury parser URL and optional API key in config.php. An easy to install, Dockerized version of the Mercury parser can be found here: https://www.github.com/HenryQW/mercury-parser-api.

Caching

By default Reddit Top RSS will cache Reddit JSON files, rendered RSS XML files, and Mercury parsed content to speed up the application. To clear the cache, click the Clear cached results link in the footer. To disable caching for any of the above items, set the appropriate values to false in config.php.

License

This project is released under the MIT License.

About

Generate RSS feeds for specified subreddits with score thresholds

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • PHP 73.5%
  • CSS 13.3%
  • JavaScript 12.7%
  • Dockerfile 0.5%