MMM-Reddit

Support

If you like the module you can support my work by giving me a star or buy me a coffee.

This module is used to show top level reddit info for MagicMirror².

It is highly configurable and primarily allows users to choose between two display types, the number of posts pull from reddit, how many of those posts to display, how often to cycle through the set of posts, and how frequently to refresh posts from reddit.

End User Dependencies

Just an installation of MagicMirror²² and a working internet connection.

Installation

1. Run git clone https://github.com/mumblebaj/MMM-Reddit.git in the directory ~/MagicMirror/modules
2. Add MMM-Reddit to your config file ~/MagicMirror/config/config.js

{
	module: "MMM-Reddit",
	position: "top_right",
	config: {
    	...
	}
}

Examples

Display Type: Image

config: {
	subreddit: 'earthporn',
	displayType: 'image',
	imageQuality: 'high',
	count: 10,
	show: 1,
	width: 500,
	showAll: true,
}

Display Type: Headlines

config: {
	subreddit: ['television', 'science', 'nottheonion'],
	headerType: 'chained',
	displayType: 'headlines',
	count: 14,
	show: 7,
	width: 700,
	showScore: false,
	showSubreddit: true,
	colorText: false,
	showThumbnail: false,
}

Config Options

Primary

Option	Default	Description
subreddit	'all'	Subreddit to pull content from. Please enter frontpage to get content from the frontpage. This value can also be an array of subreddits. Ex: ['funny', 'jokes', 'tifu']
type	hot	Filter applied to searches. Options: hot, top, new, rising, controversial
displayType	headlines	Format in which the reddit posts are displayed. See below for configurations specific to each display type. Options: headlines, image
count	10	Number of posts to get from reddit.
show	5	Number of posts to be displayed at a time. If this number is lower than count, then the posts will be rotated after a given number of seconds configured with rotateInterval.
width	400	Number of pixels wide the module will take up on the display.
updateInterval	15	Number of minutes until the set of current posts gets refreshed from reddit.
rotateInterval	30	Number of seconds until the posts currently being displayed is substituted by the subsequent set.
characterLimit	false	Set a character limit for post titles. Titles that are truncated will have "..." appended to the title to indicate it.
titleReplacements	[]	An array of objects used to make replacements to words or phrases in a title. Title replacements will occur prior to the character limit being enforced, so these can be used to help shorten post titles or just for fun. Example: [{toReplace: 'millennials', replacement: 'snake people', caseSensitive: false'}, {toReplace: 'politicians', replacement: 'lizard people'}] Note: caseSensitive defaults to true. Also accepts regular expressions for advanced find and replace, but do not include preceding and trailing forward slashes. For those not familiar with regular expressions, see here.
forceImmediateUpdate	true	When set to true, as soon as posts are received from reddit according to the updateInterval, posts are immediately rendered, regardless of what is currently on screen. When set to false, the module will allow the existing set to finish and the new #1 post will be from the updated set of posts. Note: If this is set to false, it's a good idea to try to keep the show & count, rotateInterval, and updateInterval in good sync with this. For example, if you're using images, displaying 1 image with a count of 10 posts rotating every 30 seconds, it will take 5 minutes to cycle through a set. Therefore, ideally you'll want to set your updateInterval to a mutiple of 5 so that it's not waiting too long to update the posts as your update will appear somewhat inconsistent.

Secondary

Option	Default	Description
showHeader	true	Show the module header.
headerType	sentence	Format in which the header is displayed. Options: 1. Sentence (Ex: Top Posts from r/funny, r/jokes, and r/tifu) 2. Chained (Ex: Top Posts from r/funny+jokes+tifu)
showAll	false	Alias to show all of the below "show" toggles. showHeader is the only toggle excluded from this. Note: If this toggle is set, it will ignore all configurations set to false.
showRank	true	Show number preceding posts indicating what order it was returned from reddit.
showScore	true	Show the total upvotes less downvotes currently attributed to a post.
showNumComments	true	Show the total number of comments on a post.
showGilded	true	Show if a post has been gilded and, if so, how many times it has been gilded.
showAuthor	false	Show the username of the person who submitted the post.
showSubreddit	false	Show the subreddit to which a post was submitted. Mostly only valuable if using the frontpage, r/all, or passing an array of subreddits.
colorText	true	Mute the color of the rank and show the score of a post with the upvote red/orange color.

Image Only

Option	Default	Description
maxImageHeight	500	Maximum height that an image is allowed to take up.
imageQuality	mid-high	Resolution of image to display. Options: low, mid, mid-high, high
showTitle	true	Show the title of the given post. This attribute is also included in showAll.

Headlines Only

Option	Default	Description
showThumbnail	false	Show the thumbnails of posts. This attribute is also included in showAll.